Link to JSON Schema for settings.json in the official docs

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

EDIT: see below. The schema exists at https://json.schemastore.org/claude-code-settings.json, but it is not documented in the official docs.

Claude Code's settings.json configuration file lacks an official JSON Schema definition, which means:

• No IDE autocomplete for available settings
• No inline validation of configuration values
• No documentation tooltips in editors
• Users must reference web docs to discover available options

This makes configuration more error-prone and less discoverable, especially with the extensive set of options for permissions, hooks, sandbox, MCP servers, and plugins.

Proposed Solution

EDIT: document the schema in the official docs.

Publish an official JSON Schema file that users can reference via $schema in their settings files:

{
  "$schema": "https://claude.ai/schemas/settings.schema.json",
  "permissions": { ... }
}

The schema should include:

• All documented settings properties
• Type definitions and constraints
• Description fields for inline documentation
• Enum values where applicable (e.g., forceLoginMethod, outputStyle)
• Pattern validation for permission rules

Alternative Solutions

Users can create their own schemas, but an official one would:

• Stay current with new Claude Code releases
• Be authoritative and comprehensive
• Support the modular settings pattern (basics, hooks, permissions)

Priority

Medium - Would be very helpful

Feature Category

Configuration and settings