---
url: /validators/settings.md
description: >-
  Validate .claude/settings.json files for schema compliance, permission rule
  syntax, environment variable names, and file path references with claudelint.
---

# 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  rules. See the [Settings rules category](/rules/settings/settings-file-path-not-found) for the complete list.

## CLI Usage

```bash
claudelint validate-settings
claudelint validate-settings --verbose
```

## Plugin Skill

If you have the [claudelint plugin](/integrations/claude-code-plugin) installed, you can run this validator inside Claude Code with `/validate-settings` or by asking "Check my settings."

## See Also

* [Claude Code Settings](https://code.claude.com/docs/en/settings) - Official settings documentation
* [Configuration](/guide/configuration) - Customize rule severity