Codex（CLI / VS Code 扩展） 接入教程

OpenAI 的编程助手，在 config.toml 里加一个自定义 provider 就能用

• 接口：OpenAI Responses
• 地址写法：写到 /v1（https://gpt.cherrychat.org/v1）
• 推荐模型：gpt-6.1-sol、gpt-5.5
• 平台：macOS、Windows、Linux、VS Code

接入步骤

1. 安装 Codex（装过可跳过）

   命令行版用下面的命令安装，装好后 codex --version 能看到版本号。VS Code 用户在扩展市场搜「Codex」，安装 OpenAI 官方的那个；扩展和命令行共用同一份配置。

   macOS / Linux

   curl -fsSL https://chatgpt.com/codex/install.sh | sh

   Windows（PowerShell）

   powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

   或者用 npm 安装

   npm install -g @openai/codex

2. 把 key 存进环境变量

   Codex 从环境变量 CHERRYCHAT_API_KEY 读 key，配置文件里不写 key。设完要关掉终端重新打开；VS Code 也要完全退出再打开才能读到。

   • CHERRYCHAT_API_KEY（API Key）：sk-你的密钥

   macOS / Linux（写入 ~/.zshrc）

   echo 'export CHERRYCHAT_API_KEY="sk-你的密钥"' >> ~/.zshrc
   source ~/.zshrc

   Windows（设完重开 PowerShell）

   setx CHERRYCHAT_API_KEY "sk-你的密钥"

3. 编辑 config.toml

   用下面的命令打开 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml），没有会自动新建，粘进下面的配置保存。前三行必须放在文件最上面、任何 [方括号] 段落之前；文件里原来就有 model = 或 model_provider = 的，删掉旧的那行，不能重复。

   • base_url（API 地址）：https://gpt.cherrychat.org/v1（写到 /v1 为止，Codex 自己补 /responses）
   • model（模型名）：gpt-6.1-sol

   打开文件（macOS）

   mkdir -p ~/.codex && touch ~/.codex/config.toml && open -e ~/.codex/config.toml

   打开文件（Windows）

   mkdir $HOME\.codex -Force; notepad $HOME\.codex\config.toml

   config.toml 内容

   model = "gpt-6.1-sol"
   model_provider = "cherrychat"
   web_search = "disabled"
   
   [model_providers.cherrychat]
   name = "CherryChat"
   base_url = "https://gpt.cherrychat.org/v1"
   env_key = "CHERRYCHAT_API_KEY"
   wire_api = "responses"
   requires_openai_auth = false

4. 验证是否接通

   新开一个终端运行下面的命令，能看到回复就成功了。codex exec 默认只在 Git 仓库里运行，命令里的 --skip-git-repo-check 让它在普通文件夹里也能测试。也可以运行 codex 进入交互界面，输入 /status 查看当前的模型和 provider（应显示 cherrychat）。

   codex exec --skip-git-repo-check "用一句话介绍你自己"

5. VS Code 扩展里使用

   扩展和命令行读的是同一份 config.toml：点 Codex 侧边栏的齿轮 →「Codex Settings」→「Open config.toml」可以确认内容。改完配置或环境变量后，完全退出 VS Code 再打开。

容易踩的坑

• base_url 写到 /v1（https://gpt.cherrychat.org/v1），Codex 会自己补 /responses；不要写成 https://gpt.cherrychat.org/v1/responses，也不要只写域名。
• wire_api 只能是 "responses"，老教程里的 "chat" 新版已经不支持。
• model、model_provider、web_search 三行必须在第一个 [model_providers…] 之前，写在下面会被当成那一段的内容而不生效。
• 只能写在用户目录的 ~/.codex/config.toml，项目里的 .codex/config.toml 会忽略 model_provider；provider 名不能用 openai、ollama、lmstudio（保留名）。
• web_search = "disabled" 不要删：Codex 默认会带内置联网搜索，樱桃茶 API 暂不支持这类内置工具。
• 环境变量设完要重开终端；Windows 用 setx 后，所有 PowerShell 和 VS Code 窗口都要关掉再开。

报错 → 原因 → 怎么办

教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。

API 接入 · API 模型价格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别