Codex CLI
Codex CLI 是 OpenAI 推出的运行在终端的 AI 编程智能体，能够读取本地代码库，通过自然语言交互完成代码编写、文件操作和命令执行等开发任务。
配置步骤
Codex CLI 支持通过 config.toml 配置文件接入自定义模型。
配置字段对照表
| 字段 | 解释 |
|---|---|
| model | 大模型 ID，在 AI 控制台 模型列表复制已启用的大模型标识填入 |
| model_provider | 提供商 ID，指向自定义的 [model_providers] 配置 |
| base_url | 大模型 Base URL，在 AI 控制台中获取 |
| env_key | API Key 对应的环境变量名 |
- CC Switch 配置
- 配置文件（永久生效）
- 命令行参数（临时生效）
CC Switch 是一款开源的桌面应用，统一管理多个 AI 编程工具的供应商配置。安装方式参考 CC Switch 配置文档。
- 打开 CC Switch，添加云开发供应商
| 字段 | 说明 |
|---|---|
| API Key | 在 AI 控制台 中获取 |
| Base URL | https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase |
| API 格式 | Chat Completions（需开启本地路由） |
-
在高级选项中启用本地路由映射，填入模型 ID
-
切换启用云开发供应商，启动 Codex CLI 即可使用
- 打开或创建 Codex CLI 配置文件
备注
如果通过您文件浏览器找到文件，文件浏览器默认会隐藏掉以"."开头的文件名的文件，您可能需要打开文件浏览器的隐藏文件选项才能看到。
Mac 通过访达快捷键 Command + Shift + . 打开，Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目" 打开。
- Mac/Linux 配置路径
~/.codex/config.toml
- Windows 配置路径
C:\Users\<你的用户名>\.codex\config.toml
- 新增或修改以下配置
model = "hy3-preview"
model_provider = "cloudbase"
[model_providers.cloudbase]
name = "CloudBase"
base_url = "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
env_key = "CLOUDBASE_API_KEY"
- 设置 API Key 环境变量
Mac/Linux（当前终端窗口有效）
export CLOUDBASE_API_KEY="eyJhbGciOiJSUzI1N..."
Windows CMD（当前终端窗口有效）
set CLOUDBASE_API_KEY=eyJhbGciOiJSUzI1N...
Windows PowerShell（当前终端窗口有效）
$env:CLOUDBASE_API_KEY = "eyJhbGciOiJSUzI1N..."
备注
以上环境变量为临时生效，关闭终端后失效。如需永久生效，可将环境变量写入 Shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）中。
- 启动 Codex CLI
codex
无需修改配置文件，通过命令行直接覆盖：
export CLOUDBASE_API_KEY="eyJhbGciOiJSUzI1N..."
codex --config model='"hy3-preview"' \
--config model_provider='"cloudbase"' \
--config 'model_providers.cloudbase.base_url="https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"' \
--config 'model_providers.cloudbase.env_key="CLOUDBASE_API_KEY"'
常见错误排查
| 报错信息 | 解决方法 |
|---|---|
404 模型未找到 | Base URL 填写不正确，请前往 AI 控制台中复制正确的 Base URL |
401 Credentials are invalid | API Key 填写错误，或者可能被删除 |
429 Token usage exceeded quota limit | 配置了错误的大模型名称，或者大模型未在 AI 控制台 中启用 |