Claude Agent Teams Setup

Claude Code Agent Teams - Windows Setup

Windows에서 Claude Code의 **Agent Teams (swarm) 모드**와 **tmux split pane**을 설정하는 자동화 가이드입니다.

Agent Teams란?

Claude Code의 Agent Teams는 여러 AI 에이전트가 동시에 협업하는 모드입니다. tmux split pane을 통해 각 에이전트의 작업을 실시간으로 볼 수 있습니다.

┌──────────────────┬──────────────────┐
│ @team-lead       │ @researcher      │
│ Planning...      │ Searching...     │
│                  │                  │
├──────────────────┼──────────────────┤
│ @coder           │ @tester          │
│ Writing code...  │ Running tests... │
│                  │                  │
└──────────────────┴──────────────────┘

빠른 시작

Claude Code로 자동 설정 (권장)

git clone 
cd claude-agent-teams-setup
claude
# → "설정 시작해줘"라고 입력

Claude Code가 CLAUDE.md를 읽고 단계별로 안내합니다. 사용자 조작이 필요한 부분에서는 친절하게 안내 후 대기합니다.

수동 설치

수동으로 설치하려면 클릭

1. WSL2 설치 (관리자 PowerShell)

wsl --install
# 재부팅 후 Microsoft Store에서 Ubuntu 설치

2. WSL Ubuntu에서 실행

# 기본 패키지
sudo apt update && sudo apt install -y tmux git curl

# Claude Code (네이티브 설치 — Node.js 불필요, 권장)
curl -fsSL https://claude.ai/install.sh | bash
# 새 터미널을 열거나 source ~/.bashrc 후:
claude            # 실행하면 브라우저 안내로 로그인

# (선택) Node.js — Claude Code엔 불필요. Node 기반 도구가 필요할 때만:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash
# 터미널 재시작 후:
nvm install --lts

# Oh My Tmux (선택)
cd ~ && git clone https://github.com/gpakosz/.tmux.git
ln -s -f .tmux/.tmux.conf
cp .tmux/.tmux.conf.local .

3. teammateMode 설정

cd ~/your-project
mkdir -p .claude
echo '{"teammateMode":"tmux","env":{"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS":"1"}}' > .claude/settings.local.json

4. 실행

tmux new-session -s claude
claude
# Agent Teams 실행 시 자동 split pane!

---

Core Setup (필수)

자동 설치 시 Claude Code가 수행하는 핵심 단계입니다:

단계	내용	실행
WSL2 + Ubuntu	Windows에서 Linux 환경 제공	사용자
tmux	터미널 분할 (spl