帮助
常见问题
按现象找原因。报错信息的逐条解释见 报错排查。没找到答案的，先看 服务状态，再按 反馈与联系 把使用日志里出错请求的时间发给我们。
接入与配置
首次启动报 Unable to connect to Anthropic services
首次启动的引导流程会去连 Anthropic 官方服务，国内网络常常连不上。用编辑器打开 ~/.claude.json（Windows 是 %USERPROFILE%\.claude.json），在最外层加上 "hasCompletedOnboarding": true，保存后重新运行 claude。
还在走官方账号
运行 /status 看 Base URL。不对的话检查配置文件路径、终端是否重开，或执行 /logout 退出 claude.ai 登录。
VS Code 插件没走 CoreCode
确认 env 写在 ~/.claude/settings.json，完全退出 VS Code 后重开；插件里登录过 claude.ai 账号的先退出登录。
模型不存在
用 模型价格 页列出的模型名，不要带厂商前缀。
长时间无输出
深度思考可能几分钟不出字，这是正常的；网关读超时为 10 分钟。
报错
401 密钥无效
密钥复制不完整或已删除。到「API 密钥」页重新复制；确认没有同时设置 ANTHROPIC_API_KEY。
403 额度不足
余额用完，到「钱包」充值。
403 仅接受来自 Claude Code 的请求
「Claude 满血（仅限CC）」分组的密钥只接受 Claude Code CLI 的请求，Anthropic SDK、curl 和其他客户端直接调用都会被拒绝。要在这些地方调用，另建一个「Claude 满血（可外接）」分组的密钥。
429
单个密钥的请求速率或并发超限，稍等重试；需要更高并发请 联系我们。
计费与缓存
缓存命中率低、花费比预期高
最常见的原因是开了 auto 模式，其次是会话中途切模型或停顿超过 5 分钟。排查方法见 缓存与计费。
使用日志里有很多「非流」请求
Claude Code 的主对话都是流式的，非流请求多半是 auto 模式在工具调用前发的检查。见 auto 模式的开销。
只用 Opus，账单里却有 Haiku 或 Sonnet
后台摘要、子代理和 auto 模式的分类器会用其他模型，见 账单里的其他模型。