企业官网建设流程全解析

CodeBuddy 支持通过自定义模型的方式接入阿里云百炼大模型。

由于阿里云百炼平台主要提供兼容OpenAI 标准接口的服务，你可以利用 CodeBuddy 的models.json配置文件，将百炼上的模型（如qwen-coder-turbo或qwen-plus）添加为第三方模型。

以下是详细的操作步骤：

第一步：获取阿里云百炼 API Key

1. 登录 阿里云百炼控制台。
2. 在左侧菜单找到“API-KEY管理”。
3. 点击“创建新的API-KEY”，并复制保存该密钥（通常以sk-开头）。

第二步：找到 CodeBuddy 配置文件

CodeBuddy 的自定义模型配置通常位于models.json文件中。你需要根据你的操作系统找到该文件的位置：

• Windows:%USERPROFILE%\.codebuddy\models.json
• macOS / Linux:~/.codebuddy/models.json
• 我这里一开始不存在这个配置文件，手动新建了个models.json文件

注意：如果该文件不存在，你可以手动创建一个名为models.json的文件。

第三步：编辑models.json配置

将以下内容复制到models.json文件中。请确保将<你的阿里云百炼API-Key>替换为你刚才获取的真实密钥。

1{ 2 "models": [ 3 { 4 "id": "qwen-coder-turbo", 5 "name": "Qwen-Coder-Turbo (Aliyun)", 6 "vendor": "Alibaba Cloud", 7 "apiKey": "<你的阿里云百炼API-Key>", 8 "url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions", 9 "maxInputTokens": 128000, 10 "maxOutputTokens": 4096, 11 "supportsToolCall": true, 12 "supportsImages": true 13 }, 14 { 15 "id": "qwen-plus", 16 "name": "Qwen-Plus (Aliyun)", 17 "vendor": "Alibaba Cloud", 18 "apiKey": "<你的阿里云百炼API-Key>", 19 "url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions", 20 "maxInputTokens": 128000, 21 "maxOutputTokens": 4096, 22 "supportsToolCall": true, 23 "supportsImages": false 24 } 25 ], 26 "availableModels": [ 27 "qwen-coder-turbo", 28 "qwen-plus" 29 ] 30}

配置关键点说明：

• url: 必须使用阿里云百炼的兼容模式地址https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions。
• id: 这里填写的 ID 必须是你想要调用的具体模型名称（例如qwen-coder-turbo是通义代码大模型，适合编程；qwen-plus是通用模型）。
• apiKey: 填入你的百炼 API Key。

第四步：重启与验证

1. 保存models.json文件。
2. 重启 CodeBuddy插件或 VS Code，确保配置生效。
3. 在 CodeBuddy 的模型选择下拉框中，你应该能看到刚才配置的"Qwen-Coder-Turbo (Aliyun)"或"Qwen-Plus (Aliyun)"。
4. 选择该模型，输入一句简单的指令（如“你好”或“写一个冒泡排序”），如果能正常回复，即表示接入成功。

常见问题排查

• 报错 401 / Invalid API Key: 检查apiKey是否复制完整，或者是否使用了错误的 Key（注意区分主账号和子账号权限）。
• 无响应 / 连接超时: 检查网络环境。虽然阿里云在国内访问速度很快，但部分网络代理软件可能会拦截本地请求，尝试关闭代理软件的“系统代理”模式后再试。
• 模型未找到: 确认id字段填写的名称与阿里云百炼控制台中显示的模型 ID 完全一致。