Skip to content

このページは韓国語の原文をAIで翻訳したものです。誤りが含まれる場合があります。

第11章 フックと画面のカスタマイズ ​

必須 この段階を進めるなら、必ず読んでください。

一言まとめ: フック(Hook)は、決まったタイミングごとに Claude Codeが自分で 実行するコマンドです。AIの判断に任せないので、必ず起きてほしいことに使います。

この章の画面は、2026年11月6日にLinuxでClaude Code 2.1.318を実行した結果です。

ファイルが変わるたびに記録を残すフックを作ってみます。画面の下のステータスラインと、答えの口調も自分に合わせます。

フックとは ​

フックは、自分で決めておいたシェルのコマンドです。Claude Codeが、決まったタイミングごとにそのコマンドを実行します。だから、Claudeが「覚えていてやってくれる」ことを期待する必要がありません。[1]

8章のCLAUDE.mdと並べてみると、違いがわかります。

  • 惜しい例: CLAUDE.mdに「ファイルを変えたら、changelog.txtに1行残して」と書く。守るのはClaudeです。抜け落ちることがあります。
  • 良い例: 同じことをフックにする。守るのはClaude Codeです。ファイルを変えるたびに、そのあとコマンドが実行されます。

毎回必ず起きなければならないことには、フックを使ってください。[2] だからといって、ルールを全部フックに移す必要はありません。口調や文書の形式のようなルールは、CLAUDE.mdで十分です。フックは「抜けると困ること」にだけ使ってください。

理解度チェック

ファイルが変わるたびに、必ず記録を残したいと思います。CLAUDE.md に書くよりフックのほうがよい理由は何でしょうか?

変更記録のフックを作る ​

フックは、設定ファイルに hooks の欄を追加して作ります。[3] この章では、プロジェクトの設定ファイル .claude/settings.json に入れます。7章の拒否ルールが入っている、あのファイルです。

手で直すと、カンマひとつで間違えやすくなります。そこで、ファイル全体を一度に上書きします。7章の拒否ルールも下の内容の中にそのまま入っているので、消えることはありません。

/exit で抜けて、ターミナルの練習フォルダで、下をまるごと貼り付けます。貼り付けたあと、まだ実行されていなければ、Enterをもう一度押してください。

見慣れない欄の名前がいくつも出てきますが、今すべてを知る必要はありません。大きなかたまりは3つです。

  • permissions: 7章で作った拒否ルール
  • hooks: 今回作る変更記録のフック
  • statusLine: 画面の下のステータスライン

詳しい意味は、ボックスのすぐ下でひとつずつ説明します。

bash
cat > .claude/settings.json <<'EOF'
{
  "permissions": {
    "deny": ["Read(./secret/**)"]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          { "type": "command", "command": "date '+%F %T ファイルが変更されました' >> changelog.txt" }
        ]
      }
    ]
  },
  "statusLine": { "type": "command", "command": "echo 街角カフェ整理中" }
}
EOF

Windows PowerShellでは、notepad .claude\settings.json でメモ帳を開きます。もとの内容を消して、上のボックスから cat で始まる行と EOF の行を除いた間だけを入れます。Ctrl + S で保存して閉じます。この方法は実際には試していません。

見慣れない言葉を、ひとつずつ説明しますね。最後の statusLine の欄は、あとの「ステータスライン」の節で見ます。

  • PostToolUse: Claudeがツールを使った あと という意味です。すでに終わったことを元に戻すことはできません。ツールを使う 前 に割り込んで止められるタイミングは PreToolUse です。[4]
  • matcher: どのツールに反応するかを決めます。Write|Edit は、ファイルを作るツールと直すツールです。ここで | は「または」という意味です。Claudeがシェルのコマンドで変えたファイルには、このフックは反応しません。
  • command: 実行するコマンドです。今の日付・時刻と文を、changelog.txt(変更記録.txt)の最後に書き足します。コマンドを部品に分けてみると、こうなります。
    • date: 今の日付と時刻を出力するコマンドです。
    • '+%F %T ファイルが変更されました': 出力する形です。%F の場所に日付(2026-11-06)、%T の場所に時刻(11:19:11)が入ります。
    • >> changelog.txt: 結果をそのファイルの最後に書き足します。10章の > はファイルを上書きし、>> は後ろに続けて書きます。ファイルがなければ新しく作ります。

上書きする代わりに、Claudeに言葉で頼んでもかまいません。[5] 自分のプロジェクトのように、すでに設定が入っているファイルなら、この方法のほうがよいです。.claude フォルダは特別に守られている場所なので、このとき許可の画面が出ることがあります。[6]

text
.claude/settings.json にフックを追加して。ClaudeがWriteかEditのツールを使ったあとに、毎回下のコマンドが動くようにして。すでにある内容は消さないで。
date '+%F %T ファイルが変更されました' >> changelog.txt

すでに hooks の欄があるなら、まるごと置き換えずに、その中にもうひとつ入れます。[7] Windowsでは、このフックは試していません。date コマンドはbashの形式なので、そのままでは実行されないことがあります。そのときは、Claudeに自分の環境に合うコマンドに変えてほしいと頼んでください。

