Docs search: settings.json / Claude Code source intelligence

Use Claude Code with a screen reader Claude Code CLI · in the page accessibility …`CLAUDE_AX_SCREEN_READER` value under `env` in the project's `.claude/settings.json` and `.claude/settings.local.json`, whatever their value. * **To turn the mode on**: start Claude Code with `--ax-s…

Set up Claude Code for your organization Claude Code CLI · in the page admin-setup …sed managed | macOS: `/Library/Application Support/ClaudeCode/managed-settings.json` Linux and WSL: `/etc/claude-code/managed-settings.json` Windows: `C:\Program Files\ClaudeCode\managed-settings.json…

Use Claude Code features in the SDK Claude Code CLI · in the page agent-sdk/claude-code-features …What it loads | Location | | :- | :- | :- | | `"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 …s/en/hooks.md#hook-events) defined in settings files such as `.claude/settings.json`. Which settings files your SDK application loads depends on [`setting_sources`](/docs/en/agent-sdk/python#settingso…

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 …rompt` and `setting_sources` * [Settings](/docs/en/settings.md): the `settings.json` reference, including where output styles and other configuration are stored

Configure permissions Claude Code CLI · in the page agent-sdk/permissions …**2. Deny rules** Check `deny` rules (from `disallowed_tools` and [settings.json](/docs/en/settings-reference.md#permission-settings)). If a deny rule matches, the tool is blocked, even in `bypassP…

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…

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.md) or environment. Without that variable, no team is set up at session start, no team directorie…

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…

Authentication Claude Code CLI · in the page authentication …o Anthropic. Requires Claude Code v2.1.285 or later. ```json managed-settings.json theme={null} { "forceLoginMethod": "claudeai", "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],…

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] > >…

Claude Code changelog Claude Code CLI · in the page changelog …inspecting proxy when `NODE_EXTRA_CA_CERTS` is set only in `~/.claude/settings.json`; it now also follows `CLAUDE_CODE_CERT_STORE` * \[Cloud sessions] Fixed the repository picker saying "No repositori…

Use Claude Code with Chrome Claude Code CLI · in the page chrome …self, run /chrome or start with --chrome. ``` The project's `.claude/settings.json` or `.claude/settings.local.json` sets [`CLAUDE_CODE_ENABLE_CFC`](/docs/en/env-vars#variables) to `1` in its `env` b…

Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry Claude Code CLI · in the page claude-apps-gateway …nd `forceLoginGatewayUrl` to their own user settings file, `~/.claude/settings.json`. This requires Claude Code v2.1.295 or later on the developer machine. This example names a gateway at `claude-gate…

Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …`cli` Each `code` or `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. Once you deploy the keys, Claude Code stops using a leftover API key or claude.ai login on the machine,…

Use Claude Code in the cloud Claude Code CLI · in the page claude-code-on-the-web …-projects.md)'s threads, commit the key to that repository's `.claude/settings.json` instead. [Settings in cloud sessions](/docs/en/settings.md#settings-in-cloud-sessions) lists what each session read…

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 …and to your [settings file](/docs/en/settings.md), such as `~/.claude/settings.json`: ```json theme={null} { "awsAuthRefresh": "aws sso login --profile my-profile" } ``` Claude Code also runs this…

Let Claude coordinate ongoing work with Projects Claude Code CLI · in the page claude-projects …p-from-your-repositories), but not the repositories' skills, `.claude/settings.json`, or `.mcp.json` * The [connectors](#get-skills-plugins-connectors-and-tools-into-threads) on your claude.ai accou…

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 …repo's `CLAUDE.md` | Yes | Part of the clone | | Your repo's `.claude/settings.json` hooks and permission rules | Yes, in a session with one repository | Part of the clone. For a session with several…

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,…

Review locally with /code-review Claude Code CLI · in the page code-review-local …gs file](/docs/en/settings.md#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 …never 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 …anaged-settings.md): server-managed settings, an MDM policy, `managed-settings.json`, or a [policy helper](/docs/en/managed-settings.md#compute-the-policy-with-a-helper-program). Claude Code ignores t…

Data usage Claude Code CLI · in the page data-usage …ngs.md) to disable. | All environment variables can be checked into `settings.json` (see [settings reference](/docs/en/settings-reference.md)). When a host platform sets `CLAUDE_CODE_PROVIDER_MANAGE…

Debug your configuration Claude Code CLI · in the page debug-your-config …her that matches nothing, so the hook fails silently. When you edit `settings.json`, the change takes effect in the running session after a brief file-stability delay, even if you create the file or…

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 …irectory, except some view-only ones such as `.mcp.json` and `.claude/settings.json`. To change one, [open it in another app](#open-files-in-other-apps). * **Cloud, SSH, and WSL sessions**: the file p…

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.md#choose-a-permission-mode…

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.md#settings-precede…

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 …ference.md#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.md#what-runs-before-you-trust-a-folder) lists each kind…

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…

Set up Claude Code (local mode) for a HIPAA-ready organization Claude Code CLI · in the page hipaa-setup …["anthropic"], "cleanupPeriodDays": 30 } ``` For a fuller `managed-settings.json` with sandboxing, a network allowlist, credential protections, and local data retention, see `settings-hipaa.json` a…