{"name":"mode","slug":"mode","family":"setting","title":"Settings keys","noun":"settings key","description":"Programs driving Claude Code through the SDK now see more detail about background work and turn context.","description_source":"entry","described_by":{"version":"2.1.228","anchor":"sdk-system-messages-report-background-tasks-and-turn-context"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.308","builds":126,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.282","anchor":"websearch-the-fast-search-config-can-append-a-remote-addend","heading":"Web search instructions can be extended remotely, and a stray option is ignored","line":"When fast web search is enabled, extra WebSearch tool instructions can be supplied remotely, and a `mode` value sent while it is off is dropped","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"bridge-stops-work-items-that-carry-an-unsupported-mode","heading":"Bridge stops work items that carry an unsupported mode","line":"Remote Control now stops incoming work that carries an unsupported mode instead of trying to run it","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"bridge-debug-logs-hash-ids-and-sanitise-values","heading":"Bridge debug logs hash IDs and sanitise values","line":"Bridge debug logs now hash work and session IDs and hide JSON values and unusual type or mode text","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"three-new-hidden-cli-settings-edit-commands-for-the-vs-code","heading":"Three new hidden CLI settings-edit commands for the VS Code extension","line":"Three new hidden CLI commands let the VS Code extension edit skill, sandbox, and Chrome settings","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"new-plugin-hook-api-promptread","heading":"New plugin hook API: $.prompt.read","line":"New plugin hook API lets plugins read the current text and cursor position in the prompt box","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"new-memory-mode-session-log-entry-type-has-no-writer-call","heading":"New 'memory-mode' session log entry type has no writer call site","line":"New 'memory-mode' session log entries are fully plumbed through loading and merging, but nothing yet writes them","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"artifact-copy-access-checks-now-special-case-type-locked-a","heading":"Artifact 'copy' access checks now special-case type-locked artifacts","line":"Copying a type-locked artifact now goes through a dedicated access check instead of the generic one","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"},{"version":"2.1.273","anchor":"read-tools-http-handler-helper-gains-body-file-support","heading":"Read tool's HTTP handler helper gains body_file support","line":"Read tool's HTTP handler settings now accept a body_file option alongside method, body, mode, and script","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text"},{"version":"2.1.268","anchor":"sandbox-schema-additions-mitm-proxy-domain-routing-and-env","heading":"Sandbox schema additions: MITM proxy domain routing and env-var credential masking with JWT decode","line":"Sandbox config gains schemas for routing traffic through a MITM proxy and masking credentials in environment variables, including JWT handling","released_at":"2026-09-10 18:41:11","reason":"found in this entry's text"},{"version":"2.1.229","anchor":"plugins-can-be-installed-from-a-command-that-prints-a-direct","heading":"Plugins can be installed from a command that prints a directory","line":"Marketplaces can install a plugin by running a command that prints a directory path, with your consent.","released_at":"2026-08-12 19:28:48","reason":"named in this entry, found in this entry's text"}],"entries_total":19,"docs":[{"source":"api","path":"about-claude\/additional-resources","title":"additional-resources","documented":false},{"source":"api","path":"about-claude\/api-credits-for-subscribers","title":"api-credits-for-subscribers","documented":false},{"source":"api","path":"about-claude\/glossary","title":"glossary","documented":false},{"source":"api","path":"about-claude\/model-deprecations","title":"model-deprecations","documented":false},{"source":"api","path":"about-claude\/models\/choosing-a-model","title":"choosing-a-model","documented":false},{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"about-claude\/models\/model-ids-and-versions","title":"model-ids-and-versions","documented":false},{"source":"api","path":"about-claude\/models\/optimizing-for-cost-and-intelligence","title":"optimizing-for-cost-and-intelligence","documented":false},{"source":"api","path":"about-claude\/pricing","title":"pricing","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/commerce-agents","title":"commerce-agents","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/mode","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}