Problem Solving
Troubleshooting Guide
Common issues and their solutions. Search for error messages or browse by category.
Installation
linux
macos
npm install fails with permission denied
Installation
claude: command not found
Authentication
Invalid API key error
API
Rate limit exceeded / 429 errors
Usage
Context length exceeded
Usage
Claude can't find or read files
Installation
Node.js version issues
Git
Git identity not configured
Windows
windows
Path issues in WSL
Development
Port already in use
Development
TypeScript compilation errors
Development
Next.js hydration mismatch
API
CORS errors
Development
Environment variables not loading
Still stuck?
- Copy the exact error message into Claude Code and ask for help
- Check the Claude Code GitHub issues
- Search for the error message on Stack Overflow