.claude/settings.json

Claude Code

Definition

The Claude Code settings file that configures tool permissions, hook scripts, environment variables, and behavioral settings. Project-scoped (.claude/settings.json) checked into version control, or user-scoped (~/.claude/settings.json) for personal preferences. Hooks are defined here.

Example Usage

Define PreToolUse hooks in .claude/settings.json to enforce code quality gates before Claude writes any files.

Related Concepts

CLAUDE.md Configuration Hierarchy

Claude Code & Workflows

Project CLAUDE.md is loaded for every conversation; user-level has lowest priority

Related Terms

CLAUDE.md Hooks (Claude Code)

← Back to Glossary