错误参考
一句话
查找 Claude Code 运行时错误信息，了解每个错误的含义和解决方法。
什么时候翻这页
- 遇到 Claude Code 运行时错误需要解决
- 响应质量下降但没有明显错误
- 需要了解特定错误代码的含义
- 需要报告错误给 Anthropic 团队
核心概念
- 错误分类：服务器错误、使用限制、认证错误、网络错误、请求错误
- 自动重试机制：Claude Code 会自动重试临时性错误（最多 10 次，使用指数退避）
- 错误恢复：每种错误都有特定的解决步骤和恢复命令
- 环境变量：可以通过环境变量调整重试行为和超时设置
- 错误来源：大多数运行时错误映射到底层 API 错误代码
怎么做
- 识别错误：在终端中查找错误消息
- 匹配错误：将错误消息与文档中的部分匹配
- 执行解决：按照文档中的解决步骤操作
- 调整配置：必要时调整环境变量或设置
- 报告错误：如果错误未列出或解决方法无效，使用
/feedback命令报告
命令 / 配置速查
| 命令/配置 | 描述 |
|---|---|
CLAUDE_CODE_MAX_RETRIES | 重试次数，默认为 10 |
API_TIMEOUT_MS | 请求超时时间（毫秒），默认为 600000 |
/login | 登录命令 |
/status | 查看当前凭据状态 |
/usage | 查看使用限制 |
/model | 选择模型 |
/compact | 压缩对话历史 |
/clear | 清除对话历史 |
/rewind | 回滚到检查点 |
/feedback | 报告错误 |
/doctor | 检查本地配置问题 |
初学者易错点
- 忽略自动重试机制，误以为错误是永久性的
- 混淆服务器错误（影响所有用户）和使用限制错误（仅影响个人账户）
- 未检查网络连接问题就尝试解决认证错误
- 忘记检查模型选择是否正确
- 未尝试使用
/rewind命令恢复对话状态
相关词条
authentication身份验证和登录问题model-config模型配置和选择network-config网络配置和代理设置troubleshoot-install安装和登录故障排除context-window上下文窗口管理agent-sdkAgent SDK 使用和错误处理