環境変数

CLAUDE_CODE_SAFE_MODE

1 を設定するとセーフモードで起動する。トラブルシューティングとして壊れた設定を切り分けるため、CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインド、ステータスラインとファイル候補コマンド、LSP サーバー、自動メモリを読み込まない。管理設定のポリシーは引き続き適用され、ポリシーで設定されたフック、ステータスライン、ファイル候補コマンドは有効のままだが、管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシーで設定された MCP サーバーは読み込まれない。--safe-mode を渡すのと同等。直接起動された子プロセスはこの変数を引き継ぐ。

使い方・用途

  • カスタム設定のせいで Claude Code の起動や動作が壊れている疑いがあるとき、すべてのカスタマイズを無効化した状態で起動して原因を切り分ける。
  • CLAUDE.md やプラグイン、スキル、フック、MCP サーバーなどを一時的に読み込まずに比較することで、問題がカスタム設定由来かどうかを検証する。
  • --agents に渡した値が不正で起動に失敗する場合に、検証をスキップして --agents を無視した状態でセッションを開始する。
英語原文(公式ドキュメントより)

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
トラブルシューティング用に、すべてのカスタマイズ(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

変更後

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

関連ドキュメント