Claude Code には、「サブエージェント」という機能があります。役割ごとに別の AI エージェントを用意しておき、仕事を任せられる機能です。
私は、この機能で仕事を6つの「部署」に分けて使っています。部署を作った理由と、部署が実際に止めた出来事は、AIエージェントを「部署」に分けた記事に書きました。
この記事では、出来事ではなく、設定の考え方を書きます。何を1か所にまとめ、何を部署ごとに分けたか。どこまでを AI に任せ、どこを人が決めるか。2週間ほど使ってみて、設定が古くなっていたことにも気づいたので、それも書きます。設定ファイルの中身やコードは載せません。
この記事で分かること
- サブエージェントとは何か(公式の説明から)
- 全体の決まりと、部署ごとの設定の分け方
- 「いつ、この部署に任せるか」の書き方
- 書き込める場所の分け方と、その限界
- 止める役を別にすることと、人が決める場所
- 部署の設定が、古くなっていたこと
1. サブエージェントとは
公式の説明(「Create custom subagents」のページ、英語。2026年11月12日に確認)によると、サブエージェントは、決まった種類の仕事を受け持つ AI です。次のような特徴があります。
- それぞれが、自分専用の会話の場(コンテキスト)で動く。仕事が終わると、まとめだけを元の会話に返す
- それぞれに、専用の指示と、使ってよい道具を決められる
- 元の会話の AI は、各サブエージェントの「説明」を読んで、どれに仕事を任せるかを決める
設定は、サブエージェントごとに1つのファイルです。ファイルの先頭に、名前・いつ使うかの説明・使ってよい道具を書き、その下に、そのサブエージェントへの指示を書きます。
2. 全体の決まりは1か所、部署の設定は1部署1ファイル
私の使い方では、話しかけるのは「社長役」の AI(ふだんの Claude Code の会話)だけです。社長役が、依頼の内容を見て、合う部署に仕事を振ります。部署の仕事が終わると、結果が社長役に戻り、社長役が私に報告します。

設定は、2つの層に分けました。
- 全体の決まり:プロジェクトのフォルダの一番上に置く、Claude Code が読む指示のファイル(CLAUDE.md)に書く。部署の一覧(フォルダ・部署・役割)、仕事の流れ、全部署に共通の決まりを書いている
- 部署ごとの設定:部署ごとに1ファイル。部署は6つ(経営企画・リサーチ部・戦略部・リスク管理部・運用部・広報部)なので、6ファイル。担当する仕事と、その部署だけの「守ること」を書いている
公式の説明では、自分で作ったサブエージェントも、CLAUDE.md を読み込んで始まります。つまり、全部署に共通の決まりは、全体の指示のファイルに1回書けば、どの部署にも届きます。部署ごとのファイルに同じことを何度も書かずに済みます。

部署ごとの設定は短くしています。6つとも、20〜34行です。くわしい手順や決まりは、各部署のフォルダの中の文書に書き、設定からは「この文書に従う」と指すだけにしています。たとえば広報部の設定は、発信のルールの文書を指しています。

3. 「いつ、この部署に任せるか」を1文で書く
部署ごとの設定の先頭には、「いつ使うか」の説明を書きます。社長役は、この説明を読んで、どの部署に任せるかを決めます。
私は、説明を「部署名。〇〇するとき、△△するときに使う。」という形の1文にそろえました。たとえば、リスク管理部なら「戦略を本番に出す前の検証や、全体のリスクの確認を行うときに使う」という内容です。

公式の説明でも、説明は短くし、くわしいことはサブエージェントの本文に移すように、と書かれています。
4. 書き込める場所を、部署のフォルダで分ける
部署ごとにフォルダを1つ持たせ、決まりを1つ置きました。
他の部署のフォルダは読んでよい。書き込むのは、自分の部署のフォルダだけ。
たとえばリスク管理部は、戦略部の作ったものを読んで確かめますが、直しません。問題を見つけたら、報告に書いて返します。直すのは戦略部です。こうしておくと、誰が何を変えたかが、フォルダを見れば分かります。

