Claude Codeのフォルダー信頼画面|フックの宣言元の警告と確認手順

Claude Codeのフォルダー信頼画面|フックの宣言元の警告と確認手順
📅 公開日: 2026年11月22日🔄 最終更新: 2026年11月21日

2026年11月19日のClaude Code v2.1.329で、信頼確認ダイアログに警告が加わりました。

伝えるのは「そのフォルダーのフックがどこで宣言されているか」です(Claude Code更新履歴(英語))。

人から受け取ったリポジトリを初めて開く時は、この警告で宣言元の設定ファイルを見てから「信頼する」を選ぶ、という使い方になります。

この記事では、警告が出る理由、信頼する前に動く物と動かない物、開く前の確認手順、自動実行を止めたい時の設定を、公式ドキュメントにそって整理します。

確認日は2026年11月21日です。

目次

2026年11月の更新|フック宣言元の警告とダイアログの変更点

LINEでインスタ大学の受取案内を見る

LINEでインスタ大学の受取案内を見る

インスタ大学の受取案内をLINEで確認できます。

LINEでインスタ大学の受取案内を見る

v2.1.329の更新は、信頼確認ダイアログに「フォルダーのフックがどこに宣言されているか」を示す警告を足した変更です。

更新履歴の原文は、「Added a trust dialog warning that says where a folder’s hooks are declared」です(Claude Code更新履歴(英語))。

同じ週のv2.1.326(2026年11月16日)では、フォルダーの信頼確認が改善されています。

起動時と /cd の時の確認で、Claude Codeが読み込むプロジェクトの設定ファイルの名前が示され、起動時にはコマンドを実行するファイルに印が付くようになりました(Claude Code更新履歴(英語))。

版 日付 変更の内容
v2.1.326 2026年11月16日 起動時と /cd の信頼確認で、読み込む設定ファイルの名前を表示。起動時はコマンドを実行するファイルに印
v2.1.329 2026年11月19日 信頼ダイアログに、フォルダーのフックの宣言元を伝える警告を追加

上の表は、更新履歴の記載をまとめたものです(Claude Code更新履歴(英語))。

更新履歴の一行だけでは、警告の文面や画面の見た目までは分かりません。

この記事では、画面の見た目を書かず、公式ドキュメントで確認できた動作だけを扱います。

なぜフックの宣言元が大事か|フックは自分のPCで実行される

フックは、Claude Codeの動作の決まった場面で自動実行される、ユーザー定義のシェルコマンドやHTTP呼び出しなどです。

公式ドキュメントは、フックを決まった場面で自動実行される仕組みと説明しています。

実行されるのは、ユーザー定義のシェルコマンド、HTTPエンドポイント、MCPツール呼び出し、LLMプロンプト、サブエージェントのいずれかです(Claude Codeドキュメント(フック・英語))。

フックは設定ファイルのJSONに書き、置き場所によって効く範囲が変わります。

宣言する場所 効く範囲 共有
~/.claude/settings.json 自分の全プロジェクト しない(自分のPCだけ)
.claude/settings.json そのプロジェクト リポジトリに入れて共有できる
.claude/settings.local.json そのプロジェクト しない(Claude Codeが設定を保存する時はgit管理から外れる)
管理ポリシーの設定 組織全体 管理者が管理
プラグインの hooks/hooks.json プラグインが有効な間 プラグインに同梱

上の表は、公式のフック解説にある一覧です(Claude Codeドキュメント(フック・英語))。

この中で、人から受け取ったリポジトリに入っていて自分が書いていないのは、主に .claude/settings.json です。

例えば、公開されているサンプルリポジトリを取り込んで開く場面です。

リポジトリ側がフックを持っていると、自分のPCでコマンドが動きうるため、宣言元を確認する意味があります。

警告が「どこで宣言されているか」を示すのは、このためだと考えると読み取りやすくなります。

なお、この理由づけは公式の説明文ではなく、公式ドキュメントのフックの仕組みから筆者が読み取った整理です。

フックそのものの書き方は、別記事のClaude Codeのフック(hooks)の使い方で扱っています。

信頼する前に動く物と動かない物|公式の一覧で確認する

親フォルダーだけを信頼した時や claude -p で開いた時は、そのフォルダーを信頼していなくても、リポジトリの設定にあるフックは使われます。動かないのは、allowルールや追加ディレクトリなど、権限を広げる側の設定です。

公式の権限ドキュメントには「What runs before you trust a folder」という一覧があります(Claude Codeドキュメント(権限・英語))。

親フォルダーだけを信頼した場合の扱いを、主な行だけ抜き出します。

リポジトリが持つ物 親フォルダーだけ信頼した時
設定ファイルのフック、env、apiKeyHelperなどの補助コマンド 使われる
.claude/settings.json の permissions.allow と additionalDirectories ダイアログを受け入れるまで使われない
プロジェクトのサブエージェントのフロントマターのフック 使われず、ダイアログも出ない
.mcp.json のサーバー 接続前に確認される

表は公式の一覧の一部を日本語にしたものです(Claude Codeドキュメント(権限・英語))。

一番上の行が、今回の警告の背景として読み取れる部分です。

設定ファイルのフックは、そのフォルダーを信頼する前の状態でも使われる、と書かれています。

そのため、フォルダーを開く前に、中身を自分の目で見ておく手順が役に立ちます。

信頼ダイアログは、対話式のターミナルセッションで、信頼していないフォルダーから起動した時に出ます(Claude Codeドキュメント(セキュリティ・英語))。

claude -p やSDKのセッションでは、ダイアログは出ません(Claude Codeドキュメント(セキュリティ・英語))。

