Extra Keys and Global Config

Some keys are not in the settings schema, or they live in another file. This page covers the auto mode and display keys, the keys that only the desktop app reads, and the global config keys of ~/.claude.json. The global config file is not a settings file. Claude Code writes it, and /config changes some of its keys.

All keys here work in 2.1.304. Edit a settings file for the first two tables. Use /config or edit ~/.claude.json for the global config keys in the last table. Most keys are booleans.

Auto Mode, Voice, and Display Keys

The program adds these keys itself, so the schema files do not list them. Source: Settings Reference for rows marked Documented. For rows marked Undocumented, Source: the program.

Key	Status	Type	Default	What It Does	Where to Set It
skipAutoPermissionPrompt	Documented	boolean	-	Skip the one-time notice Claude Code shows when you first enter auto mode yourself rather than through the built-in default.	User or managed settings
useAutoModeDuringPlan	Documented	boolean	true	Let the auto mode classifier review shell commands in plan mode, and set false to get prompts instead.	User, local, or managed settings
autoMode	Documented	object	-	Add your own rules to the auto mode classifier. Takes allow, soft_deny, hard_deny, and environment lists and a classifyAllShell boolean. "$defaults" in a list keeps the built-in rules.	User or managed settings
permissions.disableAutoMode	Documented	enum: disable	-	Remove auto mode from the permission mode cycle. Same as the top-level disableAutoMode.	Any settings file
disableDeepLinkRegistration	Documented	enum: disable	-	Stop Claude Code from registering the claude-cli:// link handler with the operating system.	Any settings file
voiceEnabled	Documented	boolean	-	Turn on voice dictation (hold to talk). See also voice in Interface Settings.	Any settings file
defaultView	Undocumented	enum: chat, transcript	-	Choose the default transcript view: chat shows only SendUserMessage checkpoints, and transcript shows everything.	Settings files
axScreenReader	Documented	boolean	-	Render screen-reader friendly output. The CLAUDE_AX_SCREEN_READER variable and the --ax-screen-reader flag win.	Any settings file

Other Keys

The first rows are sub-keys of an object key. The last rows are read only by the desktop app.

Key	Status	Type	Default	What It Does	Where to Set It
disablePluginDirectory	Undocumented	boolean	-	Let an administrator turn the plugin directory off.	Managed settings only
isolation.required	Undocumented	boolean	-	Sub-key of isolation. A lower settings file may set true over managed settings.	Settings files
isolation.persistHome	Undocumented	boolean	-	Sub-key of isolation. The bundle gives no description.	Settings files
remoteControl.shareHostProfile	Undocumented	enum	-	Sub-key of remoteControl. The strict values are off and basic.	Settings files
remoteTools.allowUnattendedServing	Undocumented	boolean	-	Sub-key of remoteTools. The bundle gives no description.	Settings files
attribution.sessionUrl	Documented	boolean	-	Leave the claude.ai session link out of cloud and Remote Control commits.	Any settings file
sshHostAllowlist	Documented	array of string	Unset, so any host is allowed	Limit the hosts that Desktop SSH sessions may reach. Only the desktop app reads it.	Managed settings only
disableBrowserExternalNavigation	Documented	boolean	Unset, so external browsing is on	Turn off external browsing in the desktop Browser pane. Only true takes effect.	Managed settings only
browserExternalPageTools	Documented	string	Unset, so the tools work on external pages	Stop Claude from using its tools on external pages in the desktop Browser pane. The value is "disabled".	Managed settings only
disableMobileSimulatorTools	Documented	boolean	Unset	Block Claude's tools in the desktop iOS Simulator pane. Only true takes effect.	Managed settings only
disableDesktopLocalSessions	Documented	❓	-	Turn off Desktop Code sessions that run on the device. SSH and cloud sessions stay on.	Managed settings only

Global Config Keys

These keys live in ~/.claude.json, not in a settings file. The /config command writes them. Source: Settings Reference

Key	Status	What It Does
autoConnectIde	Documented	Connect to a running VS Code or JetBrains IDE automatically from an external terminal.
autoInstallIdeExtension	Documented	Turn off automatic install of the IDE extension from a VS Code terminal.
claudeInChromeDefaultEnabled	Documented	Turn on Chrome integration when a session starts, in the interactive CLI and the VS Code extension.
copyFullResponse	Documented	Make /copy copy the full response without showing the picker.
copyOnSelect	Documented	Turn off automatic copying of text you select with the mouse in fullscreen rendering and agent view.
defaultToAgentsView	Documented	Open agent view instead of a new conversation when you run claude with no arguments.
diffTool	Documented	Choose whether Claude's proposed file changes open in the VS Code or JetBrains diff viewer or stay in the terminal.
externalEditorContext	Documented	Show Claude's last response as comments when you press Ctrl+G to edit.
leftArrowOpensAgents	Documented	Turn off the ← shortcut that backgrounds the session and opens agent view.
prStatusFooterEnabled	Documented	Turn off the prompt footer's PR review status badge and the pull request check behind it.

Not Verified

The sub-keys under isolation, remoteControl, and remoteTools come from strings in the program. The program gives no description for isolation.persistHome and remoteTools.allowUnattendedServing.

Example

Turn On Auto Mode Rules and Voice

~/.claude/settings.json

{
  "autoMode": {
    "classifyAllShell": true
  },
  "useAutoModeDuringPlan": true,
  "voiceEnabled": true
}

This file makes the classifier check every shell command, lets the classifier review shell commands in plan mode, and turns on voice dictation.

Related Pages

• Settings Files and Scopes explains the scopes and precedence.
• Interface Settings has the voice key.
• Auto Mode covers autoMode.
• Settings Reference is the official page for each key.