--restricted mode (制限モード)

評価用のハーネス (evaluation harness) が共有マシン上で claude を動かし、Claude Code にコマンドを実行させたくない場合や、そのマシンのユーザー設定・プロジェクト設定を読み込ませたくない場合を想定しています。制限モードでは、使えるツールの範囲と、読み込む設定の範囲の両方が絞られます。

--restricted フラグを付けると、Claude Code は制限モードで起動します。制限モードでは次の動作になります。

• コマンドやコードを実行する組み込みツールと WebFetch を除外します (--tools で個別に名前を指定したものを除く)。
• 組み込みのファイルツールの操作範囲を作業ディレクトリ (working directories) 内に限定します。
• ユーザー・プロジェクト・ローカルの設定ファイルを無視し、managed settings と --settings で渡した設定だけを読み込みます。
• クラウドセッションの作成を拒否します。

--restricted オプションと環境変数 CLAUDE_CODE_RESTRICTED=1 は、Claude Code v2.1.248 で追加されました (2026 年 8 月 27 日)。対象となるプランについては、公式のリリースノートには記載がありません。

制限モードでは、ユーザー・プロジェクト・ローカルの各設定ファイルは読み込まれません。読み込まれるのは managed settings と、起動時に --settings で渡した設定だけです。制限モードで動かす環境に必要な設定は、この 2 つのどちらかで渡す形になります。

また、--tools で個別に名前を指定しない限り、コマンドやコードを実行する組み込みツールと WebFetch は使えません。default プリセットを指定しても、これらのツールは戻りません。制限モードのセッションからはクラウドセッションを作成できない点も、運用の前提として押さえておく必要があります。

1. claude を起動するときに --restricted フラグを付けます。例: claude --restricted -p "query"
2. フラグの代わりに、環境変数 CLAUDE_CODE_RESTRICTED=1 を設定して制限モードを有効にすることもできます。
3. 除外されるツールのうち必要なものがある場合は、--tools でそのツールを個別に名前で指定します。default プリセット経由の指定では除外は解除されません。