{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://www.schemastore.org/claude-code-settings.json", "type": "object", "properties": { "$schema": { "description": "JSON Schema reference for Claude Code settings", "type": "string" }, "apiKeyHelper": { "description": "Path to a script that outputs authentication values", "type": "string" }, "proxyAuthHelper": { "description": "Shell command that outputs a Proxy-Authorization header value (EAP)", "type": "string" }, "awsCredentialExport": { "description": "Path to a script that exports AWS credentials", "type": "string" }, "awsAuthRefresh": { "description": "Path to a script that refreshes AWS authentication", "type": "string" }, "gcpAuthRefresh": { "description": "Command to refresh GCP authentication (e.g., gcloud auth application-default login)", "type": "string" }, "policyHelper": { "description": "Executable that computes managed settings at startup. Honored only from admin-controlled policy sources.", "type": "object", "properties": { "path": { "description": "Absolute path to the helper executable", "type": "string" }, "timeoutMs": { "type": "integer", "minimum": 1000, "maximum": 9007199254740991 }, "refreshIntervalMs": { "anyOf": [ { "type": "number", "const": 0 }, { "type": "integer", "minimum": 60000, "maximum": 9007199254740991 } ] } }, "required": [ "path" ] }, "fileSuggestion": { "description": "Custom file suggestion configuration for @ mentions", "type": "object", "properties": { "type": { "type": "string", "const": "command" }, "command": { "type": "string" } }, "required": [ "type", "command" ] }, "respectGitignore": { "description": "Whether file picker should respect .gitignore files (default: true). Note: .ignore files are always respected.", "type": "boolean" }, "cleanupPeriodDays": { "description": "Number of days to retain chat transcripts before automatic cleanup (default: 30). Minimum 1. Use a large value for long retention; use --no-session-persistence to disable transcript writes entirely.", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "skillListingMaxDescChars": { "description": "Per-skill description character cap in the skill listing sent to Claude (default: 1536). Descriptions longer than this are truncated. Raise to opt in to higher per-turn context cost.", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "skillListingBudgetFraction": { "description": "Fraction of the context window (in characters) reserved for the skill listing sent to Claude (default: 0.01 = 1%). When the listing exceeds this, descriptions are shortened to fit. Raise to opt in to higher per-turn context cost.", "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "wslInheritsWindowsSettings": { "description": "When set to true in either admin-only Windows source — the HKLM SOFTWARE/Policies/ClaudeCode registry key or C:/Program Files/ClaudeCode/managed-settings.json — WSL reads managed settings from the full Windows policy chain (HKLM, C:/Program Files/ClaudeCode via DrvFs, HKCU) in addition to /etc/claude-code. Windows sources take priority. The flag is also required in HKCU itself for HKCU policy to apply on WSL (double opt-in: admin enables the chain, user confirms HKCU). On native Windows the flag has no effect.", "type": "boolean" }, "env": { "description": "Environment variables to set for Claude Code sessions", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "attribution": { "description": "Customize attribution text for commits and PRs. Each field defaults to the standard Claude Code attribution if not set.", "type": "object", "properties": { "commit": { "description": "Attribution text for git commits, including any trailers. Empty string hides attribution.", "type": "string" }, "pr": { "description": "Attribution text for pull request descriptions. Empty string hides attribution.", "type": "string" }, "sessionUrl": { "description": "Whether to append the claude.ai session link to commits and PRs created from web or Remote Control sessions (default: true). Set to false to omit the Claude-Session trailer and PR-body link.", "type": "boolean" } } }, "includeCoAuthoredBy": { "description": "Deprecated: Use attribution instead. Whether to include Claude's co-authored by attribution in commits and PRs (defaults to true)", "type": "boolean" }, "includeGitInstructions": { "description": "Include built-in commit and PR workflow instructions in Claude's system prompt (default: true)", "type": "boolean" }, "permissions": { "description": "Tool usage permissions configuration", "type": "object", "properties": { "allow": { "description": "List of permission rules for allowed operations", "type": "array", "items": { "type": "string" } }, "deny": { "description": "List of permission rules for denied operations", "type": "array", "items": { "type": "string" } }, "ask": { "description": "List of permission rules that should always prompt for confirmation", "type": "array", "items": { "type": "string" } }, "defaultMode": { "description": "Default permission mode when Claude Code needs access ('manual' is accepted as an alias for 'default')", "type": "string", "enum": [ "acceptEdits", "auto", "bypassPermissions", "default", "dontAsk", "plan", "manual" ] }, "disableBypassPermissionsMode": { "description": "Disable the ability to bypass permission prompts", "type": "string", "enum": [ "disable" ] }, "additionalDirectories": { "description": "Additional directories to include in the permission scope", "type": "array", "items": { "type": "string" } } }, "additionalProperties": {} }, "model": { "description": "Override the default model used by Claude Code", "type": "string" }, "fallbackModel": { "description": "Fallback model(s) tried in order when the primary model is overloaded or unavailable. Each element accepts a model name or alias; \"default\" expands to the default model. CLI --fallback-model takes precedence.", "type": "array", "items": { "type": "string" } }, "availableModels": { "description": "Allowlist of models that users can select. Accepts family aliases (\"opus\" allows any opus version), version prefixes (\"opus-4-5\" allows only that version), and full model IDs. If undefined, all models are available. If empty array, only the default model is available. Typically set in managed settings by enterprise administrators.", "type": "array", "items": { "type": "string" } }, "enforceAvailableModels": { "description": "When true and availableModels is a non-empty array, the Default model selection is also constrained: if the default model for the user tier is not in availableModels, Default resolves to the first allowed availableModels entry instead. Has no effect when availableModels is unset or an empty array. Typically set in managed settings by enterprise administrators.", "type": "boolean" }, "modelOverrides": { "description": "Override mapping from Anthropic model ID (e.g. \"claude-opus-4-6\") to provider-specific model ID (e.g. a Bedrock inference profile ARN). Typically set in managed settings by enterprise administrators.", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "enableAllProjectMcpServers": { "description": "Whether to automatically approve all MCP servers in the project", "type": "boolean" }, "enabledMcpjsonServers": { "description": "List of approved MCP servers from .mcp.json", "type": "array", "items": { "type": "string" } }, "disabledMcpjsonServers": { "description": "List of rejected MCP servers from .mcp.json", "type": "array", "items": { "type": "string" } }, "disableClaudeAiConnectors": { "description": "When true in any settings source, claude.ai MCP cloud connectors are not auto-fetched or connected. Only gates auto-fetched connectors — a claudeai-proxy server passed explicitly (e.g. via --mcp-config or the SDK mcpServers option) still follows the normal MCP config trust flow. Any-source-true wins: a project can opt out, but a project-level false cannot override a user-level true.", "type": "boolean" }, "skillOverrides": { "description": "Per-skill listing overrides keyed by skill name. \"name-only\" lists the skill without its description; \"user-invocable-only\" hides it from the model but keeps /name; \"off\" hides it from both. Absent = on.", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "on", "name-only", "user-invocable-only", "off" ] } }, "disableBundledSkills": { "description": "Disable the skills and workflows that ship with Claude Code: bundled skills and workflows are removed entirely; built-in slash commands stay typable but are hidden from the model. Plugins, .claude/skills/, and .claude/commands/ are unaffected. Equivalent to CLAUDE_CODE_DISABLE_BUNDLED_SKILLS=1.", "type": "boolean" }, "allowedMcpServers": { "description": "Enterprise allowlist of MCP servers that can be used. Applies to all scopes including enterprise servers from managed-mcp.json. If undefined, all servers are allowed. If empty array, no servers are allowed. Denylist takes precedence - if a server is on both lists, it is denied.", "type": "array", "items": { "type": "object", "properties": { "serverName": { "description": "Name of the MCP server that users are allowed to configure", "type": "string", "pattern": "^[a-zA-Z0-9_-]+$" }, "serverCommand": { "description": "Command array [command, ...args] to match exactly for allowed stdio servers", "minItems": 1, "type": "array", "items": { "type": "string" } }, "serverUrl": { "description": "URL pattern with wildcard support (e.g., \"https://*.example.com/*\") for allowed remote MCP servers", "type": "string" } } } }, "deniedMcpServers": { "description": "Enterprise denylist of MCP servers that are explicitly blocked. If a server is on the denylist, it will be blocked across all scopes including enterprise. Denylist takes precedence over allowlist - if a server is on both lists, it is denied.", "type": "array", "items": { "type": "object", "properties": { "serverName": { "description": "Name of the MCP server that is explicitly blocked", "type": "string", "minLength": 1 }, "serverCommand": { "description": "Command array [command, ...args] to match exactly for blocked stdio servers", "minItems": 1, "type": "array", "items": { "type": "string" } }, "serverUrl": { "description": "URL pattern with wildcard support (e.g., \"https://*.example.com/*\") for blocked remote MCP servers", "type": "string" } } } }, "hooks": { "description": "Custom commands to run before/after tool executions", "type": "object", "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "PreToolUse", "PostToolUse", "PostToolUseFailure", "PostToolBatch", "Notification", "UserPromptSubmit", "UserPromptExpansion", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "PermissionDenied", "Setup", "TeammateIdle", "TaskCreated", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded", "CwdChanged", "FileChanged", "MessageDisplay" ] }, { "not": {} } ] }, "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "matcher": { "description": "String pattern to match (e.g. tool names like \"Write\")", "type": "string" }, "hooks": { "description": "List of hooks to execute when the matcher matches", "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "description": "Shell command hook type", "type": "string", "const": "command" }, "command": { "description": "Shell command to execute", "type": "string" }, "args": { "description": "Argument list for exec form. When present, `command` is resolved as an executable and spawned directly with these arguments — no shell. Path placeholders like ${CLAUDE_PLUGIN_ROOT} are substituted per-element as plain strings, so paths with quotes, $, or backticks never reach a shell parser. When absent, `command` runs through a shell (bash on POSIX, PowerShell on Windows without Git Bash).", "type": "array", "items": { "type": "string" } }, "if": { "description": "Permission rule syntax to filter when this hook runs (e.g., \"Bash(git *)\"). Only runs if the tool call matches the pattern. Avoids spawning hooks for non-matching commands.", "type": "string" }, "shell": { "description": "Shell interpreter. 'bash' uses your $SHELL (bash/zsh/sh); 'powershell' uses pwsh. Defaults to bash (powershell on Windows without Git Bash).", "type": "string", "enum": [ "bash", "powershell" ] }, "timeout": { "description": "Timeout in seconds for this specific command", "type": "number", "exclusiveMinimum": 0 }, "statusMessage": { "description": "Custom status message to display in spinner while hook runs", "type": "string" }, "once": { "description": "If true, hook runs once and is removed after execution", "type": "boolean" }, "async": { "description": "If true, hook runs in background without blocking", "type": "boolean" }, "asyncRewake": { "description": "If true, hook runs in background and wakes the model on exit code 2 (blocking error). Implies async.", "type": "boolean" } }, "required": [ "type", "command" ] }, { "type": "object", "properties": { "type": { "description": "LLM prompt hook type", "type": "string", "const": "prompt" }, "prompt": { "description": "Prompt to evaluate with LLM. Use $ARGUMENTS placeholder for hook input JSON.", "type": "string" }, "if": { "description": "Permission rule syntax to filter when this hook runs (e.g., \"Bash(git *)\"). Only runs if the tool call matches the pattern. Avoids spawning hooks for non-matching commands.", "type": "string" }, "timeout": { "description": "Timeout in seconds for this specific prompt evaluation", "type": "number", "exclusiveMinimum": 0 }, "model": { "description": "Model to use for this prompt hook (e.g., \"claude-sonnet-5\"). If not specified, uses the default small fast model.", "type": "string" }, "continueOnBlock": { "description": "Sets the continue value for the decision:\"block\" produced when ok is false. Default false (turn ends). Whether continue:true lets the turn proceed depends on the event's decision:\"block\" semantics. On PostToolUse, the reason is fed back to Claude and the turn continues.", "type": "boolean" }, "statusMessage": { "description": "Custom status message to display in spinner while hook runs", "type": "string" }, "once": { "description": "If true, hook runs once and is removed after execution", "type": "boolean" } }, "required": [ "type", "prompt" ] }, { "type": "object", "properties": { "type": { "description": "Agentic verifier hook type", "type": "string", "const": "agent" }, "prompt": { "description": "Prompt describing what to verify (e.g. \"Verify that unit tests ran and passed.\"). Use $ARGUMENTS placeholder for hook input JSON.", "type": "string" }, "if": { "description": "Permission rule syntax to filter when this hook runs (e.g., \"Bash(git *)\"). Only runs if the tool call matches the pattern. Avoids spawning hooks for non-matching commands.", "type": "string" }, "timeout": { "description": "Timeout in seconds for agent execution (default 60)", "type": "number", "exclusiveMinimum": 0 }, "model": { "description": "Model to use for this agent hook (e.g., \"claude-sonnet-5\"). If not specified, uses Haiku.", "type": "string" }, "statusMessage": { "description": "Custom status message to display in spinner while hook runs", "type": "string" }, "once": { "description": "If true, hook runs once and is removed after execution", "type": "boolean" } }, "required": [ "type", "prompt" ] }, { "type": "object", "properties": { "type": { "description": "HTTP hook type", "type": "string", "const": "http" }, "url": { "description": "URL to POST the hook input JSON to", "type": "string", "format": "uri" }, "if": { "description": "Permission rule syntax to filter when this hook runs (e.g., \"Bash(git *)\"). Only runs if the tool call matches the pattern. Avoids spawning hooks for non-matching commands.", "type": "string" }, "timeout": { "description": "Timeout in seconds for this specific request", "type": "number", "exclusiveMinimum": 0 }, "headers": { "description": "Additional headers to include in the request. Values may reference environment variables using $VAR_NAME or ${VAR_NAME} syntax (e.g., \"Authorization\": \"Bearer $MY_TOKEN\"). Only variables listed in allowedEnvVars will be interpolated.", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "allowedEnvVars": { "description": "Explicit list of environment variable names that may be interpolated in header values. Only variables listed here will be resolved; all other $VAR references are left as empty strings. Required for env var interpolation to work.", "type": "array", "items": { "type": "string" } }, "statusMessage": { "description": "Custom status message to display in spinner while hook runs", "type": "string" }, "once": { "description": "If true, hook runs once and is removed after execution", "type": "boolean" } }, "required": [ "type", "url" ] }, { "type": "object", "properties": { "type": { "description": "MCP tool hook type", "type": "string", "const": "mcp_tool" }, "server": { "description": "Name of an already-configured MCP server to invoke", "type": "string" }, "tool": { "description": "Name of the tool on that server to call", "type": "string" }, "input": { "description": "Arguments passed to the MCP tool. String values support ${path} interpolation from the hook input JSON (e.g. \"${tool_input.file_path}\").", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "if": { "description": "Permission rule syntax to filter when this hook runs (e.g., \"Bash(git *)\"). Only runs if the tool call matches the pattern. Avoids spawning hooks for non-matching commands.", "type": "string" }, "timeout": { "description": "Timeout in seconds for this specific tool call", "type": "number", "exclusiveMinimum": 0 }, "statusMessage": { "description": "Custom status message to display in spinner while hook runs", "type": "string" }, "once": { "description": "If true, hook runs once and is removed after execution", "type": "boolean" } }, "required": [ "type", "server", "tool" ] } ] } } }, "required": [ "hooks" ] } } }, "worktree": { "description": "Git worktree configuration for --worktree flag.", "type": "object", "properties": { "symlinkDirectories": { "description": "Directories to symlink from main repository to worktrees to avoid disk bloat. Must be explicitly configured - no directories are symlinked by default. Common examples: \"node_modules\", \".cache\", \".bin\"", "type": "array", "items": { "type": "string" } }, "sparsePaths": { "description": "Directories to include when creating worktrees, via git sparse-checkout (cone mode). Dramatically faster in large monorepos — only the listed paths are written to disk.", "type": "array", "items": { "type": "string" } }, "baseRef": { "description": "Which ref new worktrees branch from. 'fresh' (default) branches from origin/ for a clean tree. 'head' branches from your current local HEAD so unpushed commits and feature-branch state are present. Applies to --worktree, EnterWorktree, and agent isolation.", "type": "string", "enum": [ "fresh", "head" ] }, "bgIsolation": { "description": "Isolation mode for background sessions in this repo. 'worktree' (default) blocks Edit/Write in the main checkout until EnterWorktree is called. 'none' lets background jobs edit the working copy directly.", "type": "string", "enum": [ "worktree", "none" ] } } }, "disableAllHooks": { "description": "Disable all hooks and statusLine execution", "type": "boolean" }, "disableAgentView": { "description": "Disable agent view (`claude agents`, `--bg`, /background, the on-demand daemon). Typically set in managed settings. Equivalent to CLAUDE_CODE_DISABLE_AGENT_VIEW=1.", "type": "boolean" }, "disableRemoteControl": { "description": "Disable Remote Control (claude.ai/code, `claude remote-control`, `--remote-control`/`--rc`, auto-start, and the in-session toggle). Typically set in managed settings.", "type": "boolean" }, "disableWorkflows": { "description": "Disable the Workflows feature (also via CLAUDE_CODE_DISABLE_WORKFLOWS).", "type": "boolean" }, "disableArtifact": { "description": "Disable the Artifact tool (also via CLAUDE_CODE_DISABLE_ARTIFACT).", "type": "boolean" }, "enableArtifact": { "description": "Enable or disable the Artifact tool for this user. Unset defaults to enabled once the feature is available.", "type": "boolean" }, "enableWorkflows": { "description": "Enable or disable the Workflows feature for this user. Unset = default by plan once the feature is available.", "type": "boolean" }, "workflowKeywordTriggerEnabled": { "description": "Enable the \"ultracode\" keyword trigger: including the keyword in a prompt opts that turn into the Workflow tool. Set to false to disable the trigger. Default: true.", "type": "boolean" }, "disableSkillShellExecution": { "description": "Disable inline shell execution in skills and custom slash commands from user, project, or plugin sources. Commands are replaced with a placeholder instead of being run.", "type": "boolean" }, "defaultShell": { "description": "Default shell for input-box ! commands. Defaults to 'bash' on all platforms (no Windows auto-flip).", "type": "string", "enum": [ "bash", "powershell" ] }, "respondToBashCommands": { "description": "Whether Claude responds after an input-box ! bash command runs. Set to false to add the command output to context without a response. Default: true.", "type": "boolean" }, "allowManagedHooksOnly": { "description": "When true (and set in managed settings), only hooks from managed settings run. User, project, and local hooks are ignored.", "type": "boolean" }, "allowedHttpHookUrls": { "description": "Allowlist of URL patterns that HTTP hooks may target. Supports * as a wildcard (e.g. \"https://hooks.example.com/*\"). When set, HTTP hooks with non-matching URLs are blocked. If undefined, all URLs are allowed. If empty array, no HTTP hooks are allowed. Arrays merge across settings sources (same semantics as allowedMcpServers).", "type": "array", "items": { "type": "string" } }, "httpHookAllowedEnvVars": { "description": "Allowlist of environment variable names HTTP hooks may interpolate into headers. When set, each hook's effective allowedEnvVars is the intersection with this list. If undefined, no restriction is applied. Arrays merge across settings sources (same semantics as allowedMcpServers).", "type": "array", "items": { "type": "string" } }, "allowManagedPermissionRulesOnly": { "description": "When true (and set in managed settings), only permission rules (allow/deny/ask) from managed settings are respected. User, project, local, and CLI argument permission rules are ignored.", "type": "boolean" }, "allowManagedMcpServersOnly": { "description": "When true (and set in managed settings), allowedMcpServers is only read from managed settings. deniedMcpServers still merges from all sources, so users can deny servers for themselves. Users can still add their own MCP servers, but only the admin-defined allowlist applies.", "type": "boolean" }, "allowAllClaudeAiMcps": { "description": "When true (and set in managed settings), claude.ai cloud MCP connectors load alongside managed-mcp.json instead of being suppressed by its exclusive-control lockdown. Default off preserves the lockdown. Read from managed settings only.", "type": "boolean" }, "strictPluginOnlyCustomization": { "description": "When set in managed settings, blocks non-plugin customization sources for the listed surfaces. Array form locks specific surfaces (e.g. [\"skills\", \"hooks\"]); `true` locks all four; `false` is an explicit no-op. Blocked: ~/.claude/{surface}/, .claude/{surface}/ (project), settings.json hooks, .mcp.json. NOT blocked: managed (policySettings) sources, plugin-provided customizations. Composes with strictKnownMarketplaces for end-to-end admin control — plugins gated by marketplace allowlist, everything else blocked here.", "anyOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "enum": [ "skills", "agents", "hooks", "mcp" ] } } ] }, "statusLine": { "description": "Custom status line display configuration", "type": "object", "properties": { "type": { "type": "string", "const": "command" }, "command": { "type": "string" }, "padding": { "type": "number" }, "refreshInterval": { "description": "Re-run the status line command every N seconds in addition to event-driven updates", "type": "number", "minimum": 1 }, "hideVimModeIndicator": { "description": "Hide the built-in `-- INSERT --` / `-- VISUAL --` indicator below the prompt. Use this when your status line script renders `vim.mode` itself.", "type": "boolean" } }, "required": [ "type", "command" ] }, "prUrlTemplate": { "description": "URL template for PR links in the footer link badges and inline messages. The detected git PR is rendered as the first footer-link badge. Placeholders: {host} {owner} {repo} {number} {url}. Example: \"https://reviews.example.com/{owner}/{repo}/pull/{number}\"", "type": "string" }, "footerLinksRegexes": { "description": "Extra clickable footer badges that appear when a regex matches turn output (tool results and assistant responses). Read from user, flag, and managed settings only; ignored in project .claude/settings.json and local .claude/settings.local.json. At most 5 badges render; the oldest is displaced by newer matches and /clear removes them. Use to surface IDs printed by project CLIs as session links.", "type": "array", "items": { "default": { "type": "invalid-entry-stripped" }, "anyOf": [ { "type": "object", "properties": { "type": { "description": "Config variant. This client understands \"regex\": matches turn output and builds a URL from named capture groups. Entries with other variants are preserved but skipped at runtime.", "type": "string", "const": "regex" }, "pattern": { "description": "Regex matched against turn output (tool results and assistant text)", "type": "string" }, "url": { "description": "Link target. {name} placeholders are filled from named regex capture groups, e.g. (?...) -> {id}. Values are URL-encoded; the origin must be literal in the template. The scheme must be https, http, or a recognized editor or workspace deep-link scheme: vscode, vscode-insiders, cursor, windsurf, zed, jetbrains, idea, slack, linear, notion, figma.", "type": "string" }, "label": { "description": "Badge text. {name} placeholders filled from named capture groups; defaults to the full match.", "type": "string" } }, "required": [ "type", "pattern", "url" ], "additionalProperties": {} }, { "type": "object", "properties": { "type": { "description": "Config variant discriminator for entries this client does not understand; the entry is preserved as-is and skipped at runtime.", "type": "string" } }, "required": [ "type" ], "additionalProperties": {} } ] } }, "subagentStatusLine": { "description": "Custom per-subagent status line shown in the agent panel; receives row context as JSON on stdin", "type": "object", "properties": { "type": { "type": "string", "const": "command" }, "command": { "type": "string" } }, "required": [ "type", "command" ] }, "enabledPlugins": { "description": "Enabled plugins using plugin-id@marketplace-id format. Example: { \"formatter@anthropic-tools\": true }. Also supports extended format with version constraints. Settings precedence is user < project < local < flag < policy, so to disable a plugin that project settings enable, set it to false in .claude/settings.local.json — setting false in ~/.claude/settings.json is overridden by the project.", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "boolean" }, { "not": {} } ] } }, "extraKnownMarketplaces": { "description": "Additional marketplaces to make available for this repository. Typically used in repository .claude/settings.json to ensure team members have required plugin sources.", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "properties": { "source": { "description": "Where to fetch the marketplace from", "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "const": "url" }, "url": { "description": "Direct URL to marketplace.json file", "type": "string", "format": "uri" }, "headers": { "description": "Custom HTTP headers (e.g., for authentication)", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "github" }, "repo": { "description": "GitHub repository in owner/repo format", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "path": { "description": "Path to marketplace.json within repo (defaults to .claude-plugin/marketplace.json)", "type": "string" }, "sparsePaths": { "description": "Directories to include via git sparse-checkout (cone mode). Use for monorepos where the marketplace lives in a subdirectory. Example: [\".claude-plugin\", \"plugins\"]. If omitted, the full repository is cloned.", "type": "array", "items": { "type": "string" } }, "skipLfs": { "description": "Skip Git LFS smudge during clone and update (sets GIT_LFS_SKIP_SMUDGE=1) so LFS pointer files stay as pointers instead of downloading their content. Use for marketplaces hosted in repos with large LFS objects.", "type": "boolean" } }, "required": [ "source", "repo" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "git" }, "url": { "description": "Full git repository URL", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "path": { "description": "Path to marketplace.json within repo (defaults to .claude-plugin/marketplace.json)", "type": "string" }, "sparsePaths": { "description": "Directories to include via git sparse-checkout (cone mode). Use for monorepos where the marketplace lives in a subdirectory. Example: [\".claude-plugin\", \"plugins\"]. If omitted, the full repository is cloned.", "type": "array", "items": { "type": "string" } }, "skipLfs": { "description": "Skip Git LFS smudge during clone and update (sets GIT_LFS_SKIP_SMUDGE=1) so LFS pointer files stay as pointers instead of downloading their content. Use for marketplaces hosted in repos with large LFS objects.", "type": "boolean" } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "npm" }, "package": { "description": "NPM package containing marketplace.json", "type": "string" } }, "required": [ "source", "package" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "file" }, "path": { "description": "Local file path to marketplace.json", "type": "string" } }, "required": [ "source", "path" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "directory" }, "path": { "description": "Local directory containing .claude-plugin/marketplace.json", "type": "string" } }, "required": [ "source", "path" ] }, { "description": "Policy-list sentinel for the ~/.claude/skills/ auto-load (@skills-dir plugins). In strictKnownMarketplaces: opt the scan back IN (by default any allowlist blocks it). In blockedMarketplaces: turn the scan OFF without otherwise restricting marketplaces. Only meaningful in those two managed-settings lists (areLocalPluginDirsAllowedByPolicy); known_marketplaces.json / marketplace add etc. ignore it.", "type": "object", "properties": { "source": { "type": "string", "const": "skills-dir" } }, "required": [ "source" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "hostPattern" }, "hostPattern": { "description": "Regex pattern to match the host/domain extracted from any marketplace source type. For github sources, matches against github.com. For git sources (SSH or HTTPS), extracts the hostname from the URL. Use in strictKnownMarketplaces to allow all marketplaces from a specific host (e.g., \"^github\\.mycompany\\.com$\").", "type": "string" } }, "required": [ "source", "hostPattern" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "pathPattern" }, "pathPattern": { "description": "Regex pattern matched against the .path field of file and directory sources. Use in strictKnownMarketplaces to allow filesystem-based marketplaces alongside hostPattern restrictions for network sources. Use \".*\" to allow all filesystem paths, or a narrower pattern (e.g., \"^/opt/approved/\") to restrict to specific directories.", "type": "string" } }, "required": [ "source", "pathPattern" ] }, { "description": "Inline marketplace manifest defined directly in settings.json. The reconciler writes a synthetic marketplace.json to the cache; diffMarketplaces detects edits via isEqual on the stored source (the plugins array is inside this object, so edits surface as sourceChanged).", "type": "object", "properties": { "source": { "type": "string", "const": "settings" }, "name": { "description": "Marketplace name. Must match the extraKnownMarketplaces key (enforced); the synthetic manifest is written under this name. Same validation as PluginMarketplaceSchema plus reserved-name rejection — validateOfficialNameSource runs after the disk write, too late to clean up.", "type": "string", "minLength": 1 }, "plugins": { "description": "Plugin entries declared inline in settings.json", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "Plugin name as it appears in the target repository", "type": "string", "minLength": 1 }, "source": { "description": "Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.", "anyOf": [ { "description": "Path to the plugin root, relative to the marketplace root (the directory containing .claude-plugin/, not .claude-plugin/ itself)", "type": "string", "pattern": "^\\.\\/.*" }, { "description": "NPM package as plugin source", "type": "object", "properties": { "source": { "type": "string", "const": "npm" }, "package": { "description": "Package name (or url, or local path, or anything else that can be passed to `npm` as a package)", "anyOf": [ { "type": "string" }, { "type": "string" } ] }, "version": { "description": "Specific version or version range (e.g., ^1.0.0, ~2.1.0)", "type": "string" }, "registry": { "description": "Custom NPM registry URL (defaults to using system default, likely npmjs.org)", "type": "string", "format": "uri" } }, "required": [ "source", "package" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "url" }, "url": { "description": "Full git repository URL (https:// or git@)", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "github" }, "repo": { "description": "GitHub repository in owner/repo format", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "repo" ] }, { "description": "Plugin located in a subdirectory of a larger repository (monorepo). Only the specified subdirectory is materialized; the rest of the repo is not downloaded.", "type": "object", "properties": { "source": { "type": "string", "const": "git-subdir" }, "url": { "description": "Git repository: GitHub owner/repo shorthand, https://, or git@ URL", "type": "string" }, "path": { "description": "Subdirectory within the repo containing the plugin (e.g., \"tools/claude-plugin\"). Cloned sparsely using partial clone (--filter=tree:0) to minimize bandwidth for monorepos.", "type": "string", "minLength": 1 }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "url", "path" ] }, { "description": "Placeholder for source types this Claude Code version does not recognize. Never authored by hand — PluginMarketplaceSchema rewrites unparseable sources to this so the entry remains in marketplace.plugins (detectDelistedPlugins must not see it as removed). Install attempts fail at cachePlugin with a clear \"update Claude Code\" message.", "type": "object", "properties": { "source": { "type": "string", "const": "unsupported" } }, "required": [ "source" ] } ] }, "description": { "type": "string" }, "version": { "type": "string" }, "strict": { "type": "boolean" } }, "required": [ "name", "source" ] } }, "owner": { "type": "object", "properties": { "name": { "description": "Display name of the plugin author or organization", "type": "string", "minLength": 1 }, "email": { "description": "Contact email for support or feedback", "type": "string" }, "url": { "description": "Website, GitHub profile, or organization URL", "type": "string" } }, "required": [ "name" ] } }, "required": [ "source", "name", "plugins" ] } ] }, "installLocation": { "description": "Local cache path where marketplace manifest is stored (auto-generated if not provided)", "type": "string" }, "autoUpdate": { "description": "Whether to automatically update this marketplace and its installed plugins on startup", "type": "boolean" } }, "required": [ "source" ] } }, "strictKnownMarketplaces": { "description": "Enterprise strict list of allowed marketplace sources. When set in managed settings, ONLY these exact sources can be added as marketplaces. The check happens BEFORE downloading, so blocked sources never touch the filesystem. Note: this is a policy gate only — it does NOT register marketplaces. To pre-register allowed marketplaces for users, also set extraKnownMarketplaces.", "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "const": "url" }, "url": { "description": "Direct URL to marketplace.json file", "type": "string", "format": "uri" }, "headers": { "description": "Custom HTTP headers (e.g., for authentication)", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "github" }, "repo": { "description": "GitHub repository in owner/repo format", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "path": { "description": "Path to marketplace.json within repo (defaults to .claude-plugin/marketplace.json)", "type": "string" }, "sparsePaths": { "description": "Directories to include via git sparse-checkout (cone mode). Use for monorepos where the marketplace lives in a subdirectory. Example: [\".claude-plugin\", \"plugins\"]. If omitted, the full repository is cloned.", "type": "array", "items": { "type": "string" } }, "skipLfs": { "description": "Skip Git LFS smudge during clone and update (sets GIT_LFS_SKIP_SMUDGE=1) so LFS pointer files stay as pointers instead of downloading their content. Use for marketplaces hosted in repos with large LFS objects.", "type": "boolean" } }, "required": [ "source", "repo" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "git" }, "url": { "description": "Full git repository URL", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "path": { "description": "Path to marketplace.json within repo (defaults to .claude-plugin/marketplace.json)", "type": "string" }, "sparsePaths": { "description": "Directories to include via git sparse-checkout (cone mode). Use for monorepos where the marketplace lives in a subdirectory. Example: [\".claude-plugin\", \"plugins\"]. If omitted, the full repository is cloned.", "type": "array", "items": { "type": "string" } }, "skipLfs": { "description": "Skip Git LFS smudge during clone and update (sets GIT_LFS_SKIP_SMUDGE=1) so LFS pointer files stay as pointers instead of downloading their content. Use for marketplaces hosted in repos with large LFS objects.", "type": "boolean" } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "npm" }, "package": { "description": "NPM package containing marketplace.json", "type": "string" } }, "required": [ "source", "package" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "file" }, "path": { "description": "Local file path to marketplace.json", "type": "string" } }, "required": [ "source", "path" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "directory" }, "path": { "description": "Local directory containing .claude-plugin/marketplace.json", "type": "string" } }, "required": [ "source", "path" ] }, { "description": "Policy-list sentinel for the ~/.claude/skills/ auto-load (@skills-dir plugins). In strictKnownMarketplaces: opt the scan back IN (by default any allowlist blocks it). In blockedMarketplaces: turn the scan OFF without otherwise restricting marketplaces. Only meaningful in those two managed-settings lists (areLocalPluginDirsAllowedByPolicy); known_marketplaces.json / marketplace add etc. ignore it.", "type": "object", "properties": { "source": { "type": "string", "const": "skills-dir" } }, "required": [ "source" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "hostPattern" }, "hostPattern": { "description": "Regex pattern to match the host/domain extracted from any marketplace source type. For github sources, matches against github.com. For git sources (SSH or HTTPS), extracts the hostname from the URL. Use in strictKnownMarketplaces to allow all marketplaces from a specific host (e.g., \"^github\\.mycompany\\.com$\").", "type": "string" } }, "required": [ "source", "hostPattern" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "pathPattern" }, "pathPattern": { "description": "Regex pattern matched against the .path field of file and directory sources. Use in strictKnownMarketplaces to allow filesystem-based marketplaces alongside hostPattern restrictions for network sources. Use \".*\" to allow all filesystem paths, or a narrower pattern (e.g., \"^/opt/approved/\") to restrict to specific directories.", "type": "string" } }, "required": [ "source", "pathPattern" ] }, { "description": "Inline marketplace manifest defined directly in settings.json. The reconciler writes a synthetic marketplace.json to the cache; diffMarketplaces detects edits via isEqual on the stored source (the plugins array is inside this object, so edits surface as sourceChanged).", "type": "object", "properties": { "source": { "type": "string", "const": "settings" }, "name": { "description": "Marketplace name. Must match the extraKnownMarketplaces key (enforced); the synthetic manifest is written under this name. Same validation as PluginMarketplaceSchema plus reserved-name rejection — validateOfficialNameSource runs after the disk write, too late to clean up.", "type": "string", "minLength": 1 }, "plugins": { "description": "Plugin entries declared inline in settings.json", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "Plugin name as it appears in the target repository", "type": "string", "minLength": 1 }, "source": { "description": "Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.", "anyOf": [ { "description": "Path to the plugin root, relative to the marketplace root (the directory containing .claude-plugin/, not .claude-plugin/ itself)", "type": "string", "pattern": "^\\.\\/.*" }, { "description": "NPM package as plugin source", "type": "object", "properties": { "source": { "type": "string", "const": "npm" }, "package": { "description": "Package name (or url, or local path, or anything else that can be passed to `npm` as a package)", "anyOf": [ { "type": "string" }, { "type": "string" } ] }, "version": { "description": "Specific version or version range (e.g., ^1.0.0, ~2.1.0)", "type": "string" }, "registry": { "description": "Custom NPM registry URL (defaults to using system default, likely npmjs.org)", "type": "string", "format": "uri" } }, "required": [ "source", "package" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "url" }, "url": { "description": "Full git repository URL (https:// or git@)", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "github" }, "repo": { "description": "GitHub repository in owner/repo format", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "repo" ] }, { "description": "Plugin located in a subdirectory of a larger repository (monorepo). Only the specified subdirectory is materialized; the rest of the repo is not downloaded.", "type": "object", "properties": { "source": { "type": "string", "const": "git-subdir" }, "url": { "description": "Git repository: GitHub owner/repo shorthand, https://, or git@ URL", "type": "string" }, "path": { "description": "Subdirectory within the repo containing the plugin (e.g., \"tools/claude-plugin\"). Cloned sparsely using partial clone (--filter=tree:0) to minimize bandwidth for monorepos.", "type": "string", "minLength": 1 }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "url", "path" ] }, { "description": "Placeholder for source types this Claude Code version does not recognize. Never authored by hand — PluginMarketplaceSchema rewrites unparseable sources to this so the entry remains in marketplace.plugins (detectDelistedPlugins must not see it as removed). Install attempts fail at cachePlugin with a clear \"update Claude Code\" message.", "type": "object", "properties": { "source": { "type": "string", "const": "unsupported" } }, "required": [ "source" ] } ] }, "description": { "type": "string" }, "version": { "type": "string" }, "strict": { "type": "boolean" } }, "required": [ "name", "source" ] } }, "owner": { "type": "object", "properties": { "name": { "description": "Display name of the plugin author or organization", "type": "string", "minLength": 1 }, "email": { "description": "Contact email for support or feedback", "type": "string" }, "url": { "description": "Website, GitHub profile, or organization URL", "type": "string" } }, "required": [ "name" ] } }, "required": [ "source", "name", "plugins" ] } ] } }, "blockedMarketplaces": { "description": "Enterprise blocklist of marketplace sources. When set in managed settings, these exact sources are blocked from being added as marketplaces. The check happens BEFORE downloading, so blocked sources never touch the filesystem.", "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "const": "url" }, "url": { "description": "Direct URL to marketplace.json file", "type": "string", "format": "uri" }, "headers": { "description": "Custom HTTP headers (e.g., for authentication)", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "github" }, "repo": { "description": "GitHub repository in owner/repo format", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "path": { "description": "Path to marketplace.json within repo (defaults to .claude-plugin/marketplace.json)", "type": "string" }, "sparsePaths": { "description": "Directories to include via git sparse-checkout (cone mode). Use for monorepos where the marketplace lives in a subdirectory. Example: [\".claude-plugin\", \"plugins\"]. If omitted, the full repository is cloned.", "type": "array", "items": { "type": "string" } }, "skipLfs": { "description": "Skip Git LFS smudge during clone and update (sets GIT_LFS_SKIP_SMUDGE=1) so LFS pointer files stay as pointers instead of downloading their content. Use for marketplaces hosted in repos with large LFS objects.", "type": "boolean" } }, "required": [ "source", "repo" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "git" }, "url": { "description": "Full git repository URL", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "path": { "description": "Path to marketplace.json within repo (defaults to .claude-plugin/marketplace.json)", "type": "string" }, "sparsePaths": { "description": "Directories to include via git sparse-checkout (cone mode). Use for monorepos where the marketplace lives in a subdirectory. Example: [\".claude-plugin\", \"plugins\"]. If omitted, the full repository is cloned.", "type": "array", "items": { "type": "string" } }, "skipLfs": { "description": "Skip Git LFS smudge during clone and update (sets GIT_LFS_SKIP_SMUDGE=1) so LFS pointer files stay as pointers instead of downloading their content. Use for marketplaces hosted in repos with large LFS objects.", "type": "boolean" } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "npm" }, "package": { "description": "NPM package containing marketplace.json", "type": "string" } }, "required": [ "source", "package" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "file" }, "path": { "description": "Local file path to marketplace.json", "type": "string" } }, "required": [ "source", "path" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "directory" }, "path": { "description": "Local directory containing .claude-plugin/marketplace.json", "type": "string" } }, "required": [ "source", "path" ] }, { "description": "Policy-list sentinel for the ~/.claude/skills/ auto-load (@skills-dir plugins). In strictKnownMarketplaces: opt the scan back IN (by default any allowlist blocks it). In blockedMarketplaces: turn the scan OFF without otherwise restricting marketplaces. Only meaningful in those two managed-settings lists (areLocalPluginDirsAllowedByPolicy); known_marketplaces.json / marketplace add etc. ignore it.", "type": "object", "properties": { "source": { "type": "string", "const": "skills-dir" } }, "required": [ "source" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "hostPattern" }, "hostPattern": { "description": "Regex pattern to match the host/domain extracted from any marketplace source type. For github sources, matches against github.com. For git sources (SSH or HTTPS), extracts the hostname from the URL. Use in strictKnownMarketplaces to allow all marketplaces from a specific host (e.g., \"^github\\.mycompany\\.com$\").", "type": "string" } }, "required": [ "source", "hostPattern" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "pathPattern" }, "pathPattern": { "description": "Regex pattern matched against the .path field of file and directory sources. Use in strictKnownMarketplaces to allow filesystem-based marketplaces alongside hostPattern restrictions for network sources. Use \".*\" to allow all filesystem paths, or a narrower pattern (e.g., \"^/opt/approved/\") to restrict to specific directories.", "type": "string" } }, "required": [ "source", "pathPattern" ] }, { "description": "Inline marketplace manifest defined directly in settings.json. The reconciler writes a synthetic marketplace.json to the cache; diffMarketplaces detects edits via isEqual on the stored source (the plugins array is inside this object, so edits surface as sourceChanged).", "type": "object", "properties": { "source": { "type": "string", "const": "settings" }, "name": { "description": "Marketplace name. Must match the extraKnownMarketplaces key (enforced); the synthetic manifest is written under this name. Same validation as PluginMarketplaceSchema plus reserved-name rejection — validateOfficialNameSource runs after the disk write, too late to clean up.", "type": "string", "minLength": 1 }, "plugins": { "description": "Plugin entries declared inline in settings.json", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "Plugin name as it appears in the target repository", "type": "string", "minLength": 1 }, "source": { "description": "Where to fetch the plugin from. Must be a remote source — relative paths have no marketplace repository to resolve against.", "anyOf": [ { "description": "Path to the plugin root, relative to the marketplace root (the directory containing .claude-plugin/, not .claude-plugin/ itself)", "type": "string", "pattern": "^\\.\\/.*" }, { "description": "NPM package as plugin source", "type": "object", "properties": { "source": { "type": "string", "const": "npm" }, "package": { "description": "Package name (or url, or local path, or anything else that can be passed to `npm` as a package)", "anyOf": [ { "type": "string" }, { "type": "string" } ] }, "version": { "description": "Specific version or version range (e.g., ^1.0.0, ~2.1.0)", "type": "string" }, "registry": { "description": "Custom NPM registry URL (defaults to using system default, likely npmjs.org)", "type": "string", "format": "uri" } }, "required": [ "source", "package" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "url" }, "url": { "description": "Full git repository URL (https:// or git@)", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "github" }, "repo": { "description": "GitHub repository in owner/repo format", "type": "string" }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "repo" ] }, { "description": "Plugin located in a subdirectory of a larger repository (monorepo). Only the specified subdirectory is materialized; the rest of the repo is not downloaded.", "type": "object", "properties": { "source": { "type": "string", "const": "git-subdir" }, "url": { "description": "Git repository: GitHub owner/repo shorthand, https://, or git@ URL", "type": "string" }, "path": { "description": "Subdirectory within the repo containing the plugin (e.g., \"tools/claude-plugin\"). Cloned sparsely using partial clone (--filter=tree:0) to minimize bandwidth for monorepos.", "type": "string", "minLength": 1 }, "ref": { "description": "Git branch or tag to use (e.g., \"main\", \"v1.0.0\"). Defaults to repository default branch.", "type": "string" }, "sha": { "description": "Specific commit SHA to use", "type": "string", "minLength": 40, "maxLength": 40, "pattern": "^[a-f0-9]{40}$" } }, "required": [ "source", "url", "path" ] }, { "description": "Placeholder for source types this Claude Code version does not recognize. Never authored by hand — PluginMarketplaceSchema rewrites unparseable sources to this so the entry remains in marketplace.plugins (detectDelistedPlugins must not see it as removed). Install attempts fail at cachePlugin with a clear \"update Claude Code\" message.", "type": "object", "properties": { "source": { "type": "string", "const": "unsupported" } }, "required": [ "source" ] } ] }, "description": { "type": "string" }, "version": { "type": "string" }, "strict": { "type": "boolean" } }, "required": [ "name", "source" ] } }, "owner": { "type": "object", "properties": { "name": { "description": "Display name of the plugin author or organization", "type": "string", "minLength": 1 }, "email": { "description": "Contact email for support or feedback", "type": "string" }, "url": { "description": "Website, GitHub profile, or organization URL", "type": "string" } }, "required": [ "name" ] } }, "required": [ "source", "name", "plugins" ] } ] } }, "disableSideloadFlags": { "description": "When true (and set in managed settings), rejects the --plugin-dir, --plugin-url, --agents, and non-sdk --mcp-config CLI flags at startup. Closes the CLI-flag bypass of strictKnownMarketplaces. Pair with allowedMcpServers for per-server MCP control; this setting does not gate other MCP entry points (SDK setMcpServers, claude mcp add, .mcp.json). Also blocks surfaces that spawn the CLI with these flags internally (see settings documentation). Only honored from managed settings; ignored in user/project/local settings.", "type": "boolean" }, "pluginSuggestionMarketplaces": { "description": "Marketplace names whose plugins may surface as contextual install suggestions (relevance-based tips). No marketplace-declared suggestions surface without this allowlist; the built-in first-party frontend-design tip is unaffected. Only honored when set in managed settings (policy scope); the key is ignored in user, project, and local settings. A name only takes effect when the marketplace is registered on the machine AND its registered source is also declared in managed settings, either as the extraKnownMarketplaces entry for that name or as an entry of strictKnownMarketplaces. A marketplace registered from a different source under an allowlisted name is ignored. The official marketplace is exempt from the source requirement: allowlisting its name alone suffices, since that name can only register from the official Anthropic source.", "type": "array", "items": { "type": "string" } }, "forceLoginMethod": { "description": "Force a specific login method: \"claudeai\" for Claude Pro/Max, \"console\" for Console billing, \"gateway\" for the Cloud gateway OIDC device flow", "type": "string", "enum": [ "claudeai", "console", "gateway" ] }, "parentSettingsBehavior": { "description": "Controls whether the SDK parent tier (Options.managedSettings / --managed-settings) layers under this admin tier. \"first-wins\" (default): parent is dropped — admin tiers are the only policy source. \"merge\": parent's restrictive-only-filtered settings union under the admin winner. Has no effect when no admin tier exists (parent applies as the sole policy tier, still filtered restrictive-only).", "type": "string", "enum": [ "first-wins", "merge" ] }, "forceLoginOrgUUID": { "description": "Organization UUID to require for OAuth login. Accepts a single UUID string or an array of UUIDs (any one is permitted). When set in managed settings, login fails if the authenticated account does not belong to a listed organization.", "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "forceRemoteSettingsRefresh": { "description": "When set in managed settings, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails", "type": "boolean" }, "otelHeadersHelper": { "description": "Path to a script that outputs OpenTelemetry headers", "type": "string" }, "outputStyle": { "description": "Controls the output style for assistant responses", "type": "string" }, "viewMode": { "description": "Default transcript view mode on startup", "type": "string", "enum": [ "default", "verbose", "focus" ] }, "language": { "description": "Preferred language for Claude responses and voice dictation (e.g., \"japanese\", \"spanish\")", "type": "string" }, "skipWebFetchPreflight": { "description": "Skip the WebFetch blocklist check for enterprise environments with restrictive security policies", "type": "boolean" }, "sandbox": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "failIfUnavailable": { "description": "Exit with an error at startup if sandbox.enabled is true but the sandbox cannot start (missing dependencies or unsupported platform). When false (default), a warning is shown and commands run unsandboxed. Intended for managed-settings deployments that require sandboxing as a hard gate.", "type": "boolean" }, "autoAllowBashIfSandboxed": { "type": "boolean" }, "allowUnsandboxedCommands": { "description": "Allow commands to run outside the sandbox via the dangerouslyDisableSandbox parameter. When false, the dangerouslyDisableSandbox parameter is completely ignored and all commands must run sandboxed. Default: true.", "type": "boolean" }, "network": { "type": "object", "properties": { "allowedDomains": { "type": "array", "items": { "type": "string" } }, "deniedDomains": { "description": "Domains that are always blocked, even if matched by allowedDomains. Supports the same wildcard syntax as allowedDomains. Merged from all settings sources regardless of allowManagedDomainsOnly.", "type": "array", "items": { "type": "string" } }, "allowManagedDomainsOnly": { "description": "When true (and set in managed settings), only allowedDomains and WebFetch(domain:...) allow rules from managed settings are respected. User, project, local, and flag settings domains are ignored. Denied domains are still respected from all sources.", "type": "boolean" }, "allowUnixSockets": { "description": "macOS only: Unix socket paths to allow. Ignored on Linux (seccomp cannot filter by path).", "type": "array", "items": { "type": "string" } }, "allowAllUnixSockets": { "description": "If true, allow all Unix sockets (disables blocking on both platforms).", "type": "boolean" }, "allowLocalBinding": { "type": "boolean" }, "allowMachLookup": { "description": "macOS only: Additional XPC/Mach service names to allow looking up. Supports trailing-wildcard prefix matching (e.g., \"com.apple.coresimulator.*\"). Needed for tools that communicate via XPC such as the iOS Simulator or Playwright.", "type": "array", "items": { "type": "string" } }, "httpProxyPort": { "type": "number" }, "socksProxyPort": { "type": "number" }, "tlsTerminate": { "description": "[EXPERIMENTAL] Enable in-process TLS termination so the per-request filter can see HTTPS request bodies. Provide a CA cert+key, or omit both to have sandbox-runtime generate an ephemeral one for the session. Only honored from user, managed/policy, or CLI (`--settings`) settings — project settings (.claude/settings.json and .claude/settings.local.json) are ignored.", "type": "object", "properties": { "caCertPath": { "type": "string", "minLength": 1 }, "caKeyPath": { "type": "string", "minLength": 1 } } } } }, "filesystem": { "type": "object", "properties": { "allowWrite": { "description": "Additional paths to allow writing within the sandbox. Merged with paths from Edit(...) allow permission rules.", "type": "array", "items": { "type": "string" } }, "denyWrite": { "description": "Additional paths to deny writing within the sandbox. Merged with paths from Edit(...) deny permission rules.", "type": "array", "items": { "type": "string" } }, "denyRead": { "description": "Additional paths to deny reading within the sandbox. Merged with paths from Read(...) deny permission rules.", "type": "array", "items": { "type": "string" } }, "allowRead": { "description": "Paths to re-allow reading within denyRead regions. Takes precedence over denyRead for matching paths.", "type": "array", "items": { "type": "string" } }, "allowManagedReadPathsOnly": { "description": "When true (set in managed settings), only allowRead paths from policySettings are used.", "type": "boolean" } } }, "credentials": { "type": "object", "properties": { "files": { "description": "Credential files or directories to protect. `deny` blocks reads inside the sandbox.", "type": "array", "items": { "type": "object", "properties": { "path": { "description": "Path to a credential file or directory. Same resolution as sandbox.filesystem.* paths: absolute, ~ expanded, or relative to the settings file root (project root for project settings, ~/.claude for user settings).", "type": "string", "minLength": 1 }, "mode": { "description": "Access mode for this path. Only `deny` is supported.", "type": "string", "const": "deny" } }, "required": [ "path", "mode" ] } }, "envVars": { "description": "Environment variables to protect. `deny` unsets the variable for sandboxed commands; `mask` substitutes a sentinel inside the sandbox and injects the real value at the proxy.", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "Environment variable name.", "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" }, "mode": { "description": "Access mode for this environment variable. `deny` unsets the variable for sandboxed commands; `mask` shows sandboxed commands a sentinel value and the host proxy swaps sentinel→real on egress to `injectHosts`.", "type": "string", "enum": [ "deny", "mask" ] }, "injectHosts": { "description": "Optional narrowing of where the proxy substitutes this credential. Only meaningful when mode is `mask`; accepted but ignored for `deny`. If unset, defaults to `network.allowedDomains` — the credential is injected at every reachable host. Each entry must be reachable via `network.allowedDomains` (sandbox-runtime validates this).", "type": "array", "items": { "type": "string" } } }, "required": [ "name", "mode" ] } }, "allowPlaintextInject": { "description": "Allow sentinel→real substitution on the plain-HTTP proxy path. Defaults to false: without TLS termination the upstream identity is unverified and the credential travels in cleartext. Set only for trusted-network test fixtures. Only honored from user, managed/policy, or CLI (`--settings`) settings — project settings (.claude/settings.json and .claude/settings.local.json) are ignored.", "type": "boolean" } } }, "ignoreViolations": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "enableWeakerNestedSandbox": { "type": "boolean" }, "enableWeakerNetworkIsolation": { "description": "macOS only: Allow access to com.apple.trustd.agent in the sandbox. Needed for Go-based CLI tools (gh, gcloud, terraform, etc.) to verify TLS certificates when using httpProxyPort with a MITM proxy and custom CA. **Reduces security** — opens a potential data exfiltration vector through the trustd service. Default: false", "type": "boolean" }, "allowAppleEvents": { "description": "macOS only: Allow sandboxed commands to send Apple Events (and look up the appleeventsd Mach service). Needed for `open`, `osascript`, and browser-based auth flows that open URLs. **Removes code-execution isolation** — sandboxed commands can launch other applications unsandboxed with no user prompt, and can script running apps (e.g. Terminal) subject to the user's per-app TCC automation consent. Only honored from user, managed/policy, or CLI (--settings) settings — project settings (.claude/settings.json and .claude/settings.local.json) are ignored. Default: false", "type": "boolean" }, "excludedCommands": { "type": "array", "items": { "type": "string" } }, "ripgrep": { "description": "Custom ripgrep configuration for bundled ripgrep support", "type": "object", "properties": { "command": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } } }, "required": [ "command" ] }, "bwrapPath": { "description": "Linux/WSL only: Absolute path to the bwrap (bubblewrap) binary. Overrides auto-detection via PATH. Only honored from admin-controlled managed settings.", "type": "string" }, "socatPath": { "description": "Linux/WSL only: Absolute path to the socat binary used for the sandbox network proxy. Overrides auto-detection via PATH. Only honored from admin-controlled managed settings.", "type": "string" } }, "additionalProperties": {} }, "feedbackSurveyRate": { "description": "Probability (0–1) that the session quality survey appears when eligible. 0.05 is a reasonable starting point.", "type": "number", "minimum": 0, "maximum": 1 }, "spinnerTipsEnabled": { "description": "Whether to show tips in the spinner", "type": "boolean" }, "spinnerVerbs": { "description": "Customize spinner verbs. mode: \"append\" adds verbs to defaults, \"replace\" uses only your verbs.", "type": "object", "properties": { "mode": { "type": "string", "enum": [ "append", "replace" ] }, "verbs": { "type": "array", "items": { "type": "string" } } }, "required": [ "mode", "verbs" ] }, "spinnerTipsOverride": { "description": "Override spinner tips. tips: array of tip strings. excludeDefault: if true, only show custom tips (default: false).", "type": "object", "properties": { "excludeDefault": { "type": "boolean" }, "tips": { "type": "array", "items": { "type": "string" } } }, "required": [ "tips" ] }, "syntaxHighlightingDisabled": { "description": "Whether to disable syntax highlighting in diffs", "type": "boolean" }, "terminalTitleFromRename": { "description": "Whether /rename updates the terminal tab title (defaults to true). Set to false to keep auto-generated topic titles.", "type": "boolean" }, "alwaysThinkingEnabled": { "description": "When false, thinking is disabled. When absent or true, thinking is enabled automatically for supported models.", "type": "boolean" }, "effortLevel": { "description": "Persisted effort level for supported models.", "type": "string", "enum": [ "low", "medium", "high", "xhigh" ] }, "ultracode": { "description": "Enable ultracode for the session: xhigh effort plus standing dynamic-workflow orchestration. Session-scoped — typically provided via --settings or the apply_flag_settings control request; interactive toggles never persist it. Requires workflows to be enabled and an xhigh-capable model.", "type": "boolean" }, "autoCompactWindow": { "description": "Auto-compact window size", "type": "integer", "minimum": 100000, "maximum": 1000000 }, "advisorModel": { "description": "Advisor model for the server-side advisor tool.", "type": "string" }, "fastMode": { "description": "When true, fast mode is enabled. When absent or false, fast mode is off.", "type": "boolean" }, "fastModePerSessionOptIn": { "description": "When true, fast mode does not persist across sessions. Each session starts with fast mode off.", "type": "boolean" }, "promptSuggestionEnabled": { "description": "When false, prompt suggestions are disabled. When absent or true, prompt suggestions are enabled.", "type": "boolean" }, "showClearContextOnPlanAccept": { "description": "When true, the plan-approval dialog offers a \"clear context\" option. Defaults to false.", "type": "boolean" }, "askUserQuestionTimeout": { "description": "Idle time before Claude's questions auto-continue with any answers selected so far. Defaults to never — auto-continue only runs when explicitly set to 60s/5m/10m.", "type": "string", "enum": [ "60s", "5m", "10m", "never" ] }, "agent": { "description": "Name of an agent (built-in or custom) to use for the main thread. Applies the agent's system prompt, tool restrictions, and model.", "type": "string" }, "companyAnnouncements": { "description": "Company announcements to display at startup (one will be randomly selected if multiple are provided)", "type": "array", "items": { "type": "string" } }, "pluginConfigs": { "description": "Per-plugin configuration including MCP server user configs, keyed by plugin ID (plugin@marketplace format)", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "mcpServers": { "description": "User configuration values for MCP servers keyed by server name", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] } } }, "options": { "description": "Non-sensitive option values from plugin manifest userConfig, keyed by option name. Sensitive values go to secure storage instead.", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "array", "items": { "type": "string" } } ] } } } }, { "not": {} } ] } }, "remote": { "description": "Cloud session configuration", "type": "object", "properties": { "defaultEnvironmentId": { "description": "Default environment ID to use for cloud sessions", "type": "string" } } }, "autoUpdatesChannel": { "description": "Release channel for auto-updates (latest or stable)", "type": "string", "enum": [ "latest", "stable", "rc" ] }, "minimumVersion": { "description": "Minimum version to stay on - prevents downgrades when switching to stable channel", "type": "string" }, "requiredMinimumVersion": { "description": "Minimum Claude Code version required to start. If the running version is older, Claude Code exits at startup with instructions to update. Only enforced from managed (policy) settings.", "type": "string" }, "requiredMaximumVersion": { "description": "Maximum Claude Code version allowed to start. If the running version is newer, Claude Code exits at startup with instructions to install an approved version. Only enforced from managed (policy) settings.", "type": "string" }, "plansDirectory": { "description": "Custom directory for plan files, relative to project root. If not set, defaults to ~/.claude/plans/", "type": "string" }, "tui": { "description": "Terminal UI renderer. \"fullscreen\" uses the flicker-free alt-screen renderer with virtualized scrollback (equivalent to CLAUDE_CODE_NO_FLICKER=1). \"default\" uses the classic main-screen renderer.", "type": "string", "enum": [ "default", "fullscreen" ] }, "voice": { "description": "Voice mode settings (hold-to-talk / tap-to-toggle dictation)", "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "description": "'hold' (default): hold to talk. 'tap': tap to start, tap to stop+submit.", "type": "string", "enum": [ "hold", "tap" ] }, "autoSubmit": { "description": "Submit the prompt when hold-to-talk is released (hold mode only)", "type": "boolean" } } }, "channelsEnabled": { "description": "Managed-org opt-in for channel notifications (MCP servers with the claude/channel capability pushing inbound messages). claude.ai Teams/Enterprise: default off. Console: default on unless managed settings exist. Set true to allow; users then select servers via --channels.", "type": "boolean" }, "allowedChannelPlugins": { "description": "Managed-org allowlist of channel plugins. When set, replaces the default Anthropic allowlist — admins decide which plugins may push inbound messages. Undefined falls back to the default. Requires channelsEnabled: true.", "type": "array", "items": { "type": "object", "properties": { "marketplace": { "type": "string" }, "plugin": { "type": "string" } }, "required": [ "marketplace", "plugin" ] } }, "prefersReducedMotion": { "description": "Reduce or disable animations for accessibility (spinner shimmer, flash effects, etc.)", "type": "boolean" }, "autoMemoryEnabled": { "description": "Enable auto-memory for this project. When false, Claude will not read from or write to the auto-memory directory.", "type": "boolean" }, "autoMemoryDirectory": { "description": "Custom directory path for auto-memory storage. Supports ~/ prefix for home directory expansion. Ignored if set in projectSettings (checked-in .claude/settings.json) for security. When unset, defaults to ~/.claude/projects//memory/.", "type": "string" }, "autoDreamEnabled": { "description": "Enable background memory consolidation (auto-dream). When set, overrides the server-side default.", "type": "boolean" }, "showThinkingSummaries": { "description": "Request API-side thinking summaries and show them in the conversation and in the transcript view (ctrl+o). Set explicitly to override the default for your install.", "type": "boolean" }, "skipDangerousModePermissionPrompt": { "description": "Whether the user has accepted the bypass permissions mode dialog", "type": "boolean" }, "disableAutoMode": { "description": "Disable auto mode", "type": "string", "enum": [ "disable" ] }, "sshConfigs": { "description": "SSH connection configurations for remote environments. Typically set in managed settings by enterprise administrators to pre-configure SSH connections for team members.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "Unique identifier for this SSH config. Used to match configs across settings sources.", "type": "string" }, "name": { "description": "Display name for the SSH connection", "type": "string" }, "sshHost": { "description": "SSH host in format \"user@hostname\" or \"hostname\", or a host alias from ~/.ssh/config", "type": "string" }, "sshPort": { "description": "SSH port (default: 22)", "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "sshIdentityFile": { "description": "Path to SSH identity file (private key)", "type": "string" }, "startDirectory": { "description": "Default working directory on the remote host. Supports tilde expansion (e.g. ~/projects). If not specified, defaults to the remote user home directory. Can be overridden by the [dir] positional argument in `claude ssh [dir]`.", "type": "string" } }, "required": [ "id", "name", "sshHost" ] } }, "claudeMd": { "description": "CLAUDE.md-style instructions injected as organization-managed memory. Only honored from managed/policy settings.", "type": "string" }, "claudeMdExcludes": { "description": "Glob patterns or absolute paths of CLAUDE.md files to exclude from loading. Patterns are matched against absolute file paths using picomatch. Only applies to User, Project, and Local memory types (Managed/policy files cannot be excluded). Examples: \"/home/user/monorepo/CLAUDE.md\", \"**/code/CLAUDE.md\", \"**/some-dir/.claude/rules/**\"", "type": "array", "items": { "type": "string" } }, "pluginTrustMessage": { "description": "Custom message to append to the plugin trust warning shown before installation. Only read from policy settings (managed-settings.json / MDM). Useful for enterprise administrators to add organization-specific context (e.g., \"All plugins from our internal marketplace are vetted and approved.\").", "type": "string" }, "theme": { "description": "Color theme for the UI", "anyOf": [ { "type": "string", "enum": [ "auto", "dark", "light", "light-daltonized", "dark-daltonized", "light-ansi", "dark-ansi" ] }, { "type": "string", "pattern": "^custom:.*" } ] }, "editorMode": { "description": "Key binding mode for the prompt input", "type": "string", "enum": [ "normal", "vim" ] }, "verbose": { "description": "Show full tool output instead of truncated summaries", "type": "boolean" }, "preferredNotifChannel": { "description": "Preferred OS notification channel", "type": "string", "enum": [ "auto", "iterm2", "iterm2_with_bell", "terminal_bell", "kitty", "ghostty", "notifications_disabled" ] }, "autoCompactEnabled": { "description": "Automatically compact conversation when context fills", "type": "boolean" }, "switchModelsOnFlag": { "description": "When safety measures flag a message, automatically switch to a different model to keep chatting. When off, your session will pause instead.", "type": "boolean" }, "autoScrollEnabled": { "description": "Auto-scroll the conversation view to bottom (fullscreen mode only)", "type": "boolean" }, "wheelScrollAccelerationEnabled": { "description": "Ramp mouse-wheel scroll speed during fast scrolls (fullscreen mode only)", "type": "boolean" }, "fileCheckpointingEnabled": { "description": "Snapshot files before edits so /rewind can restore them", "type": "boolean" }, "showTurnDuration": { "description": "Show \"Cooked for Nm Ns\" after each assistant turn", "type": "boolean" }, "showMessageTimestamps": { "description": "Stamp each assistant message with its arrival time", "type": "boolean" }, "terminalProgressBarEnabled": { "description": "Emit OSC 9;4 progress sequences during long operations", "type": "boolean" }, "todoFeatureEnabled": { "description": "Enable the todo / task tracking panel", "type": "boolean" }, "teammateMode": { "description": "How spawned teammates execute (tmux, iterm2, in-process, auto)", "type": "string", "enum": [ "auto", "tmux", "iterm2", "in-process" ] }, "remoteControlAtStartup": { "description": "Start Remote Control bridge automatically each session", "type": "boolean" }, "isolatePeerMachines": { "description": "Require explicit approval before SendMessage can reach a peer session on another machine via Remote Control", "type": "boolean" }, "daemonColdStart": { "description": "When no background service is running: 'transient' spawns one for this login session; 'ask' offers to install it persistently", "type": "string", "enum": [ "transient", "ask" ] }, "autoUploadSessions": { "description": "Mirror local sessions to claude.ai as view-only (no remote control)", "type": "boolean" }, "inputNeededNotifEnabled": { "description": "Push to mobile when a permission prompt or question is waiting", "type": "boolean" }, "agentPushNotifEnabled": { "description": "Allow Claude to push proactive mobile notifications", "type": "boolean" }, "disableDeepLinkRegistration": { "description": "Prevent claude-cli:// protocol handler registration with the OS", "type": "string", "enum": [ "disable" ] }, "defaultView": { "description": "Default transcript view: chat (SendUserMessage checkpoints only) or transcript (full)", "type": "string", "enum": [ "chat", "transcript" ] } }, "additionalProperties": {}, "title": "Claude Code Settings", "description": "Configuration settings for Claude Code. Learn more: https://code.claude.com/docs/en/settings", "$comment": "Generated on 2026-07-07T02:09:25.788Z" }