では試してみます。claude を起動して、こう送ります。

text
notes フォルダに hook-test.md を作って、「フックのテスト」と1行だけ書いて。

終わったら、! cat changelog.txt と入力します。実際に動かしたときは、こんな1行が残りました。

text
2026-11-06 11:19:11 ファイルが変更されました

設定ファイル全体は、ch11-settings.json.txtで見られます。

理解度チェック

フックの設定の `PostToolUse` は、いつを意味するでしょうか?

フックを確認する ​

フックが登録されたかは、セッションで /hooks と入力して見ます。[8] この画面は 見るだけ です。ここでフックを作ったり直したりはできません。画面自体がそう言っています。

text
  Hooks
  1 hook on 1 event

  This menu is read-only. To add or change a hook, edit settings.json or ask Claude. Learn more

    PostToolUse  after tool execution
  ❯ [Project] date '+%F %T ファイルが変更されました' >> changelog.txt   Write|Edit · command

    All events

  Enter to view · Esc to close

フックが実行されないときは、まず自分に聞いてみてください。/hooks に表示されているか? PostToolUse の下にあるか?[8:1] それでもなければ、設定ファイルの書き方を見ます。設定ファイルには、最後に残ったカンマとコメントは書けません。[9] 前のボックスをもう一度上書きするのが、いちばん早いです。

理解度チェック

`/hooks` の画面と設定ファイルについて、正しいものはどれでしょうか?

人からもらったフォルダのフック ​

自分で作った練習フォルダなら、危険は低いです。気をつけたいのは、人からもらったフォルダです。

人からもらったフォルダには、その人が書いておいたフックが入っていることがあります。[10] claude -p で実行すると、自分が信頼すると答えたことのないフォルダでも、そのフックが実行されます。[11] だから、そのフックは自分のパソコンで、自分のアカウントで実行されると考えるほうが安全です。もらったフォルダは、Claudeを起動する 前に、まず設定ファイルを読んでください。この勧めは、公式ドキュメントの文ではなく、このガイドの判断です。

bash
cat .claude/settings.json

hooks と statusLine の欄に、どんなコマンドがあるかを見ます。意味がわからなければ、そのフォルダの外で、チャットで聞いてみてください。9章のプラグインも、自分の権限でコードを実行できます。[12] 同じ気持ちで扱えばOKです。

理解度チェック

人からもらったフォルダを初めて使うとき、このガイドがすすめる行動はどれでしょうか?

ステータスライン ​

ステータスライン(Status line)は、Claude Codeの画面の下のほうに、自分が決めたシェルスクリプトの出力を表示する行です。[13] 設定ファイルに statusLine の欄を入れればOKです。[14] 前に上書きした設定に、すでに下の行が入っています。別に直すものはありません。

json
"statusLine": { "type": "command", "command": "echo 街角カフェ整理中" }

実際に動かすと、入力欄の下にこう表示されました。

text
  街角カフェ整理中

フォルダを信頼するかの画面で承諾するまでは、ステータスラインは空のままです。[15] シェルのコマンドを実行する機能なので、フックと同じ信頼のルールに従います。前の節の注意も、そのまま当てはまります。

/statusline のあとに、ほしい形を言葉で書いて作る方法もあります。[16] この機能は、このガイドでは試していません。

理解度チェック

ステータスラインが空になっています。ドキュメントが挙げている原因の1つはどれでしょうか?

出力スタイルとテーマ ​

最初から変える必要はありません。必要なときに取り出して使ってください。この2つは、このガイドでは試しておらず、公式ドキュメントが説明している内容です。

出力スタイル(Output style)は、ひとつのセッションのすべての答えで、役割・口調・形式を決めます。たとえば Concise は、結果から先に言い、前置きと要約を減らします。[17]

text
/output-style Concise

テーマ は色です。画面の文字が見えにくければ、/theme でターミナルに合う色を選びます。[18]

理解度チェック

答えを結果から短く受け取りたいときに使えるコマンドはどれでしょうか?

やってみよう ​

  1. /exit で抜けて、ターミナルで設定のボックスを貼り付けます。
  2. claude を起動し、入力欄の下に 街角カフェ整理中 が見えるかを確かめます。
  3. /hooks と入力して、PostToolUse の下に表示されるかを確認し、Escで閉じます。
  4. フックのテストの依頼を送ったあと、! cat changelog.txt で1行増えたかを見ます。

自分に聞いてみてください。フックは本当に実行されたか? Claudeの答えではなく、changelog.txt を直接開いて答えてください。

まとめ ​

  • フックは、Claude Codeが決まったタイミングごとに実行するコマンドである。必ず起きてほしいことに使う。
  • /hooks は見るだけである。作ったり直したりする場所は、設定ファイルである。
  • 設定ファイルのJSONには、最後のカンマとコメントを書かない。
  • 人からもらったフォルダは、起動する前に、まず .claude/settings.json を読む(このガイドの判断)。
  • ステータスライン、出力スタイル、テーマは、必要なときだけ変える。

