【2026年最新】Claude Code Hooks & Skills 入門|自律エージェント構築の完全ガイド

※本記事はアフィリエイト広告を含みます

結論ファースト(30秒で分かる Claude Code Hooks & Skills)

• Hooks(settings.json)= プロンプト送信前/ツール実行前後/セッション開始等 10種類以上のライフサイクルイベント で自動発火するシェルコマンド・AIの判断に依存せず100%確実に発火
• Skills(SKILL.md)= 2025年12月公開のオープンスタンダード「Agent Skills」準拠の再利用可能プロシージャ・20以上のツールでフォーマット共有可能
• 3層設計: Hook(強制)+CLAUDE.md(憲法)+Skills(手順)= 2026年時点の自律エージェント設計の定石
• 基本構成: .claude/skills/ + .claude/hooks/ + .claude/settings.json + CLAUDE.md の4ファイル
• スコープ: ユーザー設定(~/.claude/)=全プロジェクト・プロジェクト設定(./.claude/)=該当のみ・プロジェクト>ユーザーの優先順位
• Skills + Subagents の役割分担: Skills=「何をするか」(タスク内容)・Subagents=「誰がやるか」(役割・モデル・権限)・clu_2_19 参照
• 行動安定化: 多重注入(SessionStart→UserPromptSubmit→PostToolUse)+CLAUDE.mdの <important> タグ+失敗しても止まらない設計(try-except+sys.exit(0))
• 業務活用事例: GitButlerのGit完全自動化・自動フォーマット・危険コマンドブロック・デプロイ完了通知
• 2026年最新動向: スラッシュコマンドがSkillsに統合・Pluginsによるパッケージ配布・effortフロントマター・バンドルスキル(/batch//claude-api//simplify)
• コミュニティスキル: 2026年2月時点で 数万件のスキル登録 ・GitHubエコシステム活発

【🎯 Claude Code 環境準備】Claude Code は Claude Pro/Max プランで利用可能 → Claude Pro の公式サイトを見る ※冒頭CTA

[!info] 出典は公式ドキュメント+業界解説ベース
本記事は Claude Code 公式ドキュメント(code.claude.com/docs/ja/skills)・note.com/m2ai_jp Claude Code 最小構成ハーネス設計・zenn.dev/soichiyo Claude Code設定ベストプラクティス2026年4月版・zenn.dev/zaico Hooksをハックしたマルチエージェント・DevelopersIO クラスメソッド・AI総合研究所 Claude Code Skills・playingai.hatenablog.com Hooks使い方完全ガイド2026年最新等の公式情報・業界解説に基づきます。仕様は急速に変化中のため、最新仕様は必ず公式ドキュメントを参照してください(Claude Code v2.1.84 2026年4月時点)。

---

この記事でわかること

• Hooks と Skills の基本概念(2026年最新版)
• 3層設計(CLAUDE.md+Hooks+Skills)の自律エージェント構築定石
• Hooks の10種類以上のイベント+主要活用例
• Skills の構造+Agent Skills オープンスタンダード(2025年12月公開)
• ユーザー設定とプロジェクト設定のスコープ管理
• Hooksの落とし穴+多重注入による行動安定化テクニック
• 失敗しても止まらない設計の鉄則(try-except+sys.exit(0))
• コミュニティスキル集の活用法(数万件のスキル)
• 業務活用事例(Git完全自動化・自動フォーマット等)
• 2026年最新動向(スラッシュコマンド統合・Plugins・バンドルスキル)
• Skills + Subagents + Hooks の組み合わせパターン

---

1. Claude Code Hooks & Skills の基本概念

1-1. 2つの機能の本質

機能	役割	発火タイミング	強制力
Hooks	ライフサイクルイベントで自動発火するシェルコマンド	プロンプト送信前/ツール実行前後/セッション開始等の 10種類以上	100%確実(AIの判断に依存しない)
Skills	再利用可能なプロシージャ(指示書+補助スクリプト)	Claude が必要と判断したタイミング	AI判断依存(SKILL.md記述に応じて呼出)

1-2. なぜ Hooks + Skills が重要か

[!success] 自律エージェント時代の必須機能
2026年のClaude Codeは「単なるコード生成AI」から「業務遂行型AIエージェント」へ進化。Hooksでイベント駆動の自動化を実現し、Skillsで再利用可能なタスク手順を組織化することで、毎回プロンプトで同じ指示をしなくても、Claude が自律的に正しい動作をする 環境が構築できます。Skills + Subagents + Hooks の3点セットで本格的な自律エージェントが完成(clu_2_19 Claude Code Subagents 参照)。

1-3. 2026年のClaude Codeアーキテクチャ全体像

機能	役割
CLAUDE.md	行動の「憲法」・原則的なルール
Hooks(settings.json)	ライフサイクルイベントで自動発火する「強制」
Skills(SKILL.md)	再利用可能な「手順」
Subagents(.claude/agents/)	専門エージェント・並列実行可能な「役割」(clu_2_19 参照)
MCP(Model Context Protocol)	外部システム連携の「プロトコル」

---

2. 3層設計|Hook + CLAUDE.md + Skills

2-1. 3層の役割分担

[!success] 「強制・憲法・手順」の3層分担
2026年時点で最も安定する自律エージェント設計の定石は、Hook(強制)+CLAUDE.md(憲法)+Skills(手順) の3層分担(note.com/m2ai_jp 等の業界解説で一致)。

層	役割	強制力	例
Hook	「やることリスト」を通知	100%確実(AIの判断に依存しない)	プロンプト送信時に作業ルールを再注入
CLAUDE.md	「憲法」 — 行動制約のルール	中(<important>タグで強化可能)	「テスト追加時は必ず既存パターン踏襲」
Skills(SKILL.md)	「手順」 — 再利用可能なプロシージャ	AI判断依存	「PR作成手順」「リファクタリング手順」

2-2. 基本ファイル構成

.
├── .claude/
│   ├── settings.json          # 権限設定・Hooks定義
│   ├── hooks/                 # ガード系スクリプト
│   │   ├── pretooluse_check.py
│   │   ├── posttooluse_format.py
│   │   └── sessionstart_inject.py
│   ├── skills/                # スキル群
│   │   ├── pr-creation/
│   │   │   ├── SKILL.md
│   │   │   └── helpers.py
│   │   └── refactor/
│   │       └── SKILL.md
│   └── agents/                # Subagents(clu_2_19 参照)
│       ├── code-reviewer.md
│       └── test-runner.md
└── CLAUDE.md                  # 運用指示・憲法

2-3. 「強制 > 憲法 > 手順」の使い分け

用途	使うべきレイヤー
ファイル編集後の自動フォーマット	Hook(PostToolUse)
危険コマンドのブロック	Hook(PreToolUse)
プロジェクト固有のコーディング規約	CLAUDE.md
「PR作成は必ずconventional commit形式」のルール	CLAUDE.md + <important> タグ
「PR作成」の具体的手順(コマンド+テンプレート)	Skills(SKILL.md)
並列で複数観点レビュー	Subagents(clu_2_19)

---

3. Hooks の主要イベント(10種類以上)

3-1. 主要イベント一覧

イベント	タイミング	主な用途
SessionStart	セッション開始時	作業ルール再注入・環境チェック
UserPromptSubmit	ユーザープロンプト送信時	プロンプトへの追加コンテキスト注入
PreToolUse	ツール実行前	危険コマンドブロック・事前確認
PostToolUse	ツール実行後	自動フォーマット・自動コミット
Stop	セッション終了時	終了処理・自動コミット・通知
SubagentStop	Subagent終了時	Subagent終了処理
Notification	通知発生時	外部通知連携(Slack/Discord)

3-2. 主要活用例

活用例1: PostToolUseで自動フォーマット

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "prettier --write \"$CLAUDE_TOOL_INPUT_FILE_PATH\""
      }
    ]
  }
}

