TokensClubCodex 接入教學
將 TokensClub 接到 Codex CLI、桌面端或官方 IDE 擴充。此頁適用於本機執行的客戶端；瀏覽器中的 ChatGPT／雲端任務不會套用你電腦的這份設定。
1. 準備 Key 與模型
先安裝官方 Codex 客戶端。登入 TokensClub，在 API 金鑰頁建立專用 Key，選擇可用的 GPT 分組，並確認帳戶餘額與 Key 權限。
| Base URL | https://tokensclub.top/v1 |
|---|---|
| API | OpenAI Responses |
| API Key | YOUR_TOKENSCLUB_API_KEY |
| Model | gpt-6.1-sol |
gpt-6.1-sol 是目前目錄中的設定範例；實際可用性以你的 Key 分組為準。Base URL 填到 /v1 為止，不填 /responses，亦不填登入頁。
2. 設定提供者
先備份既有設定，再將下列欄位合併到使用者層級的 config.toml。macOS／Linux 路徑為 ~/.codex/config.toml；Windows 為 %USERPROFILE%\.codex\config.toml。不要重複定義相同欄位或表格，也不要放到專案的 .codex/config.toml。
model = "gpt-6.1-sol"
model_provider = "tokensclub"
web_search = "disabled"
[model_providers.tokensclub]
name = "TokensClub"
base_url = "https://tokensclub.top/v1"
wire_api = "responses"
env_key = "TOKENSCLUB_API_KEY"首次接入先停用內建網路搜尋。基本 Responses 連線並不代表網路搜尋、所有工具或每個模型功能都已相容；按實際需求逐項驗證。保留原有的檔案及命令執行權限設定。
3. 設定密鑰並啟動
把範例中的 YOUR_TOKENSCLUB_API_KEY 換成你在本站建立的 Key，在自己電腦執行。不要把真實 Key 留在公開範例、截圖或程式碼倉庫。
macOS / Linux
export TOKENSCLUB_API_KEY="YOUR_TOKENSCLUB_API_KEY"
codexWindows PowerShell
$env:TOKENSCLUB_API_KEY = "YOUR_TOKENSCLUB_API_KEY"
codex4. 桌面端與 IDE
官方桌面端與 IDE 擴充使用同一份使用者設定；更改後重新啟動程式並建立新的本機任務。只在終端 export 密鑰，不保證由 Dock 或開始選單啟動的程式能讀到它。
優先將 TOKENSCLUB_API_KEY 提供給啟動客戶端的程序。若 GUI 無法取得環境變數，官方亦支援下列本機檔案方式：在同一個提供者表格內，以這行替換 env_key，不要兩種方式並存。這會將 Key 明文保存在本機，故只用使用者私有檔案，勿放進專案或共享配置。
experimental_bearer_token = "YOUR_TOKENSCLUB_API_KEY"5. 核對連線與用量
在 CLI 使用 /status 查看提供者及模型，確認提供者為 tokensclub。先發送一個只要求回覆 OK 的短請求，再到 TokensClub 使用日誌核對模型、分組及扣費。此步會產生實際用量；不應以模型清單載入成功代替調用驗證。
401：檢查密鑰及客戶端程序是否取得它。404：檢查模型與分組、重複 /v1 或誤加 /responses。429：檢查餘額、Key 額度與並發。模型不被客戶端識別時，先更新官方客戶端並核對模型 ID；不要隨意填寫未提供的模型目錄網址或上下文上限。