Settings Validator

The Settings validator checks .claude/settings.json files for schema compliance, permission rules, and environment variable configuration.

What It Checks

• JSON schema validation
• Permission rule syntax and validity
• Environment variable names
• File path references
• Tool name validity

Rules

This validator includes 5 rules. See the Settings rules category for the complete list.

settings-file-path-not-found

Referenced path does not exist on disk

Error

settings-invalid-permission

Permission rule has invalid structure or syntax

Error

settings-invalid-env-var

Environment variable name is invalid

Warning

settings-permission-invalid-rule

Permission rule format does not match expected pattern

Error

CLI Usage

claudelint validate-settings
claudelint validate-settings --verbose

Plugin Skill

If you have the claudelint plugin installed, you can run this validator inside Claude Code with /validate-settings or by asking "Check my settings."

See Also

• Claude Code Settings - Official settings documentation
• Configuration - Customize rule severity