→ ファイル編集後にprettierが自動実行され、コードフォーマットが統一されます。

活用例2: PreToolUseで危険コマンドブロック

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "python3 .claude/hooks/dangerous_command_check.py"
      }
    ]
  }
}

→ rm -rf / 等の危険コマンドを検出してブロックします。

活用例3: SessionStartで作業ルール再注入

{
  "hooks": {
    "SessionStart": [
      {
        "command": "cat .claude/hooks/session_rules.md"
      }
    ]
  }
}

→ セッション開始時にプロジェクト固有のルールを自動表示します。

3-3. ifフィルタによる柔軟な制御

[!tip] 最近の機能追加
2026年4月時点で ifフィルタを使って特定コマンドのみをフック+実行ブロックすることも可能 になっています(playingai.hatenablog.com 等の解説)。これにより、より精緻なフロー制御が実現できます。

---

4. Hooksの落とし穴+多重注入による行動安定化

4-1. Hookの本質的な落とし穴

[!warning] Hook出力は「絶対命令」ではない
最初のアプローチとして UserPromptSubmitフックで指示メッセージを注入する方法がありますが、Hookの出力は <user-prompt-submit-hook> タグとしてClaudeのコンテキストに入るものの、このタグはClaudeにとって「システムからの通知」であり、「絶対に従うべき命令」ではありません。Claude Codeのシステムプロンプトにも「Tags contain information from the system」としか書かれていません。

