AI精品店

Appearance

问题解决（排障） ​

本页汇总 ccodezh 教程 + 常见踩坑，按“最常见 → 最容易修”的顺序整理。

1) 报错：Failed to connect to api.anthropic.com: ERR_BAD_REQUEST ​

这是 ccodezh 官方教程点名的高频问题，通常原因是：

  • 你明明在用中转，但 Claude Code 仍尝试直连 api.anthropic.com
  • 配置缺少 apiKeyHelper

解决：

  1. 打开 ~/.claude/settings.json
  2. 确认存在 apiKeyHelper
  3. 确认 ANTHROPIC_BASE_URL 是 https://api.ccodezh.com

参考写法（把密钥替换掉）：

json
{
  "apiKeyHelper": "echo 'sk-替换为你的 API Key'",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ccodezh.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的 API Key"
  }
}

2) 报错：Unable to connect to Anthropic services ​

优先检查：

  1. API Key 是否复制完整（是否多了空格/换行）
  2. ANTHROPIC_BASE_URL 是否写错（是否漏了 https://）
  3. 是否编辑错了文件位置（Windows 的 ~ 要换成 %USERPROFILE%）
  4. 修改配置后是否重启了终端/VSCode

3) 找不到 ~/.claude 目录 / 配置文件不生效 ​

Claude Code 往往在首次运行后才会创建配置目录。先执行一次：

bash
claude

然后再去 ~/.claude/ 里创建/编辑 settings.json、config.json。

4) npm install -g 提示 permission denied / 权限不足 ​

常见解法：

  • Windows：用管理员运行 PowerShell 再执行安装命令
  • macOS / Linux：建议使用 nvm 安装 Node.js，避免系统级权限问题
  • 或者把 npm 全局目录改到用户目录（适合不想折腾 nvm 的人）

5) Windows 执行脚本被拦截（PowerShell ExecutionPolicy） ​

如果你使用控制台“一键配置脚本”时遇到执行策略限制，可以尝试（仅当前用户）：

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

执行策略属于系统安全设置，请确保脚本来源可信后再执行。

6) 首次启动卡在引导/反复提示未完成 onboarding（可选） ​

有些环境下（尤其是改过网络或配置后）可能出现引导状态异常。你可以尝试：

  1. 打开用户目录下的 ~/.claude.json（Windows 为 %USERPROFILE%\.claude.json）
  2. 在 JSON 顶层增加或修改：
json
{
  "hasCompletedOnboarding": true
}

如果你不熟悉 JSON，建议用 VSCode 打开该文件修改，避免漏逗号导致格式错误。

7) VSCode 插件不生效 ​

按这个顺序排查最省时间：

  1. 先确保 CLI 可用：claude 能正常对话
  2. 再检查 ~/.claude/settings.json 是否包含 apiKeyHelper
  3. 最后重启 VSCode