Text of code.claude.com › docs › en › settings-reference as Styx crawled it on Nov 20, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

All settings - Claude Code Docs

Documentation Index Fetch the complete documentation index at: /docs/llms.txt Use this file to discover all available pages before exploring further. Skip to main content Assistant Responses are generated using AI and may contain mistakes. This reference page lists each key Claude Code reads from a settings file, plus the short group of keys it keeps in ~/.claude.json instead. To pick a file, or check precedence, start with Settings files and precedence .

Settings index Every key below links to its entry. Scope lists the files it can go in: User is ~/.claude/settings.json , Project is .claude/settings.json , Local is .claude/settings.local.json , and Managed is what your organization deploys . Any file means all four, and Global config means ~/.claude.json . Key Description Topic Scope advisorModel Pick which model answers when Claude asks the advisor tool Model and responses Any file agent Start every session as a named subagent with its prompt, tools, and model Agents, sessions, and worktrees Any file agentPushNotifEnabled Let Claude send a push notification to your phone when it decides to Remote, desktop, and notifications Any file allowAllClaudeAiMcps Load the claude.ai connectors Claude Code fetches itself alongside a deployed managed-mcp.json MCP Managed allowClaudeInChromeWithManagedMcp Let the built-in Claude in Chrome server run alongside a deployed managed-mcp.json MCP Managed allowedChannelPlugins Replace the default allowlist of channel plugins that can push messages Plugins and skills Managed allowedHttpHookUrls Limit which URLs HTTP hooks can target Hooks and automation Any file allowedMcpServers Allowlist which MCP servers users can add MCP Any file allowedProviders Limit which API providers a machine may use Authentication and providers Managed allowManagedHooksOnly Run only the hooks your organization deploys Hooks and automation Managed allowManagedMcpServersOnly Make the managed MCP allowlist the only one that applies MCP Managed allowManagedPermissionRulesOnly Make managed settings the only settings source of permission rules Permission settings Managed alwaysThinkingEnabled Turn extended thinking off for every session Model and responses Any file apiKeyHelper Generate the API credential with your own command Authentication and providers Any file askUserQuestionTimeout Let an unanswered question auto-continue after idle time Interface and terminal User or managed appendPlugins Run your organization’s mods after every mod a user installs Plugins and skills User or managed attribution Customize the attribution Claude Code adds to commits and pull requests Git and attribution Any file attribution.commit Change or hide the trailer Claude Code adds to commits Git and attribution Any file attribution.pr Change or hide the attribution line in pull request descriptions Git and attribution Any file attribution.sessionUrl Omit the claude.ai session link from cloud and Remote Control commits Git and attribution Any file autoCompactEnabled Turn automatic compaction off or on Memory and context Any file autoCompactWindow Set how full the context gets before Claude Code compacts Memory and context Any file autoConnectIde Connect to a running VS Code or JetBrains IDE automatically from an external terminal Global config settings Global config autoContinueAtUsageLimit Wait in the open session and continue the task automatically after a claude.ai usage limit resets Interface and terminal User or managed autoInstallIdeExtension Let /ide install the IDE extension from an external terminal Global config settings Global config autoMemoryDirectory Store auto memory in a directory you choose Memory and context Any file autoMemoryEnabled Turn auto memory off or on Memory and context Any file autoMode Add your own allow and deny rules to the auto mode classifier Permission settings User or managed autoMode.classifyAllShell Send every shell command through the auto mode classifier , even ones a narrow allow rule matches Permission settings User or managed autoScrollEnabled Follow new output to the bottom in fullscreen rendering Interface and terminal Any file autoUpdatesChannel Follow the stable release channel instead of latest Updates and versioning Any file availableModels Restrict which models people can pick Model and responses Any file availableModelsMatch Make each availableModels model ID entry permit only the version it names Model and responses Managed awaySummaryEnabled Turn off the session recap shown when you come back to the terminal Remote, desktop, and notifications Any file awsAuthRefresh Refresh expired Bedrock credentials in .aws with your own command Authentication and providers Any file awsCredentialExport Supply Bedrock credentials as JSON from your own command Authentication and providers Any file axScreenReader Render screen-reader friendly output Interface and terminal User or managed bashEditDiffEnabled Record the files that changed while a Bash command ran in every permission mode Interface and terminal User or managed bashOutputMaxChars Set how much of a successful command’s output Claude receives inline Memory and context Any file blockedMarketplaces Block plugin marketplace sources for your organization Plugins and skills Managed browserExternalPageTools Keep Claude’s tools off external pages in the desktop Browser pane Tools Managed channelsEnabled Allow channels for your organization Plugins and skills Managed claudeInChromeDefaultEnabled Turn on Chrome integration when a session starts, in the interactive CLI and the VS Code extension Global config settings Global config claudeMd Inject organization-wide CLAUDE.md instructions from managed settings Memory and context Managed claudeMdExcludes Skip specific CLAUDE.md files when memory loads Memory and context Any file cleanupPeriodDays Choose how many days Claude Code keeps transcripts before deleting them Privacy and telemetry Any file companyAnnouncements Show your organization’s announcements at startup Interface and terminal Any file copyFullResponse Make /copy copy the full response without showing the picker Global config settings Global config copyOnSelect Turn off automatic copying of text you select with the mouse in fullscreen rendering and agent view Global config settings Global config crossSessionInbound Choose whether Claude Code delivers messages from your other sessions , shows a notice without delivering them, or refuses them Agents, sessions, and worktrees Any file defaultShell Choose whether Bash or PowerShell runs the shell commands you type with the ! prefix Interface and terminal Any file defaultToAgentsView Open agent view instead of a new conversation when you run claude with no arguments Global config settings Global config deniedMcpServers Block specific MCP servers by URL, command, or name MCP Any file deniedModels Block specific models , even ones availableModels permits Model and responses Managed desktopSessionCleanupPeriodDays Set an age limit in days for Claude Desktop and Cowork transcripts Privacy and telemetry User or managed dialogExpiry Set how long Claude Code waits for Remote Control or an SDK host to answer a forwarded dialog before it cancels the dialog Interface and terminal User or managed diffTool Choose whether Claude’s proposed file changes open in the VS Code or JetBrains diff viewer or stay in the terminal Global config settings Global config disableAgentView Turn off background agents and agent view Agents, sessions, and worktrees Any file disableAllHooks Turn off hooks , a custom status line , and a custom @ file suggestion command at once Hooks and automation Any file disableArtifact Deprecated; use enableArtifact to turn the Artifact tool off Remote, desktop, and notifications Any file disableAutoMode Remove auto mode from the permission mode cycle Permission settings Any file disableBrowserExternalNavigation Limit the desktop Browser pane to localhost for people and Claude Tools Managed disableBundledSkills Tur

The rest of this page is on the live site.