環境変数

CLAUDE_CODE_SAFE_MODE

すべてのカスタマイズ（CLAUDE.md、スキル、プラグイン、MCPサーバー等）を無効化したセーフモードで起動します。

使い方・用途

  • 設定ファイルや導入したプラグインが原因で Claude Code が正常に動作しない場合の切り分けとトラブルシューティングに使用します。
  • ユーザー設定を一時的に無視したクリーンな状態で起動し、不具合の原因がツール本体にあるのかカスタマイズにあるのかを素早く特定できます。
  • フォールバックの動作確認など、意図しない設定の干渉を排除して動作を検証したい場合に役立ちます。
英語原文(公式ドキュメントより)

Set to 1 to start in safe mode: 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, for troubleshooting a broken configuration. 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. Equivalent to passing --safe-mode. Directly spawned child processes inherit the variable

関連する変更履歴

v2.1.169(1件)

Added
PluginsSkillsHooksMCPMemory
トラブルシューティング用に、すべてのカスタマイズ（CLAUDE.md、プラグイン、スキル、ホック、MCPサーバー）を無効にして起動する --safe-mode フラグを追加しました。
英語原文を表示
Added --safe-mode flag (and CLAUDE_CODE_SAFE_MODE) to start Claude Code with all customizations (CLAUDE.md, plugins, skills, hooks, MCP servers) disabled for troubleshooting

変更前

特定のプラグインやフックが原因で Claude Code が正常に動作しない場合、原因を特定するために設定ファイルを個別に書き換える必要がありました。

変更後

原因不明の挙動が発生した際、--safe-mode を使うことで純粋な Claude Code の状態で起動し、カスタマイズによる影響かどうかを即座に切り分けられます。

ユーザーへの恩恵

複雑な設定を維持したまま、問題発生時の原因究明を迅速に行えるようになります。

関連ドキュメント