本文へスキップ

Claude Codeの権限ルールとは:仕組みを解説

Claude Code(クロード・コード)のパーミッション(権限)ルールは、deny、ask、allowの順に確認され、範囲の狭いallowが広いdenyに勝つことはありません。Tech AI Wireの6つのテストで、ルールが及ばない範囲が分かりました。

著者

5 分で読めます

英語の原文から機械翻訳したものです。原文はClaire Whitmoreが事実確認と編集を行いました。内容に相違がある場合は英語版が優先されます。 編集方針

Claude Code Docsのページ「Configure permissions」のスクリーンショット。左側でPermissions and sandboxingメニューが開いています。

Claude Codeのパーミッションは、Anthropicのコーディングエージェントが自分の判断で何をしてよいかを決めるルールです。先に確認を求めるべきことや、決してしてはならないことも定めます。ルールはJSONの設定ファイルに、allow、ask、denyの3つのリストとして書きます。どのルールにも一致しない操作をどう扱うかは、パーミッションモードが決めます。設定を誤ると、確認のプロンプトに埋もれるか、承認するつもりのなかったコマンドをエージェントが実行してしまいます。

Claude Codeのパーミッションの仕組み

各ルールはツールを指定し、かっこ内に任意でパターンを付けられます。Bash(npm run test *)は、npm run testで始まるすべてのシェルコマンドに一致します。Read(./.env)は1つのファイルに一致します。WebFetch(domain:example.com)は1つのWebサイトに一致します。Bashのようにツール名だけを書くと、そのツールのすべての使用に一致します。

最も重要なのは順序です。Anthropicのパーミッションのページには、こう書かれています。「ルールはdeny、ask、allowの順に評価されます。この順序で最初に一致したものが結果を決め、ルールの具体性によって順序が変わることはありません」。そのため、Bash(aws *)のような広いdenyは、aws s3 lsもブロックします。より狭いallowがそのコマンドをそのまま指定していても同じです。ドキュメントの言葉では、「allowルールでdenyルールの中に例外を作ることはできません」。

すべてのガイドが同じ説明をしているわけではありません。Vincent Qiao氏のブログに2026年4月に掲載された記事は、Claude Codeが「最も具体的なルールを最初に評価する」としています。公式ページと、以下のTech AI Wireのテストは、どちらもそうではないことを示しています。

ルールは複数のファイルから読み込まれ、各リストは置き換えではなく結合されます。設定のページは、単一の値について優先順位を高い順に示しています。「マネージド設定、コマンドライン、プロジェクトのローカル、共有プロジェクト、ユーザー」です。マネージド設定は雇用主が設定するもので、上書きできません。共有プロジェクトのファイル.claude/settings.jsonは、Gitにコミットすることを想定しています。ローカルファイルの.claude/settings.local.jsonは個人用で、Gitには入れません。そして、どのファイルのdenyも優先されます。「どのスコープのdenyルールも、allowルールより先に評価される」からです。

6つのパーミッションモード

モードは、どのルールにも一致しない呼び出しに対するフォールバックです。Claude Code 2.1.325は、--permission-modeフラグで6つのモードを受け付けます。次の表は、Anthropicのドキュメントをもとに各モードをまとめたものです。

モード確認なしで実行されるもの向いている用途
default(Manualと表示)読み取り。それ以外のツールは初回使用時に確認慣れていないリポジトリ
acceptEdits読み取り、ファイル編集、作業フォルダー内のmkdir、touch、mv、cp見守りながら進める編集の多いセッション
plan読み取りと読み取り専用のシェルコマンド。ソースファイルは編集しない変更前の計画
autoすべて。シェルとネットワークの操作はバックグラウンドでチェック任せられる長時間のタスク
dontAsk事前に承認されたツールのみ。確認が必要になる操作はすべて拒否スクリプトとCI
bypassPermissionsどのモードでも自動承認されない操作を除くすべて隔離されたコンテナーとVMのみ

パーミッションモードのページによると、denyルールはbypassPermissionsを含むすべてのモードで引き続きブロックします。

Tech AI Wireのテスト:6つのルール、6つの結果

テストは2026年11月18日に、macOS 26.6上のClaude Code 2.1.325で、空のGitフォルダーを使って行われました。各実行ではclaude -pに--permission-mode dontAskを付けました。そのため、確認が必要な呼び出しは代わりに拒否されました。ルールは--settingsフラグで渡し、--setting-sources localでマシン自体の設定を除外しました。Haikuモデルに1つのコマンドを実行するよう指示し、JSON出力のpermission_denialsを確認しました。

