0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

「中級者」の次へ — Claude Codeに“組織”を運営させる4つの上級運用パターン

0
Last updated at Posted at 2026-07-26

CLAUDE.md を整え、Skills を書き、MCP を繋ぎ、Hooks で自動チェックを回す。ここまで来ると「中級者」を名乗れます。

でも、その次で多くの人が同じ壁にぶつかります。エージェントを2体3体と増やした瞬間に、なぜか全体が遅くなり、しかも事故が起きやすくなる。 私も最初はここで盛大に転びました。

この記事は入門〜中級のロードマップ(CLAUDE.md / Skills / MCP / Hooks)のその先、つまり「1体のエージェントを使いこなす」から「複数のエージェントを“組織”として運営する」に踏み込むときの運用パターンを4つに絞って書きます。個人で12部門ぶんのエージェント体制(庶務の約90%を自動化、運用は月$200のプランのみ)を回してきた中で、実際に効いたものだけを残しました。

中級までの“おさらい”と、上級で変わる関心事

まず立ち位置の確認です。中級までは「1体のエージェントの精度」を上げるゲームでした。CLAUDE.md はその中心です。

私も新規プロジェクトで毎回同じ前提を説明するのに1回5〜10分かけていた頃、技術スタック・規約・ディレクトリ構成・禁止事項を約200行の CLAUDE.md にまとめただけで、前提説明が不要になり1日あたり約30分が浮きました。これは「AIへの引き継ぎ書」を書く感覚で、新人向けドキュメントとまったく同じです。

ところが、エージェントを増やして“組織化”しはじめると、関心事がガラッと変わります。

観点 中級(1体を極める) 上級(複数体を運営する)
中心ファイル CLAUDE.md ペルソナ + ルーティング + 承認キュー
速さの源 プロンプト最適化 役割分担・コンテキスト分割
リスク 出力ミス 外部への誤操作・暴走
並行性 気にしない git 競合・同時書き込み
コスト ほぼ意識しない トークン単価×体数で急増

上級で効くのは、プロンプトの巧さより運用設計です。以下、順に見ていきます。

パターン① 役割分担 — 「一人に全部」をやめる

最初にやりがちなのが、優秀な1体に何でも頼むことです。これが罠でした。

ある個人プロジェクトで全業務を1体に集約したところ、コンテキストが肥大化して応答が遅くなり、的外れな回答が増えていきました。人間で言えば、経理も開発も営業も一人に押し付けてパンクさせている状態です。

そこで役割別にエージェントを分割し、受付役(秘書)が用件を振り分ける構成に変えました。

agents/
├── secretary.md   # ルーティング担当(受付)
├── dev.md         # 開発担当
├── writer.md      # 文章担当
└── ops.md         # 運用・自動化担当

各エージェントには専用のペルソナファイルを持たせます。ポイントは、話し方・一人称・語尾・専門分野・対応方針を明文化すること。私の場合は約50行のペルソナ定義でトーンが安定し、「場面によって別人のように応答がブレる」問題が消えました。カスタマーサポートの対応マニュアルと本質は同じです。

役割分割の結果は明確でした。各エージェントの応答精度が約40%向上し、処理速度は平均2倍。「一人に全部頼む」より「適材適所に振る」ほうが圧倒的に良い——人間の組織設計とまったく同じ原理です。

判断の目安はシンプルにこうしています。

  • 1体のコンテキストが「複数の専門領域」にまたがり始めたら分割のサイン
  • 分割したら、受付役(ルーター)を1体だけ立てて入口を一本化する
  • 増やすのは役割単位。「なんとなく2体目」は作らない

パターン② 承認フロー — 外部への操作だけは自動化しない

組織化して怖いのは、エージェントが外向きのアクションを自律実行することです。

一度、エージェントにメール送信や外部API呼び出しまで自律で任せたところ、誤送信を1回やらかして冷や汗をかきました。内部でファイルを書き換えるのと、外に向けてメールを飛ばすのは、事故ったときの重さが桁違いです。

そこで、外部向けアクションには必ず「承認キュー」を挟みました。ドラフト生成 → キュー格納 → 人間承認 → 実行の4ステップです。

# 承認が必要 vs 自動でよい の線引き(チートシート)

自動でOK(内部・可逆)        承認必須(外部・不可逆)
--------------------------  --------------------------
ファイル読み書き              メール送信
内部データ集計                SNS投稿
下書き生成                    請求書発行
テスト実行                    本番デプロイ
ローカルのコード修正           外部APIへの書き込み

実装イメージはこれだけです。

