{"name":"--safe-mode","slug":"safe-mode","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Start with all customizations disabled to troubleshoot a broken configuration: CLAUDE.md, skills, plugins, hooks, MCP servers, custom commands and agents, output styles, workflows, custom themes, custom keybindings, status line and file-suggestion commands, LSP servers, and auto memory do not load. Authentication, model selection, built-in tools, and permissions work normally, which differs from [`--bare`](\/docs\/en\/headless#start-faster-with-bare-mode). Managed settings policy still applies, including policy-configured hooks, status line, and file-suggestion commands; managed plugins, managed skills, managed CLAUDE.md, and policy-configured MCP servers do not. Useful for checking whether a customization is what triggers [automatic model fallback](\/docs\/en\/model-config#automatic-model-fallback). Sets [`CLAUDE_CODE_SAFE_MODE`](\/docs\/en\/env-vars)","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.169","removed_in":null,"in_current_build":true,"newest_mined":"2.1.309","builds":122,"mined_builds":150,"first_cited":{"version":"2.1.248","released_at":"2026-08-27 20:35:36","spans":3}},"aliases":[],"entries":[{"version":"2.1.299","anchor":"safe-mode-is-now-a-respawn-flag-job-respawn-stripping-rew","heading":"--safe-mode is now kept when a background job restarts","line":"`--safe-mode` is now one of the flags carried over when a job or session restarts, and the warning about dropped flags is reworded","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text, named in this entry"},{"version":"2.1.299","anchor":"safe-mode-hint-text-changed","heading":"The hint for leaving safe mode now depends on how you started it","line":"The hint for leaving safe mode is no longer always \"restart without --safe-mode\", and the bare mode hint changed the same way","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text, named in this entry"},{"version":"2.1.290","anchor":"safe-mode-is-now-evaluated-lazily-and-uses-the-same-check","heading":"--safe-mode is now checked the same way as --restricted","line":"The `--safe-mode` flag now goes through the same check as `--restricted` and `--strict-mcp-config`, run when it is needed","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text, named in this entry"},{"version":"2.1.280","anchor":"bare-and-safe-mode-flag-descriptions-clarify-pluginhook","heading":"--bare and --safe-mode flag descriptions clarify plugin\/hook scope","line":"Help text for --bare and --safe-mode now clarifies they only affect plugins and settings-defined hooks, not built-in features","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text, named in this entry"},{"version":"2.1.280","anchor":"safe-mode-banner-clarifies-that-built-in-plugins-keep-workin","heading":"Safe-mode banner clarifies that built-in plugins keep working","line":"Safe-mode messages now clarify that built-in plugins keep working while installed plugins are disabled","released_at":"2026-09-22 15:44:39","reason":"named in this entry"},{"version":"2.1.248","anchor":"claude-in-chrome-is-now-also-skipped-in-restricted-sessions","heading":"Claude in Chrome is now also skipped in restricted sessions","line":"Restricted sessions skip Claude in Chrome browser wiring, same as safe mode.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"cloud-hosted-sessions-now-refuse-local-cli-options-instead-o","heading":"Cloud-hosted sessions now refuse local CLI options instead of quietly dropping them","line":"Running with --cloud now tells you which local CLI options were ignored or refused, and why.","released_at":"2026-08-24 19:16:14","reason":"found in this entry's text"},{"version":"2.1.169","anchor":"safe-mode-safe-mode-claude-code-safe-mode","heading":"Safe Mode ( --safe-mode \/ CLAUDE_CODE_SAFE_MODE )","line":null,"released_at":"2026-06-08 18:11:20","reason":"found in this entry's text"}],"entries_total":8,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"debug-your-config","title":"Debug your configuration","documented":false},{"source":"claude-code","path":"model-config","title":"Model configuration","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"plugins\/loading","title":"Plugin loading reference","documented":false},{"source":"claude-code","path":"plugins\/mods\/admin","title":"Manage mods for your organization","documented":false},{"source":"claude-code","path":"plugins\/mods\/create","title":"Create a mod","documented":false},{"source":"claude-code","path":"plugins\/mods\/overview","title":"Mods overview","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/safe-mode","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}