サブエージェント研究室

Claude Code / 運用設計

Claude Code を「毎回同じ説明をする道具」から卒業させる

入門は終わった。次に必要なのは、サブエージェントの分業設計と権限の境界です。 このサイトでは、実機で動作を確認した設定ファイルと、その設計判断の理由をまとめた資料を公開しています。

Claude Code v2.1.221 で検証 サブエージェント 権限設計 hooks カスタムコマンド
無料ツールを使う 資料を見る

よくある詰まり

こういう状態になっていませんか

  • 毎回「レビューして。ただしファイルは直さないで」と説明し直している
  • 「編集後は必ずフォーマットして」と CLAUDE.md に書いたのに、忘れられる
  • 調査を頼んだらファイルの中身が会話に大量に流れ込み、本題の文脈が消えた
  • .claude/agents を書いてみたがエラーも出ずに動かない。原因が分からない
  • サブエージェントが気づけば Opus で動いていて、請求が想定外だった
  • ヒヤリとするコマンドを実行されかけた

これらは Claude Code の使い方が悪いのではなく、運用設定をしていないだけです。 そして運用設定は、フィールドを1つ間違えるだけでエラーを出さずに黙って無効になります。 だから「仕様を知っているか」が結果を分けます。

無料ツール

Claude Code エージェントジェネレーター

ブラウザ上のフォームに入力すると、.claude/agents/*.md と .claude/commands/*.md を 生成してダウンロードできます。登録不要・送信なし。入力内容はブラウザ内だけで処理され、サーバーへは送信されません。

仕様に沿った出力

frontmatter を間違えない

name に : が使えないこと、tools を書くと MCP ツールまで落ちること、 model の既定が inherit であること——迷いやすい箇所を入力時に検査します。

落とし穴の警告

「動かない」を先に潰す

既定のバックグラウンド実行で消えるツールを選んでいる、副作用のあるコマンドに disable-model-invocation が無い——といった点をその場で指摘します。

ひな形つき

白紙から書かない

レビュー担当・調査担当・テスト作成・一括変換など、役割別のシステムプロンプトのひな形を 読み込んでから編集できます。

ジェネレーターを開く

資料

設計の理由を知るための2点

ツールは「書き方」を助けますが、「なぜその設計にするか」は別です。そこを扱うのが次の2点です。

Zenn 有料本

Claude Codeサブエージェント設計実践ガイド
― マルチエージェントで開発を分業する

サブエージェントを「なんとなく使う」から「設計して運用する」へ。 対象は Claude Code を実務で数週間以上使った中級エンジニアで、入門解説は最小限です。

900円 / 全10章・第1〜2章は無料公開

  • 起動時にサブエージェントへ何が渡り、何が渡らないか（CLAUDE.md・git status・会話履歴）
  • tools / disallowedTools / permissions による三層の権限分離
  • 並列実行の3つの上限と、出力契約によるコンテキスト予算管理
  • スキル（カスタムコマンド）と hooks の連携、実践ワークフロー3件をファイル一式で
  • 失敗パターン17件の診断表と、実際に出たエラーメッセージの引用
Zenn で読む（900円）
BOOTH / ダウンロード

Claude Code 設定テンプレート集 Pro
― コピーして動く .claude/ 一式

記事ではなく実ファイルです。すべて Claude Code v2.1.221 の実環境で読み込ませ、 動作を確認しています。

2,980円 / ZIP・自動納品

  • サブエージェント定義 15種 — レビュー / セキュリティ監査 / 調査 / テスト作成 / DB調査 / 一括移行 ほか
  • カスタムコマンド 15種 — /review-diff /commit /fix-ci /security-scan ほか
  • 実用 hooks 9本 — 編集後の型チェック差し戻し / 危険コマンドブロック / 秘密ファイル保護 ほか
  • 失敗診断表 80項目以上 — 「書いたのに動かない」を症状から逆引き。各項目に確認コマンド付き
  • 動くサンプルリポジトリ — 全テンプレート適用済み。外部依存ゼロでテスト27件が通る
BOOTH で公開準備中（2,980円）

購入前にご確認ください。 どちらも Claude Code をすでに使っている方向けです。入門書ではありません。 テンプレート集はダウンロード商品のため、購入後の返品・返金はお受けできません。 hooks は bash 前提のため、Windows ネイティブ（PowerShell のみ）では動きません（WSL / Git Bash をご利用ください）。

方針

この資料が守っていること

1. 実機検証済みのことしか書かない

掲載した設定例・コマンド・エラーメッセージは、Claude Code v2.1.221（macOS）の実環境で実行して確認したものです。 仕様は公式ドキュメント（code.claude.com）を一次資料として突き合わせ、記憶に頼っていません。 「たぶんこう動く」という推測は書いていません。

2. 汎用論を書かない

「レビューしてください」だけのエージェント定義に価値はありません。 やってはいけないこと・報告フォーマット・判定基準まで書き込んだものだけを載せています。

3. 削ることを勧める

選択肢が多いと Claude は選び間違えます。「使わないエージェントは消す」「allow から使っていないツールを消す」—— 全部入れさせて満足させる作りにはしていません。

4. 捏造した実績を書かない

「導入して開発速度が○%向上した」のような、検証していない効果の主張はしていません。 書いているのは、資料の内容と、実機で確認できた動作の範囲だけです。

項目内容
検証バージョンClaude Code v2.1.221
推奨バージョンv2.1.200 以降
OSmacOS / Linux / WSL（hooks は bash 前提）
必須ツールjq（テンプレート集の hooks が依存）
無料ツールの動作環境モダンブラウザ（JavaScript 有効）。サーバー送信なし

AI 利用に関する開示。 このサイトおよび公開している資料は、生成AI（Anthropic Claude）の支援を受けて制作し、 内容は制作者が検証しています。仕様の裏付けは公式ドキュメントを取得して突き合わせ、 設定例は実機で動作を確認しました。架空の利用実績・体験談・レビューは含まれていません。

Claude および Claude Code は Anthropic 社の製品です。 本サイトは Anthropic 社の公式サイトではなく、同社と提携・承認関係にありません。