用語まとめ ​

用語読み方一言でいうと
Hookフック決まったタイミングごとに自動で実行されるコマンド
PostToolUseポストツールユーズツールを使ったあと、というタイミング
PreToolUseプリツールユーズツールを使う前、というタイミング
JSONジェイソン設定ファイルに使う文字の形式
Status lineステータスライン画面の下に自分のコマンドの出力を表示する行
Output styleアウトプットスタイル答えの役割・口調・形式のセット

この章は読み終わりましたか?

学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。

次の章: 第12章 同時作業とリモート

参考資料(18件)
  1. Claude Code公式ドキュメント、「Automate actions with hooks」。"Hooks are user-defined shell commands." / "Claude Code runs them at specific points in its lifecycle, which gives you deterministic control: certain actions always happen rather than relying on the LLM to choose to run them." code.claude.com (確認日 2026-11-06) ↩︎

  2. Claude Code公式ドキュメント、「Output styles」。"For something that has to happen every time, such as formatting after each edit or blocking a command, use a hook." code.claude.com (確認日 2026-11-06) ↩︎

  3. Claude Code公式ドキュメント、「Automate actions with hooks」。"To create a hook, add a hooks block to a settings file." code.claude.com (確認日 2026-11-06) ↩︎

  4. Claude Code公式ドキュメント、「Automate actions with hooks」。"PostToolUse hooks can't undo actions since the tool has already executed." / "Before a tool call executes. Can block it" code.claude.com (確認日 2026-11-06) ↩︎

  5. Claude Code公式ドキュメント、「Automate actions with hooks」。"You can also ask Claude to write the hook for you by describing what you want in the CLI." code.claude.com (確認日 2026-11-06) ↩︎

  6. .claude フォルダは保護されたパスなので、書き込みがそのまま承認されることはありません。手動モードでは許可の画面が出て、自動モードでは、行動を前もって確かめる別のAIが判断します。Claude Code公式ドキュメント、「Choose a permission mode」。"Writes to a small set of paths are never auto-approved" / 表の auto 行: "Routed to the classifier" code.claude.com (確認日 2026-11-06) ↩︎

  7. Claude Code公式ドキュメント、「Automate actions with hooks」。"If your settings file already has a hooks key, add Notification as a sibling of the existing event keys rather than replacing the whole object." code.claude.com (確認日 2026-11-06) ↩︎

  8. Claude Code公式ドキュメント、「Automate actions with hooks」。"Type /hooks at the Claude Code prompt to open the hooks browser." / "Run /hooks and confirm the hook appears under the correct event" code.claude.com (確認日 2026-11-06) ↩︎

  9. Claude Code公式ドキュメント、「Automate actions with hooks」。"Verify your JSON is valid: trailing commas and comments aren't allowed" code.claude.com (確認日 2026-11-06) ↩︎

  10. Claude Code公式ドキュメント、「Automate actions with hooks」。.claude/settings.json 行の共有できるかの欄: "Yes, can be committed to the repo" code.claude.com (確認日 2026-11-06) ↩︎

  11. Claude Code公式ドキュメント、「Run Claude Code programmatically」。"Without --bare, a -p session runs the hooks in a project's .claude/settings.json and connects the servers in its .mcp.json, even in a folder you've never trusted." code.claude.com (確認日 2026-11-06) ↩︎

  12. Claude Code公式ドキュメント、「Plugins overview」。"Whatever the tier, a plugin you install can run code with your user privileges." code.claude.com (確認日 2026-11-06) ↩︎

  13. Claude Code公式ドキュメント、「Customize your status line」。"The status line is a customizable bar at the bottom of Claude Code that runs any shell script you configure." code.claude.com (確認日 2026-11-06) ↩︎

  14. Claude Code公式ドキュメント、「Customize your status line」。"Add a statusLine field to your user settings (~/.claude/settings.json, where ~ is your home directory) or project settings." code.claude.com (確認日 2026-11-06) ↩︎

  15. Claude Code公式ドキュメント、「Customize your status line」。"Until you accept the workspace trust dialog, the status line stays blank." / "Because statusLine executes a shell command" code.claude.com (確認日 2026-11-06) ↩︎

  16. Claude Code公式ドキュメント、「Customize your status line」。"The /statusline command accepts natural language instructions describing what you want displayed." code.claude.com (確認日 2026-11-06) ↩︎

  17. Claude Code公式ドキュメント、「Output styles」。"An output style is a set of instructions that sets Claude's role, tone, and response format for every response in a session." / "Responses lead with the result and leave out preamble, narration, and recaps" code.claude.com (確認日 2026-11-06) ↩︎

  18. Claude Code公式ドキュメント、「Configure your terminal for Claude Code」。"Use the /theme command, or the theme picker in /config, to choose a Claude Code theme that matches your terminal." code.claude.com (確認日 2026-11-06) ↩︎