程式工具
OpenCodex
透過 OpenCodex 並使用模型專屬的 API 路由將 Codex 連接到 TokenLab
讓我的 Agent 進行設定
將此任務複製到您電腦上正在執行的 Agent:
Read https://tokenlab.sh/docs/zh-TW/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.連接運作原理
OpenCodex 是 Codex 與模型 API 之間的本地代理。本指南使用 OpenCodex 2.73.0 與 Codex CLI 0.149.0。
TokenLab 預設的 Chat Completions 整合已於 2.72.0 版本發布並完成端到端驗證。2.73.0 版本 保留了該整合,並新增了模型專屬的 Responses 與 Anthropic Messages 路由。下方列出的路由已透過 TokenLab 進行串流文字與函式呼叫/結果往返的驗證。
Codex 會將 Responses 請求發送至 本地 OpenCodex 代理。隨後,OpenCodex 會將所選模型的請求發送至 TokenLab。本地連線上的 Responses 請求並不代表該模型是透過 TokenLab 的 Responses API 進行呼叫。
| Codex 中選擇的模型 | OpenCodex → TokenLab |
|---|---|
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3 | Responses: POST /v1/responses |
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1 | Anthropic Messages: POST /v1/messages |
gemini-3.8-flash | Chat Completions: POST /v1/chat/completions |
該預設的 Base URL 為 https://api.tokenlab.sh/v1。請保持不變:OpenCodex 會自行建構對應的 Messages 或 Responses URL。不在上述 Responses 預設值與 Claude 路由清單中的模型,將會使用該預設的 Chat 轉接器 (adapter)。
TokenLab 支援宣告該功能的 Gemini 原生 API,但 OpenCodex 2.73.0 的 TokenLab 預設設定是透過 Chat Completions 呼叫 Gemini。請勿將整個提供者 (provider) 變更為 Responses 或 Gemini;這會同時變更那些不接受該格式的模型請求。
安裝或更新
請使用 Node.js 18 或更高版本進行 npm 安裝:
npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --version同時必須安裝 Codex。OpenCodex 提供了 安裝說明 與 Codex 連接指南。原生 Windows 與 WSL 有不同的設定方式;請在相同的環境中執行設定與 Codex。
新增 TokenLab
在 TokenLab API Keys 中建立金鑰。若要進行終端機設定,請遵循 快速入門 來設定 TOKENLAB_API_KEY,且不要將其值放入指令記錄中。從該終端機啟動 OpenCodex;背景服務需要在其自身的啟動環境中取得該變數。
對於 全新的 OpenCodex 安裝,請執行 ocx init,選擇 TokenLab,並在本地輸入金鑰或使用字面環境參考 ${TOKENLAB_API_KEY}。在套用之前,請檢查精靈的 Codex 連接與自動啟動選項。
對於 現有的安裝,請在不取代其他提供者的情況下新增預設設定:
ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'單引號會儲存環境變數參考,而非金鑰的值。此指令同樣適用於 PowerShell。如果 tokenlab 已經存在,請在儀表板中編輯該提供者,而不是使用 --force 覆寫它。
您也可以在儀表板的 Add provider 清單中選擇 TokenLab 並在該處輸入金鑰。OpenCodex 會將其設定儲存在 $OPENCODEX_HOME/config.json,通常為 ~/.opencodex/config.json。
如果代理尚未執行,請啟動它,然後開啟其儀表板:
ocx start
ocx status
ocx gui在提供者頁面中,檢查 Base URL 與已發現的模型。該預設設定會執行 GET /v1/models?category=chat 並保留具有 tool-use 能力的模型。影像、影片、音訊、嵌入 (embeddings) 與決策模型將被排除。使用金鑰進行發現會反映該金鑰的模型權限與交付政策。
執行 ocx sync 以連接 Codex 並重新整理其模型目錄,然後啟動新的 Codex 工作階段。這會變更 Codex 的代理連線與目錄;在同步之前,請檢查現有的自訂提供者設定並保留備份。這不需要取代您的帳戶或權限政策。
選擇模型並驗證請求
在 Codex 的模型選擇器中選擇 tokenlab/<model-id> 項目,或在 CLI 啟動時選擇它:
codex -m "tokenlab/gpt-6.1-sol"OpenCodex 使用 tokenlab/ 來選擇提供者;發送至 TokenLab 的模型 ID 為 gpt-6.1-sol。請從 Models 選擇一個目前可用的確切 ID。
若要進行簡單的連線檢查,請發送:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.此請求會使用您的 TokenLab 餘額。請在 Requests 中檢查回覆及其對應的模型、時間與狀態。僅僅是提供者發現與成功啟動並不能驗證推論存取權。
串流與函式呼叫適用於表格中的路由。影像輸入與思考控制取決於所選模型:請檢查其功能,並僅使用 OpenCodex 為該模型提供的努力程度 (effort) 選項。影像輸入與思考請求已在 Responses 與 Messages 路由的代表性模型上進行過檢查;Gemini 影像輸入則是在其 Chat 路由上進行檢查。支援思考的模型不一定會公開思考文字或支援每個努力程度。
在 Chat Completions 上保留 Responses 模型
若要針對列出的其中一個 Responses 模型使用 Chat 路徑,請將 modelAdapters 項目合併到 OpenCodex 設定中 現有的 providers.tokenlab 物件內。此範例將 gpt-6-astra 保留在 Codex 的 Chat 上:
{
"modelAdapters": {
"gpt-6-astra": "openai-chat"
}
}這是一個提供者欄位範例,並非完整設定的替代品。請保留其他模型覆寫、憑證與提供者,然後重新啟動代理並開啟新的 Codex 工作階段。僅移除此模型項目即可恢復其 Responses 預設值。
Claude 的 Messages 路由與標準的 TokenLab 端點綁定。上述的 Chat 覆寫適用於 Responses 預設值;它不會將 Claude 切換至 Chat。對於 Chat 原生用戶端,列出的 Responses 模型已經在不使用此覆寫的情況下使用 Chat。請參閱 OpenCodex provider routing。
交付政策與其他 TokenLab 工具
該預設設定不會強制執行 X-TokenLab-Delivery-Policy 標頭。TokenLab 會使用您 API 金鑰的交付政策預設值。選擇 Chat、Responses 或 Messages 與選擇交付政策是分開的;請參閱 TokenLab provider settings。
TokenLab Skills 新增了整合說明。它們不會變更主要模型的提供者或 API 格式。
OpenCodex 2.73.0 中的 JEV Auto 使用 TypeSafe 的決策後端。 它不提供 TokenLab 作為該後端。透過 MCP 呼叫 TokenLab 的 System One API 是獨立的操作;請勿將 TokenLab 金鑰放入 TypeSafe 憑證欄位中。
在同一個 Agent 中產生影像與影片
Codex 也可以透過 TokenLab MCP server 建立影像與短影片。每次產生都會從相同的 TokenLab 餘額中扣除。OpenCodex 僅路由模型請求,而 Codex 本身會啟動 MCP 伺服器。在設定了 TOKENLAB_API_KEY 的終端機中將伺服器新增至 Codex:
codex mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48MCP 不會變更主要模型的提供者或 API 格式。執行 codex mcp list 並確認已列出 tokenlab。然後在新的 Codex 工作階段中嘗試:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video 會回傳一個任務 ID。Agent 會呼叫 get_task_status 直到影片準備就緒。
疑難排解與還原設定
- 選擇器中缺少 TokenLab: 檢查
ocx --version;本指南針對的是 2.73.0。使用ocx sync重新整理目錄並啟動新的 Codex 工作階段。 - 401 或缺少憑證: 檢查金鑰是否為啟用狀態,且執行 OpenCodex 的處理程序是否可存取該金鑰。不同終端機中的環境變數不會更新已在執行的服務。
- 缺少模型: 檢查確切的 ID、金鑰權限與目前的可用性。非 Chat 模型以及沒有
tool-use的 Chat 模型不包含在此預設設定中。 - 不支援的請求或錯誤的端點: 將所選模型與路由表進行比較,並檢查已儲存的轉接器覆寫。所需的格式為 模型詳細資訊 中的
tokenlab.accepted_request_formats;模型清單不能取代該詳細資訊欄位。Claude 與 Gemini 不得僅因為 Codex 在本地使用 Responses 而被發送至 Responses。 - 工具或影像輸入失敗: 保留原始錯誤與請求 ID。在變更設定前,請檢查模型的功能與作用中的 OpenCodex 路由;請勿移除對話記錄或工具結果來隱藏錯誤。
若要停止透過代理路由 Codex,請使用 ocx stop;OpenCodex 會停止代理並還原原生 Codex 連線。ocx restore 會還原原生連線,同時為其他用戶端保持代理執行。在變更其他用戶端共用的安裝之前,請參閱 OpenCodex CLI reference。