Claude Code Media
連載 3/3この記事は「ツール比較」シリーズの第 3 回 / 全 3シリーズ全体を見る →
126,697中級

Claude Code サブエージェント おすすめ 8 選【2026年5月版】

Claude Code サブエージェントおすすめ 8 選。code-reviewer・security-auditor・tdd-guide・architect など実務で即戦力になるサブエージェントを GitHub star 順・用途別に厳選し、導入手順・Pros/Cons 付きで解説します。

By claude-code-media 編集部

TL;DR — サブエージェント 8 選 早見表

#サブエージェント主な用途出典リポジトリ(★)推奨対象
1code-reviewerコードレビュー自動化VoltAgent(★20k)全開発者
2security-auditorセキュリティ診断VoltAgent / Anthropic公式本番デプロイを行う開発者
3tdd-guideTDD 強制・品質保証ECC(★187k)コード品質重視チーム
4architectシステム設計・技術選定wshobson/agents(★35k)大規模開発・技術責任者
5Codebase Orchestrator並列マルチエージェントVoltAgent(★20k)大規模タスクの自動化
6Error Detective自動デバッグVoltAgent(★20k)デバッグに苦労している開発者
7refactor-cleanerリファクタリング自動化ECC(★187k)技術的負債を抱えたプロジェクト
8Documentation Engineer自動ドキュメント生成VoltAgent(★20k)ドキュメント整備が後回しなチーム

全アイテムは 無料 OSS~/.claude/agents/ にコピーするだけで即使用可能。


サブエージェントとは? — 30 秒で理解

Claude Code のサブエージェントは、メインセッションから独立した AI インスタンスとして起動します。
コンテキスト汚染を防ぎながら専門タスクを並列実行できるため、大規模な開発自動化の核となる機能です。

# ~/.claude/agents/code-reviewer.md に定義ファイルを配置するだけ
# メインセッションから呼び出す例
claude -p "コードレビューを実施して" --agent code-reviewer

詳しい基礎は Claude Code の使い方完全ガイド を参照してください。


選定基準

本記事での選定条件は以下のとおりです。

  • GitHub star ≥ 1,000 または Anthropic 公式リスト掲載
  • 2025 年 8 月以降にコミットあり(過去 9 ヶ月以内)
  • 英語または日本語ドキュメントが完備されていること
  • 汎用性が高く、特定フレームワークに依存しない

各サブエージェント詳細

1. code-reviewer — コードレビューを完全自動化

出典: VoltAgent/awesome-claude-code-subagents(GitHub ★20,168)

セキュリティ・品質・パフォーマンス・テストカバレッジを多角的に自動レビューするサブエージェントです。SOLID 原則・DRY 準拠・循環的複雑度まで精査し、コメントで改善点を返却します。コードを書いたら即 code-reviewer に投げるだけで、シニアエンジニア相当のレビューを自動化できます。

こんな人に使うべき
毎週コードレビューに数時間を費やしている開発者・レビュアーが不在のソロ開発者。

ProsCons
セキュリティ〜DX まで全レイヤーをカバーOpus モデル使用でトークンコスト高め
CI/CD に組み込めば自動ゲートになるプロジェクト固有ルールはカスタマイズが必要
80% カバレッジ・複雑度 10 以下を自動検証巨大ファイルは複数回に分割が必要

導入方法

# ファイルをダウンロードして agents ディレクトリへ
curl -o ~/.claude/agents/code-reviewer.md \
  https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/04-quality-security/code-reviewer.md

2. security-auditor — OWASP 準拠のセキュリティ自動診断

出典: VoltAgent/awesome-claude-code-subagents(GitHub ★20,168)

OWASP Top 10 に準拠し、SQL インジェクション・XSS・CSRF・認証バイパス・ハードコードされたシークレットなどを自動検出するセキュリティ専門エージェントです。本番コードのコミット前に走らせることで、重大な脆弱性の流出を防ぎます。

こんな人に使うべき
本番環境へのデプロイを行う開発者・ユーザーデータを扱うアプリを開発中のチーム。

