# --safe-mode Flag

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --safe-mode, CLAUDE_CODE_SAFE_MODE

## Think of it like

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

## 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

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.

## Example code

```bash
claude --safe-mode
```

Start clean to see if an add-on is the problem.

## Why it matters

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

## 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.

## Three principles

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

## Related terms

- [Bare Mode](https://learn.benibix.com/term/ai/bare-mode)
- [claude doctor Command](https://learn.benibix.com/term/ai/claude-doctor-command)
- [Claude Code Plugin](https://learn.benibix.com/term/ai/claude-code-plugin)

## Told apart from

- [--safe-mode vs Bare Mode](https://learn.benibix.com/compare/safe-mode-flag-vs-bare-mode): People think --safe-mode and --bare do the same thing, since both skip your add-ons. They have different jobs. --safe-mode is for finding a fault. It turns off CLAUDE.md, plugins, hooks and the rest, but sign-in, tools and permissions work as usual. Bare mode is for scripts and CI. It never reads your saved sign-in, so it needs an API key, and it gives Claude just a few tools. Use safe mode when something is broken. Use bare mode for a run that must act the same on each machine.
- [--safe-mode vs --restricted](https://learn.benibix.com/compare/safe-mode-flag-vs-restricted-flag): People think --safe-mode and --restricted are both a locked-down mode, and they are not. --safe-mode turns off your add-ons, such as skills, plugins and hooks, to find the one that causes a fault. Your tools still work. --restricted is for a test harness on a shared machine. It takes away the tools that run commands. It reads only managed settings and what --settings passes.

## Taught in

- [Install, Update and Doctor](https://learn.benibix.com/learn/ai-claude-code-commands/install-update-and-doctor): Claude Code Commands, 2/17

![What still loads under --safe-mode and under --restricted.](https://learn.benibix.com/diagrams/flag-safe-restricted.svg)

---

Source: https://learn.benibix.com/term/ai/safe-mode-flag
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
