claude-config-doctor
v0.2.6
Published
Extra diagnostics and autofixes for common community-reported Claude Code configuration pitfalls.
Maintainers
Readme
Claude Config Doctor 🩺
An extra diagnostic tool designed specifically to find and fix common community-reported pitfalls in Claude Code configuration files. It acts as a specialized extension to the built-in Claude doctor.
🚀 Usage
Run the doctor instantly with npx in either your repo root or home directory:
# Check for common configuration issues
npx claude-config-doctor check
# Apply autofixes for known model-naming and API key conflicts
npx claude-config-doctor fix
# Initialize a fresh repo-level config template
npx claude-config-doctor init🔍 Targeted Diagnostics
The Doctor focuses on some specific frustration points:
- ✅ Schema Guard: Validates your configuration against official JSON standards.
- ✅ OpenRouter Bridge Verification: Ensures correct variable separation for OpenRouter integrations.
- ✅ Model Name Errors: Detects and strips accidental
:freesuffixes that cause "Model not found" errors.
🛠️ Pro Workflow
The tool automatically prioritizes ./.claude/settings.local.json but checks ~/.claude/settings.json too.
# Output raw results for scriptable diagnostics or CI/CD
npx claude-config-doctor check --json📜 License
MIT. For more information, please read our Contributing Guide.
