CodeBuddy 接入指南：IDE 模型文件与完整接口路径

确认腾讯 CodeBuddy 的客户端

本篇指腾讯 CodeBuddy 官方文档中的 IDE 模型配置，不是同名扩展的通用教程。先记录产品来源、版本和个人或组织账号，再打开该版本的模型说明。官方 IDE 页支持 models.json 自定义模型，并明确该入口使用 OpenAI 接口格式与完整请求路径。

CodeBuddy Code 的命令行配置页不能自动代表 IDE 的能力。尤其是 Key 的环境变量解析，CLI 文档已有说明，IDE 表格却写明实际密钥值；在当前客户端没有核对前，不应混用。

选择正确配置作用域

用户级文件为 ~/.codebuddy/models.json，项目级文件位于工作区的 .codebuddy/models.json。同 ID 的项目定义会覆盖用户定义，项目的 availableModels 也会完整替换用户列表。 团队共享前先检查项目里有没有已有规则，避免把同事模型隐藏。

以下为原创最小示例。地址、Key 与模型都是占位，并无真实接口，也不代表本站已经提供 API：

{
  "models": [{
    "id": "YOUR_MODEL_ID",
    "name": "项目模型",
    "vendor": "OpenAI",
    "url": "https://80321.cn/v1/chat/completions",
    "apiKey": "YOUR_API_KEY"
  }],
  "availableModels": ["YOUR_MODEL_ID"]
}

这里的 vendor 是配置标签，不构成厂商合作声明。url 不能只写到 /v1；官方要求完整接口路径。

显示模型不等于能力通过

文件保存并被加载后，再在模型选择列表确认所选 ID。先完成一段无敏感信息的文本问答，然后核对工具调用。supportsToolCall、图片和推理开关只描述客户端如何使用模型，不能凭勾选创造服务端能力。

输入输出限制应按实际模型规格设置。初次不要同时开启图片、长上下文和复杂 Agent 工具；逐项记录验证结果，才能区分协议问题和能力不足。

按覆盖关系排错

模型不显示时，检查 availableModels 是否包含该 ID，以及项目列表是否遮盖了全局列表。修改无效时先核对 JSON 语法、文件是否保存和日志中的实际加载位置；官方配置支持文件变更检测。

请求失败时再检查最终 URL、模型权限和凭证来源。IDE 的变量名不能直接当作 Key。CLI 环境变量缺失时可能保留原占位字符串并导致调用失败，这也不能反推 IDE 具有同一解析逻辑。

把凭证与共享配置分开管理

公开示例可以共享，真实密钥不能进入项目仓库、截图或错误报告。若当前版本确实要求文件保存，限制文件读取权限，并按组织批准的凭证流程处理；没有核验安全存储机制前，不宣称 Key 已进入系统钥匙串。

切换自定义端点意味着代码、提示和工具结果可能交给新的接收方。先审核数据政策，再在隔离工作区测试编辑和命令权限，不能把聊天接通当作整个 Agent 安全验收。