---
id: 4dfc5003-44f8-4520-8cfc-dc6d6ef9a65f
type: configuration
title: "Claude Code Agent Teams enabled in ~/.claude/settings.json with tmux controls"
tags: [claude-code, agent-teams, tmux, settings, claude-home, configuration]
importance: 0.6
confidence: 0.8
created: "2026-02-26T18:14:54.211526+00:00"
updated: "2026-03-01T22:02:57.288962+00:00"
---

# Claude Code Agent Teams configuration

## Settings location
`~/.claude/settings.json` — env block, line 5

```json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}
```

## How Agent Teams detects tmux
Auto-detects via `$TMUX` env var. Uses tmux split panes for sub-agent teammates when inside a tmux session.

## Override / force tmux mode
```
claude --teammate-mode tmux
```

## Key tmux controls for Agent Teams
- `Ctrl+T` — toggles task list
- `Shift+Down` — cycles between teammates

## Prerequisite
Must be inside a tmux session. Use the `cc()` alias in ~/.zshrc to auto-create named sessions.