Troubleshooting Guide

Common Issues

Installation Problems

Issue	Solution
command not found	Add npm bin to PATH
Permission denied	Use sudo (macOS/Linux)
Old Node version	Upgrade to Node 18+

Authentication Issues

Issue	Solution
Auth fails	Check internet connection
Invalid API key	Verify ANTHROPIC_API_KEY
Token expired	Re-authenticate

Runtime Issues

Issue	Solution
Slow response	Check network speed
Out of memory	Use /compact
Tool fails	Check permissions

Diagnostic Commands

bash

# Check installation
claude --version

# Run diagnostics
> /doctor

# Check MCP servers
> /mcp

Debug Mode

Enable verbose logging:

bash

export CLAUDE_CODE_DEBUG=1
claude

Log Locations

Platform	Location
macOS/Linux	~/.claude/logs/
Windows	%USERPROFILE%.claude\logs\

Getting Help

Run /doctor for diagnostics
Check logs for errors
Verify configuration
Report issues on GitHub