Claude Codeを本格的に運用しようとした瞬間に必ず直面するのが、「専門特化したsubagentをどう揃えるか」という問題だ。コードレビュー用と、セキュリティ監査用と、Kubernetes担当と、データ基盤担当を、すべて自分で書き起こすのは現実的ではない。Claude Code全体の使い方は Claude Code完全ガイド2026：インストールから本番運用まで をご覧ください。
そこに2026年5月時点でGitHub Star 1.9万を超える勢いで応えているのが、VoltAgent/awesome-claude-code-subagents だ。131個超の専門subagentを10カテゴリに整理し、Claude Code公式のPlugin Marketplace、インタラクティブインストーラ、curlワンライナーのいずれからでも導入できる。同じVoltAgentが公開する Codex版のサブエージェント集 の姉妹リポジトリにあたり、Claude Code側ではこちらが本命となる。
30秒で理解する awesome-claude-code-subagents
- ・何者か：Claude Code向けの専門subagentを131個超集めたキュレーション型リポジトリ。VoltAgent公式。
- ・規模：GitHub Star 19,834／Fork 2,297／Watcher 206（2026年5月時点）。MITライセンス。
- ・導入方法：Claude Code Plugin Marketplaceにカテゴリ単位で登録／対話型シェルスクリプト／curlワンライナー／手動コピーの4通り。
- ・カバー範囲：Core Development、Language、Infrastructure、Quality & Security、Data & AI、DevEx、Specialized Domains、Business、Meta、Researchの10カテゴリ。
- ・差別化：各subagentにモデルルーティング（opus/sonnet/haiku）と最小権限ツールセットがあらかじめ設定済み。
awesome-claude-code-subagentsとは——131個超のClaude Code向けsubagentを束ねたカタログ
awesome-claude-code-subagentsは、AIエージェント基盤を手掛けるVoltAgentが2025年7月末から公開・運用している、Anthropic Claude Code専用のsubagentキュレーションリポジトリだ。READMEの冒頭で「the definitive collection of Claude Code subagents」と自称しており、実際にawesome-listバッジを取得している。
リポジトリの規模は2026年5月時点でStar 19,834・Fork 2,297・Watcher 206・Issue 21件。直近のpushは2026年4月20日で、メンテナンスは継続している。トピックタグも claude-code-subagents claude-subagents awesome-list などが付与され、GitHub上での探索性は高い。
重要なのは、この集合体が単なる「リンク集」ではなく、Claude Code側で即実行可能なフロントマター付きMarkdown定義の束として配布されている点だ。 Anthropicが定めるsubagent仕様（.claude/agents/{name}.md）に揃ったファイルが、カテゴリ別ディレクトリに整理されている。
姉妹プロジェクトとしてはCodex向けの awesome-codex-subagents があり、こちらはCodex CLI向けのtoml形式で同種のキュレーションを行う。コンセプトは双子だが、Claude Code側の方が131個超とラインナップが厚い。
この章のポイント
- ・VoltAgent公式メンテのClaude Code subagentカタログ。
- ・Star 1.9万超、131個超のsubagent、MITライセンス。
- ・配布物は実行可能なフロントマター付きMarkdown。
10カテゴリで整理されたClaude Code subagentの全体像
131個超という数字は、自分のプロジェクトに何が使えるのかを判断する上で多すぎる。awesome-claude-code-subagentsはこれを10カテゴリに分解して、各カテゴリを独立したPlugin Marketplaceのプラグインとして配布している。下表が全カテゴリの一覧だ。
| # | カテゴリ | Plugin名 | subagent数 | 代表的なsubagent |
|---|---|---|---|---|
| 01 | Core Development | voltagent-core-dev |
11 | api-designer / backend-developer / frontend-developer / microservices-architect |
| 02 | Language Specialists | voltagent-lang |
32 | typescript-pro / python-pro / golang-pro / rust-engineer / swift-expert |
| 03 | Infrastructure | voltagent-infra |
16 | cloud-architect / kubernetes-specialist / terraform-engineer / sre-engineer |
| 04 | Quality & Security | voltagent-qa-sec |
16 | security-auditor / penetration-tester / code-reviewer / compliance-auditor |
| 05 | Data & AI | voltagent-data-ai |
13 | llm-architect / mlops-engineer / nlp-engineer / data-engineer |
| 06 | Developer Experience | voltagent-dev-exp |
14 | refactoring-specialist / dx-optimizer / mcp-developer / build-engineer |
| 07 | Specialized Domains | voltagent-domains |
13 | blockchain-developer / fintech-engineer / iot-engineer / payment-integration |
| 08 | Business & Product | voltagent-biz |
12 | product-manager / technical-writer / scrum-master / legal-advisor |
| 09 | Meta & Orchestration | voltagent-meta |
13 | multi-agent-coordinator / context-manager / workflow-orchestrator |
| 10 | Research & Analysis | voltagent-research |
8 | research-analyst / competitive-analyst / market-researcher |
10カテゴリのうち、特にラインナップが厚いのはLanguage Specialists（32）だ。typescript-pro・python-pro・golang-proといった主要言語に加え、laravel-specialist・rails-expert・spring-boot-engineer・django-developer・fastapi-developer・nextjs-developer・react-specialist・vue-expertなどフレームワーク別の専門subagentまで揃っており、現実のチーム構成のほとんどを1セットでカバーできる。
Infrastructureも実戦的だ。cloud-architect、kubernetes-specialist、terraform-engineer、docker-expert、terragrunt-expert、さらにWindows系の windows-infra-admin、Azureの azure-infra-engineer、SREの sre-engineer、incident-responder、devops-incident-responder まで、IaC・コンテナ運用・障害対応の3本柱がフルでそろう構成になっている。
カテゴリ選びの目安
- ・新規Webサービス：voltagent-core-dev＋voltagent-lang＋voltagent-infra＋voltagent-qa-sec。
- ・データ／ML基盤：voltagent-data-ai＋voltagent-infra＋voltagent-qa-sec。
- ・社内ツール開発：voltagent-core-dev＋voltagent-dev-exp＋voltagent-biz。
- ・自律エージェント設計：voltagent-meta＋voltagent-data-ai＋voltagent-research。
subagentの仕組み——独立コンテキストとスマートモデルルーティング
Claude CodeのsubagentがOSS化されているテキスト断片以上の意味を持つのは、Anthropicが用意した4つの設計原則の上に乗っているからだ。awesome-claude-code-subagentsは、この原則をフル活用するように個々のsubagentを設計している。
- ・Independent Context Windows：各subagentはメインの会話とは別の独立コンテキストで走る。レビュー結果だけがメインに戻り、内部の試行錯誤は持ち込まれない。
- ・Domain-Specific Intelligence：システムプロンプトに役割・チェックリスト・出力フォーマットが詰め込まれており、汎用LLMより一貫した結果を返す。
- ・Shared Across Projects：プロジェクト固有（`.claude/agents/`）と全プロジェクト共通（`~/.claude/agents/`）の2段配置で、チーム全体に同じsubagentを行き渡らせられる。
- ・Granular Tool Permissions：subagent別に利用可能なツールを限定できるため、レビュー系には書き込み権を渡さない、といったセキュリティ制御が可能になる。
awesome-claude-code-subagentsの全subagentは、この4原則を前提にフロントマターでmodelとtoolsがあらかじめ設定済みだ。READMEに掲載されたスマートモデルルーティングの方針が下表だ。
| モデル | 使い所 | 該当subagentの例 |
|---|---|---|
| opus | 深い推論——アーキテクチャレビュー、セキュリティ監査、金融ロジック | security-auditor / architect-reviewer / fintech-engineer |
| sonnet | 日常コーディング——実装、デバッグ、リファクタリング | python-pro / backend-developer / devops-engineer |
| haiku | 軽量タスク——ドキュメント生成、検索、依存チェック | documentation-engineer / seo-specialist / build-engineer |
opusとsonnetとhaikuではトークン単価が大きく違うため、「全部opusに振る」運用はコスト面で破綻する。awesome-claude-code-subagentsはタスクの複雑さに応じてあらかじめモデルを最適化しており、ユーザーは何も考えず使い始めても、コードレビューが重いopus、リネームが軽いhaikuで自動的に走る。model: inherit を指定すればメイン会話と同じモデルに揃えることもできる。
ツール権限の付与も同じ思想で整理されている。
| subagentの種別 | 既定ツール | 設計意図 |
|---|---|---|
| 読み取り系（reviewers / auditors） | Read / Grep / Glob | 解析はするが書かない。レビュー結果のみメインへ返す |
| 調査系（analysts / researchers） | Read / Grep / Glob / WebFetch / WebSearch | 外部情報を集めて要約。書き込み権はなし |
| 実装系（developers / engineers） | Read / Write / Edit / Bash / Glob / Grep | コード生成・実行までフル権限 |
| ドキュメント系（writers / documenters） | Read / Write / Edit / Glob / Grep / WebFetch / WebSearch | 調査と書き込みを兼ねる |
「最小権限の原則」がカタログ全体で徹底されているため、無闇に131個全部入れてもツール越しの事故は起こりにくい設計になっている。 ただし、本番プロジェクトに入れる前に各.mdのフロントマター tools を確認しておくのが安全な運用だ。
アーキテクチャ全体像——Claude CodeとPlugin Marketplaceの関係
awesome-claude-code-subagentsを実際に使うと、ファイルが手元の.claude/に流れ込んでくる流れは次のようになる。Plugin Marketplaceを経由する場合と、curlで直接落とす場合で経路が変わる。
(対話型)"] CLI -->|plugin marketplace add| MK["VoltAgent Marketplace
(10カテゴリ)"] MK -->|plugin install| CAT["categories/
NN-xxxx/"] SCRIPT --> CAT CAT -->|配置| LOC[".claude/agents/
(プロジェクト)"] CAT -->|配置| GLB["~/.claude/agents/
(グローバル)"] LOC --> CC[Claude Code 起動] GLB --> CC CC -->|タスクに応じて呼出| SUB["subagent 個別
独立コンテキスト"] SUB -->|model/tools 自動付与| RUN[Anthropic API]
Plugin Marketplace経由はバージョン管理がClaude Code側にゆだねられるのが利点で、claude plugin update で一括追従できる。curl／対話型スクリプトはGitHub上のmainブランチから直接ファイルを引いてくるため、最新を即時反映したいときや、特定のsubagentだけピンポイントで入れたいときに使う。
導入後はClaude Code起動中に該当タスクが発生すると、メインの会話モデルが自動的にsubagentを呼び出す。「コードレビューして」と言えばcode-reviewer、「TerraformでGKEを書いて」と言えばterraform-engineerが呼び出され、結果のサマリだけがメイン会話に戻る。プロジェクト固有のsubagentが優先され、グローバルが補完する。
4通りのインストール方法とClaude Code Plugin Marketplaceの実体
READMEは4つのインストール方法を並べている。それぞれの使い所が違うので順に整理する。
方法1：Plugin Marketplace（推奨）
Claude CodeのPlugin Marketplace機構を使う方法。安定版を継続的に取り込みたい組織での既定解になる。
# VoltAgentのMarketplaceを登録
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
# カテゴリ単位で導入（複数指定可）
claude plugin install voltagent-lang
claude plugin install voltagent-infra
claude plugin install voltagent-qa-sec
各プラグインは前述の10カテゴリに対応する。Meta & Orchestration（voltagent-meta）は他のカテゴリと組み合わせて初めて機能を発揮する設計になっているため、最後に入れるのが推奨されている。
方法2：対話型インストーラ（install-agents.sh）
git cloneしてからスクリプトを走らせる方式。「中身を全部見てから決めたい」場合に向く。
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
./install-agents.sh
カテゴリ・subagentを一覧から選び、グローバル／プロジェクトのどちらに置くかも対話で決められる。アンインストールも同じスクリプトで可能だ。社内勉強会でClaude Codeを触ってもらうデモ用途に向いている。
方法3：curlワンライナー（クローン不要）
リポジトリ全体を持ってきたくない場合の最小構成。GitHubから直接スクリプトを取得して実行する。
curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.sh
クローンが要らない代わりに、ネットワーク経由でsubagent本体を都度取得する。curl が使える環境であれば、CIや使い捨てワークスペースでも素早く立ち上げられる。
方法4：agent-installerをsubagentとして使う
最も「Claude Codeらしい」やり方が、Meta & Orchestration配下にある agent-installer 自身をsubagentとして入れてしまう方法だ。
curl -s https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/09-meta-orchestration/agent-installer.md \
-o ~/.claude/agents/agent-installer.md
そのあとClaude Code内で「agent-installerを使って利用可能なカテゴリを表示して」「PHP系のsubagentを探してphp-proをグローバルに入れて」のように自然言語で頼める。Claude Codeをパッケージマネージャとして使う発想で、最初に1つだけ入れておくと残りは会話で済む。
本番投入前のチェック
- ・
.claude/agents/配下に既存ファイルがあるか確認し、上書きされうるものをgitで退避する。 - ・各subagentの
toolsフィールドを開き、不要なBash・Writeが付いていないか目視確認する。 - ・READMEに「無監査」と明記されているため、セキュリティクリティカルな業務利用ではsystem promptの文面まで読む。
subagent単体のファイル構造——フロントマターで完結する設計
Claude Codeのsubagentが採用する標準テンプレートは、awesome-claude-code-subagents配下でも一貫している。次のYAMLフロントマター＋システムプロンプトの組み合わせだ。
---
name: subagent-name
description: When this agent should be invoked
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---
You are a [role description and expertise areas]...
[Agent-specific checklists, patterns, and guidelines]...
## Communication Protocol
Inter-agent communication specifications...
## Development Workflow
Structured implementation phases...
4つのキーが要点だ。name はClaude Code内でsubagentを指す識別子、description はメインの会話モデルが「このsubagentを呼び出すべきか」を判断する材料になる。tools は最小権限の原則に基づいて付与し、model はopus／sonnet／haiku／inheritから選ぶ。
本文側にはチェックリスト、出力フォーマット、他subagentとの通信プロトコルが書き込まれている。たとえば security-auditor であればOWASP Top 10に沿った検査項目、refactoring-specialist であればコード変更前後の差分提示形式、multi-agent-coordinator であれば他subagentへのタスク分配ルールが、それぞれシステムプロンプトに直接埋め込まれている。
この設計の利点はファイル1つで完結することだ。.claude/agents/{name}.md を1個コピーすれば、その瞬間からClaude Codeはそのsubagentを認識する。subagent同士の依存関係はマークダウンの相互参照だけで表現されるため、Gitでバージョン管理する場合もdiffが読みやすい。
類似OSSとの比較——awesome-claude-code-subagentsをどう位置づけるか
Claude Code拡張系のOSSは2026年に入って急増した。代表的な3つと並べると棲み分けが見える。
| プロジェクト | 主役 | 対象 | スター | 強み |
|---|---|---|---|---|
| VoltAgent/awesome-claude-code-subagents | subagent単体 | Claude Code専用 | 19.8K | 131個超／カテゴリ別Pluginで配布／モデルとツール権限を最適化済み |
| davila7/claude-code-templates | Agent＋Command＋MCP＋Skill＋Hook＋Setting | Claude Code専用 | 26.8K超 | 横断インストーラ／Analytics・Plugin Dashboard内蔵 |
| VoltAgent/awesome-codex-subagents | subagent単体（toml） | OpenAI Codex CLI専用 | 3.8K | 同コンセプトのCodex版／sandbox_mode制御 |
claude-code-templatesは「Claude Code拡張のすべて」を扱う横断的インストーラで、awesome-claude-code-subagentsは「subagentに専門特化したカタログ」だ。両者は競合というより役割分担に近い：Slash CommandやMCPサーバまで揃えたい場合はclaude-code-templates、subagentラインナップを厚く持ちたい場合はawesome-claude-code-subagents、両方使う組織も珍しくない。
Codex版（awesome-codex-subagents）はsubagentコンセプトを別のCLIに移植したもので、toml形式・sandbox_modeによるアクセス制御などCodex特有の仕様に最適化されている。Claude CodeとCodexの両方を社内で運用している場合は、両方をフォークして社内向けに整理しているチームもある。
選び分けの目安
- ・subagent資産だけを厚く欲しい：awesome-claude-code-subagents。
- ・MCP・Skillも含めて一括導入したい：claude-code-templatesを軸に、足りないsubagentを本リポジトリから補う。
- ・Codex側も並行運用：両VoltAgent資産を使い、社内で命名規則を揃える。
実運用で押さえる注意点——subagentカタログを「無監査」で入れない
awesome-claude-code-subagentsは便利だが、リポジトリのREADME末尾に重要な注意書きがある。「All subagents are provided “as is” without warranty. We do not audit or guarantee the security or correctness of any subagent. Review before use」 という一文だ。コミュニティ寄稿が多いカタログでは現実的な但し書きだが、本番投入する側は読み飛ばしてはいけない。
実運用で特に確認しておきたいのは次の3点だ。
- ・tools フィールドの最終確認：レビュー系・監査系のsubagentに
WriteやBashが付いていないか。意図せず広い権限が付与されていれば外す。 - ・システムプロンプト内の外部呼び出し：
WebFetch権限がある場合、特定ドメインへの問い合わせを促すプロンプトが入っていないか。組織のネットワークポリシーに抵触する可能性を消す。 - ・model指定とコスト試算：opus指定のsubagentが何個あるかを把握し、月次トークンコストの上振れを織り込む。重い解析タスクが続けばopus呼び出しが累積する。
組織内で運用する場合は、本家をそのまま使うのではなくフォークして社内向けのtools制限・descriptionの日本語化・組織独自の規約を追記するのが定石だ。プロジェクトローカル（.claude/agents/）が常に優先されるため、本家のsubagent名と同名でフォークを置けば自然に上書きできる。
サブエージェント設計の前提となるClaude Code側の挙動については、Claude Code開発者Thariqが語るSkills 9カテゴリ実践則 で詳述したように、コンテキスト分離とツール権限の二軸で考えるのが基本だ。awesome-claude-code-subagentsはそこに「即使える具体例131個」を流し込んでくれるリソース集として位置づけられる。
まとめ——Claude Code subagent運用の出発点として
awesome-claude-code-subagentsは、Claude Code subagentを「ゼロから設計して書く」段階から「キュレーション済みカタログを取捨選択する」段階へと、運用の前提を一段引き上げてくれるリポジトリだ。131個超という規模、10カテゴリの整理、モデルルーティングとツール権限の最適化、Plugin Marketplaceでのカテゴリ単位配布——これらが組み合わさることで、subagent運用のハードルは確実に下がっている。
一方で、READMEが明言する「無監査」の現実は変わらず、本番運用前のレビューはユーザー側の責任に残る。本家をそのまま入れるのではなく、フォークして社内向けに整える運用が、結局のところ一番スジが良い。同じVoltAgentが出している Codex版のサブエージェント集 と合わせれば、Claude CodeとCodexを並走する組織でも一貫した命名・カテゴリ体系を保てる。
Claude Code拡張全体を見渡して横断的に入れたい場合は claude-code-templatesの解説 も合わせて読むと、自社の構成を組み立てやすい。
