Claude Code Settings Validator

A CLI tool to validate settings.json and settings.local.json files for Claude Code configuration.

Setup

1. Create a virtual environment:

python -m venv .venv

2. Activate the virtual environment:

# On Linux/macOS
source .venv/bin/activate

# On Windows
.venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

Usage

# Validate a settings file
python claude-json-validator.py settings.json

# Validate with verbose output
python claude-json-validator.py .claude/settings.local.json --verbose

# Strict mode (warnings treated as errors)
python claude-json-validator.py ~/.claude/settings.json --strict

What it validates

• JSON syntax and structure
• Environment variable names
• Permission tool names
• Model names
• Configuration value ranges

Exit codes

• 0: Valid file (warnings allowed unless --strict)
• 1: Invalid file or errors found