什麼是命令代碼?
Command Code 是一個命令列編碼代理,具有適用於 OpenAI 相容和 Anthropic-wire 模型提供者的 BYOK 流程。
本命令代碼 BYOK 指南遵循官方 /connect 工作流程。它使用 OpenAI 相容的 API 根,將憑證儲存在本地身份驗證儲存中,並在發現不可用時允許手動模型 ID。官方 BYOK 流程在本地儲存提供者憑證,並允許使用者使用 /model 選擇結果模型。谨慎选择 API 连接,在发现为空时输入完整的模型 ID,并在允许 Command Code 更改工作存储库之前验证代码读取和工具调用。
Command Code 目前将 BYOK 标记为 Beta。其自訂提供者精靈會依序要求 ID、線路協定、API 根、金鑰和模型;它不是通用的三字段形式。
使用官方 BYOK 向导添加 TokenHub
- 在Command Code中运行
/connect。 - 選擇**(BYOK) Add your own provider**。
- 在 Name it 處,輸入小寫 ID
tokenhub。這將成為~/.commandcode/providers.json中的條目名稱,並且模型將路由為tokenhub/<model-id>。 - 在Pick the wire处,选择默认的OpenAI-compatible线
openai-completions。仅当Anthropic Messages时才选择anthropic-messages。 - 在Point at the endpoint處,輸入API根
https://us-api.tokenhub.com/v1。 Command Code 可能会修剪不小心粘贴的/chat/completions,但您应该直接输入正确的根。 - 在 Add the key 处,粘贴您的 TokenHub API 密钥。精靈將其儲存到
~/.commandcode/auth.json;不要將金鑰提交到儲存庫。 - 在Declare the models,讓嚮導請求
/models。如果发现未返回任何内容,请手动输入准确的 TokenHub 型号 ID。
在非輸入畫面上,按 h 取得簡潔幫助,或按 esc 返回上一步。設定完成後,Command Code 將開啟 /model,其中新提供者與其內建模型一起出現。
當需要手動變更時,僅編輯providers.json
提供者定義位於 ~/.commandcode/providers.json 中。重新開啟 /connect 或 /model 以重新載入變更:
{
"provider": {
"tokenhub": {
"name": "TokenHub",
"baseURL": "__API_BASE_URL__/v1",
"api": "openai-completions",
"apiKey": "$TOKENHUB_API_KEY",
"models": {
"YOUR_TOKENHUB_MODEL_ID": {}
}
}
}
}如果 /connect 已儲存金鑰,請勿將其複製到提供者檔案中。模型也可以宣告 contextWindow、maxOutput、reasoningEfforts 和 options,但僅新增針對此 TokenHub 模型驗證的功能。
維持與其提供者卡的連接
再次運行/connect,選擇tokenhub。提供者卡顯示端點、模型計數和金鑰狀態:
r:更換或儲存金鑰。u:再次取得模型而不更改電線、接頭或關鍵參考。c:清除儲存的金鑰。d:刪除提供者及其本機憑證。
健康的提供者會顯示綠色複選標記和模型計數。如果 providers.json 無效,Command Code 會跳過錯誤條目而不覆蓋文件,並報告其在 /connect 或 --list-models 中的路徑。
驗證來自 /model 的路由
运行/model,在TokenHub组中选择一个模型,并询问只读存储库问题。确认TokenHub日志中的型号ID和/v1/chat/completions。對於 401,返回提供者卡並按 r;對於 404,檢查 baseURL 和 api;如果沒有該型號,則按u或在providers.json中聲明。
官方參考
如何選擇推薦模型?
命令代碼 BYOK 常見問題解答
TokenHub 該選擇哪一條線路?
使用以 /v1 結尾的 TokenHub API 根目錄時,請選擇 OpenAI 相容。
命令代碼在哪裡儲存 API 金鑰?
/connect 流程將提供程式金鑰儲存在命令代碼的本機驗證儲存中。避免將金鑰提交給providers.json。
如果模型清單為空怎麼辦?
在 BYOK 流程或providers.json 中手動輸入準確的 TokenHub 模型 ID,然後在 /model 中選擇它。
BYOK 設定後如何安全地測試命令代碼?
使用 /model 選擇 TokenHub 模型,並從唯讀儲存庫問題開始。在授予編輯或命令權限之前驗證請求日誌。
為什麼命令代碼到達錯誤的端點?
檢查 /connect 期間選擇的電線。除非您有意配置了 Anthropic Messages 端點,否則 TokenHub /v1 根屬於 OpenAI 相容線路。
參考資料
本頁設定依據 TokenHub 教學與官方資料,最後驗證日期為 2026-09-08。