4-2. CLAUDE.md の <important> タグ活用

タグ	Claudeの処理
通常の段落	「知っておくべき情報」 として処理
<important> タグ	「従うべきルール」 として処理(特別な重み)
<system-reminder> タグ	システムからの注意喚起(状況依存)

CLAUDE.md 例:

# プロジェクト固有の指針

<important>
- テスト追加時は必ず既存テストファイルのパターンを踏襲すること
- 環境変数(.env)を絶対にコミットしないこと
- pre-commit hookをスキップするオプション(--no-verify)は使わないこと
</important>

4-3. 多重注入による行動安定化

[!success] 多重注入の効果
PostToolUseには「確率的揺らぎ」があり、1回の注入で完璧な制御を期待するのではなく、SessionStart→UserPromptSubmit→PostToolUseと繰り返し同じメッセージを注入することで、エージェントの行動を安定させるアプローチが有効です(zenn.dev/zaico 等の業界解説)。

実装パターン:

{
  "hooks": {
    "SessionStart": [{"command": "cat .claude/hooks/rules.md"}],
    "UserPromptSubmit": [{"command": "cat .claude/hooks/rules.md"}],
    "PostToolUse": [
      {"matcher": "Edit|Write", "command": "cat .claude/hooks/post_rules.md"}
    ]
  }
}

→ 同じルール群を3回の異なるタイミングで注入することで、Claude の行動遵守率が向上します。

---

5. 失敗しても止まらない設計の鉄則

5-1. 4つの鉄則

鉄則	内容
1. try-exceptで全体をラップ	例外を握りつぶしてセッション継続
2. sys.exit(0)で常に正常終了	失敗時もexit code 0
3. エラーはstderrに出力	デバッグ可能だが処理は継続
4. 「失敗しても止まらない」設計	Hookの不具合がセッション全体に影響することを防ぐ

5-2. Pythonのfail-safe Hookパターン

#!/usr/bin/env python3
import sys
import traceback

def main():
    # メイン処理
    pass

try:
    main()
except Exception as e:
    print(f"Hook error: {e}", file=sys.stderr)
    print(traceback.format_exc(), file=sys.stderr)

# 必ずexit 0で終了(Claude Codeセッション継続)
sys.exit(0)

5-3. なぜfail-safeが必須か

[!danger] Hookの失敗はセッション全体に影響する
Hookが例外で落ちると、Claude Code全体のセッションが止まる可能性があります。特に PreToolUse フックが落ちると、そのツール実行自体がブロックされる場合があります。fail-safe設計(try-except + sys.exit(0))が必須で、Hookは「失敗しても何もしないが処理は継続させる」設計にするのが業界標準(zenn.dev/soichiyo 等の指摘)。

---

6. Skills の構造と Agent Skills 標準

6-1. Skills の基本構造

.claude/skills/
└── my-skill/
    ├── SKILL.md           # 指示書(必須)
    ├── helpers.py         # 補助スクリプト
    ├── templates/         # テンプレート
    │   └── pr-template.md
    └── docs.md            # 補足ドキュメント

6-2. SKILL.md の基本形式