実践用の「Claude Code・Codex 最初の安全設定と仕事の渡し方」を無料で配布しています。LINE で「AIエージェント設定」と送ると届きます。LINEで受け取る

初めて開くフォルダーの確認手順|信頼を選ぶ前の4ステップ

手順は、バージョンの確認、宣言元の確認、フックの中身の確認、信頼するかどうかの判断、の4つです。

ここでは、公式ドキュメントの記載から導ける手順として整理します。

  1. claude --version でバージョンを確かめます。警告はv2.1.329以降で追加された変更なので、それより前の版では、この警告は出ません。
  2. 起動して信頼確認が出たら、警告に書かれた宣言元と、名前が示された設定ファイルを読みます。
  3. そのファイルのフックの command や args、http の送信先が、自分の知らない処理を呼んでいないか確かめます。
  4. 内容に納得できる時だけ信頼を選びます。納得できない時は、信頼せずに閉じます。

信頼を受け入れた時の保存の単位は、場所によって変わります。

リポジトリの中では、gitリポジトリのルートに対して信頼が記録され、リポジトリ全体に及びます(入れ子のgitリポジトリを除く)(Claude Codeドキュメント(権限・英語))。

ホームディレクトリから直接起動した時は、信頼はそのセッションだけ保持され、ディスクには書かれません(Claude Codeドキュメント(セキュリティ・英語))。

プロジェクトのサブディレクトリから起動すれば、信頼はディレクトリごとに保存されると公式に書かれています(Claude Codeドキュメント(セキュリティ・英語))。

自動実行を止めたい時|-pで開く前に決める設定

知らないリポジトリで claude -p を使う前は、プロジェクト設定を読まない指定か、フックを無効にする指定を付けて、実行される内容を先に絞ります。

公式の権限ドキュメントは、自分が書いていないリポジトリで claude -p を使う前の選択肢を4つ挙げています(Claude Codeドキュメント(権限・英語))。

やりたいこと 公式が挙げる指定
プロジェクトの設定と .mcp.json を読まない --setting-sources user(SDKは settingSources からプロジェクト設定を外す)
フック・スキル・サブエージェント・プラグインなどを読まない --bare で起動する
その実行だけフックを無効にする --settings '{"disableAllHooks": true}'
.mcp.json のサーバーを名前で拒否する disabledMcpjsonServers に追加する

表は公式の記載をそのまま整理したものです(Claude Codeドキュメント(権限・英語))。

注意点が2つあります。

--bare でも、プロジェクトの設定ファイルにある env ブロックと、awsAuthRefreshなどの補助コマンドは効き続けます(Claude Codeドキュメント(権限・英語))。

また、フックの無効化を自分のユーザー設定だけに書いても足りません。

リポジトリのプロジェクト設定のほうが優先され、false に戻せるためです(Claude Codeドキュメント(権限・英語))。

組織で使っている場合は、管理ポリシーの allowManagedHooksOnly で、動かせるフックを制限できます(Claude Codeドキュメント(フック・英語))。

設定ファイルの場所と優先順位は、別記事のClaude Codeのsettings.json|場所と優先順位・確認方法で整理しています。

よくある質問|警告が出ない時と、すでに信頼済みのフォルダー

警告が出ない時は何を確認しますか

まず claude --version で、v2.1.329以降かを確かめます。

次に、そのフォルダーを信頼済みでないかを見ます。信頼ダイアログは、信頼していないフォルダーから対話式で起動した時に出る画面です(Claude Codeドキュメント(セキュリティ・英語))。

警告は、フォルダーにフックが宣言されている時のための表示です。

フックの無いフォルダーで出ないことは、更新履歴の文面から自然に読み取れますが、公式が明記しているわけではありません。

すでに信頼したフォルダーのフックを後から確認できますか

公式ドキュメントでは、信頼ダイアログの再表示の方法は確認できませんでした。

確認だけなら、フックが書かれる設定ファイル(.claude/settings.json など)を直接開いて読めます。

設定の変更を監査したい場合、公式のセキュリティ解説は、セッション中の設定変更を監査・ブロックする ConfigChange フックを挙げています(Claude Codeドキュメント(セキュリティ・英語))。

管理設定のフックが読み込めない時はどうなりますか

同じv2.1.329には、Claude Desktopなど非対話のホストで、管理設定のフックが読み込めなかった時に会話内で警告する変更も入っています(Claude Code更新履歴(英語))。

信頼ダイアログの警告とは別の変更なので、取り違えないようにします。

読み終わったら、手元に残す

Claude Code・Codex 最初の安全設定と仕事の渡し方

中身

  • 最初に決める6項目(契約・場所・権限・承認・使用量・検収)
  • Claude Code と Codex の操作の違い
  • 最初の仕事を小さく渡す方法

LINE を友だち追加して「AIエージェント設定」と送ると、無料で届きます。

LINEで「AIエージェント設定」を受け取る

この記事で確認した範囲

確認した公式ページは、更新履歴、フックの解説、権限の解説、セキュリティの解説です。

警告の文面と画面の見た目は、公式ドキュメントで確認できなかったため、この記事では書いていません。

公式の記載は更新されることがあるため、使う前に自分の版で信頼確認の表示を見て、更新履歴の最新の記載もあわせて確かめてください。

Claude Codeを仕事で使う前の点検に、LINEの学習案内も使えます。

このサイトは株式会社S.Lineが運営しています。記事内の店舗予約・LINE登録・講座の案内には、当社または当社が集客を担当するサービスの広告(PR)が含まれます。
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

株式会社S.Line 代表取締役。偏差値39から起業し、AIとSNSの活用で「普通の人」が成果を出す方法を発信。

目次