Claude Code Agent Teams

Appearance

Commands Reference ​

All Claude Code commands for working with agent teams.

Fresh 🌱

Team Creation ​

Create Team (Auto) ​

Create an agent team to [describe task and desired team structure]

Claude decides number and composition based on task.

Create Team (Specific Count) ​

Create an agent team with 4 teammates to [task]

Create Team (Specific Model) ​

Create an agent team with 3 Sonnet teammates to [task]

Models: Haiku, Sonnet (default), Opus

Create Team (With Plan Approval) ​

Spawn teammates for [task]. Require plan approval before implementation.

Spawning Teammates ​

Spawn Specific Teammate ​

Spawn a security expert teammate to review authentication module

Spawn Multiple with Roles ​

Create 2 teammates:
- Database specialist focusing on query optimization
- Backend developer for API implementation

Spawn with Detailed Prompt ​

Spawn a frontend expert with this prompt:
"Build responsive React components for user dashboard.
Focus on mobile-first design. Component size limit: 500 lines."

Spawn Without New Team ​

Add another teammate to existing team to handle [task]

Team Management ​

View Team Status ​

Show me the current team status

List All Teammates ​

Who are the current teammates?

Show Teammate Progress ​

What is each teammate currently working on?

Get Team Composition ​

Show me the team members and their assignments

Communication ​

Message Specific Teammate ​

Tell the [role/name] teammate: "[message]"

Example:

Tell the security reviewer: "Focus on JWT token handling"

Broadcast to All ​

Broadcast to all teammates: "[message]"

Example:

Broadcast to all teammates: "We're wrapping up. Save your findings."

Direct Interaction (In-Process Mode) ​

Shift+Up/Down: Select teammate
Enter: Enter their session
Type: Send message directly
Escape: Exit session

Ask for Specific Feedback ​

Tell the frontend teammate: "How will this scale to 10K users?"

Task Management ​

Create Task ​

Create a task: "[task description]"

Create Multiple Tasks ​

Create these tasks:
1. "[task 1]"
2. "[task 2]"
3. "[task 3]"

Create Task with Dependencies ​

Create a task: "[task]"
Block on: task #[N]

Assign Task ​

Assign task #3 to [teammate name]

Assign with Instructions ​

Assign task #5 to backend specialist with prompt:
"[Specific instructions for this task]"

View Task List ​

Show me the task list

Or press Ctrl+T (in-process mode)

Check Specific Task ​

Show details for task #7

Get Task Status ​

What's the status of all tasks?

Mark Task Complete ​

Mark task #5 as complete

Reopen Task ​

Reopen task #3, it needs more work

Cancel Task ​

Cancel task #7

Set Task Dependency ​

Task #8 depends on task #6

View Dependencies ​

Show me task dependencies

Delegation ​

Delegate Mode Toggle ​

Shift+Tab (keyboard shortcut)

Or:

Enable delegate mode

Exit Delegate Mode ​

Disable delegate mode

Or:

Shift+Tab (keyboard shortcut again)

Verify Delegate Mode Active ​

Am I in delegate mode?

Work Coordination ​

Stop New Work ​

Stop accepting new work. Begin wrapping up.

Wait for Teammates ​

Wait for your teammates to complete their tasks before proceeding

Synthesize Findings ​

Collect all findings and synthesize into a summary report

Coordinate Integration ​

Teammates: Integrate your modules and test together

Get Blockers ​

What tasks are currently blocked?

Unblock Task ​

Task #8 can proceed even though task #5 isn't done

Shutdown and Cleanup ​

Shut Down Single Teammate ​

Ask [teammate name] to shut down

Shut Down All Teammates ​

Ask all teammates to shut down gracefully

Force Shutdown Teammate ​

Force shutdown [teammate name]

Clean Up Team ​

Clean up the team

Must run on lead, not teammate.

Verify Team Cleaned ​

Show me the current team status

Should return "No active team"

Display and Navigation ​

Force Display Mode ​

claude --teammate-mode in-process

Or:

claude --teammate-mode tmux

Toggle Task List (In-Process) ​

Press Ctrl+T

Cycle Teammates (In-Process) ​

Shift+Up    - Previous teammate
Shift+Down  - Next teammate

Enter Teammate Session (In-Process) ​

Press Enter to enter their session
Press Escape to exit and stop their turn

Click into Pane (Split Panes) ​

Click on teammate's pane to interact
Click elsewhere to leave pane

Permission Management ​

Skip All Permission Checks ​

claude --dangerously-skip-permissions

Pre-Approve Operations ​

Edit ~/.claude/settings.json:

json
{
  "mode": "bypassPermissions"
}

Debugging and Status ​

Check Claude Version ​

claude --version

Verify Agent Teams Enabled ​

Create an agent team with 1 teammate

If blocked, agent teams not enabled.

Check List of Teams ​

~/.claude/teams/  (directory of teams)

View Team Configuration ​

cat ~/.claude/teams/[team-name]/config.json

List Shared Tasks ​

ls ~/.claude/tasks/[team-name]/

Advanced Coordination ​

Assign by Criteria ​

Assign the next available task to whoever finishes first

Or explicitly:

Assign to whoever is best at [skill/domain]

Create Subtasks ​

Break task #5 into subtasks:
1. Design phase
2. Implementation phase
3. Testing phase

Track Progress Metrics ​

Show me:
- Completion percentage
- Estimated time remaining
- Teammate utilization
- Task velocity

Request Status Update ​

Give me a comprehensive status update on all ongoing work

Configuration ​

Update Settings ​

~/.claude/settings.json

Add or modify:

json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "teammateMode": "auto",
  "mode": "default"
}

Environment Variables ​

bash
# Enable agent teams
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# Skip permissions
claude --dangerously-skip-permissions

# Set display mode
claude --teammate-mode in-process

Quick Command Patterns ​

Standard Workflow ​

1. Create agent team with X teammates to [task]
2. Tell teammates: [specific instructions]
3. Monitor: What's the current status?
4. Coordinate: [adjust as needed]
5. Synthesize: Compile findings
6. Clean up the team

Code Review Workflow ​

1. Create agent team with 3 reviewers for [PR]
2. Tell each reviewer: [focus area]
3. Collect findings
4. Synthesize into review report
5. Clean up the team

Debugging Workflow ​

1. Create agent team with 5 teammates for investigation
2. Assign competing hypotheses
3. Foster debate: [questions]
4. What's the most likely root cause?
5. Clean up the team

Common Patterns ​

Parallel work:

Create agent team with [N] teammates
Each teammate owns different module
Parallel execution

Sequential work with checkpoints:

Create task dependency: Task 2 depends on Task 1
Team self-coordinates through dependencies

Expert rotation:

Task 1: Architect designs
Task 2: Developer implements
Task 3: Reviewer verifies
Dependencies ensure proper order

Tips ​

  • Use clear, specific instructions for teammates
  • Include examples in prompts
  • Give context about project/codebase
  • Break work into 5-6 tasks per teammate
  • Monitor progress at least every 30-45 minutes
  • Synthesize findings incrementally, not just at end
  • Always use lead to clean up

See Also ​