テストルールコマンド結果
Aallow Bash(echo hello)echo hello実行された
Ballow Bash(echo hello)、deny Bash(echo *)echo hello拒否された
Callow Bash(echo hello)、ask Bash(echo *)echo hello拒否された
Dルールなしecho hello実行された
Eallow Bash(cat *)、deny Read(./secret.txt)cat secret.txt拒否された
Fallow Bash(python3 *)、deny Read(./secret.txt)python3 -c "print(open('secret.txt').read())"実行され、ファイルの内容を表示

テストBとCは、順序を裏付けています。より広いdenyとaskが、どちらも完全一致のallowに勝ちました。テストDはルールが一切ない状態で実行されました。echoが、Claude Codeに組み込まれた読み取り専用コマンドのセットに含まれているためです。テストEは、Readのdenyがcatにも適用されることを示しています。ドキュメントは、head、tail、sed、teeについても同じだとしています。

テストFが抜け穴です。ドキュメントは、ファイルのdenyが「ファイルを自分で開くPythonやNodeのスクリプト」には及ばないと警告しています。今回、1行のPythonスクリプトが「拒否された」はずのファイルを読み込み、その内容を表示しました。

何がいつ変わったか

パーミッションは2026年に何度も変わっています。設定のページによると、バージョン2.1.257で、プロジェクト設定やローカル設定のbypassPermissionsが効かなくなりました。2.1.283以降、対話型のターミナルセッションとVS Codeセッションではautoがデフォルトのモードです。2.1.302以降、モードを指定せずに実行したclaude -pは、代わりにManualで始まります。

Tech AI Wireは、これらのルールに関わる設定を取り上げてきました。Claude Codeは8月に、コミットにデフォルトでセッションリンクを追加するようになりました。バージョン2.1.277では、フォールバックとしてAGENTS.mdを読み込むようになりました。Tech AI WireのClaude Codeのプラグインに関するガイドは、拡張機能を扱っています。拡張機能は、独自のルールが必要なツールを追加します。mcp__<server>__<tool>という形式は、MCPサーバーのツールを指します。MCPサーバーは、プラグインに似たツールの提供元です。

開発者にとっての意味

決して起きてはならないことにはdenyルールを書き、範囲を広く保ちましょう。ブランチ名を1つ指定するのではなく、Bash(git push *)のようにします。広いdenyは狭いallowで覆せないため、その内側に例外は作れません。確認したい操作にはaskを使いましょう。askも、一致するallowに勝つからです。

Readのdenyを、秘密情報の保護として扱ってはいけません。テストFが示すとおり、エージェントが実行できるスクリプトなら、どれでもそのファイルを開けてしまいます。ドキュメントは、Bashルールは「プログラムの周りのセキュリティ境界ではない」としています。本当の制限には、サンドボックスを追加しましょう。サンドボックスは、シェルコマンドがアクセスできる範囲をOSレベルで制限します。さらに良いのは、秘密情報をプロジェクトフォルダーに置かないことです。

設定は.claude/settings.jsonとしてGitにチェックインし、チーム全体が同じdenyを使えるようにしましょう。個人的な承認はsettings.local.jsonに置きます。CIジョブでは、明示的なallowリストとともにdontAskを使いましょう。想定外のコマンドが、確認待ちで止まるのではなく失敗するようになります。bypassPermissionsは使い捨てのコンテナーだけに使いましょう。

出典

  1. Configure permissions - Claude Code Docs
  2. Claude Code settings - Claude Code Docs
  3. Choose a permission mode - Claude Code Docs
  4. Claude Code Permission Rules & settings.json Guide - AI Arte
  5. Claude Code settings.json Permissions: Control Exactly What AI Can Do - Vincent's Blog

関連記事

GitHub上にあるAnthropic公式のclaude-codeリポジトリのスクリーンショット。ファイル一覧と、Claude Codeをエージェント型のコーディングツールと説明するAboutパネルが表示されています。
開発ツール

Cursor上のClaude Code拡張機能、SSHバックドアを仕込む

改ざんされたClaude Code(クロード・コード)拡張機能のビルド2.1.312と2.1.313が、10月29日に約11時間、Cursor(カーソル)のマーケットプレイスに掲載されていました。SSH鍵とリバーストンネルを追加するものでした。