CodeBuddy

在腾讯云代码助手 CodeBuddy 中用 models.json 接入灵眸 API：填入完整的 /chat/completions 端点即可使用 Claude、GPT 与国产大模型。

CodeBuddy（腾讯云代码助手）是一款 AI 代码编辑器，支持通过 models.json 配置文件自定义模型列表。本页说明如何接入灵眸。

安装并登录

  1. 前往官网下载并安装适合你操作系统的版本：https://www.codebuddy.cn
  2. 按提示完成 CodeBuddy 账号登录

配置灵眸

第 1 步：确定配置文件位置

级别路径说明
用户级（推荐）~/.codebuddy/models.json全局配置，适用于所有项目
项目级<项目根目录>/.codebuddy/models.json项目专属，优先级高于用户级

文件不存在就新建。合并优先级从高到低：项目级 → 用户级 → 内置默认配置。

第 2 步：写入配置

以用户级 ~/.codebuddy/models.json 为例：

{
  "models": [
    {
      "id": "claude-opus-5",
      "name": "Claude Opus 5（灵眸）",
      "vendor": "LMU AI",
      "apiKey": "sk-你的灵眸API密钥",
      "url": "https://api.lmuai.com/v1/chat/completions",
      "maxInputTokens": 200000,
      "maxOutputTokens": 32000,
      "supportsToolCall": true,
      "supportsImages": true,
      "supportsReasoning": true
    },
    {
      "id": "gpt-5.6-sol",
      "name": "GPT-5.6 Sol（灵眸）",
      "vendor": "LMU AI",
      "apiKey": "sk-你的灵眸API密钥",
      "url": "https://api.lmuai.com/v1/chat/completions",
      "maxInputTokens": 400000,
      "maxOutputTokens": 32000,
      "supportsToolCall": true
    }
  ]
}

url 必须是完整路径，不是 Base URL

url 字段要填接口完整路径，以 /chat/completions 结尾：

  • ✅ 正确：https://api.lmuai.com/v1/chat/completions
  • ❌ 错误：https://api.lmuai.com/v1
  • ❌ 错误：https://api.lmuai.com

这是照抄简化示例最常见的失败原因——很多教程把它当成 Base URL 填，CodeBuddy 会请求不到接口。

CodeBuddy 只支持 OpenAI 接口格式

官方说明目前仅支持 OpenAI 接口格式的 API，所以接灵眸走 OpenAI 兼容协议。

想用 Claude 系列也没问题：把 claude-opus-5 这类模型 ID 直接填进去，灵眸后端会做 OpenAI ↔ Anthropic 协议转换。

第 3 步：选择模型开始对话

保存文件即可 —— models.json 支持热重载（1 秒防抖），不用重启 CodeBuddy。在对话框的模型选择器里选中刚配置的模型即可使用。

通过 models.json 添加的模型会自动带上 custom 标签，方便在 UI 里识别。

字段说明

models 数组里每一项的可用字段：

字段类型必填说明
idstring✓模型唯一标识符，填灵眸的模型 ID
namestring-下拉列表里显示的名称
vendorstring-供应商名称，自定义即可
apiKeystring-灵眸后台生成的 sk- 开头密钥（填实际密钥值，不是环境变量名）
urlstring-接口完整路径，灵眸填 https://api.lmuai.com/v1/chat/completions
maxInputTokensnumber-最大输入 token 数
maxOutputTokensnumber-最大输出 token 数
supportsToolCallboolean-是否支持工具调用
supportsImagesboolean-是否支持图片输入
supportsReasoningboolean-是否支持推理模式

只显示指定模型

用顶层的 availableModels 字段控制下拉列表里显示哪些模型：

{
  "models": [
    {
      "id": "claude-opus-5",
      "name": "Claude Opus 5（灵眸）",
      "apiKey": "sk-你的灵眸API密钥",
      "url": "https://api.lmuai.com/v1/chat/completions",
      "supportsToolCall": true
    }
  ],
  "availableModels": ["claude-opus-5"]
}
  • 不配置或配成空数组 → 显示所有模型
  • 配置后 → 只显示列出的模型 ID（可同时包含内置模型与自定义模型）
  • 项目级的 availableModels 会完全覆盖用户级，不做合并

删掉 availableModels 时注意逗号

官方提醒：删除 availableModels 字段后，要把上方 models 数组末尾多出来的 , 一起删掉，否则 JSON 不合法、整个配置都不生效。

常用模型 ID

模型 ID说明
claude-opus-5Claude Opus 5（旗舰，推荐）
claude-sonnet-5Claude Sonnet 5（平衡）
claude-haiku-4-5Claude Haiku 4.5（高速）
gpt-5.6-solGPT-5.6 Sol
glm-5.2智谱 GLM-5.2
qwen3.8-max-preview通义千问 3.8 Max Preview
deepseek-v4-proDeepSeek V4 Pro
kimi-k3Kimi K3

不知道填什么模型？前往 模型广场 查看全部可用模型 ID 并一键复制。

需要 1M 长上下文时，把模型 ID 写成带 [1M] 后缀的形式（如 claude-opus-5[1M]）并把 maxInputTokens 调大即可。

常见问题

配置没生效？

  1. 检查 JSON 格式是否合法（缺逗号、尾逗号是最常见原因）
  2. 确认文件路径正确（~/.codebuddy/models.json）
  3. 确认必填的 id 字段都有
  4. 确认文件确实保存到磁盘了（热重载有 1 秒防抖延迟）

模型不在下拉列表里？

  • 如果配了 availableModels，检查模型 ID 是否列在其中
  • 检查 models 数组里的配置是否完整

报 401 / 404？

  • 401：apiKey 是不是灵眸后台生成的 sk- 开头密钥
  • 404：url 十有八九漏了 /chat/completions，必须是完整路径

注意事项

  • url 必须是接口完整路径 https://api.lmuai.com/v1/chat/completions，不能只填到 /v1 或域名
  • CodeBuddy 只支持 OpenAI 接口格式，Claude 系列模型走灵眸的协议转换即可
  • apiKey 填实际密钥值，不支持填环境变量名
  • 配置支持热重载，保存即生效，无需重启
  • 每个模型条目都要各自写一份 apiKey 和 url
  • 项目级配置会按 id 覆盖用户级；availableModels 则是整字段覆盖、不合并

最后更新：

本页目录

安装并登录配置灵眸第 1 步：确定配置文件位置第 2 步：写入配置第 3 步：选择模型开始对话字段说明只显示指定模型常用模型 ID常见问题配置没生效？模型不在下拉列表里？报 401 / 404？注意事项