Skip to content
BENIBIX Learn

--safe-mode Flag

Also known as claude --safe-mode, CLAUDE_CODE_SAFE_MODE

It starts Claude Code with your add-ons turned off.

Think of it like

It is like you take all the stickers off a toy. Then you see if it still works.

Example

Since Monday, Lucy's sessions crash on start. With --safe-mode it starts fine, so she turns her plugins back on one at a time and finds the bad one.

Why it matters

It splits the problem in two: Claude Code itself, or something you added to it.

Definition

--safe-mode starts Claude Code with your add-ons turned off. Then you can find what is breaking it. CLAUDE.md, skills, plugins, hooks, MCP servers, custom commands and agents, themes, the status line and auto memory do not load. Sign-in, the model, built-in tools and permissions still work. Your admin's settings still apply.

Example code

bash
claude --safe-mode
Start clean to see if an add-on is the problem.
The left column shows what --safe-mode keeps and drops.

Common mistake

Mixing it up with --bare. Safe mode keeps sign-in and permissions working as usual. Bare mode skips your saved sign-in too, for scripts.

Key takeaways

  1. 1
    Add-ons off. CLAUDE.md, plugins, hooks.
  2. 2
    Core still works. Sign-in, tools.
  3. 3
    Find the cause. Then add back.

Compare

Learn it properly