ProsCons
OWASP Top 10 を網羅した系統的な診断動的テスト(ペネトレーション)は別途必要
シークレット漏洩を PR 前に検出できる誤検知が出る場合があり、手動確認が必要
Anthropic 公式の claude-code-security-review(★4,656)と組み合わせ可ゼロデイ脆弱性への対応は限定的

3. tdd-guide — TDD を強制して品質を担保

出典: affaan-m/ECC (Everything Claude Code)(GitHub ★187,380)

Red-Green-Improve サイクルを強制し、テストを先に書かせることで実装品質を保証するサブエージェントです。ECC(Everything Claude Code)は 48 エージェント・183 スキルを収録した最大規模のサブエージェントコレクションであり、tdd-guide はその中核を担います。

こんな人に使うべき
「テストを後回しにしがち」「バグ修正に追われている」開発者。テスト文化をチームに定着させたいリード。

ProsCons
テスト先行を習慣化できるTDD に不慣れだと最初は時間がかかる
実装ミスを早期に発見・修正コストが激減既存コードベースへの適用は段階的に行う必要あり
ECC の 183 スキルと連携して深い実装支援ECC リポジトリ全体がやや大規模で初期設定に時間がかかる

関連: Claude Code スキル活用ガイド も参照


4. architect — シニアアーキテクト相当の設計支援

出典: wshobson/agents(GitHub ★35,687)

システム設計・マイクロサービス分割・技術選定・API 設計を支援する、シニアアーキテクト相当のサブエージェントです。185 体のエージェントを擁する wshobson/agents のアーキテクチャドメインから抽出されており、新機能開発前に呼び出すことで後戻りコストを削減します。

こんな人に使うべき
技術選定・DB 設計・モジュール分割に迷っている開発者。CTO 不在のスタートアップ。

ProsCons
複数の設計オプションを比較検討できる詳細実装は別のサブエージェントに委譲が必要
トレードオフを明示してくれる組織固有の制約は事前にプロンプトに加える必要あり
マイクロサービス〜モノリスの判断指針を提示Opus モデル推奨でコスト高め

5. Codebase Orchestrator — 並列マルチエージェントの指揮官

出典: VoltAgent/awesome-claude-code-subagents(GitHub ★20,168)

複数のサブエージェントを並列起動し、大規模タスクを効率的に分散処理するオーケストレーターです。「セキュリティ診断・コードレビュー・ドキュメント生成」を同時に走らせるなど、独立タスクを並列化することで作業時間を大幅に短縮します。

こんな人に使うべき
大規模リファクタリング・マイグレーション・並列ビルドパイプラインを自動化したい開発者。

ProsCons
独立タスクを並列化して時間を大幅短縮エージェント間の依存関係管理が複雑になりうる
コンテキスト汚染なしに専門タスクを分離コスト管理(並列分のトークン消費)に注意
タスク完了後に結果を集約・要約初回設定にオーケストレーション設計の理解が必要

詳しくは Claude Code Hooks でワークフロー自動化 も参照


6. Error Detective — スタックトレースを自動解析してデバッグ

出典: VoltAgent/awesome-claude-code-subagents(GitHub ★20,168)

スタックトレース・エラーログを自動解析し、根本原因と具体的な修正コードを提示するデバッグ専門サブエージェントです。「エラーが出たが原因がわからない」という状況で呼び出すと、再現ステップ・修正案・テストケースまで一括提示します。

こんな人に使うべき
デバッグに 1 時間以上かかることが多い開発者。非エンジニアがコード変更後にエラーが出た場合。

ProsCons
ログを貼り付けるだけで原因を特定してくれる環境依存のエラーは実行環境情報が必要
修正コードと再発防止策まで提示難読化されたエラーには限界あり
初心者でも使いやすいシンプルな起動方法複雑なマルチスレッドバグは人間の確認必須

7. refactor-cleaner — デッドコードを一掃してコードベースをスリムに

出典: affaan-m/ECC (Everything Claude Code)(GitHub ★187,380)

デッドコード削除・関数分割・命名改善・依存関係整理を自動化し、技術的負債を継続的に解消するサブエージェントです。月次で refactor-cleaner を実行するだけでコードベースの健全性を維持できます。

