claude doctor: Diagnostic Tool for Claude Code

When encountering authentication issues, tool execution failures, or slow network connections, run claude doctor to analyze system health.

Running Diagnostics

claude doctor

What It Checks

1. Authentication Status: Verifies valid API keys or OAuth session tokens.
2. Node & Environment: Checks Node.js runtime version compatibility.
3. MCP Server Connectivity: Tests response times for all registered Model Context Protocol endpoints.
4. Git Repository State: Ensures permissions for reading/writing local workspace files.

Output Example

[✓] API Key status: Valid
[✓] Node.js version: v20.11.0 (Supported)
[✓] Git Repository: /var/www/html/magento
[!] MCP Server 'postgres': Connection timed out (Check DB host)