外观
Codex 部署指南
| 资源 | 地址 |
|---|---|
| Codex 官方文档 | developers.openai.com/codex |
📋 前置要求
- 已安装 Node.js 18+（nodejs.org）
- 已安装 CC-Switch 配置工具（推荐）
关于 Codex
Codex 是 OpenAI 推出的命令行 AI 编程助手，基于 GPT-5 系列模型。本指南教你如何把它接到卡皮巴拉中转服务。
部署路径： 安装 CLI ➜ 配置 API ➜ 开始使用
🚀 用 CC-Switch 一键配置（推荐）
前置条件：先装 Codex
无论用不用 CC-Switch，Codex 命令行工具本身需要先装好：
bash
npm install -g @openai/codex@latest验证：
bash
codex --version配置步骤
1. 添加卡皮巴拉配置到 CC-Switch
- 打开 CC-Switch 应用
- 点击顶部 「Codex」 标签页
- 点击右上角橙色 「+」 按钮添加新配置
2. 填写配置信息
| 字段 | 填写内容 |
|---|---|
| 提供商名称 | 自定义，比如「卡皮巴拉」 |
| Base URL | https://ai.bututrip.fun/v1 |
| API Key | 你在卡皮巴拉创建的 Codex 专用密钥 |
| Model | 选择可用的 GPT 模型，如 gpt-5.4 或 gpt-4o |
| 其他配置 | 按需调整推理强度等参数 |
填完点 「保存」。
💡 提示
- CC-Switch 会自动写入
~/.codex/config.toml和auth.json两个文件 - 可以同时保存多个不同提供商，随时切换
3. 启用配置
- 在配置列表里找到刚创建的「卡皮巴拉」
- 点击右侧的 「当前使用」
- 该配置变成绿色「当前使用」状态
- 重启 Codex 让新配置生效
4. 系统托盘快速切换
- 右键点击系统托盘里的 CC-Switch 图标
- 在菜单选 Codex 分类
- 直接点要切换的配置，立即生效
⚠️ 注意事项
- 在卡皮巴拉创建密钥时，务必选择 Codex 类型
- Codex 密钥与 Claude Code 密钥不通用，要分别创建
- 切换后必须重启 Codex 才能生效
⌨️ 手动命令行配置
不用 CC-Switch 也行，按平台跟着步骤来。
🖥️ Windows
第一步：安装 Codex
以管理员权限打开 PowerShell 或 CMD：
powershell
npm install -g @openai/codex@latest
codex --version第二步：创建配置目录
powershell
mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codex第三步：写 config.toml 配置文件
在 %USERPROFILE%\.codex\ 目录下新建 config.toml，内容：
toml
model_provider = "Capybara"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
approval_policy = "on-request"
sandbox_mode = "danger-full-access"
model_supports_reasoning_summaries = true
[model_providers.Capybara]
name = "capybara"
base_url = "https://ai.bututrip.fun/v1"
wire_api = "responses"
requires_openai_auth = true第四步：写 auth.json 认证文件
在同一目录下新建 auth.json：
json
{
"OPENAI_API_KEY": "把你在卡皮巴拉创建的 Codex 密钥粘贴在这里"
}第五步：启动
powershell
mkdir my-codex-project
cd my-codex-project
codex🍏 macOS
第一步：安装 Codex
bash
npm install -g @openai/codex@latest
codex --version第二步：创建配置目录
bash
mkdir -p ~/.codex
cd ~/.codex第三步：一行命令写入 config.toml
bash
cat > config.toml << 'EOF'
model_provider = "Capybara"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
approval_policy = "on-request"
sandbox_mode = "danger-full-access"
model_supports_reasoning_summaries = true
[model_providers.Capybara]
name = "capybara"
base_url = "https://ai.bututrip.fun/v1"
wire_api = "responses"
requires_openai_auth = true
EOF第四步：写入 auth.json
bash
cat > auth.json << 'EOF'
{
"OPENAI_API_KEY": "把你在卡皮巴拉创建的 Codex 密钥粘贴在这里"
}
EOF第五步：启动
bash
mkdir my-codex-project
cd my-codex-project
codex🐧 Linux
第一步：安装 Codex
bash
sudo npm install -g @openai/codex@latest
codex --version第二步：创建配置目录
bash
mkdir -p ~/.codex
cd ~/.codex第三步：写入 config.toml
bash
cat > config.toml << 'EOF'
model_provider = "Capybara"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
approval_policy = "on-request"
sandbox_mode = "danger-full-access"
model_supports_reasoning_summaries = true
[model_providers.Capybara]
name = "capybara"
base_url = "https://ai.bututrip.fun/v1"
wire_api = "responses"
requires_openai_auth = true
EOF第四步：写入 auth.json
bash
cat > auth.json << 'EOF'
{
"OPENAI_API_KEY": "把你在卡皮巴拉创建的 Codex 密钥粘贴在这里"
}
EOF第五步：启动
bash
mkdir my-codex-project
cd my-codex-project
codex常见问题
Codex 和 Claude Code 的密钥不通用？
对，是分开的。这是因为它们底层调用的是不同的模型服务：
- Claude Code 用的是 Claude 系列密钥
- Codex 用的是 OpenAI / GPT 系列密钥（独立的 codex 令牌组）
所以你需要在卡皮巴拉管理页面为 Codex 单独创建一个密钥。
配置文件放在哪？
- Windows:
%USERPROFILE%\.codex\ - macOS / Linux:
~/.codex/
里面有两个文件：config.toml（模型配置）和 auth.json（密钥）。
改完配置 Codex 没反应？
- 必须完全退出 Codex 进程，重新执行
codex才会读新配置 - 检查
config.toml里的base_url是不是https://ai.bututrip.fun/v1（末尾要有/v1） - 检查
auth.json里的密钥是不是 Codex 类型，不要用了 Claude Code 的密钥
报错连接不上？
参考 常见问题排查。