接入软件
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 格式。
步骤 2 · STEP 0x02
或者直接编辑 models.json
| 字段 | 填什么 |
|---|---|
id(必填) | 模型名:<模型名> |
name | 列表里显示的名字,随意 |
vendor | 例如 Custom |
url | https://api.suanlimao.shop/v1/chat/completions(见下方说明) |
apiKey | Key 本身,不是环境变量名 |
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)。