Codex 配置指南

Codex 可以通过 API 模式或 OAuth 登录模式连接到 xcodecli。推荐使用 API 模式。

快速安装与配置

使用下面的单行命令即可自动完成安装和 API 模式配置。

macOS / Linux

API_KEY='你的密钥' bash -c "$(curl -fsSL https://docs.xcodecli.com/scripts/codex/setup-codex.sh)"

Windows

$key='你的密钥'; $f="$env:TEMP\xc.ps1";iwr -useb https://docs.xcodecli.com/scripts/codex/setup-codex.ps1 -OutFile $f;& $f

请将命令中的 你的密钥 替换为你在 xcodecli 中为 Codex 创建的 API Key。

Windows 执行策略

如果 PowerShell 拦截 .ps1 脚本执行，请先以管理员身份打开 PowerShell，运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned，出现确认提示时输入 Y 并按 Enter。

配置完成后请重启终端

如果脚本刚安装了 Codex，请重启终端使命令 PATH 生效。

• macOS / Linux：重新打开终端，或执行 source ~/.zshrc（或 source ~/.bashrc）
• Windows：重新打开 PowerShell 窗口

API 模式（推荐）

启动 xcodecli 服务器，修改 ~/.codex/config.toml 和 ~/.codex/auth.json 文件。

config.toml：

# 无需确认是否执行操作，危险指令，初次接触 Codex 不建议开启，移除 # 号即可开启
# approval_policy = "never"

# 沙箱模式超高权限，危险指令，初次接触 Codex 不建议开启，移除 # 号即可开启
# sandbox_mode = "danger-full-access"

model_provider = "xcodecli"
model = "gpt-5.5" # 或者是 gpt-5.4，你也可以使用任何我们支持的模型
model_reasoning_effort = "high"

[model_providers.xcodecli]
name = "xcodecli"
base_url = "https://api2.xcodecli.com/v1"
wire_api = "responses"

auth.json：

{
  "OPENAI_API_KEY": "sk-dummy"
}

请将 sk-dummy 替换为你在 xcodecli 中为 Codex 创建的 API Key。

OAuth 登录模式

启动 xcodecli 服务器，然后使用 ChatGPT 账户（任意订阅，包含免费账户）登录 Codex CLI 或者 Codex App。

只需要修改 ~/.codex/config.toml 文件：

model = "gpt-5.5" # 或者是 gpt-5.4，你也可以使用任何我们支持的模型
model_provider = "xcodecli"

# 无需确认是否执行操作，危险指令，初次接触 Codex 不建议开启，移除 # 号即可开启
# approval_policy = "never"

# 沙箱模式超高权限，危险指令，初次接触 Codex 不建议开启，移除 # 号即可开启
# sandbox_mode = "danger-full-access"

model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
supports_websockets = true

[model_providers.xcodecli]
base_url = "https://api2.xcodecli.com/v1"
experimental_bearer_token = "sk-dummy" # 这里修改为你在 xcodecli 中为 Codex 创建的 API Key
name = "xcodecli"
wire_api = "responses"
requires_openai_auth = true

OAuth 登录模式无需修改 auth.json 文件。

注意事项

• Codex 推荐使用 codex 分组，不再推荐使用 cc2api 分组。
• approval_policy = "never" 和 sandbox_mode = "danger-full-access" 都是高风险配置，初次接触 Codex 不建议开启。
• 默认端点是 https://api2.xcodecli.com/v1；如果不可用，可切换到 https://api.xcodecli.com/v1。