ClaudeCodeのAgent Teamsを体験できる手順書
**投稿者:** すぅ| PM & PdM🐈 (@suh_sunaneko)
**投稿日時:** 2026-02-07
**URL:** https://x.com/suh_sunaneko/status/2020129695350878650
**エンゲージメント:** Article形式の長文投稿
**カテゴリ:** 💻 技術Tips / 📖 学習リソース
**有益度:** ⭐⭐⭐ HIGH
---
概要
Claude Codeの新機能「Agent Teams」を非エンジニアでも体験できる手順書。「理屈はわかっていても実際どう使うのか全然わからなかった」という課題を解決するために、AIにデモを作ってもらった実例。「自分でSubAgent作らなくてもClaudeCodeが勝手にSubAgentっぽいものを作ってくれて実行してくれる」機能の実体験ガイド。
---
まとめ
🎯 Agent Teamsとは
**定義**: Claude Code 内で複数の Claude セッションを チームとして並列に協調させる仕組み
**イメージ**: 複数の AI インスタンスを分業・並行処理させることで、大規模なタスクや複雑なワークフローを効率的に進める
**著者の理解**:「自分でSubAgent作らなくてもClaudeCodeが勝手にSubAgentっぽいものを作ってくれて実行してくれる」
※厳密には違うかもしれないが、体験して理解する方が先
📝 デモ手順（そのまま実行可能）
#### 1. 目的
Agent Team を3人起動し、`docs/product-plan.md` に新規プロダクト企画書をまとめる。
**見れる光景**: 勝手にチーム作って並列作業している様子
#### 2. 事前準備（1回だけ）
**2-1. tmux インストール**
brew install tmux
tmux -V**2-2. グローバル設定（手動編集）**
対象: `~/.claude/settings.json`（グローバル設定）
既存内容は消さずに、次の2項目を反映:
- `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1"`
- `teammateMode = "tmux"`
例:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
},
"teammateMode": "tmux"
}#### 3. プロジェクト準備（毎回）
手動で以下を作成:
- フォルダ: `agent-team-demo`
#### 4. 起動
cd <対象リポジトリ>
tmux new -s agent-demo
claude**補足:**
- Cursor統合ターミナルでは分割ペインに見えないことがある（正常）
- 1画面のままでも Agent Team は動く
#### 5. 実行プロンプト（このまま貼る）
**途中から分割してくる:**
このリポジトリでエージェントチームを3人作成して開始してください。
新規プロダクト企画書を docs/product-plan.md に作成してください。
不足条件は仮定で進め、仮定は先頭に明記してください。
5分ごとに進捗共有し、30分で1案に統合してください。**観察できること**:
- 最初は直列（1人）で思考
- 途中から並列（複数人）で作業し始める
#### 6. 成功判定（確認ポイント）
✅ `docs/product-plan.md` が作成・更新されている
✅ 先頭に「仮定」が明記されている
✅ 進捗共有が複数回出ている（5分ごと）
✅ 最後に1案へ統合されている
---
X Article 本文（原文そのまま）
話題のClaudeCodeで新機能「Agent Teams」が登場しました。
非エンジニアの私は理屈はわかっていても実際どう使うのか全然わからなかったので、AIにデモを作ってもらったのでそのままシェアします。同じ気持ちの方がいれば参考にしてください。
note版はこちら: https://note.com/suh_sunaneko/n/nfe794eac6a23
Agent Teamsとは
Claude Code 内で複数の Claude セッションを チームとして並列に協調させる仕組み です。複数の AI インスタンスを分業・並行処理させることで、大規模なタスクや複雑なワークフローを効率的に進められます。
「自分でSubAgent作らなくてもClaudeCodeが勝手にSubAgentっぽいものを作ってくれて実行してくれる」みたいな理解で一旦いい気がしています。
※厳密には違うと思いますが。。。悪しからず
考えるより体験するべし
Agent Teamsを一回体験してみるためのデモ手順になります。この手順通りすれば、勝手にチームを作って並列作業をする様子をみることができました。一回やってみよう。
以下AIによって作ってもらったデモ手順書をそのまま貼り付けています
**1. 目的**
Agent Team を3人起動し、docs/product-plan.md に新規プロダクト企画書をまとめる。
勝手にチーム作って並列作業している光景を見ることができます。
**2. 事前準備（1回だけ）**
2-1. tmux インストール
brew install tmux
tmux -V2-2. グローバル設定（手動編集）
対象: `~/.claude/settings.json` ※グローバル設定
既存内容は消さずに、次の2項目を反映。
`env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1"`
`teammateMode = "tmux"`
例:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
},
"teammateMode": "tmux"
}**3. プロジェクト準備（毎回）**
手動で以下を作成。
フォルダ: `agent-team-demo`
**4. 起動**
cd <対象リポジトリ>
tmux new -s agent-demo
claude補足:
- Cursor統合ターミナルでは分割ペインに見えないことがある（正常）
- 1画面のままでも Agent Team は動く
**5. 実行プロンプト（このまま貼る）**
途中から分割してくるよ。
このリポジトリでエージェントチームを3人作成して開始してください。
新規プロダクト企画書を docs/product-plan.md に作成してください。
不足条件は仮定で進め、仮定は先頭に明記してください。
5分ごとに進捗共有し、30分で1案に統合してください。最初は直列（1人）で思考しているが、途中から並列（複数人）で作業し始める光景を見ることができました！
**6. 成功判定（確認ポイント）**
- `docs/product-plan.md` が作成・更新されている
- 先頭に「仮定」が明記されている
- 進捗共有が複数回出ている（5分ごと）
- 最後に1案へ統合されている
なんとなく動きがわかったので、ここから先は思っているように動いてもらうようにどうするかそれぞれの研究あるのみです！
---
活用ポイント
🎯 非エンジニア向けの優れた設計
**特徴:**
- **理屈より体験優先**: 「厳密には違うかも」と認めつつ、まず動かすことを優先
- **コピペ可能**: プロンプトそのまま貼れば動く
- **成功判定明確**: 何が起きれば成功かを具体的に示す
**学び:**
- 非エンジニアへの技術説明は「完璧な理解」より「最初の一歩」が重要
- AIを使ってデモ手順を作る→シェアする、のループが効率的
🚀 Vibe Coder Bootcamp運営者として
**カリキュラム設計への示唆:**
- **ハンズオン優先**: 概念説明より「まず動かす」
- **AIにデモ作らせる**: 手順書作成もAIに任せられる（著者が実証）
- **段階的な深掘り**: 「なんとなく動きがわかった」→「ここから先は各自研究」の流れ
**Workshop設計:**
1. 全員で同じプロンプト実行（5分）
2. Agent Teamsが動く様子を観察（10分）
3. 自分のタスクで試す（20分）
4. 振り返り・共有（15分）
💡 Agent Teamsの実用シーン
**適した作業:**
- 大規模ドキュメント作成（企画書、設計書）
- 複数視点が必要なもの（マーケティング戦略、プロダクトロードマップ）
- 並列可能なリサーチ（競合分析、市場調査）
**不向きな作業:**
- 単純・短時間のタスク（オーバーヘッドが大きい）
- 高度に統一された文体が必要なもの（複数人で書くと統一感が薄れる）
🔧 技術的補足
**tmuxの役割:**
- 複数Claudeセッションを並列管理
- ターミナル分割で視覚的に作業分担を確認可能
- セッション再接続可能（途中で切断しても復帰できる）
**EXPERIMENTAL flag:**
- 実験的機能なので、今後仕様変更の可能性
- グローバル設定に書くことで、全プロジェクトで有効化
---
関連リンク
- [note版（詳細）](https://note.com/suh_sunaneko/n/nfe794eac6a23)
- [Agent Teams公式ドキュメント](https://code.claude.com/docs/en/agent-teams)