Codex 配置

Codex 是 OpenAI 推出的 AI 编程助手 CLI 工具。Clauddy 兼容 OpenAI API 格式，可直接对接。

前提条件

• 已在 Clauddy 创建 API 令牌（创建教程）
• 已安装 Node.js 18+（环境检查）

安装

macOS / Linux

npm install -g @openai/codex

Windows (以管理员身份运行)

npm install -g @openai/codex

验证安装：

codex --version

配置方法

Codex 支持通过配置文件设置 API 地址和密钥。

macOS / Linux (~/.codex/config.toml)

model_provider = "clauddy"
model = "gpt-5.3-codex"

[model_providers.clauddy]
name = "clauddy"
base_url = "https://clauddy.com/v1"
wire_api = "responses"
requires_openai_auth = true

Windows (%USERPROFILE%\.codex\config.toml)

# 1. 按 Win+R，输入 %USERPROFILE% 后回车
# 2. 创建 .codex 文件夹
# 3. 在文件夹中创建 config.toml 和 auth.json 两个文件

model_provider = "clauddy"
model = "gpt-5.3-codex"

[model_providers.clauddy]
name = "clauddy"
base_url = "https://clauddy.com/v1"
wire_api = "responses"
requires_openai_auth = true

还需要创建 auth.json 文件（与 config.toml 同目录）：

macOS / Linux (~/.codex/auth.json)

{
  "OPENAI_API_KEY": "sk-your-clauddy-token"
}

Windows (%USERPROFILE%\.codex\auth.json)

{
  "OPENAI_API_KEY": "sk-your-clauddy-token"
}

Windows 用户创建 .codex 文件夹

mkdir "%USERPROFILE%\.codex"

配置说明

配置项	说明
base_url	Clauddy OpenAI 兼容 API 地址：https://clauddy.com/v1
OPENAI_API_KEY	您在 Clauddy 创建的 API 令牌
model	推荐使用 gpt-5.3-codex

注意 URL 格式

Codex 需要 /v1 后缀。请确保设置的是 https://clauddy.com/v1 而不是 https://clauddy.com。

启动使用

cd your-project-folder
codex

常见问题

参考 Codex 常见问题。