算力猫
← 返回教程列表

接入软件

CodeBuddy

腾讯 CodeBuddy:在对话面板里配置自定义模型,或直接编辑 models.json。

约 7 分钟适合:用 CodeBuddy(IDE 插件 / 独立 IDE / CLI)写代码的开发者

开始之前

  • 已安装 CodeBuddy 并登录
  • 一把 Key,以及从模型广场复制的模型名

步骤 1 · STEP 0x01

在对话面板里配置自定义模型

对话面板 → 模型列表 → 配置自定义模型
1

Base URL

https://api.suanlimao.shop/v1
2

API Key

<你的 Key>
3

模型名称

<模型名>
4
保存
示意图,以软件当前版本界面为准

在对话面板上方的模型列表里找到「配置自定义模型」,填接入地址、Key 和模型名后保存。官方文档提示保存后可能需要重启 CodeBuddy 面板,模型才会出现在列表里。

CodeBuddy 官方明确「目前仅支持 OpenAI 接口格式」,所以只能走 Chat Completions,不能选 Anthropic 格式。

去创建 Key →

步骤 2 · STEP 0x02

或者直接编辑 models.json

字段填什么
id(必填)模型名:<模型名>
name列表里显示的名字,随意
vendor例如 Custom
urlhttps://api.suanlimao.shop/v1/chat/completions(见下方说明)
apiKeyKey 本身,不是环境变量名
maxInputTokens / maxOutputTokens按模型广场里该模型的参数
supportsToolCall / supportsImages / supportsReasoning按模型能力填 true / false
顶层 availableModels要在列表里显示的模型 id
  • 用户级文件在 ~/.codebuddy/models.json(Windows:C:\Users\<用户名>\.codebuddy\models.json);项目级在 <工作区>/.codebuddy/models.json,优先级项目 > 用户 > 内置。
  • 文件支持热更新,保存后约 1 秒生效;这样加进来的模型带 custom 标记。
  • 完整的 JSON 模板请从官方「models.json 配置指南」复制,这里只列字段含义。
关于 url:官方 models.json 指南写的是「必须是完整接口路径,一般以 /chat/completions 结尾」;而腾讯云另一份接入文档的示例只填了不带路径的地址。两种都试一下:先填 https://api.suanlimao.shop/v1/chat/completions,报 404 再改成 https://api.suanlimao.shop/v1。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 3 · STEP 0x03

选模型并测试

对话面板
1

模型列表

你添加的模型(带 custom 标记)
2

输入框

你好
示意图,以软件当前版本界面为准
  • 在模型列表里选刚添加的模型;CLI 里用 /model 切换。
  • 发一句话,正常回答就通了。

✓ 怎么确认成功了

  • 对话能用你添加的模型回答。
  • 控制台「用量」页出现这次请求。

常见问题

报 404?

官方排错表:404 是 Base URL 不对。按第 2 步的提示在带 / 不带 /chat/completions 之间切换一下。

报 401?

Key 无效:没复制全、已吊销,或者把环境变量名当成了 Key。

提示额度 / 模型相关错误?

官方排错表:多半是模型名写错或该模型没开通。重新从模型广场复制。

保存后列表里没有新模型?

重启 CodeBuddy 面板;用 models.json 时确认 id 在 availableModels 里。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。