Claude Codeのサブエージェントで「部署」を作る。全体の決まり・部署の設定・止める役の分け方

Claude Codeのサブエージェントで「部署」を作る。全体の決まり・部署の設定・止める役の分け方

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 の会話)だけです。社長役が、依頼の内容を見て、合う部署に仕事を振ります。部署の仕事が終わると、結果が社長役に戻り、社長役が私に報告します。

私が社長役に話し、社長役が6つの部署に仕事を振り、部署がまとめを返す図
話しかけるのは社長役だけ。部署は自分の場で動き、まとめを返す

設定は、2つの層に分けました。

  • 全体の決まり:プロジェクトのフォルダの一番上に置く、Claude Code が読む指示のファイル(CLAUDE.md)に書く。部署の一覧(フォルダ・部署・役割)、仕事の流れ、全部署に共通の決まりを書いている
  • 部署ごとの設定:部署ごとに1ファイル。部署は6つ(経営企画・リサーチ部・戦略部・リスク管理部・運用部・広報部)なので、6ファイル。担当する仕事と、その部署だけの「守ること」を書いている

公式の説明では、自分で作ったサブエージェントも、CLAUDE.md を読み込んで始まります。つまり、全部署に共通の決まりは、全体の指示のファイルに1回書けば、どの部署にも届きます。部署ごとのファイルに同じことを何度も書かずに済みます。

全体の決まり、部署ごとの設定、部署のフォルダの文書の3段の図
全体の決まりは1か所に、部署の設定は短く、くわしいことは部署のフォルダに

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

全体の決まりのファイルの、部署の一覧と共通ルールの一部
実際の全体の決まりのファイル(CLAUDE.md)の一部(見やすく整えたもの)。青い印は、この記事で付けたもの。「…」は省いたところ

3. 「いつ、この部署に任せるか」を1文で書く

部署ごとの設定の先頭には、「いつ使うか」の説明を書きます。社長役は、この説明を読んで、どの部署に任せるかを決めます。

私は、説明を「部署名。〇〇するとき、△△するときに使う。」という形の1文にそろえました。たとえば、リスク管理部なら「戦略を本番に出す前の検証や、全体のリスクの確認を行うときに使う」という内容です。

6つの部署の設定ファイルの「いつ使うか」の説明の行を並べたもの
実際の6つの部署の設定の「いつ使うか」の行(見やすく整えたもの。運用部の行は11月13日に直したあとのもの)。太字は部署名

公式の説明でも、説明は短くし、くわしいことはサブエージェントの本文に移すように、と書かれています。

4. 書き込める場所を、部署のフォルダで分ける

部署ごとにフォルダを1つ持たせ、決まりを1つ置きました。

他の部署のフォルダは読んでよい。書き込むのは、自分の部署のフォルダだけ。

たとえばリスク管理部は、戦略部の作ったものを読んで確かめますが、直しません。問題を見つけたら、報告に書いて返します。直すのは戦略部です。こうしておくと、誰が何を変えたかが、フォルダを見れば分かります。

リスク管理部の設定ファイル。書き込むのは自分のフォルダだけと書かれている
実際のリスク管理部の設定の一部(見やすく整えたもの。使ってよい道具の名前は省いた)。青い印は、この記事で付けたもの。「…」は省いたところ

部署の成果物は、それぞれのフォルダの中の報告の場所に、「日付_内容」の名前で残します。11月12日の時点で、6部署の報告は合わせて128本になりました。

ただし、この決まりには限界があります。今は、設定に書いた指示で守らせているだけで、道具の上では、どの部署もほかのフォルダに書き込めます。6部署とも、ファイルを読む・探す・書く・直す道具と、コマンドを動かす道具を持っているからです。

外のウェブを調べる道具を持っているのは、リサーチ部だけです。ただ、コマンドを動かす道具があれば、ほかの部署も外のページを読めます。道具の一覧だけで、できることを完全に閉じているわけではありません。

公式の説明には、使ってよい道具を絞ったり、使わせない道具を指定したりする方法があります。今の私の設定では、書き込みを道具の上で閉じることはしていません。そうするかどうかは、まだ決めていません。

設定に書いた指示道具の上
ほかの部署のフォルダへの書き込みしない(自分の部署のフォルダだけ)できる(6部署とも、書く・直す・コマンドを動かす道具を持っている)
外のウェブを調べる―調べる道具はリサーチ部だけ。ただしコマンドを動かす道具で、ほかの部署も外のページを読める
道具の上で閉じるか―絞る方法はある。閉じるかどうかは、まだ決めていない

5. 止める役を別にし、人が決める場所を決める

部署に分けるときに一番大事にしたのは、作る役と、止める役を別にすることです。

  • 戦略部が作ったものは、リスク管理部の確認を通らないと本番に出さない。承認のないものは本番に出さない
  • 本番の環境を変える前には、必ず私の承認を取る
  • 実際の注文は、私が出す。AI がするのは、推奨と計算まで
  • 記事の公開も、毎回私の承認を取る。広報部が作るのは下書きまで。この記事も、広報部が下書きを作り、私が承認してから公開しています

止める役がいても、最後に決めるのは人です。どこで人が決めるかを、全体の決まりに書いておくと、どの部署もそこで止まって私に返してきます。

戦略部が作り、リスク管理部が確かめ、本番の変更・実際の注文・記事の公開は私が決める図
止める役がいても、本番の変更・注文・公開は人が決める

決めたことは、番号を付けて1つのファイルに残しています。部署が増えても、何が決まっていて、何が決まっていないかを、あとから追えるようにするためです。

6. 部署の設定が、古くなっていた

この記事を書くために、6つの部署の設定を読み直しました。すると、運用部の「いつ使うか」の説明に、11月に引っ越す前のサーバーの会社の名前が、そのまま残っていました。

部署の設定のファイルは、10月29日に作ってから、11月12日まで一度も書き換えていませんでした(変更の履歴で確かめました)。同じ間に、全体の指示のファイルは1回、広報部の決まりの文書は、作った日のあとも何度か書き換えています。くわしい決まりを部署のフォルダの文書に置いたので、設定そのものを触る機会がなかったのです。

ふだん読まれる文書は、こまめに直されます。一方、最初に作った設定は、短い分、見直されにくい。運用部の説明は、仕事の振り分けに使われる部分なので、社長役に伝えて、直すかどうかを決めてもらうことにしました。運用部の説明は、11月13日に直しました。

まだ分からないこと

  • 「書き込みは自分の部署だけ」を、指示のままにするか、道具の上で閉じるか
  • 部署の設定を、いつ見直すか。今回は、たまたま読み直して気づきました
  • 部署は6つのままでよいか

やって分かったこと

サブエージェントで部署を作るときは、部署ごとの設定を厚くするより、全体の決まりを1か所にまとめ、部署の設定は短く、くわしいことは部署のフォルダの文書に、という分け方が使いやすいと感じています。

ただ、短い設定は、作ったあとに見直されにくい。設定も、手順書と同じように、ときどき読み直す必要がありそうです。

関連記事:

出どころ:Claude Code の公式の説明「Create custom subagents」 https://code.claude.com/docs/en/sub-agents (英語、2026年11月12日に確認)

※ この記事は、仕組みづくりの記録です。特定の銘柄や投資手法をすすめるものではありません。