Claude Codeのpermissionsでdenyを書く方法|パスの先頭が「/」1本だと、絶対パスにならない
Claude Codeに読ませたくないフォルダは、permissionsのdenyで決める。
パスは「//」で絶対パス、「/」1本だと設定ファイルの場所が起点になる。denyは書いた形しか止めないので、僕は指示のファイルにも同じ決まりを書いている。
Claude Codeに「このフォルダは読ませない」と決めるなら、設定ファイルの permissions に deny のルールを書く。
つまずきやすいのはパスの書き方で、先頭のスラッシュが1本か2本かで、指す場所がまるで変わる。
僕は自分のパソコンのダウンロードフォルダにある .md を読ませないようにしていて、今日その書き方を公式のドキュメントと突き合わせた。
分かったのは、denyは強いけれど、書いたとおりの形しか止めないということだった。
permissionsは3種類。強いのはdeny
許可の設定は、allow(聞かずに使ってよい)、ask(毎回たずねる)、deny(使わせない)の3つに分かれている。
ドキュメントによると、ルールは deny → ask → allow の順に見られて、最初に当たったものが結果になる。
細かく書いたルールが優先される、という仕組みではない。
たとえば Bash(aws *) をdenyにすると、allowに Bash(aws s3 ls) を書いていても止まる。
だから「基本は止めて、これだけ通す」という書き方は、denyとallowの組み合わせではできない。
僕はここを逆に覚えていたので、読んでいて少しひやっとした。
パスの先頭は4通り。「/」1本は絶対パスではない
Read と Edit のルールは、gitignoreと同じ書き方でパスを指定する。
先頭の形で、どこから数えるかが決まる。
//path:ファイルシステムのいちばん上から(絶対パス)~/path:ホームフォルダから/path:その設定ファイルの置き場所に対応するフォルダからpathや./path:いまの作業フォルダから
落とし穴は3つ目で、/Users/alice/file と書いても絶対パスにはならない。
プロジェクトの .claude/settings.json に書けば作業フォルダの下、ユーザーの ~/.claude/settings.json に書けば ~/.claude/ の下を指す。
絶対パスにしたい時は、スラッシュを2本にして //Users/alice/file と書く。
僕の設定は、ユーザーの設定ファイルにこう書いている(ユーザー名だけ伏せた)。
"permissions": {
"deny": [
"Read(//c/Users/ユーザー名/Downloads/**/*.md)",
"Read(//c/Users/ユーザー名/Downloads/*.md)"
]
}Windowsの C:\Users\… は、先頭を //c/ にして書く。
ダウンロードフォルダには出どころのばらばらなファイルが溜まるので、そこの .md は最初から読ませない、と僕は決めた。
.md は文章として読まれるので、中にAI向けの指示が紛れていた時に一番効いてしまう形式だと思う。
Readのdenyが止めるもの
ドキュメントには、Readのdenyがどこまで効くかも書いてある。
組み込みのファイル読み込みのほか、GrepやGlobにも「できる限り」当てはめる。
Bashの中でも cat・head・tail・sed・tee のような、Claude Codeがファイル操作だと分かるコマンドと、< file のようなリダイレクトの先には効く。
同じパスへのEditとWriteも止まる。
止まらない例も書いてある。grep -r pattern . のように、ファイル名を名指ししないで中身を読むコマンドには効かない。
つまりdenyは「ここを読むな」という鍵ではなく、「この形で読むのは止める」という網だ。
Bashのルールは、書いた形しか止めない
Bashのdenyは、もっと素直に効かない。
ドキュメントの例では、Bash(rm *) は rm -rf build/ を止めるが、/bin/rm -rf build/ や bash -c 'rm -rf build/' は止めない。Bash(curl http://github.com/ *) のように引数まで縛るルールは「壊れやすい」とはっきり書かれていて、オプションを前に置いたり、https に変えたりするだけで外れる。
僕の設定にも、cat と type で Downloads の .md を開くのを止めるBashのルールを2行足してある。
でも今日読んだ内容からすると、catはReadのdenyでもう止まるし、PowerShellの Get-Content は2行のどちらにも当たらない。
この2行は、保険というより気休めに近いと思う。
で、僕はどうしているか
denyだけで守れると思わないことにした。
同じ決まりを、AIに毎回読ませる指示のファイル(CLAUDE.md)にも「ダウンロードフォルダの .md は、方法を問わず読み込まない」と書いてある。
設定ファイルで形を止めて、指示のファイルで意図を伝える、の二段にしている。
本当に触らせたくないものなら、そもそもAIの作業フォルダから見える場所に置かないのが一番だと僕は思う。
ドキュメントも、コマンドの中身まで自分で調べたいならフック(PreToolUse)か、サンドボックスを使うように案内している。
フックの書き方は、Claude Codeのフック(hooks)の使い方にまとめた。
CLAUDE.mdの手順を必要な時だけ読ませる仕組みは、Claude Codeのスキル(Skills)とはに書いている。
出典
ほかにも書いています
受託・note・スタンプこういう仕組みを作る相談を受けています
毎日の更新・データ集め・集計の自動化/3万円〜収益がいくらだったか、どの施策が外れたか
note / 個人の視点で掘り下げていますスタンプラリーに挑戦する
行った場所は、現地チェックインで記録に残せます※受託の相談とnoteは、運営者が個人で受けている・書いているものです。
