Skip to content

Codex 接入 ​

让 Codex CLI 和 Codex 桌面端通过 爱鹿 Plan 调用模型。有两种方式,推荐用 CCSwitch。

需要 OpenAI 分组

Codex 使用 OpenAI Responses 协议,Key 要绑定支持它的分组。点击 使用密钥 能看到 Codex CLI 标签就说明分组没问题,见 模型与分组怎么选。

  1. 安装 Codex
  2. 创建 Key
  3. 一键导入
  4. 重启并测试

安装 Codex ​

CodexOpenAI 官方页面,桌面端和 VS Code 插件都在这里下载
下载
CCSwitch选择 .msi 安装包,用来一键导入配置
下载

只用命令行版的话,装好 Node.js 后在 PowerShell 运行:

powershell

powershell
npm install -g @openai/codex
CodexOpenAI 官方页面,桌面端和 VS Code 插件都在这里下载
下载
CCSwitch选择 .dmg 安装包,用来一键导入配置
下载

只用命令行版的话,装好 Node.js 后在终端运行:

bash

bash
npm install -g @openai/codex

方式一:CCSwitch 一键导入(推荐) ​

按 CCSwitch 接入 完成「导入 → 启用到 使用中 → 刷新用量」,然后:

  1. 完全关闭已经打开的 Codex 终端、Codex 桌面端或 VS Code 窗口。
  2. 重新打开 Codex,发一句测试:

text

text
用一句话回复:Codex 连接成功。
  1. 到 使用记录 确认出现这次调用。

方式二:手动写入配置文件 ​

不用 CCSwitch 时,把站内生成的配置写进 Codex 的配置目录。

1. 复制站内生成的配置 ​

打开 API 密钥,在目标 Key 上点击 使用密钥,选择 Codex CLI 标签,再选你的系统。认证模式保持默认的 兼容模式。

弹窗会生成两个文件,直接复制弹窗里的内容。下面是结构示意,模型名等细节以弹窗为准:

config.tomlauth.json

toml

toml
model_provider = "OpenAI"
model = "以弹窗生成为准"
review_model = "以弹窗生成为准"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://www.dcbot.online/v1"
wire_api = "responses"
requires_openai_auth = true

json

json
{
  "OPENAI_API_KEY": "sk-你的密钥"
}

以弹窗内容为准

弹窗里的 config.toml 还带有模型目录等配置项,比上面的示意更完整。请复制弹窗原文,不要照抄示意。

2. 保存到 Codex 配置目录 ​

按 Win + R,输入下面的路径回车;目录不存在就手动新建一个 .codex 文件夹:

text

text
%USERPROFILE%\.codex

在 Finder 按 ⌘ + ⇧ + G 输入 ~/.codex,或在终端运行:

bash

bash
mkdir -p ~/.codex && open ~/.codex

bash

bash
mkdir -p ~/.codex && xdg-open ~/.codex

把两个文件分别保存为 config.toml 和 auth.json。如果 config.toml 已经存在,把弹窗内容放在文件开头。打不开目录、看不到隐藏文件或保存成了 .txt,见 找到配置文件。

模型目录 ​

弹窗的 Codex CLI 标签下有一个 Codex 模型目录 区域,决定 Codex 从哪里读取可选模型列表。目录来源有两种:

目录来源适用你要做什么
远程目录(默认)Codex 0.156.0 及以上什么都不用做。config.toml 里会多一行 model_catalog_url,Codex 自己联网刷新
本地文件旧版 Codex,或模型目录太大(超过 1 MiB 时会自动切到这个模式)下载 codex-models.json,放进配置目录

选 本地文件 时:

  1. 点击 获取目录,提示「已获取 N 个模型」后按钮变成 下载目录。
  2. 点击 下载目录,浏览器会下载 codex-models.json。
  3. 把它放进上一步的 .codex 目录,和 config.toml 放在一起。
  4. 复制弹窗里的 config.toml。它会多一行 model_catalog_json = "~/.codex/codex-models.json",Windows 上也是这样写,不用改。

不确定自己的版本

在终端运行 codex --version。低于 0.156.0、或者模型列表一直是空的,就改用 本地文件。模型更新后重新下载一次目录覆盖旧文件即可。

3. 重启 Codex 并验证 ​

完全退出 Codex 再重新打开,发一句测试消息,然后到 使用记录 确认有新记录。

为什么一定要重启

Codex 只在启动时读取一次 config.toml。改完配置不重启,会继续用旧配置。

VS Code 里的 Codex 插件 ​

插件和 CLI 共用同一份 ~/.codex/config.toml。按上面任意一种方式配好后,在 VS Code 里执行 重新加载窗口(Ctrl/Cmd + Shift + P → Reload Window)即可。

VS Code Codex 插件配置示意

确认真的走了 爱鹿 Plan ​

以站内 使用记录 为准:

  • 有记录:请求已经走 爱鹿 Plan。
  • 没记录:Codex 还在用官方账号登录,或者用的是旧配置。退出官方登录、确认配置已保存,再完全重启 Codex。

常见现象 ​

现象优先检查
能回复,但使用记录里没有Codex 仍在用官方账号或其它供应商,见 排查
401 / invalid api keyauth.json 里的 Key 是否完整、有没有多余空格
model not found模型名是否来自弹窗;Key 分组是否支持该模型
改了配置不生效是否完全退出并重启了 Codex

更多报错见 常见报错排查。想在 Codex 里直接生成图片,见 Codex 生图 Skill。