Command Code BYOK 设置

Command Code 的 BYOK 目前标记为 Beta。它的自定义 Provider 向导会依次询问 ID、wire、API root、Key 和模型，不是一个通用的三字段表单。

按官方五步 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 wire，也就是 openai-completions。只有使用 Anthropic Messages 时才选 anthropic-messages。
5. Point at the endpoint：填 API root https://us-api.tokenhub.com/v1。即使误粘贴了 /chat/completions，Command Code 会尝试裁剪为 root，但这里应直接填正确根地址。
6. Add the key：粘贴 TokenHub API Key。向导把它保存到 ~/.commandcode/auth.json；不要把 Key 写进仓库。
7. Declare the models：向导先请求 /models。若没有发现结果，直接输入 TokenHub 的准确 Model ID。

非输入步骤按 h 可查看精简帮助，按 esc 返回上一步。完成后会进入 /model，新 Provider 与 Command Code 自带模型会同时存在。

需要手动修改时只编辑 providers.json

Provider 配置全部位于 ~/.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": {}
      }
    }
  }
}

若 Key 已由 /connect 保存，可不在 Provider 文件里重复声明环境变量。模型级还可声明 contextWindow、maxOutput、reasoningEfforts 与 options，但只应填写 TokenHub 已验证的能力。

用 Provider 卡片维护连接

再次运行 /connect 并选择 tokenhub，Provider 卡片会显示 endpoint、模型数和 Key 状态：

• r：替换或保存 Key。
• u：重新获取模型；不会改动 wire、headers 或 Key 引用。
• c：清除已保存 Key。
• d：删除 Provider 及其本地凭证。

健康的 Provider 会显示绿色勾和模型数。若 providers.json 无效，Command Code 会跳过错误条目而不覆盖文件，并在 /connect 或 --list-models 显示具体路径。

从 /model 验证路由

运行 /model，在 TokenHub 分组选择模型并发送一个只读仓库问题。随后在 TokenHub 日志核对 Model ID 和 /v1/chat/completions。401 时回到 Provider 卡片按 r 更新 Key；404 时检查 baseURL 和 api；模型未出现时按 u 或在 providers.json 手动声明。

官方资料

• Command Code：BYOK Providers