44 pages for settings.local.json.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Use Claude Code features in the SDK
Claude Code CLI · in the page
agent-sdk/claude-code-features
…ls, commands, and subagents | | `"local"` | CLAUDE.local.md, `.claude/settings.local.json` | `<cwd>/.claude/` for `settings.local.json`; `<cwd>` and every parent directory for CLAUDE.local.md | Omitt…
Migrate to Claude Agent SDK
Claude Code CLI · in the page
agent-sdk/migration-guide
…includes `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, CLAUDE.md files, and custom commands. To run isolated from filesystem settings, pass `settingSources: []`,…
Modifying system prompts
Claude Code CLI · in the page
agent-sdk/modifying-system-prompts
…Code v2.1.269 or later. * **Settings**: set `outputStyle` in `.claude/settings.local.json` * **TypeScript SDK**: set `outputStyle` inside the inline `settings` object passed to `query()`, or point `se…
Agent SDK reference - Python
Claude Code CLI · in the page
agent-sdk/python
…ettings, gitignored when Claude Code saves a setting to it | `.claude/settings.local.json` | #### Default behavior When `setting_sources` is omitted or `None` and `skills` is not set, `query()` load…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…Style` and merges it into the project's local settings file, `.claude/settings.local.json`. The new style takes effect on the session's next request. * **`"userSettings"`**: accepts `effortLevel` and…
Handle approvals and user input
Claude Code CLI · in the page
agent-sdk/user-input
…tion with the `localSettings` destination writes the rule to `.claude/settings.local.json` so future sessions skip the prompt for matching calls. In TypeScript, skip the always-allow choice for a…
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…`defaultMode` from the project's `.claude/settings.json` or `.claude/settings.local.json` that selects a more permissive mode than the session you came from was in. 2. The permission mode of the sess…
Share session output as artifacts
Claude Code CLI · in the page
artifacts
…eArtifact": false` in a project's `.claude/settings.json` or `.claude/settings.local.json` to turn artifacts off for sessions in that project. An `"enableArtifact": true` in either file doesn't turn t…
Configure auto mode
Claude Code CLI · in the page
auto-mode-config
…utoMode` from project settings in `.claude/settings.json` or `.claude/settings.local.json`. Both files live in the repo directory, so a checked-in repo or a build step could otherwise inject its own a…
Claude Code changelog
Claude Code CLI · in the page
changelog
…servers whose config entry omits the `type` field * Fixed `.claude/settings.local.json` allow rules being held back outside a git repository when git's trace2 output is configured * Fixed the `/c…
Explore the .claude directory
Claude Code CLI · in the page
claude-directory
…use git, commit most files here so your team shares them; a few, like settings.local.json, are gitignored when Claude Code saves settings to them. Each file badge shows which.', children: [{…
Run Claude Code behind a corporate launcher
Claude Code CLI · in the page
corporate-launcher
…`CLAUDE_CODE_PROCESS_WRAPPER` in `.claude/settings.json` or `.claude/settings.local.json` with a warning in the [debug log](/docs/en/troubleshooting), and never reads the `processWrapper` key from th…
Debug your configuration
Claude Code CLI · in the page
debug-your-config
…. | | A `settings.json` value seems ignored | The same key is set in `settings.local.json` | `settings.local.json` overrides `settings.json`, and both override `~/.claude/settings.json`. See [settings…
Environment variables
Claude Code CLI · in the page
env-vars
…| | `.claude/settings.local.json` | You, in this project only, gitignored when Claude Code saves a setting to it; add it to your gitignore if y…
Error reference
Claude Code CLI · in the page
errors
…mote-control) | | `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-th…
Glossary
Claude Code CLI · in the page
glossary
…managed-settings), command-line arguments, local settings at `.claude/settings.local.json`, project settings at `.claude/settings.json`, then user settings at `~/.claude/settings.json`. Arrays merge a…
Hooks reference
Claude Code CLI · in the page
hooks
…on` | Single project | Yes, can be committed to the repo | | `.claude/settings.local.json` | Single project | No, gitignored when Claude Code saves a setting to it | | Managed policy settings | Organi…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…on` | Single project | Yes, can be committed to the repo | | `.claude/settings.local.json` | Single project | No, gitignored when Claude Code saves a setting to it | | Managed policy settings | Organi…
Interactive mode
Claude Code CLI · in the page
interactive-mode
…ngs) only. Entries in a project's `.claude/settings.json` or `.claude/settings.local.json` are ignored, so a checked-out repository can't remap your keystrokes. ### Navigation (NORMAL mode) | Comman…
Set up Claude Code in a monorepo or large codebase
Claude Code CLI · in the page
large-codebases
…only want these exclusions for yourself, put the setting in `.claude/settings.local.json`. Claude Code adds that file to your global gitignore when it saves a setting there. Since you are creating it…
Connect Claude Code to an LLM gateway
Claude Code CLI · in the page
llm-gateway-connect
…Windows the path is `%USERPROFILE%\.claude\settings.json` * `.claude/settings.local.json` applies to one project. Claude Code adds it to your global gitignore when it saves a setting there; if you cr…
Connect Claude Code to tools via MCP
Claude Code CLI · in the page
mcp
…tings` Claude Code also applies approvals from an untracked `.claude/settings.local.json`, but it runs git to check whether the file is tracked, and it runs that check only in a [trusted folder](/doc…
How Claude remembers your project
Claude Code CLI · in the page
memory
…UDE.md and a rules directory from a parent folder. Add it to `.claude/settings.local.json` so the exclusion stays local to your machine: ```json theme={null} { "claudeMdExcludes": [ "**/monorep…
Monitoring
Claude Code CLI · in the page
monitoring-usage
…gnores-in-env) in a repository's `.claude/settings.json` and `.claude/settings.local.json`, so a repository can't use them to turn telemetry on, choose where it goes, or capture content. Set them in m…
Output styles
Claude Code CLI · in the page
output-styles
…ettings file. The command and both menus save your choice to `.claude/settings.local.json` at the [local project level](/docs/en/settings). * **`/output-style` command**: run `/output-style <style>`…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…-live) If you set `"auto"` in `.claude/settings.json` or `.claude/settings.local.json`, the value doesn't take effect, and Claude Code then uses the built-in default rather than a `defaultMode` fr…
Configure permissions
Claude Code CLI · in the page
permissions
…command or a WebFetch domain, Claude Code saves the rule to `.claude/settings.local.json` at the root of the git repository, resolved through [worktrees](/docs/en/worktrees) to the main checkout. The…
Create a Claude Code plugin
Claude Code CLI · in the page
plugins/create
…hooks"> If you have hooks in `.claude/settings.json` or `.claude/settings.local.json`, create a hooks directory: ```bash theme={null} mkdir -p my-plugin/hooks ``` Create `my-plu…
Host and maintain a marketplace
Claude Code CLI · in the page
plugins/host-marketplace
…ce.json` entry, or in a project's `.claude/settings.json` or `.claude/settings.local.json`, Claude Code removes from the environment every variable whose name looks like a credential, by the [same rul…
Install and manage plugins
Claude Code CLI · in the page
plugins/install
…s enabled for you in this repository only. The entry goes in `.claude/settings.local.json`. Some plugins are set by their author to start turned off, through the [`defaultEnabled`](/docs/en/plugins/m…
Plugin loading reference
Claude Code CLI · in the page
plugins/loading
…| :- | :- | :- | | `--add-dir` | `.claude/settings.json` or `.claude/settings.local.json` in a directory you pass with `--add-dir` | This session only. Only a `true` value has an effect, and every ot…
Troubleshoot plugins
Claude Code CLI · in the page
plugins/troubleshooting
…; a declaration in a repository's `.claude/settings.json` or `.claude/settings.local.json` doesn't count * For a source that differs from its settings declaration, re-add the marketplace from the decl…
Continue local sessions from any device with Remote Control
Claude Code CLI · in the page
remote-control
…alse` in project or local settings (`.claude/settings.json`, `.claude/settings.local.json`) turns auto-connect off even over a managed `true`. * **`default`**: clear your choice and follow your organi…
Configure the sandboxed Bash tool
Claude Code CLI · in the page
sandboxing
…el, Claude Code saves it to your project's local settings at `.claude/settings.local.json`, which apply to the current project. Claude Code adds that file to your global gitignore when it saves a sett…
Catch security issues as Claude writes code
Claude Code CLI · in the page
security-guidance
…`, uninstalling it from `/plugin` writes an override to your `.claude/settings.local.json` rather than editing the checked-in file, so the plugin stays off for you while teammates are unaffected. The…
Manage sessions
Claude Code CLI · in the page
sessions
…he session. The standard settings files, such as `settings.json` and `settings.local.json`, are re-read at launch, so configuration that lives in them doesn't need to be passed again. For `--system-pr…
Claude Code settings
Claude Code CLI · in the page
settings
…ed to git) | | **Local** | `.claude/settings.local.json` at the repository root | You, in this repository only…
All settings
Claude Code CLI · in the page
settings-reference
…ings.json`, `Project` is `.claude/settings.json`, `Local` is `.claude/settings.local.json`, and `Managed` is [what your organization deploys](/docs/en/managed-settings). `Any file` means all four, and…
Extend Claude with skills
Claude Code CLI · in the page
skills
…ill and press `Space` to cycle states, then `Esc` to save to `.claude/settings.local.json`. Each key is a skill name and each value is one of four states: | Value | Listed to Claude | In `/` menu |…
Create custom subagents
Claude Code CLI · in the page
sub-agents
…/docs/en/settings-reference#permissions-allow) in `settings.json` or `settings.local.json`, but these rules apply to the entire session, not only the plugin subagent. If you're the plugin's author,…
Tools reference
Claude Code CLI · in the page
tools-reference
…saves a `WebFetch(domain:...)` allow rule for that domain to `.claude/settings.local.json` for that repository. See [how saved approvals persist](/docs/en/permissions#permission-system). When your org…
Week 36 · August 31 – September 4, 2026
Claude Code CLI · in the page
whats-new/2026-w36
…e> in a project's <code>.claude/settings.json</code> or <code>.claude/settings.local.json</code>, it <a href="/docs/en/permission-modes#which-mode-a-session-starts-in">no longer takes effect</a> and t…
Run parallel sessions with worktrees
Claude Code CLI · in the page
worktrees
…in a worktree session saves the rule to the main checkout's `.claude/settings.local.json`, so it applies in the main checkout and in every other worktree of the repository, and it survives the worktr…
Configuration reference
Claude Documentation · in the page
third-party/claude-desktop/configuration
…ude Code's own settings: for a scheduled task, the project's `.claude/settings.local.json`, under `permissions.allow`. Any allow rule in Claude Code's settings, including one written by hand or by **A…