Codex 部署指南
下載適合電腦系統的 CC Switch，填入貴數智能 API 金鑰，再用 Codex CLI 確認能收到第一則回覆。
1. 下載並開啟 CC Switch
用 CC Switch 設定 API 連線，再用 Codex CLI 在終端機裡對話。先選擇適合這台電腦的 CC Switch 4.0.25 安裝檔。
- Windows x64 · 下載 MSI 大多數使用 Intel 或 AMD 處理器的電腦都選這個版本。按兩下下載的
.msi完成安裝，再從「開始」功能表開啟 CC Switch。 - Windows ARM64 · 下載 MSI 開啟「設定 → 系統 → 關於」，如果「系統類型」顯示 ARM 處理器，就選這個版本。
- macOS · 下載 DMG Intel 與 Apple 晶片的 Mac 共用此安裝檔。按兩下
.dmg，把 CC Switch 拖進「應用程式」資料夾，再從那裡開啟。 - Linux · 選擇安裝套件 展開 Assets，依
uname -m的輸出選擇架構（aarch64對應arm64）。Ubuntu、Debian 選.deb，Fedora 選.rpm。
已經下載了其他檔案？ v3.12.2-en.md 是版本說明。如果解壓縮後只看到 CC-SWITC.14，直接下載上方適合系統的安裝檔即可，不需要更改副檔名。其他版本可在官方發布頁查看。
2. 安裝 Codex CLI
在 Windows 開啟「命令提示字元」，在 macOS 或 Linux 開啟「終端機」。如果已安裝 Codex，請執行 codex --version，看到版本號碼即可跳到第 3 步。
首次安裝請先裝好 Node.js LTS，重新開啟終端機，依序執行以下兩行指令。第二行應會顯示 codex-cli 和版本號碼。
npm install -g @openai/codex@latest
codex --version3. 在 CC Switch 加入貴數智能
在左側選擇 Codex，開啟 直連（Direct） 分頁，按 新增供應商（Add Provider，+），在「全部（All）」中選 自訂設定（Custom Configuration）。
| 畫面欄位 | 填寫內容 |
|---|---|
| 供應商名稱 | 輸入「貴數智能」，方便稍後從清單中找到。 |
| API 請求網址 | 輸入 https://api.llm-token.cn/v1，保留結尾的 /v1。 |
| API Key | 貼上你從貴數智能取得的完整 API 金鑰。 |
| 預設模型 | 從模型清單複製這把金鑰可使用、且支援 Responses API 的模型 ID，例如 gpt-6.1-terra。 |
按頁面底部的 新增（Add）。回到「直連」清單，在「貴數智能」卡片上按 切換（Switch）。如果之前使用路由或聚合模式，按鈕會顯示「回到直連並使用」（Back to direct and use）。卡片顯示 使用中（In use） 後即可開啟 Codex。
4. 在終端機確認第一則回覆
先結束已開啟的 Codex，在終端機切換到你的專案資料夾，再執行 codex。如果還沒有專案，可以建立一個空資料夾：
mkdir my-codex-project
cd my-codex-project
codex在 Codex 輸入「只回覆 OK」。收到回覆就表示這次請求已完成。這項測試會使用該金鑰的額度。
沒有收到回覆？ 遇到 401 錯誤時，請重新貼上 API 金鑰並確認金鑰已啟用。如果顯示模型無法使用，請檢查預設模型 ID 和金鑰的存取權限。如果找不到端點，請確認網址以 /v1 結尾，並到進階選項確認「上游格式」（Upstream Format）設為 OpenAI Responses。
選用：手動編輯設定檔
如果透過 CC Switch 設定後已收到回覆，操作到這裡就完成了。要手動設定，可以在 Windows 的 %USERPROFILE%\.codex\，或 macOS、Linux 的 ~/.codex/ 中編輯以下兩個檔案。資料夾不存在時請先建立。若已有設定檔，請先備份，並保留其他設定。
config.toml 填入供應商、網址及這把金鑰可使用的模型。
model_provider = "gpt-agent"
model = "gpt-6.1-terra"
[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json 將範例值換成你的貴數智能 API 金鑰，儲存後依第 4 步重新開啟 Codex。
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}