WorkBuddy/CodeBuddy 是 AI Agent 与编程助手工具。它支持通过本地模型配置文件添加自定义模型，可以使用 OpenAI 兼容的 Chat Completions API 接入 DeepSeek V4。 1. 安装 WorkBuddy/CodeBuddy ​ 安装并登录 WorkBuddy/CodeBuddy。 至少打开一次项目目录，让应用创建本地配置目录。 前往 DeepSeek 开放平台 获取 API Key。 如果只想让配置对某个项目生效，也可以创建项目级配置文件： 先将 DeepSeek API Key 设置为环境变量： 请将 models.json 保存为 UTF-8 无 BOM。部分桌面版本在读取带 UTF-8 BOM 文件头的 JSON 时，可能会读取本地模型配置失败。

完全退出 WorkBuddy/CodeBuddy 后重新打开。 4. 可选：验证 API Key ​ Windows 用户可以在 PowerShell 中验证 API Key： 如果请求成功，说明 API Key 和模型名都可用。 Authentication Fails 或 401 ：检查 apiKey 是否为真实 DeepSeek API Key。不要把接口 URL 填到 API Key 字段。 未找到模型 或 404 ：检查模型 id 是否严格写成 deepseek-flash 。 读取本地模型配置失败 ：检查 models.json 是否是合法 JSON，并保存为 UTF-8 无 BOM。 模型选择器中不显示：完全重启 WorkBuddy/CodeBuddy，并确认文件放在 .codebuddy\models.json 。 UI 中直接显示 ${DEEPSEEK_API_KEY} ：请从已设置 DEEPSEEK_API_KEY 的终端中重启 WorkBuddy/CodeBuddy。如果桌面端仍不展开环境变量，可以在 UI 或本地 models.json 中填入真实 API Key。