Manualで作業する、ごく普通の1時間を想像してください。エージェントはプロジェクトを読み、修正案を出し、テストの実行を尋ね、また修正し、またテストを尋ねます。20回目の確認になると、ほとんど見ずに"Yes"を押してしまいます。そんな確認の合間に、ずっと誰も触っていないし、触るべきでもないlegacy/フォルダーへの修正が紛れ込むこともあります。
この記事では、本当にあなたの判断が必要な場面だけ確認を残す方法を紹介します。Claude Codeには、そのための権限ルールがあります。設定ファイルにある3つのリストで、エージェントがすぐ実行できる操作、確認が必要な操作、実行してはいけない操作を指定します。何のために使うのか、どう読めばよいのか、おそらくすでに手元にあるルールのファイルをどう整理するのかを見ていきましょう。
すべてに同じ設定
権限モードは、セッション全体にかかるひとつのつまみです。どちらの方向にも回せますが、変わるのは常にセッション全体です。
厳格なManualでは、エージェントは修正のたび、そしてほぼすべてのコマンドの前に確認します。確認が役立つのは、あなたが内容を読んでいる間だけです。数が増えると、やがて読まれなくなり、保護は形だけになってしまいます。
自由度の高いacceptEditsでは、確認なしでファイルを修正できます。それに加えて、rmやmvのようなファイル操作コマンドも実行されます。自分のコードを扱うには便利です。ただし、このモードはフォルダーを区別しません。legacy/への修正も、プロジェクトのほかの場所と同じように静かに実行されます。
CLAUDE.mdに"legacy/には触らないで"と書く方法もあります。エージェントは従おうとしますが、これはモデルへの依頼であり、禁止ルールではありません。権限ルールは操作の実行前にClaude Code自体が確認します。CLAUDE.mdや依頼文の記述がルールに影響することはありません。
つまり、操作ごとに失敗したときの影響は違うのに、モードはどの操作にも同じように対応します。テストの実行は黙って通したい。別の人が担当するモジュールの修正は確認したい。凍結したフォルダーには一切入ってほしくない。3つの操作に3つの異なる対応が必要ですが、モードだけではできません。
3つのリスト
権限ルールを使えば、まさにこの3つの対応を指定できます。
allow- 確認なしで実行します。頻繁に行う安全な操作を任せ、余計な割り込みを減らします。ask- 必ず確認します。判断をあなたに委ねる場面では、どのモードでも、最も自由なモードであっても確認を残します。deny- 実行しません。エージェントには拒否が返り、あなたには確認すら表示されません。これもモードを問いません。
ルールは設定ファイルに記述します。たとえば、プロジェクトの.claude/settings.jsonなら、冒頭で見たプロジェクトに対して次のように設定できます。
{
"permissions": {
"allow": [
"Bash(npm test)"
],
"ask": [
"Edit(src/partner/**)"
],
"deny": [
"Edit(legacy/**)",
"Bash(git push *)"
]
}
}ここでは、src/partner/は慎重に修正したい別の担当者のモジュール、legacy/は凍結されたプロジェクトの一部、npm testはエージェントがひとつの作業中に何度も実行するチェックです。アスタリスク2つは"フォルダー内のどの階層もすべて"を表します。
セッションで何が変わるか、同じ5つの操作を3つのパターンで比べてみましょう。
| 操作 | ルールなしのManual | ルールなしのacceptEdits | ルールありのacceptEdits |
|---|---|---|---|
それ以外のsrc/内の修正 | 確認 | 確認なし | 確認なし |
src/partner/内の修正 | 確認 | 確認なし | 確認 |
legacy/内の修正 | 確認 | 確認なし | 拒否 |
npm test | 確認 | 確認 | 確認なし |
git push | 確認 | 確認 | 拒否 |
最後の列を見てください。セッションは自由度の高いモードで進みます。自分のコードは中断なく修正され、テストも自動で実行されます。確認はひとつだけ残り、本当に修正を見たい場所について尋ねます。許可できない2つの操作は、夕方にどれだけ疲れていても実行されません。
権限ルールを使うのは、このためです。エージェントに許可を増やすことが目的ではなく、失敗したときの影響に応じて振り分けることが大切です。そうすれば、自由度の高いモードで作業しながら、重要な箇所の制御を保てます。
ひとつの操作が複数のルールに一致することがあります。そのためClaude Codeは、次の順にリストを確認します。
図は上から下へ読み、エージェントの操作ごとに確認し直します。ルールに一致した時点で確認は終わり、より具体的なルールだからといって優先されることはありません。denyにBash(git push *)があれば、allowのルールでもpushは許可されません。誤って禁止を覆すことはできません。これは安心できる点です。
一番下の四角は、別に覚えておきましょう。どのリストにも一致しないからといって、"許可された"とは限りません。モードによって決まります。Manualではエージェントが確認し、acceptEditsでは修正がそのまま実行されます。つまりルールはモードを無効にするのではなく、あなたが指定した場所についてだけモードの動きを細かく決めます。
ルールの読み方
ほぼ正しいルールは、ルールがないより厄介です。ルールがなければ境界がないと分かっています。不正確なルールでは、境界があると思い込んでいても、想定とは違う操作を通してしまいます。
すべてのルールは同じ形式です。ツール名を書き、括弧内で対象を指定します。括弧がなければ、そのツールのすべての呼び出しが対象です。つまり、denyにBashと書くと、エージェントはターミナルを一切使えません。
ファイル
ファイルには2つのツールを使います。あらゆる修正にEdit、読み取りにReadです。パスは.gitignoreと同じパターンで指定します。アスタリスク1つは同じフォルダー内の任意の名前、2つなら任意の深さの階層に一致します。先頭にスラッシュがないパスは、セッションを起動したフォルダーを基準にするため、Claude Codeはプロジェクトのルートから起動してください。
よくある間違いは、Write(legacy/**)と書くことです。エージェントにはその名前のツールがありますが、Claude CodeはファイルルールをEditとReadに対してしか照合しません。Writeのルール自体は受け付けられ、起動時に警告が表示されますが、その後のチェックには使われません。Editなら、新規ファイルの作成を含め、組み込みのあらゆるファイル変更方法をカバーできます。
もうひとつ便利な点があります。たとえばdenyにRead(./.env)と書いて読み取りを禁止すると、そのファイルの修正も禁止されます。
コマンド
Bash(...)ルールはコマンドの文字列を照合します。アスタリスクはスペースを含む任意の文字列に一致します。ルールに一致するかどうかは、次の3点で決まります。
- アスタリスクがなければ、文字単位で一致するコマンドひとつだけが対象です。
- アスタリスクはサブコマンドの後に置きます。
Bash(git log *)が許可するのは、任意のフラグを付けたgit logだけです。一方、Bash(git *)はpushを含むあらゆるgitコマンドを許可します。 - アスタリスクの前のスペースもルールの一部です。
Bash(ls *)はlsofに一致しませんが、Bash(ls*)なら一致します。
青い部分はコマンドと文字単位で照合し、オレンジの部分はアスタリスクがまとめて受け持ちます。そのため、ルールの範囲を決めるのはアスタリスクより前に書かれた内容です。最初のルールではgit logなので、履歴の表示以外は許可されません。2つ目はgitだけなので、アスタリスクの後にpush、ブランチの削除、変更のリセットなどが続く可能性があります。他の人のルールを読むときは、まずアスタリスクより前に何が書かれているか確認してください。
| ルール | 一致する | 一致しない |
|---|---|---|
Bash(npm test) | npm test | npm test --watch |
Bash(npm run *) | npm run build、npm run lint --fix | npm install |
Bash(git log *) | git log、git log --oneline | git push |
Bash(git *) | git pushを含むあらゆるgitコマンド | - |
Edit(src/partner/**) | src/partner/内のあらゆるファイルの修正 | src/app.jsの修正 |
Read(./.env) | プロジェクトルートの.envの読み取り | .env.exampleの読み取り |
a && bのような複合コマンドは、Claude Codeが個々の部分に分けて扱います。allowは、すべての部分がそれぞれの許可ルールに一致した場合だけ実行します。askとdenyは、どれかひとつでも一致すれば適用されます。つまり、npm testを許可しても、npm test && git pushまで許可されるわけではありません。
ほかのツールにもルールを設定できます。たとえば、ひとつのMCPサーバーの全ツールにはmcp__github__*、特定のサイトからページを取得する操作にはWebFetch(domain:example.com)を指定できます。仕組みは同じなので、ここでは詳しく扱いません。
ルールを保存するファイル
ルールを間違ったファイルに置くと、気づかないまま問題が起きます。個人用ファイルに禁止ルールを置いても、同僚には共有されないため、同僚のエージェントは何事もなくlegacy/に入ってしまいます。自分だけに便利な許可ルールを共有ファイルに置くと、プロジェクトをダウンロードした全員に渡ってしまいます。
| ファイル | 誰のルールか | Gitに含まれるか |
|---|---|---|
~/.claude/settings.json | このコンピューターのすべてのプロジェクトで使う、あなた個人のルール | いいえ。ホームフォルダーに保存 |
.claude/settings.json | プロジェクトで作業する全員に共通 | はい。コミットされる |
.claude/settings.local.json | このプロジェクトだけで使う、あなた個人のルール | いいえ |
この3つのファイル以外に、組織から設定ファイルが配布される場合もあり、そのルールを上書きすることはできません。学習用プロジェクトでは、通常そのようなファイルはありません。
別々のファイルにあるリストは競合せず、合算されます。個人用ファイルのallowは共有ファイルのallowに加わります。一方、ルールの確認順は共通で、どのファイルにあるdenyも、別のファイルにあるallowより優先されます。使い分けは簡単です。legacy/、.env、pushのようなプロジェクトの境界は、リポジトリと一緒に届くように共有ファイルに置きます。自分の作業スタイルに合わせた便利な設定は個人用ファイルに置きます。
共有ファイルには、もうひとつ安全のための仕組みがあります。フォルダーを信頼すると確認した後でなければ、共有ファイルのallowは有効になりません。プロジェクトでClaude Codeを初めて起動すると確認があり、そのファイルが許可しようとしている内容も表示されます。askとdenyは制限するだけなので、すぐに有効です。ターミナル全体を許可するルールが入った他人のリポジトリでも、あなたが同意するまでは何も許可されません。
実際に有効な設定は、2つのスラッシュコマンドで確認できます。/permissionsはすべてのルールと、それぞれのルールがどのファイルから読み込まれたかを表示します。同じ画面で追加や削除もできます。/statusのSetting sources欄には、読み込まれたファイルが並びます。設定ファイルを変更すると、Claude Codeは再起動なしで反映します。設定ファイルは厳密なJSONです。//によるコメントや末尾のカンマがあると壊れ、起動時にClaude Codeが警告します。
エージェントがコマンドについて確認し、あなたが"Yes, and don't ask again"を選ぶと、Claude Codeはallowルールを.claude/settings.local.jsonに書き込みます。ファイルがまだなければ新規作成し、コミット対象にならないようにします。ファイルの修正については事情が異なります。この同意はセッションが終わるまで有効で、ファイルには記録されません。
実際のsettings.local.jsonを読み解く
このファイルは、おそらくすでに手元にあり、自分で書いたものではないでしょう。"次から確認しない"を選ぶたびにルールが追加され、数週間もすると、思っていた以上の操作をエージェントに許可しているかもしれません。以下は、Pythonプロジェクトで数週間作業するうちに実際に蓄積した設定です。
{
"permissions": {
"allow": [
"Bash(python3 *)",
"Bash(PYTHONIOENCODING=utf-8 python3 *)",
"Bash(git status *)",
"Bash(git log *)",
"Bash(git diff *)",
"Bash(git show *)",
"Bash(git branch *)",
"Bash(git add *)",
"Bash(git commit *)",
"Bash(git fetch *)"
]
}
}解説を読む前に、まず自分で考えてみてください。どの行を残し、どれを絞り込み、どれを削除しますか?
Bash(python3 *)
ファイル内で最も範囲の広い行です。あらゆるスクリプトの実行に加え、python3 -cでどんなコードでも実行できます。Pythonはファイルの削除、ネットワークアクセス、ほかのプログラムの起動など、何でもできます。つまり、確認なしであらゆる操作を実行できる許可です。たとえばBash(python3 scripts/build.py *)のように、このルールが追加されるきっかけになったスクリプトだけに絞りましょう。
Bash(PYTHONIOENCODING=utf-8 python3 *)
先頭に環境変数を付けた同じコマンドです。allowルールがこの形式を許可するのは、環境変数が既知の安全な変数の短いリストに含まれている場合だけです。リストになければ、Bash(python3 *)ではこのコマンドをカバーできず、エージェントが別に確認します。そのときボタンを押すと、ルールがもうひとつ保存されます。この行はそのように追加された可能性が高いでしょう。こちらも特定のスクリプトに絞れます。
git status、git log、git diff、git show
通常、これらのコマンドは読み取りだけを行います。Claude Codeは読み取りコマンドを確認やルールなしで実行します。書いてあっても害はありませんが、ほとんど役に立ちません。削除すれば、ファイルが短くなり、分かりやすくなります。
Bash(git branch *)
ブランチ一覧を見るだけに思えるので、無害に見えます。しかし、ルールが照合するのは文字列で、git branch -D featureもgit branchで始まります。つまり、ブランチの削除が確認なしで実行されます。この行は削除した方がよいでしょう。ブランチ一覧を見るたびの確認が煩わしくなったら、アスタリスクを使わず、正確なコマンドBash(git branch)を許可してください。
git addとgit fetch
git addは変更を次のコミットに含め、git fetchはサーバーから最新の履歴を取得しますが、作業ファイルには触れません。どちらも簡単に取り消せるので、残してかまいません。
Bash(git commit *)
エージェントは確認なしでコミットします。つまり、あなたがdiffを読む前です。まさにここで確認が必要です。コミットは、変更に同意するタイミングだからです。この行はaskに移しましょう。単に削除するだけでは不十分です。Manualならそれでもエージェントは確認しますが、askなら最も自由なモードを含め、どのモードでも確認が残ります。
ファイルにないもの
git pushです。これはよいことですが、pushの確認で誰も一度も"次から確認しない"を押していない、というだけに頼っています。禁止ルールを明示しておく方が確実です。
整理すると、次のようになります。
{
"permissions": {
"allow": [
"Bash(python3 scripts/build.py *)",
"Bash(PYTHONIOENCODING=utf-8 python3 scripts/build.py *)",
"Bash(git add *)",
"Bash(git fetch *)"
],
"ask": [
"Bash(git commit *)"
],
"deny": [
"Bash(git push *)"
]
}
}
10行あった設定は6行になり、どれも意図した役割を果たしています。作業中の確認はほとんど増えません。ビルドは自動で進み、エージェントが確認するのはコミットの前だけです。チーム全体に適用したいpushの禁止ルールは、前のセクションで説明したとおり、共有の.claude/settings.jsonに移すのがよいでしょう。
Bash(python3 *)、Bash(node *)、Bash(npm *)、Bash(npx *)のようなルールは、ひとつのツールだけを許可しているように見えます。実際には、そのツールが実行できるあらゆるコードを許可しています。プログラム全体ではなく、具体的なスクリプトやコマンドを許可してください。
ルールで防げないこと
エージェントが拒否を受け取っても、ツールからの通常の応答として扱い、作業を続けます。同じ操作を別の方法で実現しようとすることもあります。ここでは、ルールが何をチェックするのかを理解しておくことが大切です。
Bash(...)ルールは、起動されるプログラムではなく、コマンドの文字列を照合します。そのため、通常の書き方は拒否できても、あらゆる書き方を止められるわけではありません。
denyのBash(git push *)では、git -C . pushを止められません。同じコマンドでも、記述が異なるためです。Bash(rm *)では、/bin/rmやbash -c 'rm ...'を止められません。Read(...)を禁止しても、Pythonスクリプトが自分でファイルを開くことは防げません。
だからといって、ルールを使わない理由にはなりません。エージェントはほとんどの場合、通常の形式でコマンドを記述するため、denyで止められます。ただし、ルールは完全な防壁ではありません。Claude Codeのドキュメントにも明記されています。エージェントが別の方法を探さなくて済むように、CLAUDE.mdにも"legacy/は凍結されています。そこへの修正が必要なら、作業を止めて確認してください"と説明しておきましょう。ルールで制御し、CLAUDE.mdで理由を説明すると、別々に使うより効果的です。
境界を確実に守る必要があるなら、ほかの仕組みも使えます。たとえば、実行前にすべてのコマンドをチェックするhookや、システムレベルでアクセスを制限するサンドボックスです。これらは別のテーマです。
日々のルール
ここまでを、いくつかの習慣にまとめます。
denyには、このプロジェクトで絶対に許可できない操作を設定します。凍結したフォルダー、.env、pushなどです。askには、判断をあなたに委ねる境界上の操作だけを設定します。すべてにaskを設定すると、確認疲れが戻ってきます。allowには、範囲を絞って、繰り返し行う操作を設定します。具体的なチェックやスクリプトなどです。- プロジェクトの境界は共有の
.claude/settings.jsonに、自分用の便利な設定は.claude/settings.local.jsonに置きます。 - ときどき
/permissionsを開き、"次から確認しない"で蓄積されたルールを削除します。 - 新しいルールを追加したら、エージェントに禁止した操作を依頼し、拒否されることを確認します。
プロジェクト内の領域について、自由に修正してよい場所、確認が必要な場所、立ち入りを禁止する場所を言葉で説明してください。エージェントにpermissionsブロックの作成を依頼し、保存前に、上の解説と同じ観点でJSONを読みましょう。ルールの範囲は広すぎませんか? 適切なファイルに書き込まれますか?
モードは作業全体のペースを決め、ルールはどこでそのペースを落とすかを決めます。組み合わせることで、どちらか単独では得られないものが実現します。失敗の影響が小さい場所では素早く作業し、影響が大きい場所では確認または拒否できます。
GO TO FULL VERSION