80321 API咨询方案
菜单
文档导航
INTEGRATION GUIDE

Command Code BYOK 接入：自定义供应商与模型选择

接入文档

根据 Command Code 官方 BYOK 文档，配置自定义协议、模型和密钥引用，区分默认服务与外部供应商，并给出验证及安全边界。

内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。

查看教程占位服务地址
控制台
https://80321.cn
创建 Key
https://80321.cn/keys
钱包充值
https://80321.cn/wallet
文档站
https://80321.cn/docs.html

以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。

本页目录

Command Code 的默认模型服务与 BYOK 是两条接入路径。这里讨论把外部模型服务接入 CLI，不是从其他应用调用 Command Code 的 Provider API。官方将 BYOK 标为 Beta，因此配置流程应以正在使用的版本为准。

Command Code 外部供应商连接原创示意图，非运行截图

从连接菜单开始

在 CLI 输入 /connect，选择 (BYOK) Add your own provider。已知供应商可以预填信息；自定义服务则需要自己确定 ID、协议、API 根地址和模型。供应商 ID 是本地短名称，选择模型时还会成为模型前缀，不等于远端模型 ID。

下面是一组菜单填值示意。地址仅为占位，本站没有提供真实接口；密钥和模型也是占位，不能用于联通验证。

Provider ID: guide
Wire: OpenAI-compatible
API root: https://80321.cn/v1
API key: YOUR_API_KEY
Model ID: YOUR_MODEL_ID

三种协议不能混填

官方支持 Chat Completions、Responses 与 Anthropic Messages。应先让实际服务确认协议，再选菜单中的 wire。服务只实现聊天补全时，选择 Responses 并不会自动转换请求。连接菜单会尝试获取模型列表；获取不到时，可以手工填写服务确认的模型 ID。

密钥不写进模型清单

BYOK 定义保存在用户级 ~/.commandcode/providers.json，不能由项目仓库定义。apiKey 字段接受环境变量等引用，不接受直接粘贴的真实秘密；通过 /connect 保存的密钥位于 auth.json，并且优先于文件中的引用。

实际使用时，优先让连接菜单管理密钥，不把凭证提交到项目。若更换环境变量后仍使用旧密钥，先检查供应商卡片是否保存了另一份凭证，而不是反复修改模型条目。

在模型菜单验收路由

完成连接后打开 /model，在新供应商所属分组选择目标模型，再提一个不需要工具的短问题。检查模型分组、响应和用量记录，而不是仅凭菜单中的绿色标记判断成功。同名模型可以在多个供应商下并存，务必确认所属分组。

随后在临时工作区请求读取一个无敏感内容的说明文件，逐项审批工具操作。普通回答成功只说明基础推理链路可用，不能证明长上下文、流式工具调用或子任务都符合预期。

失败时保留可解释的边界

模型消失时检查配置语法、baseURL 和模型条目；官方会跳过无效条目并显示警告，不能将其当作模型下线。 官方还提供 cmd --local-only，用于阻断 Command Code 后端流量，但默认模型服务及部分后端工具会因此不可用。 是否启用应按团队的数据出境要求决定。遇到鉴权或权限错误就暂停评估，不通过关掉审批、复制陌生认证命令或改用其他账户绕过限制。