{ "$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", "const": "https://json.schemastore.org/claude-code-settings.json" }, "apiKeyHelper": { "description": "Path to a script that outputs authentication values", "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" }, "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 }, "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" } } }, "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", "type": "string", "enum": [ "acceptEdits", "auto", "bypassPermissions", "default", "dontAsk", "plan" ] }, "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" }, "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" } }, "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" } }, "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", "pattern": "^[a-zA-Z0-9_-]+$" }, "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", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact", "PermissionRequest", "PermissionDenied", "Setup", "TeammateIdle", "TaskCreated", "TaskCompleted", "Elicitation", "ElicitationResult", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "InstructionsLoaded", "CwdChanged", "FileChanged" ] }, { "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" }, "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.", "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-4-6\"). If not specified, uses the default small fast model.", "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": "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-4-6\"). 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" ] } ] } } }, "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" } } } }, "disableAllHooks": { "description": "Disable all hooks and statusLine execution", "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" ] }, "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" }, "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" } }, "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.", "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" } } }, "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" } } }, "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" ] }, { "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" ] }, { "description": "Python package as plugin source", "type": "object", "properties": { "source": { "type": "string", "const": "pip" }, "package": { "description": "Python package name as it appears on PyPI", "type": "string" }, "version": { "description": "Version specifier (e.g., ==1.0.0, >=2.0.0, <3.0.0)", "type": "string" }, "registry": { "description": "Custom PyPI registry URL (defaults to using system default, likely pypi.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": { "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" } } }, "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" } } }, "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" ] }, { "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" ] }, { "description": "Python package as plugin source", "type": "object", "properties": { "source": { "type": "string", "const": "pip" }, "package": { "description": "Python package name as it appears on PyPI", "type": "string" }, "version": { "description": "Version specifier (e.g., ==1.0.0, >=2.0.0, <3.0.0)", "type": "string" }, "registry": { "description": "Custom PyPI registry URL (defaults to using system default, likely pypi.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": { "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" } } }, "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" } } }, "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" ] }, { "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" ] }, { "description": "Python package as plugin source", "type": "object", "properties": { "source": { "type": "string", "const": "pip" }, "package": { "description": "Python package name as it appears on PyPI", "type": "string" }, "version": { "description": "Version specifier (e.g., ==1.0.0, >=2.0.0, <3.0.0)", "type": "string" }, "registry": { "description": "Custom PyPI registry URL (defaults to using system default, likely pypi.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": { "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" ] } ] } }, "forceLoginMethod": { "description": "Force a specific login method: \"claudeai\" for Claude Pro/Max, \"console\" for Console billing", "type": "string", "enum": [ "claudeai", "console" ] }, "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" }, "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, unsupported platform, or platform not in enabledPlatforms). 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" } }, "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" }, "httpProxyPort": { "type": "number" }, "socksProxyPort": { "type": "number" } } }, "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" } } }, "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" }, "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" ] } }, "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" ] }, "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" }, "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": { "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" } } ] } } } } }, "remote": { "description": "Remote session configuration", "type": "object", "properties": { "defaultEnvironmentId": { "description": "Default environment ID to use for remote sessions", "type": "string" } } }, "autoUpdatesChannel": { "description": "Release channel for auto-updates (latest or stable)", "type": "string", "enum": [ "latest", "stable" ] }, "minimumVersion": { "description": "Minimum version to stay on - prevents downgrades when switching to stable channel", "type": "string" }, "plansDirectory": { "description": "Custom directory for plan files, relative to project root. If not set, defaults to ~/.claude/plans/", "type": "string" }, "proactive": { "description": "Autonomous background operation configuration", "type": "object", "properties": { "autoEnable": { "description": "When true, autonomous background operation is activated automatically at launch (if entitled). When false or null, the user must opt in via the /proactive command or --proactive flag. Existing entitlement gates (GrowthBook flag, ZDR, managed-settings) still apply.", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } }, "voice": { "description": "@internal Voice handsfree settings; behavior gated at read sites by feature(VOICE_HANDSFREE). Hidden from public SDK types until external launch; see TODO on voiceEnabled above.", "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": "Teams/Enterprise opt-in for channel notifications (MCP servers with the claude/channel capability pushing inbound messages). Default off. Set true to allow; users then select servers via --channels.", "type": "boolean" }, "allowedChannelPlugins": { "description": "Teams/Enterprise 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": "Show thinking summaries in the transcript view (ctrl+o). Default: false.", "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" ] } }, "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" } }, "additionalProperties": {}, "title": "Claude Code Settings", "description": "Configuration settings for Claude Code. Learn more: https://code.claude.com/docs/en/settings", "$comment": "Generated on 2026-04-08T03:55:01.653Z" }