---
name: pr-creation
description: "Creates a Pull Request following project conventions. Use when user asks to create PR."
---

# PR Creation Skill

## Steps

1. Check git status with `git status`
2. Review changes with `git diff`
3. Create commit message following conventional commits
4. Push to remote branch
5. Create PR with `gh pr create` using the template in `templates/pr-template.md`

## Conventions

- Title: type(scope): description
- Body: ## Summary / ## Test Plan

6-3. Agent Skills オープンスタンダード(2025年12月公開)

項目	内容
公開時期	2025年12月
性質	オープンスタンダード
対応ツール	20以上のツールでSKILL.mdフォーマット共有
主な対応	Claude Code・他のAIエージェントツール

6-4. Skills と Subagents の役割分担

レイヤー	役割	例
Agent Skills	「何をするか」を定義(タスク内容・手順・ナレッジ)	コードレビューのチェックリスト・セキュリティ監査の観点
Subagents	「誰がやるか」を定義(役割・モデル・権限・ツール)	code-reviewer subagent(Read/Grep/Glob+sonnet)

→ 両方セットで運用すると精度が安定(clu_2_19 Claude Code Subagents 参照)。

---

7. スコープ管理|ユーザー設定 vs プロジェクト設定

7-1. 2階層のスコープ

スコープ	パス	発火範囲
ユーザースコープ	~/.claude/settings.json ~/.claude/skills/ ~/.claude/agents/	全プロジェクトで発火
プロジェクトスコープ	./.claude/settings.json ./.claude/skills/ ./.claude/agents/	そのプロジェクト内のみで発火

7-2. 「上に遡る」のはCLAUDE.mdだけ

[!warning] スコープの重要な特性
CLAUDE.md だけが「上に遡る」動き(親ディレクトリのCLAUDE.mdも読み込まれる)をし、skills・hooks・rules は起動ディレクトリに閉じている。親ディレクトリにスキルを置いても子プロジェクトでは効きません(zenn.dev/soichiyo 等の指摘)。

7-3. 優先順位

競合	優先
プロジェクトスコープ vs ユーザースコープ(同名Skills/Agents)	プロジェクト > ユーザー
プロジェクトCLAUDE.md vs ユーザーCLAUDE.md	両方読み込まれる(プロジェクトが優先的に適用)

7-4. 運用設計の使い分け

配置先	推奨ファイル
~/.claude/ (ユーザー)	汎用Hooks(自動フォーマット)・汎用Skills(PR作成・コードレビュー)・汎用Subagents(code-reviewer)
./.claude/ (プロジェクト)	プロジェクト固有Hooks(API呼出ブロック等)・プロジェクト固有Skills(独自ワークフロー)・ドメイン特化Subagents

---

8. コミュニティスキル集の活用

8-1. スキルエコシステムの規模

[!success] 数万件のスキルが利用可能
2026年2月時点で数万件のスキルが登録された最大規模のスキル集をはじめ、活発なエコシステムが形成。世界中の開発者が作成した専門スキルを自由に活用できる環境が整っています。

8-2. 入手方法2パターン

方法	内容
GitHubリポジトリからダウンロード	コードを .claude/skills/ に配置
コマンドで追加	npx skills add <owner/repo> (skills.sh等)

8-3. スキル管理のベストプラクティス

[!tip] symlinkで配るのが安全
~/.claude/自体はgit管理されていないため、正本は別のgitリポに置いて、symlinkで配るのが安全(dotfilesリポから~/.zshrcにsymlinkを貼るのと全く同じパターン)です。これにより、複数マシン間でのスキル同期+バージョン管理が両立できます。

実装例:

# dotfilesリポでスキルを管理
cd ~/dotfiles
git clone <skill-repo> skills/my-skill

# symlinkで~/.claude/に配置
ln -s ~/dotfiles/skills/my-skill ~/.claude/skills/my-skill

---

9. 業務活用事例

9-1. GitButler事例|Git完全自動化

GitButlerユーザーはHooksを使って、以下のワークフローを構築:

Hook	処理
PreToolUse	コード生成前のチェック(規約適合確認・テスト存在確認)
PostToolUse	生成後の処理(自動フォーマット・lint修正)
Stop	セッション終了時に変更を 自動コミット・ブランチ更新

