Claude Codeのコードレビューを「専門AIエージェント」に自動で任せられる機能が、2026年に開発者の間で注目を集めています。

「Subagents（サブエージェント）」と呼ばれるこの仕組みを使うと、コーディング中にレビュー担当・デバッグ担当・データ分析担当のAIが自動で起動し、それぞれ専門的にタスクをこなしてくれます。海外で話題になったClaude Codeチートシートをもとに、設定手順と活用例を解説します。

この記事でわかること：

  • Subagentsが解決する課題と基本的な仕組み
  • .claude/agents/ への設定ファイルの書き方
  • Agent Skillsとの役割分担の違い
  • Hooksと組み合わせた自動化フローの例

https://awesomeclaude.ai/code-cheatsheet

Subagentsとは何か

Claude Codeをそのまま使うと、コーディング・レビュー・デバッグ・ドキュメント作成まで、すべてを1つのセッションが担います。タスクが複雑になるほどコンテキストが混在し、専門的な回答の精度が落ちる問題があります。

Subagentsはこれを解決する仕組みです。独立したコンテキストウィンドウを持つ専門エージェントにタスクを委任することで、各エージェントが自分の専門領域に集中できます。チームに専門家を増やすのと同じ発想です。

コード変更後に自動でレビューが走る、エラーが出たら自動でデバッグ担当が調査を開始する——そういったワークフローをコードなしで実現できます。

設定ファイルの書き方

Subagentsは .claude/agents/ ディレクトリ（プロジェクト共有）か ~/.claude/agents/ ディレクトリ（個人専用）にMarkdownファイルを置くだけで有効になります。ファイルの先頭にはYAMLフロントマターを記述します。

---
name: code-reviewer
description: コード変更後に自動でコードレビューを実行する。品質・セキュリティ・テストカバレッジを確認。コードを新規作成・修正した場合は必ず呼び出す。
tools: Read, Grep, Glob, Bash
model: inherit
---

あなたはシニアエンジニアとしてコードレビューを担当します。

呼び出されたら以下の手順で動いてください。
1. git diff で変更内容を確認する
2. 修正ファイルを中心にレビューを行う
3. Critical（必須対応）→ Warning（推奨）→ Suggestion（任意）の順に報告する

確認項目：
- コードの可読性と命名規則
- エラーハンドリングの抜け漏れ
- セキュリティ上の懸念点（APIキー露出など）
- テストカバレッジの充足度

tools フィールドで使えるツールを絞り込むと、セキュリティと処理の集中度が上がります。model: inherit は親セッションのモデルをそのまま引き継ぐ設定で、model: sonnet のように指定してコスト重視のエージェントを作ることも可能です。

自動起動のしくみ

Subagentsには2つの起動方法があります。

明示的な起動は、チャット内で「code-reviewerサブエージェントを使ってこのコードを確認して」と指示する方法です。

自動起動は、descriptionに「必ず呼び出す」「MUST BE USED」「proactively」といったキーワードを含めると、Claude Codeが状況を判断して自律的にSubagentを呼び出します。上の設定例では「コードを新規作成・修正した場合は必ず呼び出す」と書いているため、ファイルを編集するたびにレビューが自動で走ります。

複数のSubagentsを連鎖させることもできます。

"debuggerサブエージェントで原因を特定してから、optimizerサブエージェントで改善案を出して"

チームで共有したい場合はプロジェクトの .claude/agents/ に配置してGit管理します。個人専用にしたい場合は ~/.claude/agents/ に置きます。

Agent Skillsとの違い

Claude CodeにはSubagentsとは別に「Agent Skills」という機能もあります。どちらも専門機能を追加しますが、役割が異なります。

Agent Skillsは .claude/skills/ に置くモジュール型の機能で、特定の手順をまとめたものです。モデルがコンテキストに合わせて自律的に呼び出す点は共通していますが、親セッションのコンテキストをそのまま共有する軽量な実装です。単一目的の手順書として使います。

Subagentsは独立したコンテキストウィンドウを持ちます。長い専門的なシステムプロンプト、独自のツール制限、指定モデルを持てるため、複雑なタスクに向いています。

簡単な手順の自動化にはAgent Skills、専門的な判断が必要な複合タスクにはSubagentsという使い分けが基本です。

Hooksと組み合わせる

Hooksはツール実行のライフサイクルに自動でシェルコマンドを差し込む機能です。Subagentsと組み合わせると、さらに細かい自動化が可能になります。

たとえば、コード変更後に自動でフォーマットをかけるHooksの設定は次の通りです。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write $FILE_PATH"
          }
        ]
      }
    ]
  }
}

PostToolUse はファイル編集後に実行されるイベントです。Stop イベントはセッション終了時のactivity log記録、PreToolUse は特定操作の事前ブロックに使えます。Hooksの設定は ~/.claude/settings.json（個人）か .claude/settings.json（プロジェクト）に記述します。

設定をはじめる手順

Subagentsの導入は次の流れで進めます。

まず .claude/agents/ ディレクトリを作成します。次に、目的に応じたMarkdownファイルを作成し、YAMLフロントマターに name・description・tools を記述します。ファイル本文にシステムプロンプトを書いたら、Claude Codeのチャット内で /agents コマンドを実行して登録状況を確認します。

テンプレートとして公開されているコードレビュー担当・デバッグ担当・データサイエンティスト担当の設定例が、awesomeclaude.aiのチートシートに掲載されています。MCPサーバー30社以上の接続コマンドや、Headless Modeを使ったCI/CD統合の例なども収録されています。