Enable multi-agent collaboration in Claude Code v2.1+ for parallel development workflows. Now powered by Opus 4.7 (April 16, 2026 release).
For Sports Media Inc. Training Site - Last Updated: May 12, 2026
Claude Code ships as a standalone native binary. Choose the instructions for your operating system.
Install via the official installer (recommended) or Homebrew:
# Recommended - official installer (auto-updates) curl -fsSL https://claude.ai/install.sh | bash # Alternative - Homebrew (manual updates) brew install claude-code
Works on Intel and Apple Silicon (M1/M2/M3/M4). Do not use sudo. If claude is not found after install, open a new terminal window.
# Official installer (auto-updates) curl -fsSL https://claude.ai/install.sh | bash
Supports Ubuntu 20.04+, Debian 10+, Fedora, Arch, and Alpine. Installs to ~/.claude/bin/.
Claude Code runs natively on Windows via PowerShell or CMD, or through WSL:
# Option A: Native Windows (PowerShell) winget install Anthropic.ClaudeCode # Option B: WSL (Ubuntu) - install WSL first if needed wsl --install -d Ubuntu # Then inside WSL: curl -fsSL https://claude.ai/install.sh | bash
WinGet does not auto-update. Run winget upgrade Anthropic.ClaudeCode to update manually. For agent teams with split panes, WSL with tmux is recommended.
claude --version claude doctor
claude doctor checks your installation type, version, and reports any issues.
Open your global Claude settings file:
# macOS / Linux code ~/.claude/settings.json # or: nano ~/.claude/settings.json # Windows (PowerShell) code $env:USERPROFILE\.claude\settings.json
Paste this configuration (replace everything in the file):
{
"alwaysThinkingEnabled": true,
"model": "opus",
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}Save the file. This enables agent teams across all your projects on this computer. The setting must be nested under the "env" key - not at the root level of the JSON.
Agent teams use tmux to spawn each teammate in its own terminal pane so you can see all agents working simultaneously. Install tmux for your platform:
brew install tmux
sudo apt update sudo apt install tmux
sudo dnf install tmux
Windows: tmux does not run natively on Windows. Use WSL (wsl --install), then install tmux inside your WSL distribution. Alternatively, set teammateMode to "in-process" in settings.json to run teammates without tmux (agents share your terminal instead of getting separate panes).
macOS iTerm2 users: Claude Code auto-detects iTerm2 as a split-pane backend. No extra configuration needed.
# Close your current Claude session exit # Start fresh with tmux, then launch Claude tmux claude
Setup Complete
Agent teams are now enabled globally. No per-project configuration needed.
A unified dashboard for managing multiple parallel Claude Code sessions from one terminal. Spawn, monitor, and attach to sessions without juggling tmux panes or windows.
npm install -g @anthropic-ai/claude-code@latest (need v2.1.139 or later).claude --version.claude agents, or press ← from inside any active session..tool-versions if you need stability.An agent team consists of a team lead (your main Claude session), one or more teammates (independent Claude instances), a shared task list, and a mailbox for inter-agent communication. The lead orchestrates the work while teammates execute tasks in parallel.
Before: "Update the website and push to Vercel."
With teams: "Use agent teams to update the website and push to Vercel."
Everything else stays the same - git, Supabase, Vercel, and all existing workflows work as before.
| Component | Role |
|---|---|
| Team Lead | Your main Claude Code session. Creates the team, spawns teammates, and coordinates work. |
| Teammates | Separate, independent Claude Code instances that each work on assigned tasks. |
| Task List | Shared list of work items with dependency tracking. Teammates claim and complete tasks. |
| Mailbox | Inbox-based messaging system for peer-to-peer communication between agents. |
Tasks have three states: pending, in progress, and completed. Tasks can depend on other tasks - a pending task with unresolved dependencies cannot be claimed until those dependencies are completed. File locking prevents race conditions when multiple teammates try to claim the same task.
Copy and paste these prompts directly into your tmux + Claude session. Each describes the team structure so Claude knows how to distribute the work.
Use agent teams to audit https://computersciencesop2.vercel.app. Have one agent check Lighthouse performance scores, another review accessibility/SEO, another analyze mobile responsiveness, and a fourth check all external links and student program URLs. Summarize findings with priority fixes.
Result: 4 agents work in parallel - performance, accessibility, responsiveness, and link validation - then the lead consolidates findings.
Use agent teams to deploy this project to Vercel. One agent runs the production build and tests, another handles git commit/push to the main branch, a third initiates Vercel deployment, and a fourth verifies the live URL and checks for deployment errors. Share the production URL when complete.
Result: Parallel execution of build, git, deploy, and verification.
Use agent teams to: update Supabase schema to add 'program_clicks' analytics table, update the homepage hero section with new messaging, add tracking to all student program signup buttons, test locally, commit to GitHub, and deploy to Vercel. Share the live URL and Supabase migration SQL.
Result: Multi-layer changes (database + UI + deploy) completed in parallel.
Use agent teams to create a new page for the GitHub Student Developer Pack at /programs/github-pack. One agent builds the Next.js page with all pack benefits listed, another creates the Supabase table for tracking signups, a third adds navigation links from the homepage, and a fourth deploys to Vercel and shares the URL.
Result: Complete feature from page creation to deployment.
Use agent teams to scan all pages on https://computersciencesop2.vercel.app for broken external links to student programs, verify each program is still active and the URLs are correct, update any outdated information (prices, deadlines, eligibility), commit changes, and deploy. Provide a summary of all fixes made.
Result: Comprehensive site maintenance with automated fixes.
Use agent teams to add a new section to the training site. One agent writes the documentation content following our existing format, another creates the page layout and navigation, a third adds code examples and setup instructions, and a fourth deploys to Vercel and validates all links work. Follow our existing design system.
Result: Documentation writing, page structure, code examples, and deployment handled in parallel.
| Task | Solo Claude | Agent Teams |
|---|---|---|
| Quick button color fix | Best choice - fast | Overkill |
| Routine deploy to Vercel | Best choice - simple | Not needed |
| Multi-step workflow (DB + UI + Deploy) | Slow, sequential | Parallel speed |
| Website audit (perf + a11y + SEO) | May miss angles | Parallel experts |
| Full feature (schema + code + test + deploy) | Sequential, slower | Parallel execution |
Rule of thumb: If your task has 3 or more independent steps, use agent teams. A 3-teammate team uses roughly 3-4x the tokens of a single session, so reserve teams for tasks where parallel execution provides a clear benefit.
Teammates start with a blank conversation - they do not inherit the lead's history. They load CLAUDE.md automatically, but task-specific details must be in your prompt. Be explicit about what files matter, what conventions to follow, and what "done" looks like.
Aim for roughly 5-6 tasks per teammate. Too granular and coordination overhead dominates. Too broad and you lose the benefit of parallelism. Each task should produce a clear deliverable (a function, a test file, a review).
There is no built-in file locking for code files. Two teammates writing to the same file means last write wins. Structure work so each teammate owns different files. If they need to touch the same file, sequence the tasks with dependencies.
Assign each teammate a distinct lens so they do not overlap. For example, when reviewing a PR: one focused on security, one on performance, one on test coverage.
Use plan mode to design the work (cheap), then hand the plan to a team for parallel execution (faster but uses more tokens). The plan gives you a checkpoint before committing resources.
If you are new to agent teams, start with tasks that do not modify code: reviewing a PR, researching a library, investigating a bug. Learn the coordination patterns before letting multiple agents write code simultaneously.
"Agent team:" for quick activation. Claude recognizes this as a request to create a team..claude/skills folder - no conflicts.tmux then claude. Without tmux, split-pane mode is unavailable."teammateMode": "in-process" in settings.json if you cannot install tmux. Teammates share your terminal - navigate with Shift+Up/Down.| Shortcut | Action |
|---|---|
Shift+Up/Down | Select a teammate |
Enter | View a teammate's session |
Escape | Interrupt a teammate's turn |
Ctrl+T | Toggle the task list |
Shift+Tab | Cycle into delegate mode |
Run this test to confirm everything works:
# In your terminal tmux claude
Then paste this prompt:
Agent team: create a simple Next.js hello world page with TypeScript, deploy it to Vercel, and share the live URL.
Expected result: 2-4 tmux panes open with agents working in parallel. The lead coordinates while teammates handle page creation, build, and deployment.
Restart Claude after editing ~/.claude/settings.json. Run exit, then tmux, then claude. Verify the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS key is nested inside the "env" object.
macOS: brew install tmux. Ubuntu/Debian: sudo apt install tmux. Windows: Install WSL first (wsl --install), then install tmux inside WSL.
Did you explicitly ask for teams in your prompt? Add "use agent teams" or start with "Agent team:" in your prompt. Claude will not create a team unless you request it.
Open a new terminal window. The installer modifies your shell profile (.zshrc, .bashrc), but changes only take effect in new sessions.
Split-pane mode is not supported in VS Code's integrated terminal, Windows Terminal, or Ghostty. Use a standalone terminal (iTerm2 on macOS, a native terminal on Linux, or WSL on Windows) with tmux.
Combine agent teams with custom instructions and standard operating procedures to create specialized, repeatable workflows. This is how Gilbridge staff and students should set up their team workflows for consistent results.
Your CLAUDE.md file acts as the SOP for all agents. Every teammate loads it automatically on start, so put team-wide instructions here.
# CLAUDE.md - Team SOP ## Team Roles - **Lead Agent**: Coordinates work, reviews outputs, manages git - **Frontend Agent**: UI components, styling, accessibility - **Backend Agent**: API routes, database, server logic - **QA Agent**: Testing, validation, link checking ## Standards (All Agents Must Follow) - TypeScript strict mode required - All components must be accessible (WCAG 2.1 AA) - No secrets in code - use environment variables - Run `npm run lint` before committing - Follow existing code patterns and naming conventions ## Workflow 1. Lead creates tasks and assigns to teammates 2. Each teammate works on assigned files only 3. Teammates report completion via mailbox 4. Lead reviews, runs build, commits, and deploys ## Deployment SOP 1. Run `npm run build` - fix any errors 2. Run `npm run lint` - fix any warnings 3. Git commit with descriptive message 4. Push to main branch 5. Verify Vercel deployment succeeds
All teammates inherit this context automatically. No manual sharing needed.
While CLAUDE.md provides the team SOP, your prompt should include specific role instructions for each agent. This ensures each teammate knows their exact responsibilities.
Use agent teams to update the training site with the following structure: Agent 1 (Content Writer): Update all free tools documentation on /tools/ai-platforms. Verify all URLs are current, update pricing, and add any new student programs. Follow our existing card layout pattern. Agent 2 (Frontend Dev): Create a new ClaudeModelsGuide component explaining Opus 4.6 vs Sonnet 4.6, extended thinking, and deep research. Match existing design system (Tailwind, rounded-lg cards, gradient headers). Agent 3 (QA & Deploy): After agents 1 and 2 finish, run npm build, check for TypeScript errors, verify all links work, commit to git, and deploy to Vercel. Share the live URL. All agents: Follow the CLAUDE.md SOP for coding standards and deployment procedures.
The lead agent will create tasks with dependencies - QA waits for content and frontend to complete.
Optimize cost and performance by mixing models within your team:
Use Opus for the lead agent that coordinates work, makes architectural decisions, and reviews outputs. The deeper reasoning is worth the extra tokens for coordination.
Use Sonnet for worker agents doing focused implementation tasks. Faster execution and lower token cost per agent. Enable extended thinking for tasks requiring deeper reasoning.
// ~/.claude/settings.json - Optimal team config
{
"alwaysThinkingEnabled": true,
"model": "opus",
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
// Note: Lead uses Opus. Teammates default to Sonnet for cost efficiency.
// The system handles model selection per role automatically./resume and /rewind do not restore in-process teammates.#computer-science or #5-training-new-interns on Slack.One-time global setup. Explicit prompts. Parallel execution on multi-step workflows.
Ideal for training site updates, Supabase + Vercel deployments, content audits, and full-feature development.