首要排查点是API密钥配置：需按环境变量＞CLI flag＞config.yaml优先级落位，检查格式、协议及权限；执行codebuddy config list和echo $CODEBUDDY_OPENAI_API_KEY验证加载状态，再核对密钥有效性、端点URL合法性（含协议、路径、无多余斜杠）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
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 Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
执行：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 响应才算通路正常。
