| name | validate-settings |
| description | Validates Claude Code settings.json files for schema, permissions, and security. Use when user asks to "check my settings", "validate settings.json", "permission errors", "environment variable issues", or "settings syntax errors". Validates model names, permission rules, hooks configuration, and environment variables. |
| version | 1.0.0 |
| argument-hint | [flags] |
| allowed-tools | ["Bash(claudelint:*)"] |
Validate Settings
Runs claudelint validate-settings to validate .claude/settings.json and .claude/settings.local.json files.
Usage
claudelint validate-settings $ARGUMENTS
Options
--path <path> - Custom path to settings.json--verbose - Show detailed output--warnings-as-errors - Treat warnings as errors
What Gets Validated
- JSON syntax
- Model validation (sonnet, opus, haiku)
- Permission rules (tool names, actions: allow/block)
- Hooks configuration
- Environment variables (naming, empty values, secrets detection)
Examples
claudelint validate-settings
claudelint validate-settings --path /path/to/settings.json
See Also
