Codex CLI

配置 Codex CLI 使用 Essevin 的 OpenAI Responses 兼容接口。

Codex CLI 是 OpenAI 的官方编程代理。首次接入建议使用控制台「一键接入」;手动接入需要配置 config.tomlOPENAI_API_KEY

推荐:控制台一键接入

选择 Codex 分组密钥

登录控制台,在「API 密钥」找到 Codex Plus 或 Codex Pro 分组的密钥。

生成接入命令

点密钥旁的「一键接入」,再选择 Codex CLI 和目前使用的操作系统。

执行并验证

将命令贴到终端执行;完成后重新开启终端,输入 codex

偏好图形界面时,按CC Switch 指南从密钥菜单点「导入 CCS」,再选择 Codex CLI

手动配置

系统config.toml 位置
macOS / Linux~/.codex/config.toml
WindowsC:\Users\你的用户名\.codex\config.toml

如果文件不存在,请创建文件并填入以下内容:

# config.toml
model_provider = "essevin"
model = "gpt-5.6-sol"

[model_providers.essevin]
name = "Essevin"
base_url = "https://api.essevin.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

不要混用两种密钥写法

手动配置用 env_key 从环境变量读密钥;一键接入用的是 requires_openai_auth = trueauth.json。不要把 requires_openai_auth = true 和环境变量写法混在同一份配置里:Codex 0.153 实测这种组合不发送密钥,网关返回 401 missing_api_key

设置 OPENAI_API_KEY 后启动 Codex:

临时设置:只在当前终端窗口有效。

export OPENAI_API_KEY=sk-你的密钥
codex

永久设置:写入 shell 启动文件,之后新开终端即可使用。

# zsh(macOS 默认)
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc

# bash(Linux 常见;与上面 zsh 二选一)
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc

联网搜索与远程压缩暂不支持

Codex 的联网搜索会请求 /v1/alpha/search,远程上下文压缩会请求 /v1/responses/compact,这两个接口目前都不支持,会返回 404。联网搜索的 404 不影响普通对话;不想看到这条报错,在 Codex 中关闭联网搜索即可。

必须用 Codex 分组的密钥

请使用 Codex 分组(Codex Plus / Codex Pro)的密钥。卡住了?看报错速查

本页目录