命令代碼 BYOK 設定

透過命令代碼 BYOK 連接 TokenHub,並在啟用編輯之前驗證相容的編碼模型。

什麼是命令代碼?

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

  1. 在Command Code中运行/connect
  2. 選擇**(BYOK) Add your own provider**。
  3. Name it 處,輸入小寫 ID tokenhub。這將成為 ~/.commandcode/providers.json 中的條目名稱,並且模型將路由為 tokenhub/<model-id>
  4. Pick the wire处,选择默认的OpenAI-compatible线openai-completions。仅当Anthropic Messages时才选择anthropic-messages
  5. Point at the endpoint處,輸入API根https://us-api.tokenhub.com/v1。 Command Code 可能会修剪不小心粘贴的 /chat/completions,但您应该直接输入正确的根。
  6. Add the key 处,粘贴您的 TokenHub API 密钥。精靈將其儲存到~/.commandcode/auth.json;不要將金鑰提交到儲存庫。
  7. 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 已儲存金鑰,請勿將其複製到提供者檔案中。模型也可以宣告 contextWindowmaxOutputreasoningEffortsoptions,但僅新增針對此 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,檢查 baseURLapi;如果沒有該型號,則按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。