Codex CLI 接入指南

适用角色：开发者、主用户、子用户更新日期：2026-08-06

Codex CLI 通过自定义 Provider 连接本平台。当前配置使用 Responses wire API；如果本机版本不认识该字段，应先升级 Codex，而不是改成已禁用的 chat 模式。

安装

npm install -g @openai/codex
codex --version

配置自定义 Provider

先让 Codex 从环境变量读取 Key：

export CUSTOM_API_KEY="YOUR_API_KEY"

在 ~/.codex/config.toml 中加入：

model = "deepseek-v4-flash"
model_provider = "myplatform"
 
[model_providers.myplatform]
name = "自定义平台"
base_url = "https://<接口地址>"
env_key = "CUSTOM_API_KEY"
wire_api = "responses"

以控制台「API Key」页展示的接口地址为准。

model 应替换为控制台展示的实际调用名。配置文件可以保存 Provider 和模型，但不要把真实 Key 直接写入并提交到代码仓库。

验证与排查

在一个测试目录运行：

codex -m deepseek-v4-flash

先让它回答一个不修改文件的问题，再检查控制台使用记录。出现 404 时查看最终路径是否重复 /v1；出现 wire_api = chat is no longer supported 时，确认配置为 responses 并升级 Codex。

VS Code 扩展的安装入口如下。扩展市场页面可能随版本更新。

Codex 扩展安装界面

CLI 已连通而扩展未生效时，重启 VS Code，并确认扩展使用的是同一用户目录下的 Codex 配置。