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

首要排查点是API密钥配置：需按环境变量＞CLI flag＞config.yaml优先级落位，检查格式、协议及权限；执行codebuddy config list和echo $CODEBUDDY_OPENAI_API_KEY验证加载状态，再核对密钥有效性、端点URL合法性（含协议、路径、无多余斜杠）。

CodeBuddy命令执行失败、AI功能无响应或提示“Unauthorized (401)”时，首要排查点就是API密钥是否配置正确——它不是写在某个UI框里就完事，而是必须按优先级层级落位到环境变量或配置文件中，且格式、协议、权限缺一不可。

检查配置是否生效

打开终端，执行以下命令：

codebuddy config list

观察输出中是否包含 【api_key】 或对应 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 管理页），确认该密钥处于 Enabled 状态，且已勾选所需权限范围（例如 OpenAI 的 models、assistants；Coding Plan 的 code-completion 和 chat）。

第三步：若使用 Coding Plan 套餐，务必确认密钥属于 【当前账号绑定的 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 响应才算通路正常。