部署の成果物は、それぞれのフォルダの中の報告の場所に、「日付_内容」の名前で残します。11月12日の時点で、6部署の報告は合わせて128本になりました。
ただし、この決まりには限界があります。今は、設定に書いた指示で守らせているだけで、道具の上では、どの部署もほかのフォルダに書き込めます。6部署とも、ファイルを読む・探す・書く・直す道具と、コマンドを動かす道具を持っているからです。
外のウェブを調べる道具を持っているのは、リサーチ部だけです。ただ、コマンドを動かす道具があれば、ほかの部署も外のページを読めます。道具の一覧だけで、できることを完全に閉じているわけではありません。
公式の説明には、使ってよい道具を絞ったり、使わせない道具を指定したりする方法があります。今の私の設定では、書き込みを道具の上で閉じることはしていません。そうするかどうかは、まだ決めていません。
| 設定に書いた指示 | 道具の上 | |
|---|---|---|
| ほかの部署のフォルダへの書き込み | しない(自分の部署のフォルダだけ) | できる(6部署とも、書く・直す・コマンドを動かす道具を持っている) |
| 外のウェブを調べる | ― | 調べる道具はリサーチ部だけ。ただしコマンドを動かす道具で、ほかの部署も外のページを読める |
| 道具の上で閉じるか | ― | 絞る方法はある。閉じるかどうかは、まだ決めていない |
5. 止める役を別にし、人が決める場所を決める
部署に分けるときに一番大事にしたのは、作る役と、止める役を別にすることです。
- 戦略部が作ったものは、リスク管理部の確認を通らないと本番に出さない。承認のないものは本番に出さない
- 本番の環境を変える前には、必ず私の承認を取る
- 実際の注文は、私が出す。AI がするのは、推奨と計算まで
- 記事の公開も、毎回私の承認を取る。広報部が作るのは下書きまで。この記事も、広報部が下書きを作り、私が承認してから公開しています
止める役がいても、最後に決めるのは人です。どこで人が決めるかを、全体の決まりに書いておくと、どの部署もそこで止まって私に返してきます。

決めたことは、番号を付けて1つのファイルに残しています。部署が増えても、何が決まっていて、何が決まっていないかを、あとから追えるようにするためです。
6. 部署の設定が、古くなっていた
この記事を書くために、6つの部署の設定を読み直しました。すると、運用部の「いつ使うか」の説明に、11月に引っ越す前のサーバーの会社の名前が、そのまま残っていました。
部署の設定のファイルは、10月29日に作ってから、11月12日まで一度も書き換えていませんでした(変更の履歴で確かめました)。同じ間に、全体の指示のファイルは1回、広報部の決まりの文書は、作った日のあとも何度か書き換えています。くわしい決まりを部署のフォルダの文書に置いたので、設定そのものを触る機会がなかったのです。
ふだん読まれる文書は、こまめに直されます。一方、最初に作った設定は、短い分、見直されにくい。運用部の説明は、仕事の振り分けに使われる部分なので、社長役に伝えて、直すかどうかを決めてもらうことにしました。運用部の説明は、11月13日に直しました。
まだ分からないこと
- 「書き込みは自分の部署だけ」を、指示のままにするか、道具の上で閉じるか
- 部署の設定を、いつ見直すか。今回は、たまたま読み直して気づきました
- 部署は6つのままでよいか
やって分かったこと
サブエージェントで部署を作るときは、部署ごとの設定を厚くするより、全体の決まりを1か所にまとめ、部署の設定は短く、くわしいことは部署のフォルダの文書に、という分け方が使いやすいと感じています。
ただ、短い設定は、作ったあとに見直されにくい。設定も、手順書と同じように、ときどき読み直す必要がありそうです。
関連記事:
- AIエージェントを「部署」に分けて、投資の仕組みを作る。止める役を別にした理由
- Claude Codeにサーバーを触らせるときの決まり。安全確認で止まったら、人が決める
- Claude CodeにWordPressを任せた1週間。予約が出ない、誰が直したか分からない、で足した決まり
- シリーズの目次:SERIES — AIに作業を任せるときの決まり。
出どころ:Claude Code の公式の説明「Create custom subagents」 https://code.claude.com/docs/en/sub-agents (英語、2026年11月12日に確認)
※ この記事は、仕組みづくりの記録です。特定の銘柄や投資手法をすすめるものではありません。