模型配置
用 models.json 自定义模型列表(OpenAI 兼容接口)、用环境变量引用密钥、用 availableModels 控制下拉列表。
models.json 用来自定义模型列表并控制模型下拉列表的显示,有两级:用户级 ~/.codebuddy/models.json(全局)和项目级 <workspace>/.codebuddy/models.json(优先级更高)。合并优先级:项目级 > 用户级 > 内置默认;同一 id 的模型定义被高优先级覆盖。切换模型用 /model(list 列出可用模型)或 Option+P/Alt+P;/model:lite、/model:reasoning 分别设置轻量子任务和复杂分析场景用的模型。
接入自定义模型的约束:目前仅支持 OpenAI 接口格式的 API;url 字段必须是完整接口路径,一般以 /chat/completions 结尾,例如 https://api.openai.com/v1/chat/completions 或 http://localhost:11434/v1/chat/completions。避免密钥明文:apiKey 和 url 字段支持环境变量引用(在 ~/.zshrc 等里导出,或存到系统钥匙串后在 shell 配置里导出),CLI 启动时解析;变量不存在则保留原占位符,导致 API 调用失败。建议把 models.json 权限设为 600,且不要把含真实密钥的文件提交到版本控制。availableModels(字符串数组):未配置或为空时显示所有模型;配置后只显示列出的模型 ID。各字段的完整含义(LanguageModel 结构)见官方页面。