CodeBuddy的API密钥配置怎么检查才能解决无法执行问题

遇到 CodeBuddy 命令执行失败、AI 功能没反应，或者直接弹出一个“Unauthorized (401)”的时候，第一反应别慌——八成是 API 密钥的配置出了问题。这里的关键是：密钥不是随便在 UI 框里填上就完事的，它必须按照环境变量 > CLI flag > config.yaml 这个优先级层级正确落位，格式、协议、权限一个都不能少。

检查配置是否生效

打开终端，先用下面这条命令探探底：

codebuddy config list

看看输出里有没有

或者对应的 provider（比如 openai、anthropic）的密钥字段。如果压根没有这个字段，说明密钥没有被任何配置层加载；要是显示成 undefined 或者空字符串，那就是配置值没写对。

这里有个坑要注意：这条命令只会读取 CLI 配置层（config.yaml 或 CLI flag），

。也就是说，即便终端里看不到，也不代表环境变量没生效。

验证环境变量是否被识别

方法一：直接打印关键变量

在终端里跑一下：echo $CODEBUDDY_OPENAI_API_KEY（如果是其他 provider，换成 CODEBUDDY_ANTHROPIC_API_KEY 之类的）。

如果返回空，或者报错 command not found，那就说明变量没设置，或者拼写错了。

方法二：启动时强制注入并盯紧日志

执行：CODEBUDDY_OPENAI_API_KEY=sk-xxx codebuddy --debug（把 sk-xxx 换成真实密钥）。

看终端输出里有没有 INFO: Loaded API key from environment variable。如果仍然报 ERROR: Unauthorized (401)，那问题就转到密钥本身上了——要么无效，要么权限不够。

确认密钥格式与权限状态

第一步：把密钥全文复制到文本编辑器里，用光标一个字一个字地检查首尾有没有隐藏的空格、换行或者中文标点。

第二步：登录对应服务商的控制台（比如 OpenAI Platform、Anthropic Console 或者 Coding Plan 管理页），确认这个密钥的状态是

，而且该勾选的权限都勾上了（例如 OpenAI 的 models、assistants；Coding Plan 的 code-completion 和 chat）。

第三步：如果用上了 Coding Plan 套餐，千万要确认密钥属于

。跨账号的密钥或者过期套餐下的密钥，系统会直接静默拒绝，连个提示都没有。

校验模型端点 URL 是否合法

① 跑一下命令：codebuddy config get model_endpoint

② 如果返回为空，说明没手动设置端点，这时候 CodeBuddy 会使用 provider 的默认地址（比如 OpenAI 是 https://api.openai.com/v1）。

③ 如果返回非空，一定要确认 URL 包含完整的协议（https:// 或 http://）、域名和路径，并且末尾

（比如 https://api.openai.com/v1/ 是错的，应该是 https://api.openai.com/v1）。

④ 如果是本地模型（比如 Ollama），要确保 CODEBUDDY_OLLAMA_BASE_URL 指向一个可以访问的服务地址（例如 http://localhost:11434/v1），然后直接在浏览器里手动访问一下这个地址，如果能返回 JSON 响应，才说明服务正常。