帮助
Claude Code 报错排查
按报错信息找原因。每一节先说是什么，再说怎么办。先确认请求走的是哪里：在 Claude Code 里运行 /status，Base URL 应当是 https://corecode.live；不是的话，先按 Claude Code 接入 改好配置。
Unable to connect to Anthropic services
首次启动时，引导流程会去连 Anthropic 官方服务，国内网络常常连不上，于是报 Unable to connect to Anthropic services 或 Failed to connect to api.anthropic.com。这一步和中转无关，跳过引导即可：
- 用编辑器打开
~/.claude.json（Windows 是%USERPROFILE%\.claude.json）。 - 在最外层加上
"hasCompletedOnboarding": true，保存。 - 重新运行
claude。
之后仍有零星的官方请求（自动更新、遥测、错误上报）连不上，可以在 ~/.claude/settings.json 的 env 里加 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" 关掉它们，见 推荐配置。
Invalid API key · Please run /login
Claude Code 没有读到中转的密钥，回退到了官方登录。常见原因：
- 环境变量只在另一个终端里设置过。写进
~/.claude/settings.json的env最稳，所有终端和 VS Code 插件都会读到。 - 变量名写错。中转的密钥用
ANTHROPIC_AUTH_TOKEN，地址用ANTHROPIC_BASE_URL。 - 改完配置没有重开 Claude Code。配置只在启动时读取。
不要按提示运行 /login 登录 claude.ai 账号，那会让 Claude Code 改用官方账号。
Auth conflict: Both a token and an API key are set
同时设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY，Claude Code 不确定该用哪个。删掉 ANTHROPIC_API_KEY，只留 ANTHROPIC_AUTH_TOKEN。用 echo $ANTHROPIC_API_KEY（PowerShell 是 $env:ANTHROPIC_API_KEY）确认它在当前终端里也已清空；之前登录过 claude.ai 的，再运行一次 /logout。
401 authentication_error
中转收到了请求，但不认这个密钥：复制时少了字符、密钥已被删除，或者填的是别家的密钥。到控制台 API 密钥 页重新复制一份，确认以 sk- 开头、前后没有空格。
403
| 报错内容 | 原因 | 怎么办 |
|---|---|---|
| 额度不足 | 余额用完。 | 到 钱包 充值，立即恢复，不用改配置。 |
| 仅接受来自 Claude Code 的请求 | 「仅限CC」分组的密钥只放行 Claude Code CLI，SDK、curl 和其他客户端会被拒绝。 | 在 Claude Code 里使用；其他客户端改用「可外接」分组的密钥。 |
| Request not allowed | 请求直接发到了 Anthropic 官方，被地区限制拒绝，说明没有走中转。 | 用 /status 检查 Base URL，见 上面。 |
| 该对话包含被上游模型以违反使用政策为由拒绝的消息 | Anthropic 的安全分类器拒绝过这个对话里的一条消息。同一段对话再发还会被拒，CoreCode 直接拦下，不再转给上游。分类器有时也会拒绝正常的请求，包括 Claude Code auto 模式单独发出的检查请求。 | 开一个新对话，或改掉被拒的那条消息再发。经常遇到时，检查有没有设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS，见 auto 模式的开销。 |
429 rate_limit_error
单个密钥的请求速率或并发超过了上限。Claude Code 会自动退避重试，偶尔出现可以不管。持续出现时，减少同时运行的 Claude Code 会话和子代理；需要更高并发请 联系我们。
529 overloaded_error
Anthropic 官方暂时过载，和你的配置无关，Claude Code 会自动重试。持续几分钟以上时先看 服务状态，也可以临时用 /model 换一个模型。
500、502、503、504
503，内容是Service deployment in progress; retry shortly.：CoreCode 正在发版，响应头带Retry-After: 5，几秒后重试即可，已经在进行的请求不受影响。- 其他
5xx：上游或网关出错。先看 服务状态；状态正常但反复出现时，把使用日志里出错请求的时间发给我们。
400 invalid_request_error
| 报错内容 | 怎么办 |
|---|---|
prompt is too long | 上下文超过了模型上限。运行 /compact 压缩历史，或者用 /clear 开新会话。 |
| 模型不存在 | 用 模型价格 页列出的模型名，不要带厂商前缀。 |
长时间没有输出、请求超时
开启深度思考时，模型可能几分钟不出字，这是正常的。CoreCode 网关的读超时是 10 分钟。Claude Code 自己的超时由 API_TIMEOUT_MS 控制，单位毫秒；调得比 10 分钟短，长思考会被客户端提前断开。
开着代理或 VPN
corecode.live 在国内可以直连。全局代理会让请求绕一圈，变慢，偶尔还会断流。在代理软件的规则里把 corecode.live 设为直连（DIRECT）。支付页面打不开或一直加载时，也先关掉代理再试。
还是不行
先看 服务状态。状态正常的话，把三样东西发给我们：claude --version 的输出、报错原文，以及使用日志里出错请求的时间。也可以到 微信交流群 里问。其他问题见 常见问题。