接入文档
Codex 接入指南
将熊猫算力接入 OpenAI Codex CLI,使用 config.toml 配置文件或环境变量。
Codex 是 OpenAI 发布的 AI 编码助手 CLI 工具,支持通过 ~/.codex/config.toml 配置文件指定 API 提供商。
1 字段对照表
| 字段 | 填写内容 |
|---|---|
| model_provider.openai.base_url | 平台网关地址 + /v1(Codex 使用 OpenAI 兼容协议) |
| OPENAI_API_KEY(环境变量) | 你的 API 密钥(sk-xxxxx)——Codex 通过环境变量读取,不写入 toml |
| model | 从模型广场复制的模型 ID |
路径差异:带 /v1
Codex 使用 OpenAI 兼容协议,base_url 需要填带 /v1 的完整地址(即平台网关地址 + /v1)。
与之对比:Claude Code 的 ANTHROPIC_BASE_URL 不带 /v1。
2 配置文件(推荐)
编辑 ~/.codex/config.toml
~/.codex/config.toml
注意:API 密钥不写在 toml 文件里,通过环境变量提供(见下一步)。
验证接入
运行 Codex,发一条消息,确认能收到回复。然后前往调用记录 查看调用记录。
3 环境变量(无配置文件)
同时设置 OPENAI_API_KEY 和 OPENAI_BASE_URL(带 /v1)后,Codex 会直接使用,无需 config.toml。
4 CC Switch(图形化快捷路径)
安装 CC Switch(下载页面)。
在熊猫算力控制台的密钥详情页,切换到「CC Switch」标签。
选择应用为 Codex,填入从模型广场复制的模型 ID,点击「导入到 CC Switch」。
CC Switch 自动生成配置,无需手动编辑 config.toml。
5 常见问题
6 下一步
- 快速开始 — 回顾完整上手流程
- Claude Code 接入指南 — 对比 Claude Code 的路径差异
- 错误码大全 — 排查常见错误