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.

Rule	Severity	Description
settings-file-path-not-found	error	Referenced path does not exist
settings-invalid-permission	error	Invalid permission rule
settings-invalid-env-var	warn	Invalid environment variable
settings-permission-invalid-rule	error	Permission rule format invalid
settings-permission-empty-pattern	warn	Empty permission pattern

CLI Usage

claudelint validate-settings
claudelint validate-settings --verbose

See Also

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