程式工具
Codex CLI
將 OpenAI Codex CLI 配置為使用 TokenLab API
交給我的 Agent 設定
把這段任務交給電腦上已經可用的 Agent：
閱讀此教學，協助我將 Codex CLI 連接至 TokenLab：
https://tokenlab.sh/docs/zh-TW/integrations/codex-cli
先檢查已安裝版本與目前生效的設定。
保留既有帳戶、供應商、權限及其他設定。
備份本機檔案並展示預計修改的內容。
讓我在本機輸入所需的 API 金鑰；不要在聊天中索取、顯示或貼上金鑰。
先確認設定能正常載入。
執行任何付費請求測試前，請另行說明費用。概覽
Codex CLI 透過 /v1/responses 連線至 TokenLab。所選模型的 tokenlab.accepted_request_formats 必須包含 openai_responses，功能可能因模型而異。
Codex CLI 遠端壓縮支援 POST /v1/responses/compact。Codex 在 /compact 和自動壓縮時會把目前工作階段的 model 放在 body.model 中，因此請確保要用於壓縮的模型在 Responses 路徑上可用；不要設定 /v1/compact。
系統需求
macOS、Linux 或 Windows 請依官方 CLI 指南安裝。原生 Windows 與 WSL 為不同環境，參閱 Windows 指南。下方 npm 是一種安裝方式，並非原生二進位檔的前置需求。
安裝
npm install -g @openai/codex@0.149.0驗證安裝：
codex --version設定
第 1 步：設定 API Key
依快速開始的 macOS、Linux、WSL 或 Windows PowerShell 步驟設定 TOKENLAB_API_KEY，避免把金鑰寫入命令歷史，再從同一終端機啟動 Codex。長期使用請透過本地秘密管理工具提供金鑰，不要把明文金鑰附加至 shell 設定檔。
第 2 步：設定 tokenlab.config.toml
在 Codex 0.149.0 使用中的 CODEX_HOME（通常為 ~/.codex）新增獨立的 tokenlab.config.toml。只在名稱未被使用時建立；修改既有 TokenLab profile 前先備份。使用 codex --profile tokenlab 明確載入，保留預設 config.toml、auth.json、帳戶及權限規則。不要使用舊式 [profiles.tokenlab] 表。正常啟動時不加此 profile 即可回到原設定。請參閱官方 profile 設定。
model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000此 WebSocket 模式是面向 Codex 用戶端的 Responses-over-WebSocket 橋接層。它只接受官方 response.create 事件；stream 為隱含行為，此 transport 不提供 background 或 response.cancel。它不是 OpenAI Realtime API，也不接受 session.update、conversation.item.*、input_audio_buffer.*、二進位音訊或巢狀 Realtime response.create.response 信封。
若所選設定檔不存在，請建立該檔案。修改後，使用下方對應命令啟動新的工作階段。
目前 Codex 使用 wire_api = "responses"，勿設定 chat/completions。此供應商的 requires_openai_auth 應省略或為 false，以使用 env_key。
Responses 請求不會轉換為 Chat Completions。選用與未來欄位的支援取決於所選模型。
基本用法
啟動互動模式:
codex --profile tokenlab直接指令:
codex --profile tokenlab "Fix the bug in main.py line 42"指定模型:
codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"選擇模型
選擇目前 tokenlab.accepted_request_formats 包含 openai_responses 的模型。請用自己的程式設計工作比較候選模型，並在模型頁查看目前價格。
互動指令
| 指令 | 說明 |
|---|---|
/help | 顯示說明 |
/exit 或 Ctrl+C | 退出 |
/clear | 清除對話 |
/status | 檢視目前模型、權限與 token 用量 |
/model <name> | 切換模型 |
驗證設定
只檢查環境變數是否已設定，不輸出其值。這項檢查無法判斷金鑰是否有效：
if [ -n "${TOKENLAB_API_KEY:-}" ]; then
printf '%s\n' 'TOKENLAB_API_KEY is set'
else
printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi啟動 Codex 後執行 /status，核對目前模型與權限。如果使用 profile，請啟動相同的 profile。請參閱官方狀態命令說明。
準備好發出真實請求後，再執行下列命令；它會使用 TokenLab 餘額。核對回覆與請求記錄中的對應記錄。環境檢查通過或用戶端成功啟動，都不等於請求已成功。
codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."常見用例
程式碼審查:
git diff | codex --profile tokenlab "Review these code changes"產生 commit 訊息:
git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"修復錯誤:
codex --profile tokenlab "Fix the TypeScript errors in src/components/"解釋程式碼:
cat main.py | codex --profile tokenlab "Explain what this code does"