40 lines
980 B
Markdown
40 lines
980 B
Markdown
---
|
|
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.
|
|
|