使用文档问题排查

unable to connect to anthropic services 排查教程

Claude Code 提示 unable to connect to anthropic services 时，按 Base URL、auth token、环境变量和余额逐项定位。

Anthropic 连接失败

unable to connect to anthropic services 通常表示 Claude Code 还没有成功连到可用的模型服务。先确认 ANTHROPIC_BASE_URL 指向 CoderPlan endpoint，再确认 ANTHROPIC_AUTH_TOKEN 是完整的 CoderPlan API Key，最后检查余额、模型权限和当前终端是否读取了新环境变量。

配置步骤

  1. 1

    确认 ANTHROPIC_BASE_URL

    Claude Code 使用 CoderPlan 时，ANTHROPIC_BASE_URL 应指向 CoderPlan 基础 endpoint，不要混用默认 Anthropic 地址。

    ANTHROPIC_BASE_URL=https://api.coderplan.ai
  2. 2

    确认 ANTHROPIC_AUTH_TOKEN

    ANTHROPIC_AUTH_TOKEN 里填写 CoderPlan 控制台生成的完整 `sk-` API Key，不要填写浏览器登录 token。

    ANTHROPIC_AUTH_TOKEN=sk-your-api-key
  3. 3

    确认当前终端读取了新配置

    重开终端或 IDE 后再运行一次小任务，排除旧 shell、项目 `.env` 或全局配置覆盖。

  4. 4

    确认余额和模型可用

    如果 endpoint 和密钥都正确，再到 CoderPlan 控制台检查余额、API Key 状态和目标 Claude 模型可用状态。

常见问题

为什么设置了 CoderPlan 以后还提示连接 Anthropic 失败？

通常是当前 Claude Code 进程仍在读取旧配置，或者 ANTHROPIC_BASE_URL 没有被当前终端会话读取。先打印环境变量，再重启终端或 IDE。

这个错误一定是网络问题吗？

不一定。它也可能来自 Base URL、auth token、余额或模型权限。排查时先验证配置，再判断是否是本地网络或工具版本问题。