使用文档问题排查

failed to connect to api.anthropic.com: err_bad_request 排查教程

错误里仍出现 api.anthropic.com 或 err_bad_request 时，检查旧 endpoint、字段路径、auth token 和项目级配置覆盖。

Anthropic err_bad_request

failed to connect to api.anthropic.com: err_bad_request 通常说明 Claude Code 仍在请求官方 Anthropic 地址，或把官方地址、CoderPlan API Key、错误路径混在了一起。先找出当前生效的 endpoint，再确认 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和项目配置没有互相覆盖。

配置步骤

  1. 1

    搜索旧 endpoint

    在 shell 配置、项目 `.env`、IDE 设置和 Claude Code 配置里查找 `api.anthropic.com`，确认没有旧地址覆盖新配置。

  2. 2

    重设 CoderPlan endpoint

    Claude Code 的 ANTHROPIC_BASE_URL 使用 CoderPlan 基础 endpoint，不要照搬 OpenAI Compatible `/v1` 地址。

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

    核对 auth token

    ANTHROPIC_AUTH_TOKEN 使用 CoderPlan `sk-` API Key。官方 Anthropic Key、OpenAI Key 和浏览器 token 都不应该混用。

  4. 4

    用小请求重新验证

    先让 Claude Code 解释一个短函数，确认 endpoint 和认证成功后，再恢复长上下文项目任务。

常见问题

为什么错误里还有 api.anthropic.com？

这说明当前请求路径没有完全切到 CoderPlan，常见原因是项目级配置、全局环境变量或 IDE 启动环境仍在使用旧 endpoint。

err_bad_request 是 API Key 错了吗？

可能是，但不只这一种原因。endpoint 路径错误、Base URL 混用 `/v1`、模型名不匹配或旧配置覆盖都可能触发 bad request。