CLAUDE_CODE_RESTRICTED

環境変数

起動時に --restricted フラグを渡した場合と同じ制限モードでセッションを開始するには 1 に設定します。設定ファイルの env ブロック内では無視されます。Claude Code v2.1.248 以降が必要です。

使い方・用途

  • セキュリティを強化し、意図しない操作や外部へのアクセスを制限する
  • コマンド実行やコード実行を行う組み込みツールや WebFetch を無効化し、作業ディレクトリ内のファイルツールのみを許可する
  • bypassPermissions を拒否し、ユーザー、プロジェクト、ローカルの設定ファイルを無視する
英語原文

Set to 1 to start the session in restricted mode, the same as passing --restricted. Claude Code ignores this variable in a settings file's env block. Requires Claude Code v2.1.248 or later

関連ドキュメント

関連する変更履歴

v2.1.290(1件)

--restricted(CLAUDE_CODE_RESTRICTED=1 を含む)セッションがセッション間メッセージングソケットを開く問題を修正した。
英語原文を表示
Fixed --restricted (and CLAUDE_CODE_RESTRICTED=1) sessions opening the cross-session messaging socket

v2.1.248(1件)

--restricted(CLAUDE_CODE_RESTRICTED=1 でも指定可能)を追加した。これにより、コマンドやコードを実行する組み込みツールと WebFetch(--tools で指定された場合を除く)が削除され、ファイルツールは作業ディレクトリ内に制限され、bypassPermissions は拒否され、ユーザー・プロジェクト・ローカルの設定ファイルが無視される
英語原文を表示
Added --restricted (or CLAUDE_CODE_RESTRICTED=1): removes the built-in tools that run commands or code and WebFetch (unless named in --tools), keeps file tools inside the working directory, refuses bypassPermissions, and ignores user, project and local settings files

変更後

--restricted フラグ(または CLAUDE_CODE_RESTRICTED=1)を使うと、コマンドやコードを実行する組み込みツールと WebFetch を無効化した状態で Claude Code を起動できる。共有マシン上で評価ハーネスなどが Claude Code を動かす場合でも、ファイル操作を作業ディレクトリ内に限定しつつ、設定ファイルや権限昇格による意図しない動作を防げる。

関連ドキュメント