[DOCS] Agent teams docs omit `teammateMode: "iterm2"` setting value

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

teammateMode in the "Available settings" table

Current Documentation

The settings table currently says:

"teammateMode | How agent team teammates display: in-process (the default), auto (split panes when running inside tmux or iTerm2, in-process otherwise), or tmux (split panes using tmux or iTerm2, detected from your terminal)."

The Agent Teams page similarly says:

"Set auto to enable split panes when you're already running inside a tmux session or your terminal is iTerm2, falling back to in-process otherwise. The tmux setting enables split-pane mode and auto-detects whether to use tmux or iTerm2 based on your terminal."

What's Wrong or Missing?

Claude Code v2.1.186 added teammateMode: "iterm2" and warns when auto mode cannot find the it2 CLI. The settings reference still lists only in-process, auto, and tmux.

This makes the documented enum incomplete and leaves users without a clear way to force the iTerm2 backend directly.

Suggested Improvement

Update the teammateMode setting description to include iterm2 as a valid value, for example:

{
  "teammateMode": "iterm2"
}

Also update the Agent Teams "Choose a display mode" section to explain:

• iterm2 forces iTerm2 split-pane mode.
• It requires the it2 CLI and the iTerm2 Python API.
• Auto mode now warns when it chooses iTerm2 but cannot find it2.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | teammateMode enum in the settings table |
| https://code.claude.com/docs/en/agent-teams | Display mode explanation and iTerm2 setup guidance |

Total scope: 2 pages affected