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 生成，請仔細甄別