50 pages for settings.json.

Set up Claude Code for your organization Claude Code CLI · in the page admin-setup …anaged | macOS: `/Library/Application Support/ClaudeCode/managed-settings.json`<br />Linux and WSL: `/etc/claude-code/managed-settings.json`<br />Windows: `C:\Program Files\ClaudeCode\managed-set… Use Claude Code features in the SDK Claude Code CLI · in the page agent-sdk/claude-code-features …------------------------------------------ | | `"project"` | Project `settings.json` and hooks; project CLAUDE.md and `.claude/rules/*.md`; project skills, commands, and subagents | `<cwd>/.claude/` f… Intercept and control agent behavior with hooks Claude Code CLI · in the page agent-sdk/hooks …docs/en/hooks#hook-events) defined in settings files such as `.claude/settings.json`. To load shell command hooks from your SDK application, include the appropriate setting source with [`setting_sourc… Migrate to Claude Agent SDK Claude Code CLI · in the page agent-sdk/migration-guide …local filesystem settings, matching the CLI. This includes `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, CLAUDE.md files, and custom commands. To run isolated fro… Modifying system prompts Claude Code CLI · in the page agent-sdk/modifying-system-prompts …m_prompt` and `setting_sources` * [Settings](/docs/en/settings): the `settings.json` reference, including where output styles and other configuration are stored Configure permissions Claude Code CLI · in the page agent-sdk/permissions …le="Deny rules"> Check `deny` rules (from `disallowed_tools` and [settings.json](/docs/en/settings-reference#permission-settings)). If a deny rule matches, the tool is blocked, even in `bypassPerm… Agent SDK reference - Python Claude Code CLI · in the page agent-sdk/python …ngs | `~/.claude/settings.json` | | `"project"` | Shared project settings (version controlled) | `.claude/settings… Persist sessions to external storage Claude Code CLI · in the page agent-sdk/session-storage …rectory, such as OAuth credentials or an `apiKeyHelper` in your user `settings.json`, copy those files into the temp directory first, or set `ANTHROPIC_API_KEY` in `env` instead. Otherwise the run fai… Subagents in the SDK Claude Code CLI · in the page agent-sdk/subagents …de keeps references to the permission configuration, such as `.claude/settings.json`, `bypassPermissions`, or `--dangerously-skip-permissions`, as written. * **Turn markers**: a line that starts wit… Agent SDK reference - TypeScript Claude Code CLI · in the page agent-sdk/typescript …ngs | `~/.claude/settings.json` | | `'project'` | Shared project settings (version controlled) | `.claude/settings… Orchestrate teams of Claude Code sessions Claude Code CLI · in the page agent-teams …ble them by setting `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in your [settings.json](/docs/en/settings) or environment. Without that variable, no team is set up at session start, no team directories a… Manage multiple agents with agent view Claude Code CLI · in the page agent-view …ving into a worktree first. Add the setting to the project's `.claude/settings.json`: ```json theme={null} { "worktree": { "bgIsolation": "none" } } ``` Outside a git repository, sessions wr… Claude Code on Amazon Bedrock Claude Code CLI · in the page amazon-bedrock …ts from your currently pinned models. The wizard writes to `~/.claude/settings.json`, or to `$CLAUDE_CONFIG_DIR/settings.json` when [`CLAUDE_CONFIG_DIR`](/docs/en/env-vars#variables) is set. ## Set u… Share session output as artifacts Claude Code CLI · in the page artifacts …. You can also set `"enableArtifact": 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… Configure auto mode Claude Code CLI · in the page auto-mode-config …--------------------- | | One developer | `~/.claude/settings.json` | Personal trusted infrastructure | | Organization-wide | [… Best practices for Claude Code Claude Code CLI · in the page best-practices …e a hook that blocks writes to the migrations folder."* Edit `.claude/settings.json` directly to configure hooks by hand, and run `/hooks` to browse what's configured. ### Create skills <Tip> Crea… Claude Code changelog Claude Code CLI · in the page changelog …sandbox's after-command cleanup deleting a dotfile-managed `~/.claude/settings.json` symlink (nix/home-manager, stow) when it is repointed outside the sandbox's writable area * Fixed `/terminal-setu… Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry Claude Code CLI · in the page claude-apps-gateway …ces plist on macOS or an HKLM policy on Windows outranks the `managed-settings.json` file, and the gateway's own remote managed settings outrank both, so on machines that sign in to the gateway, also… Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …at goes in `cli` Each `cli` value is a complete Claude Code `managed-settings.json` document, the same schema you would deploy via MDM or `/etc/claude-code/managed-settings.json`, expressed here as Y… Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …e through managed settings, via MDM or by writing the per-OS `managed-settings.json` directly. Without this, `/login` shows the standard account picker with no gateway option. See [Client-side managed… Explore the .claude directory Claude Code CLI · in the page claude-directory # Explore the .claude directory > Where Claude Code reads CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules, and auto memory. Explore the .claude directory in your projec… Claude Code on Claude Platform on AWS Claude Code CLI · in the page claude-platform-on-aws …ommand to your [settings file](/docs/en/settings), such as `~/.claude/settings.json`: ```json theme={null} { "awsAuthRefresh": "aws sso login --profile my-profile" } ``` Claude Code also runs this… CLI reference Claude Code CLI · in the page cli-reference …line JSON string. Values you set here override the same keys in your `settings.json` files for this session. Keys you omit keep their file-based values. The file must be a regular file no larger than… Configure cloud environments Claude Code CLI · in the page cloud-environments …| | Your repo's `.claude/settings.json` hooks… Code Review Claude Code CLI · in the page code-review …tings file](/docs/en/settings#where-settings-live) such as `~/.claude/settings.json`: ```json theme={null} { "skillOverrides": { "code-review": "user-invocable-only" } } ``` Before v2.1.246,… Commands Claude Code CLI · in the page commands …MCP tool calls, then add a prioritized allowlist to project `.claude/settings.json` to reduce permission prompts… Explore the context window Claude Code CLI · in the page context-window …olor: '#B8860B', vis: 'hidden', desc: 'A PostToolUse hook in `settings.json` runs prettier after every file edit and reports back via `hookSpecificOutput.additionalContext`. That field enters… Run Claude Code behind a corporate launcher Claude Code CLI · in the page corporate-launcher …r re-reads shell profiles. For one machine, add it to `~/.claude/settings.json`. To deploy it to every machine in your organization, put the same block in [managed settings](/docs/en/managed-sett… Manage costs effectively Claude Code CLI · in the page costs …led by default. Set `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in your [settings.json](/docs/en/settings) or environment to enable them. See [enable agent teams](/docs/en/agent-teams#enable-agent-teams)… Data usage Claude Code CLI · in the page data-usage …ttings) to disable. | All environment variables can be checked into `settings.json` (see [settings reference](/docs/en/settings-reference)). When a host platform sets `CLAUDE_CODE_PROVIDER_MANAGED_B… Debug your configuration Claude Code CLI · in the page debug-your-config …gs still apply, and `claude doctor` lists the dropped key. Edits to `settings.json` take effect in the running session after a brief file-stability delay. You don't need to restart. If `/hooks` still… Launch sessions from links Claude Code CLI · in the page deep-links …en/settings-reference#disabledeeplinkregistration) to `"disable"` in `settings.json`. To enforce this across an organization so users cannot re-enable it, set it in [managed settings](/docs/en/server-… Desktop application Claude Code CLI · in the page desktop …in in a cloud session, either declare it in the repository's `.claude/settings.json` under [`enabledPlugins`](/docs/en/settings-reference#enabledplugins) so Claude Code [installs it at session start](… Schedule recurring tasks in Claude Code Desktop Claude Code CLI · in the page desktop-scheduled-tasks …ou set when creating or editing the task. Allow rules from `~/.claude/settings.json` also apply to scheduled task sessions. If a task runs in [Manual mode](/docs/en/desktop#choose-a-permission-mode) a… Development containers Claude Code CLI · in the page devcontainer …very engineer's machine. Claude Code reads `/etc/claude-code/managed-settings.json` on Linux and applies it at the highest precedence in the [settings hierarchy](/docs/en/settings#settings-precedence… Discover and install prebuilt plugins through marketplaces Claude Code CLI · in the page discover-plugins …bledPlugins`](/docs/en/settings-reference#enabledplugins) in `.claude/settings.json` for cloud sessions. If the install fails, match the message Claude Code reports: * `Marketplace "claude-plugins-o… Environment variables Claude Code CLI · in the page env-vars …Tabs> ### In settings files Add variables under the `env` key in a `settings.json` file, creating the file if it doesn't exist. Claude Code reads them directly from the file, so they take effect no… Error reference Claude Code CLI · in the page errors …Helper`](/docs/en/settings-reference#apikeyhelper) setting from your `settings.json` * Run `/login` to sign in with your claude.ai account * Run `/status` afterward to confirm the active credential is… Fullscreen rendering Claude Code CLI · in the page fullscreen …CODE_SCROLL_SPEED` environment variable sets, persisted to `~/.claude/settings.json`. The dialog's maximum is 10: if you set a higher value through the environment variable, the dialog shows 10, and s… Claude Code with GitHub Enterprise Server Claude Code CLI · in the page github-enterprise-server …-reference#extraknownmarketplaces), including a repository's `.claude/settings.json`; managed settings deliver it organization-wide: ```json theme={null} { "extraKnownMarketplaces": { "internal… Glossary Claude Code CLI · in the page glossary …supplies, such as project allow rules and marketplaces from `.claude/settings.json`. [What runs before you trust a folder](/docs/en/permissions#what-runs-before-you-trust-a-folder) lists each kind of… Claude Code on Google Cloud's Agent Platform Claude Code CLI · in the page google-vertex-ai …ts from your currently pinned models. The wizard writes to `~/.claude/settings.json`, or to `$CLAUDE_CONFIG_DIR/settings.json` when [`CLAUDE_CONFIG_DIR`](/docs/en/env-vars#variables) is set. ## Regio… Run Claude Code programmatically Claude Code CLI · in the page headless …thout `--bare`, a `-p` session runs the hooks in a project's `.claude/settings.json` and connects the servers in its `.mcp.json`, even in a folder you've never trusted. A `-p` session shows no workspa… Hooks reference Claude Code CLI · in the page hooks …:---------------------------------------------------- | | `~/.claude/settings.json` | All your projects… Automate actions with hooks Claude Code CLI · in the page hooks-guide …s> <Step title="Add the hook to your settings"> Open `~/.claude/settings.json` and add a `Notification` hook. If the file doesn't exist, create it. The example below uses `osascript` for macOS;… How Claude Code works Claude Code CLI · in the page how-claude-code-works …g your source files You can also allow specific commands in `.claude/settings.json` so Claude doesn't ask each time. This is useful for trusted commands like `npm test` or `git status`. Settings can… Interactive mode Claude Code CLI · in the page interactive-mode …applied `"readline"` only to `Ctrl+W`. Add the setting to `~/.claude/settings.json`: ```json theme={null} { "keybindingFlavor": "readline" } ``` To confirm, type `fix the bug in src/utils/foo.ts`… Set up Claude Code in a monorepo or large codebase Claude Code CLI · in the page large-codebases …is scoped to one package or subsystem | Project settings in `.claude/settings.json` aren't inherited from parent directories the way CLAUDE.md files are. For which directory's `.claude/settings.json`… Connect Claude Code to an LLM gateway Claude Code CLI · in the page llm-gateway-connect …ng on your shell. Settings files have different scopes: * `~/.claude/settings.json` applies to all your projects. On Windows the path is `%USERPROFILE%\.claude\settings.json` * `.claude/settings.loca… Control MCP server access for your organization Claude Code CLI · in the page managed-mcp …ngs, an MDM-deployed plist or HKLM registry key, or a system `managed-settings.json` file. Placing it in user or project settings has no effect, so users cannot re-enable connectors that exclusive con…