# エージェントは「実行」ではなく「キューへの投函」までしかやらない
queue_action() {
  local type="$1" payload="$2"
  echo "$(date -Iseconds) | $type | $payload | PENDING" >> approval-queue.md
  echo "承認待ちに積みました。承認後に実行します。"
}
# 人間が queue を確認 → APPROVED に書き換え → 実行スクリプトが拾って実行

効果は劇的で、誤送信・誤操作がゼロに。承認作業そのものは1日5分程度なので、安全性と効率をきちんと両立できます。「内部操作は自動、外部操作は承認必須」が、体感でいちばん安全なラインでした。

パターン③ git 並行制御 — 複数の書き手が同じブランチに触る問題

これは中級記事がまず触れない、上級ならではの課題です。

エージェント・複数ターミナル・cron・常駐ワーカーが同じブランチに同時に commit しようとすると、index の競合や rebase の途中停止が普通に起きます。1体で使っていたときは存在しなかった問題が、組織化した瞬間に牙をむきます。

解決の原則は「全ての書き手を1つのロックに通す」こと。commit / push / pull --rebase を直接叩かせず、ラッパー経由に一本化します。

#!/bin/bash
# ai-git.sh — 全エージェント共通の書き込みゲート
LOCK=/tmp/repo.lock
exec 9>"$LOCK"
flock 9 || { echo "他の書き手がロック中"; exit 1; }

git add "${@:2}"          # 明示パスのみ add(全部 add しない)
git commit -m "$1"
git push
# flock はスクリプト終了時に自動解放

ルールとしては次の3つを守るだけで、競合はほぼ消えます。

  1. 書き込みは必ずラッパー経由git commit の直接実行を禁止にする)
  2. git add . をしない。触ったファイルパスだけを明示的に add する
  3. 大きく独立した作業は worktree で物理的に分離して並走させる

読み取り系(status / log / diff)は自由にやらせてOKです。ロックが要るのは書き込みだけ。「全書き手が同一ロックを通る」——この一点を徹底できるかどうかで、並行運用の安定性がまるで変わります。

パターン④ コスト管理 — 体数×トークンで静かに膨らむ

最後はお金の話です。エージェントを増やすと、トークン消費は体数ぶん掛け算で効いてきます。ここを設計しないと、気づいたら請求が跳ねています。

私も一時期、LLMのAPI利用料が月5万円を超えていました。内訳を調べると、犯人は「不要に長いプロンプト」と「重複したコンテキストの送信」でした。

やったことは3つです。

  • プロンプトの共通部分をシステムプロンプト側に集約(毎回送らない)
  • 会話履歴の要約機能を実装(全履歴を毎回積まない)
  • キャッシュ可能なレスポンスはローカルにキャッシュ

結果、トークン使用量が約60%削減、月額は2万円に収まりました。しかも応答品質は落ちていません。コスト最適化は「何を送るか」の設計が9割で、不要なコンテキストを削るだけで劇的に下がります。

運用として効くのは、消費量を「1件あたり」で測っておくことです。ドラフト1本あたり、タスク1件あたりの $ を把握しておくと、「この自動化はペイしているか」を判断できるようになります。

まとめ — 上級とは「精度」から「運営」への視点の移動

中級までは1体のエージェントの精度を上げるゲーム、上級は複数のエージェントを事故なく安く走らせる運営のゲームです。最後に4パターンを一覧にしておきます。

パターン 課題 打ち手 効果(実測)
① 役割分担 1体の肥大化 役割別分割+受付ルーター+ペルソナ 精度+40% / 速度2倍
② 承認フロー 外部への暴走 draft→キュー→承認→実行 誤操作ゼロ / 承認1日5分
③ git並行制御 同時書き込み競合 単一ロックのラッパー経由 index競合の解消
④ コスト管理 体数×トークン増 共通化・要約・キャッシュ トークン-60%

順序も大事です。私の経験では ①役割分担 → ②承認フロー → ③git並行制御 → ④コスト管理 の順に必要になります。先に承認フローだけ作っても、役割が割れていないと結局1体がボトルネックになるからです。

特別なフレームワークは要りません。中身は Markdown とシェルスクリプト、そして CLAUDE.md の延長線上にある“運用設計”だけです。中級の道具立てはそのまま活きます。


この記事が参考になったら、いいね・ストック していただけると励みになります。

Claude Code・AIエージェント・業務自動化の実装Tipsを継続的に発信しています。フォロー しておくと新着が届きます。

みなさんは何体目のエージェントで「増やすと逆に遅くなる」壁にぶつかりましたか? ぜひコメントで教えてください。

関連記事

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?