Codex API 兌換與設定完整教學

Codex API 兌換碼怎麼用：兌換、產生 Key、設定 config.toml，再接入 Codex CLI、Cursor 或 VS Code，附可用模型、配額查詢與錯誤處理。

本教學適用

適用於本站 Codex API 的 10M / 50M / 100M Token 規格，效期分別為 1 / 2 / 3 天，從兌換時開始計算。介面為 OpenAI 相容格式，可用於 Codex CLI、Cursor、VS Code 的 Cline 或 Roo Code 擴充功能、9router 和自寫程式。

開始前準備

在訂單詳情複製兌換碼。

確認已安裝 Node.js 18 以上：終端機執行 node -v 看得到版本號。Codex CLI 透過 npm 安裝。

第一步：兌換並啟用

打開 Token 和到期時間。

提示無效時，先檢查有沒有多複製空白、字母 O 和數字 0 是否看錯，再核對訂單；仍失敗請聯絡客服，不要重複送出。

第二步：產生 API Key

打開

App 下拉選單選你用的工具，例如 Codex CLI；模型下拉選一個可用模型，例如 gpt-5.6-sol。

點產生，複製 sk- 開頭的 Key 和頁面提供的設定文字。兩個都要保存，設定文字下一步會用到。

第三步：寫進 Codex CLI 設定

打開或新建設定檔：macOS / Linux 為 ~/.codex/config.toml，Windows 為 C:\Users\你的使用者名稱\.codex\config.toml。

貼上設定頁提供的文字。最小設定如下，env_key 的變數名稱可以自己改：

model = "gpt-5.6-sol"

model_provider = "custom"

[model_providers.custom]

name = "custom"

base_url = "

env_key = "CODEX_API_KEY"

wire_api = "responses"

把 Key 放進同名環境變數：

macOS / Linux：export CODEX_API_KEY="sk-你的Key"

Windows PowerShell：$env:CODEX_API_KEY="sk-你的Key"

要長期生效，寫進 ~/.zshrc / ~/.bashrc 或系統環境變數。

不想用環境變數，可把 env_key 那行換成 experimental_bearer_token = "sk-你的Key"。這樣 Key 會以明文寫在檔案裡，不要把檔案提交到儲存庫。

在專案目錄執行 codex，讓它列出目前目錄的檔案，能正常回傳就接通了。

錯誤對照：401 多半是 Key 不對或環境變數沒生效，重開一個終端機再試；404 檢查 base_url 是否帶了 /v1；model not found 表示模型名稱與規格不符，回設定頁重新複製。

第四步：接入 Cursor / VS Code / 9router

Cursor

設定 → Models，展開 OpenAI API Key。

填入 sk-...，開啟 Override OpenAI Base URL，填

手動新增模型名稱，例如 gpt-5.6-sol，選取後傳訊息測試。

VS Code + Cline / Roo Code

安裝擴充功能後打開設定，API Provider 選 OpenAI Compatible。

Base URL 填 Key 填 sk-...。

Model ID 填 gpt-5.6-sol 或其他可用模型，儲存後測試。

9router

Provider → Add OpenAI Compatible，填 Base URL 與 Key，點 Create。

Add API Key 顯示 Valid 後儲存，再點 Import Model 匯入模型。

第五步：查配額與到期時間

在 查看已用 Token、剩餘量和到期時間。到期後即使還有 Token 也會停止服務。

可用模型

gpt-6-astra

gpt-6-sol

gpt-5.6-luna

gpt-5.6-terra

gpt-5.6-sol

以設定頁下拉清單為準，清單外的名稱會出現 model not found。

常見問題

codex 啟動後仍要求登入 ChatGPT：設定沒被讀到。確認檔案在 ~/.codex/ 下，檔名就是 config.toml，不是 config.toml.txt；model_provider 的值要和 [model_providers.xxx] 的區段名稱一致。

改了設定沒生效：Codex CLI 只在啟動時讀設定，改完要退出重開。

401 / 403：Key 失效、環境變數沒載入，或複製時帶了引號。重新產生 Key 再試。

回覆中斷或逾時：上下文太大。拆小任務，或換較輕量的模型。

多台電腦能否共用一個 Key：可以，但共用同一份額度，建議每人一個 Key。

注意事項

Key 只放在本機環境變數或設定檔裡，不要提交到 Git，不要貼到公開管道。

兌換後請馬上照上面步驟驗證一次，避免快到期才發現設定有問題。

Token 用完或到期後請求會直接被拒。

仍不通，帶訂單編號、規格和錯誤截圖聯絡客服。