こんな人に使うべき
「リファクタリングしたいが時間が取れない」チーム。長年メンテしてきた legacy コードを持つプロジェクト。

ProsCons
デッドコード・未使用変数を網羅的に検出大胆なリファクタは動作確認が必要
命名改善まで提案してくれる自動適用時は git で差分を必ず確認
ECC の tdd-guide と組み合わせて安全に実行可言語・フレームワーク固有の慣習は追加指示が必要

8. Documentation Engineer — README・API ドキュメントを自動生成

出典: VoltAgent/awesome-claude-code-subagents(GitHub ★20,168)

README・API リファレンス・インラインコメントを自動生成し、ドキュメント負債をゼロに近づけるサブエージェントです。コードを書いた直後に呼び出すことで、「後でドキュメントを書く」という先送りを解消します。

こんな人に使うべき
OSS プロジェクトを公開する開発者。社内ライブラリのドキュメント整備を後回しにしているチーム。

ProsCons
Markdown 形式で即 push できるドキュメントを生成コードの意図まで正確に反映するには補足が必要
README・API docs・コメントを一括生成複雑なビジネスロジックは人間による追記が必要
既存ドキュメントとの差分更新にも対応生成物の校正レビューは必須

インストール方法 — 3 ステップ

# 1. VoltAgent のリポジトリをクローン
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git /tmp/awesome-subagents

# 2. 使いたいサブエージェントを ~/.claude/agents/ にコピー
mkdir -p ~/.claude/agents
cp /tmp/awesome-subagents/categories/04-quality-security/code-reviewer.md ~/.claude/agents/
cp /tmp/awesome-subagents/categories/04-quality-security/security-auditor.md ~/.claude/agents/
cp /tmp/awesome-subagents/categories/04-quality-security/error-detective.md ~/.claude/agents/
cp /tmp/awesome-subagents/categories/09-meta-orchestration/codebase-orchestrator.md ~/.claude/agents/
cp /tmp/awesome-subagents/categories/06-developer-experience/documentation-engineer.md ~/.claude/agents/

# 3. ECC から tdd-guide・refactor-cleaner・architect を取得
git clone https://github.com/affaan-m/ECC.git /tmp/ecc
cp /tmp/ecc/agents/tdd-guide.md ~/.claude/agents/
cp /tmp/ecc/agents/refactor-cleaner.md ~/.claude/agents/
cp /tmp/ecc/agents/architect.md ~/.claude/agents/

~/.claude/agents/.md ファイルを置くだけで Claude Code が自動認識します。詳細は 公式ドキュメント「カスタムサブエージェントの作成」 を参照。


まとめ:用途別おすすめ組み合わせ

ソロ開発者・個人プロジェクト

最低限この 3 体から始める
code-reviewer + security-auditor + Error Detective

コードを書いたらレビュー→セキュリティ診断→エラー時はデバッグ、という最小ループで品質を底上げできます。


中小企業 DX 担当・スタートアップ CTO

品質ゲートを自動化する 4 体構成
tdd-guide + code-reviewer + security-auditor + architect

TDD で設計→実装→レビュー→セキュリティ診断を全自動化。architect で技術的判断の壁打ちをするとチームの意思決定速度が上がります。


大規模プロジェクト・テックリード

フル自動化 8 体構成
全サブエージェントを Codebase Orchestrator が指揮する最大構成。大規模リファクタリング・マイグレーション・並列ビルドパイプラインをすべて自動化できます。月次で refactor-cleaner を定期実行し、Documentation Engineer でドキュメントを常に最新化します。


関連記事

Newsletter

この記事が役立ったら、続報を週1で

新着記事・実装事例・ツール情報を毎週木曜にお届け。いつでも配信停止可能。

ニュースレターを購読 →
Byclaude-code-media 編集部

AI支援で執筆 — 本記事は Claude Code エージェントによる執筆支援を受け、編集部が事実確認・編集を行っています。 数値・引用元は記事更新日時点で確認済みですが、最新情報は各公式サイトでご確認ください。

Related

続けて読む

すべての記事 →