9-2. その他の業務活用パターン

パターン	Hook	効果
自動フォーマット	PostToolUse(Edit/Write)	コード品質統一
危険コマンドブロック	PreToolUse(Bash)	重大事故防止
作業ルール再注入	SessionStart+UserPromptSubmit	行動遵守率向上
デプロイ完了通知	Notification	Slack/Discord連携
自動コミット	Stop	バージョン管理自動化
テスト自動実行	PostToolUse	テスト駆動開発の徹底

9-3. Skills + Subagents + Hooks の3点セット活用

[!success] 自律エージェント構築の完成形
Skills(手順)+ Subagents(役割)+ Hooks(強制)の3点セットで、本格的な自律エージェントが構築できます(clu_2_19 Claude Code Subagents 参照)。

実装例: テストドリブン開発自動化

1. Hooks(PreToolUse): コード変更前にテスト存在チェック→ない場合はSubagentに作成依頼
2. Subagents(test-creator): テストファイル作成専門エージェント
3. Skills(test-pattern): プロジェクト固有のテストパターン手順書
4. Hooks(PostToolUse): コード変更後に自動テスト実行
5. Hooks(Stop): セッション終了時に自動コミット

→ 5つのレイヤーが協調して、開発者は 設計・要件定義に集中 できます。

---

10. 2026年最新動向

10-1. 機能追加5つ

機能	内容
スラッシュコマンドのSkills統合	スラッシュコマンドが機能的にSkillsに統合・メモ管理のような用途のスキルもSKILL.md形式で記述可能
effortフロントマター	推論深度制御(より深い推論を要求できる)
動的コンテキスト注入	実行時にコンテキストを動的に変更
Plugins	スキルのパッケージ配布(npm/PyPI類似)
バンドルスキル	/batch /claude-api /simplify 等が標準提供

10-2. Claude Code v2.1.84(2026年4月時点)

ステータス	内容
バージョン	v2.1.84(2026年4月時点)
アップデート頻度	頻繁にアップデート中
最新仕様の確認	必ず公式ドキュメント(code.claude.com/docs/ja/skills)を参照

10-3. バンドルスキルの活用例

バンドルスキル	用途
/batch	バッチ処理(複数タスクの並列実行)
/claude-api	Anthropic APIアクセスの補助
/simplify	コードのシンプル化(リファクタリング補助)

→ 標準提供されるため、設定なしですぐに使えます。

---

11. 実装シナリオ|テスト駆動開発自動化

11-1. シナリオ概要

項目	内容
目標	テスト駆動開発(TDD)の徹底+品質保証
構成	CLAUDE.md + Hooks + Skills + Subagents の4層
期待効果	テスト書き忘れ防止+コード品質統一+自動コミット

11-2. CLAUDE.md 例

# プロジェクト指針

<important>
- 新規コード追加時は必ずテストを先に書くこと(TDD)
- コミット前に全テストパスを確認すること
- pre-commit hookをスキップしないこと
</important>

## Subagent 委任方針

- テスト作成は test-creator subagent を MUST BE USED
- コードレビューは code-reviewer subagent を use proactively

11-3. .claude/settings.json 例

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "python3 .claude/hooks/tdd_check.py"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "python3 .claude/hooks/auto_test.py"
      }
    ],
    "Stop": [
      {
        "command": "python3 .claude/hooks/auto_commit.py"
      }
    ]
  }
}

11-4. .claude/skills/tdd-workflow/SKILL.md 例

---
name: tdd-workflow
description: "Use proactively for TDD workflow. Ensures test-first development."
---

# TDD Workflow Skill

## Steps

1. Identify the feature to implement
2. Create test file first (`*.test.ts` or `*_test.py`)
3. Write failing test cases for the feature
4. Run tests to confirm they fail (`npm test` or `pytest`)
5. Implement the minimal code to make tests pass
6. Refactor while keeping tests green
7. Commit with `test+feat:` prefix

## Test Patterns

- Use existing test file structure as reference
- Follow project naming conventions
- Include both happy path and edge cases

---

12. 学習リソース|Claude Code エコシステム

