行业资讯
CodeBuddy 自定义模型配置完整指南
文章目录一、背景说明二、配置方式文件位置配置文件格式字段说明三、常见踩坑与解决方案❌ 坑1文件放错目录❌ 坑2availableModels 字段导致内置模型消失❌ 坑3缺少 models 顶层字段❌ 坑4API Key 未正确配置❌ 坑5配置文件不生效/需要重启四、常用模型配置参考MiniMax M3智谱 GLM-5.1天翼云六、多模型完整配置示例七、API 获取渠道汇总八、总结核心要点一、背景说明CodeBuddy 支持用户添加自定义模型如 MiniMax M3、智谱 GLM、天翼云等方便在不同场景下灵活切换。本文档汇总了配置过程中遇到的所有问题及解决方案。下载 codebuddy工具国际版https://www.codebuddy.ai /ide国内版https://www.codebuddy.cn/ide/二、配置方式通过models.json文件配置适用于CodeBuddy IDE和CLI版本也适用于部分VS Code 插件版本经实测可行。文件位置配置级别路径说明全局配置~/.codebuddy/models.json也有可能是~/.codebuddycn/models.json对所有项目生效项目配置项目根目录/.codebuddy/models.json仅对当前项目生效注意~代表用户主目录Windows 下为C:\Users\你的用户名。在codebuddy文件夹下新建models.json文件配置文件格式{models:[{id:minimax-m3,name:MiniMax M3,vendor:MiniMax,url:https://api.minimax.chat/v1/text/chatcompletion_v2,apiKey:sk-xxxxxxxxxxxxxxxx,supportsToolCall:true,supportsImages:false,supportsReasoning:true}]}字段说明字段类型必填说明idString✅唯一标识符程序内部使用nameString✅显示名称在下拉菜单中展示vendorString✅模型提供商名称urlString✅API 请求完整地址apiKeyString✅API 密钥建议用环境变量supportsToolCallBoolean✅是否支持工具/函数调用supportsImagesBoolean✅是否支持图像输入多模态supportsReasoningBoolean✅是否支持推理/思维链能力CodeBuddy IDE重启即可VS Code 插件版本配置好后重启vscode打开codebuddy注多个版本位置不同但是大致基本都是一个范围自己寻找一下三、常见踩坑与解决方案❌ 坑1文件放错目录症状配置后模型列表里看不到自定义模型。解决方案确认文件放在了正确的路径用户级~/.codebuddy/models.json项目级项目根目录/.codebuddy/models.json❌ 坑2availableModels字段导致内置模型消失症状自定义模型没出现系统内置模型如 minimax-m2.5、glm-5 等也不见了。原因availableModels是白名单模式写了它系统就只显示列表里的模型。解决方案❌ 不要写这个字段或者✅ 写成空数组availableModels: []❌ 坑3缺少models顶层字段症状配置文件完全不被识别。原因最外层必须是{models: [...]}格式。错误写法{id:minimax-m3,name:MiniMax M3,...}正确写法{models:[{id:minimax-m3,name:MiniMax M3,...}]}❌ 坑4API Key 未正确配置解决方案使用环境变量更安全{apiKey:${MINIMAX_API_KEY}}然后在~/.bashrc或~/.zshrc中设置exportMINIMAX_API_KEYsk-xxxxxxxxxxxxxxxx❌ 坑5配置文件不生效/需要重启解决方案CodeBuddy 支持热重载修改后约 1 秒生效若未生效尝试重启 CodeBuddy 面板或整个编辑器四、常用模型配置参考MiniMax M3{id:minimax-m3,name:MiniMax M3,vendor:MiniMax,url:https://api.minimax.chat/v1/text/chatcompletion_v2,apiKey:sk-xxxxxxxxxxxxxxxx,supportsToolCall:true,supportsImages:false,supportsReasoning:true}智谱 GLM-5.1{id:glm-5.1,name:智谱 GLM-5.1,vendor:Zhipu,url:https://open.bigmodel.cn/api/paas/v4/chat/completions,apiKey:sk-yyyyyyyyyyyyyyyy,supportsToolCall:true,supportsImages:true,supportsReasoning:true}天翼云{id:ctyun-glm,name:天翼云 GLM,vendor:CTyun,url:https://wishub-x6.ctyun.cn/v1/chat/completions,apiKey:your-api-key-here,supportsToolCall:false,supportsImages:false,supportsReasoning:true}六、多模型完整配置示例{models:[{id:minimax-m3,name:MiniMax M3,vendor:MiniMax,url:https://api.minimax.chat/v1/text/chatcompletion_v2,apiKey:${MINIMAX_API_KEY},supportsToolCall:true,supportsImages:false,supportsReasoning:true},{id:glm-5.1,name:智谱 GLM-5.1,vendor:Zhipu,url:https://open.bigmodel.cn/api/paas/v4/chat/completions,apiKey:${ZHIPU_API_KEY},supportsToolCall:true,supportsImages:true,supportsReasoning:true},{id:gpt-4,name:GPT-4,vendor:OpenAI,url:https://api.openai.com/v1/chat/completions,apiKey:${OPENAI_API_KEY},supportsToolCall:true,supportsImages:true,supportsReasoning:true}]}七、API 获取渠道汇总模型官方地址MiniMaxhttps://api.minimax.chat智谱 GLMhttps://open.bigmodel.cnOpenAIhttps://platform.openai.com天翼云https://www.ctyun.cnAnthropic Claudehttps://console.anthropic.comDeepSeekhttps://platform.deepseek.com八、总结核心要点文件路径~/.codebuddy/models.json或项目下的.codebuddy/models.json文件格式{models: [...]}最外层必须有models数组不要写availableModels会隐藏内置模型API Key 用环境变量安全且方便您好我是肥晨。欢迎关注我获取前端/AI学习资源日常分享技术变革生存法则行业内幕洞察先机。
郑州网站建设
网页设计
企业官网
