使用文档问题排查

Anthropic 连接失败排查教程

Claude Code 连接失败时,按 Base URL、auth token、环境变量和额度逐项排查。

Anthropic 连接失败

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

配置步骤

  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

    确认 API 使用额度和模型可用

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

常见问题

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

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

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

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