The teammateMode setting now accepts "iterm2" as a value, allowing spawned agent teammates to open in iTerm2 split panes using the iTerm2 Python API.
Usage
# In your Claude Code settings.json
{
"teammateMode": "iterm2"
}Details
- Requires the iTerm2 Python API to be enabled: Preferences > General > Magic > Enable Python API.
- Requires the
it2CLI tool:pip install it2. - If
it2is not on PATH or the Python API is not enabled, Claude prints a diagnostic message and falls back to the next available mode. - If Claude is not running inside iTerm2, it warns and suggests changing
teammateMode. "auto"mode now also considers iTerm2 availability.- The
--scope serverCLI flag is now used for finer-grainedmcp removescope targeting.
Evidence
New "iterm2" option added to teammateMode enum (search for "How spawned teammates execute (tmux, iterm2, in-process, auto)" and "teammateMode is set to \"iterm2\"")
Strings lifted out of the shipped bundle, so the claim above can be checked against them.
One source agreesOne thing we can check says the same as this entry.
Anthropic's release notes agree
Added teammateMode: "iterm2" setting with a warning when auto mode cannot find the it2 CLI