validate-settings

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

• validate-all - Run all validators