主题
报错与踩坑汇总
记录使用 Claude Code 过程中遇到的常见问题，部分条目附有详细的根因分析与修复步骤。带「详情」标记的条目可点击进入完整档案。
Claude Code
EE-01请求返回 400，与内容无关CC 附加了实验性 Beta 请求头，中转服务不支持详情EE-02401 无效令牌（sk 开头令牌）IDE 插件或 MCP 服务器覆盖了 settings.json 中的 apiKey / baseURL详情EE-03API Error (Connection error.)本地到服务器链路不通，代理节点失效或网络路由异常详情EE-04API Error (Request timed out.)网络延迟过高，或上下文 token 过多处理超时详情EE-05WebFetch 报错，目标网站可访问但联网功能失效CC 在抓取前向 claude.ai 发预检请求，国内网络拦截 claude.ai 导致预检失败详情EE-06429 Rate Limit Exceeded，重试无效额度耗尽（insufficient_quota，需充值）或短时间请求过于频繁详情EE-07Permission denied，文件读写被拒绝系统文件权限不足、CC Permission 设置为拒绝、或 .claudeignore 规则误匹配详情EE-08401 Invalid API Key format，Key 目视正确仍报错从 PDF / 网页 / 截图复制 Key 时混入零宽空格、换行符等不可见字符详情EE-09加入 skipAutoPermissionPrompt 后 Plan 模式无法执行跳过自动权限提示相关流程后，Plan 模式执行阶段无法继续推进详情EE-10401 / Invalid API Key中转 API 的 ANTHROPIC_BASE_URL 未正确配置，请求打到官方端点详情EE-11context window 超限，对话被截断单次会话积累 token 过多，未及时 /compact 或新开会话详情EE-12403 / Missing API Key配置冲突或 Claude Code 配置文件被意外修改，推荐用 CC Switch 重新写入详情EE-13API Error 400（非内容原因）CC 本身 bug 导致请求体格式异常，重发或 /compact 后通常恢复详情EE-14Overloaded / 500官方服务过载或故障，查 status.anthropic.com 确认状态详情EE-15Command timed out after 2m 0.0sCC 等待 shell 命令返回超时，与 API 请求无关，可手动执行对应命令详情EE-16API Error: response exceeded the 32000单次回复超出默认输出 token 上限，设置 CLAUDE_CODE_MAX_OUTPUT_TOKENS=128000 解决详情EE-17登录过官网后 API Key 失效OAuth 登录令牌写入 ~/.claude.json，优先级高于中转配置详情EE-18413 请求体过大 / 400 Invalid model name会话上下文 token 过多，或模型名拼写 / 映射错误详情EE-19接入第三方模型时 400 unknown variant system第三方端点不接受 messages 中的 system role，需由转换层处理详情EE-20首次启动即报 Unable to connect to Anthropic services首启引导流程强制访问官方端点，被网络环境拦截详情EE-21重复创建缓存导致单场重复收费备用负载切号后二次转发携带原请求头，请求被误路由重复建缓存详情