12-1. 学習ステップ

ステップ	内容	関連記事
① Claude Code 基本操作	導入・基本コマンド	post_010 Claude Code 始め方完全ガイド
② Subagents 実装	専門エージェント構築	clu_2_19 Claude Code Subagents 実践ガイド
③ Hooks & Skills 実装	本記事	–
④ AIエージェント全体像	AIエージェント概念ハブ	post_009 AIエージェント入門
⑤ AI業務効率化体系	AI×SaaS業務効率化マップ	pillar_002 AI×SaaS業務効率化マップ

12-2. 推奨書籍・スクール

カテゴリ	推奨
書籍(Claude Code)	Claude Code関連書籍(Amazon検索で「Claude Code 入門」)
書籍(Claude Pro活用)	Claude Pro関連書籍
スクール(AI開発)	キカガクの公式サイトを見る
スクール(AIエンジニア)	AIジョブカレの公式サイトを見る
スクール(生成AI実務)	DMM 生成AI CAMP の無料カウンセリングを予約する
Claude Pro/Max契約	Claude Pro の公式サイトを見る

---

13. まとめ|3層設計+多重注入で本格的な自律エージェント

13-1. 結論

• Hooks(settings.json)= 10種類以上のライフサイクルイベントで自動発火・100%確実
• Skills(SKILL.md)= 2025年12月公開のオープンスタンダード「Agent Skills」準拠の再利用可能プロシージャ
• 3層設計: Hook(強制)+CLAUDE.md(憲法)+Skills(手順)が2026年の自律エージェント定石
• Skills + Subagents + Hooks の3点セットでフルカスタム自律エージェント構築可能
• 2026年最新動向: スラッシュコマンドがSkillsに統合・Pluginsによるパッケージ配布・effortフロントマター

13-2. 行動指針

1. CLAUDE.mdの整備(<important> タグで原則ルール定義)
2. Hooksの最小構成導入(PostToolUseで自動フォーマットから開始)
3. 失敗しても止まらない設計(try-except+sys.exit(0)+stderr出力)
4. Skills作成(よく繰り返すタスクをSKILL.md化)
5. Subagentsとの組み合わせ(Skills=「何を」+Subagents=「誰が」)
6. 多重注入で行動安定化(SessionStart→UserPromptSubmit→PostToolUseで同じルール注入)
7. コミュニティスキル活用(数万件のスキルから自社用途に合うものをsymlink管理)

13-3. 関連記事

• post_009 AIエージェント入門|2026年の主要プラットフォーム3 Tier比較
• post_010 Claude Code 始め方完全ガイド|2026年版
• clu_2_19 Claude Code Subagents 実践ガイド|並列処理・カスタム設計
• clu_2_22 Notion Custom Agents 完全ガイド|3トリガー・料金体系
• pillar_002 【2026年最新】AI×SaaS業務効率化マップ|10カテゴリ完全比較
• pillar_001 AIスキル習得完全ロードマップ|2026年版

[!success] 最後に
Claude Code Hooks & Skills は2026年の自律エージェント時代を象徴する機能です。「強制・憲法・手順」の3層設計+多重注入で行動安定化+失敗しても止まらない設計の3原則を守れば、再現性のある自律エージェントを構築できます。最新仕様は必ず公式ドキュメント参照必須(2026年は機能追加が急速)。

---

参考リンク

• Claude Code 公式ドキュメント – Skills
• Claude Code 設定のベストプラクティス 2026年4月版
• Claude Code Hooks 使い方完全ガイド 2026年最新
• CLAUDE.md + Skills + Hooks のハーネス設計
• Hooksをハックして自律駆動するマルチエージェント
• DevelopersIO Claude Code Settings and Functions
• AI総合研究所 Claude Code Skills
• Claude Code 全機能ガイド – Skills, Hooks, MCP

---

著者: AIノート(AI業務改善ノート運営者)
最終更新: 2026年5月26日
監修: 本記事は Claude Code 公式ドキュメント+業界各社の解説を一次情報源として執筆しています。仕様は急速に変化中のため、最新仕様は必ず公式ドキュメント(code.claude.com/docs/ja/skills)を参照してください。