跳到主要内容

Claude Code 常见问题

本页适用于 Claude Code CLI。桌面版的安装、启动和连接问题见 Claude 桌面版常见问题。

先按报错判断​

报错优先处理
仍在连接 api.anthropic.com配置没被读取 → 往下看「配置与连接」
API Error: 524换长连接地址 + 完全重启客户端
API Error: 400检查模型名称和令牌分组
403 且包含 bad response 808保留报错信息并联系客服
403 Forbidden检查令牌的「模型可用列表」
请求超时或无响应检查 Base URL、网络、客户端是否已重启

配置与连接​

仍在连接 Anthropic 官方服务​

出现下面一类提示：

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com

说明 Claude Code 没读到你的配置，依次检查：

  1. settings.json 是否在当前系统用户实际使用的配置目录
    • 未设置 CLAUDE_CONFIG_DIR 时：Windows 为 %userprofile%\.claude\settings.json，macOS / Linux 为 ~/.claude/settings.json
  2. 文件名确实为 settings.json，末尾没有多出 .txt
  3. JSON 中包含完整的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
  4. ANTHROPIC_BASE_URL 为 https://187api.com，末尾没有 /v1 或其他接口路径
  5. 修改后完全退出 Claude Code，并关闭原来的终端窗口，再开新终端启动

修改配置后没有变化​

Claude Code 启动后不会持续重新读取配置。改完 settings.json 要退出会话 → 关掉终端 → 重开终端。从编辑器启动的也要完全退出编辑器。

同时确认改的是当前用户实际使用的配置文件，而不是其他账号、旧备份或项目目录里的同名文件。

查看实际配置目录：

Windows（PowerShell）：

$claudeDir = if ($env:CLAUDE_CONFIG_DIR) { $env:CLAUDE_CONFIG_DIR } else { Join-Path $HOME '.claude' }
New-Item -ItemType Directory -Force $claudeDir | Out-Null
$claudeDir
notepad (Join-Path $claudeDir 'settings.json')

macOS / Linux：

CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
printf '当前 Claude Code 配置目录：%s\n' "$CLAUDE_DIR"
mkdir -p "$CLAUDE_DIR"
touch "$CLAUDE_DIR/settings.json"
nano "$CLAUDE_DIR/settings.json"   # macOS 可用 open -e
注意

如果系统设置了 CLAUDE_CONFIG_DIR，Claude Code 读的是该变量指向目录里的 settings.json，改默认目录不生效。

返回 524：请求超时​

API Error: 524

通常表示请求等待时间长、连接被中途断开。处理：

  1. 把 settings.json 的 ANTHROPIC_BASE_URL 改为长连接地址 https://187api.com
  2. 末尾不要加 /v1、/messages 或其他接口路径
  3. 只替换 ANTHROPIC_BASE_URL，API Key 和其他配置保持不变
  4. 保存后完全退出 Claude Code，关掉原终端，重开后再试

如果已经用了该地址仍出现 524，检查本地网络和代理是否稳定；只在特定模型或长任务中发生时，可稍后重试或换模型。

模型与权限​

返回 503：服务暂时不可用​

服务暂时不可用，请稍后重试
error.code: get_channel_failed

表示当前模型没有可用通道，属于服务端模型路由暂时不可用，不是 API Key 格式错误。稍后重试；持续出现则联系客服并提供请求时间和 request id。

返回 model_not_found​

表示当前令牌分组不支持 Claude Code 实际请求的模型：

  1. 在 模型广场 搜索报错对应的模型
  2. 查看该模型支持的分组，不要把 default 当通用分组
  3. 在 令牌管理 创建对应分组的令牌
  4. 如果配了模型映射，确认每个角色映射到的模型都属于当前令牌分组

返回 403：Forbidden​

通常是「模型可用列表」不包含当前模型。建议留空；必须限制时，填写与报错中完全一致的模型名。

返回 400​

优先检查模型名称和令牌分组。

排错​

现象优先检查
报连接官方域名配置没被读取
404Base URL 加了 /v1，去掉
401key 不完整，或环境变量没生效
一直重试网络/代理问题

相关：Claude Code 配置 · 卸载重装 · 常见问题总览