文档

接入文档

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 文件里,通过环境变量提供(见下一步)。

设置 API 密钥环境变量

export OPENAI_API_KEY="sk-xxxxx"

sk-xxxxx 替换成你的真实密钥(前往密钥页面创建或复制)。

从模型广场选一个模型

打开 模型广场,复制模型 ID。在 config.toml 中加一行:

model = "[在模型广场复制的模型 id]"

或在调用时通过 --model <模型 id> 参数指定。

验证接入

运行 Codex,发一条消息,确认能收到回复。然后前往调用记录 查看调用记录。


3 环境变量(无配置文件)

同时设置 OPENAI_API_KEYOPENAI_BASE_URL(带 /v1)后,Codex 会直接使用,无需 config.toml


4 CC Switch(图形化快捷路径)

安装 CC Switch(下载页面)。

在熊猫算力控制台的密钥详情页,切换到「CC Switch」标签。

选择应用为 Codex,填入从模型广场复制的模型 ID,点击「导入到 CC Switch」。

CC Switch 自动生成配置,无需手动编辑 config.toml


5 常见问题


6 下一步

Codex 接入指南 | 熊猫算力文档