Error reference
Look up Claude Code runtime error messages with what each one means and how to fix it.
This page lists runtime errors Claude Code displays and how to recover from each one, plus what to check when responses seem off without an error. For installation errors such as command not found or TLS failures during setup, see Troubleshoot installation and login.
Except for Wrapper and IDE errors, which the launching program prints rather than Claude Code itself, these errors and recovery commands apply across the CLI, the Desktop app, and Claude Code on the web, since all three wrap the same Claude Code CLI. For other surface-specific issues, see the troubleshooting section on that surface's page.
Claude Code calls the Claude API for model responses, so most runtime errors map to an underlying API error code. This page covers what each error means inside Claude Code and how to recover. For the raw HTTP status code definitions, see the Claude Platform error reference.
本篇目录
- Find your error
- Automatic retries
- Server errors
- Usage limits
- Authentication errors
- Network and connection errors
- Request errors
- Installation errors
- Command-line errors
- Plugin errors
- Tool errors
- Background session errors
- Wrapper and IDE errors
- Rewind warnings and errors
- Session saving warnings
- Configuration warnings
- Responses seem lower quality than usual
- Report an error