Answer: Agent teams support two display modes: in-process (all teammates run inside your main terminal, works in any terminal with no extra setup) and split panes (each teammate gets its own pane, requiring tmux or iTerm2). Teammates run in-process until you change the teammateMode setting; setting it to "auto" opens split panes when running inside tmux or iTerm2 and in-process in other terminals, and you can also pass the mode for a single session with the --teammate-mode flag. Status: Confirmed Entry: tool/claude-code/agents-and-automation/choose-display-mode Revision: 3 Digest: sha256:d8c52bed0c1c2ec7 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:03:10Z Last changed: 2026-11-19T12:13:31Z (single-session flag: — → claude --teammate-mode auto) Last verified: 2026-11-20T12:17:49Z Next check: 2026-11-21T12:17:49Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of display modes | In-process | [1] | 2026-11-20 in-process description | all teammates run inside your main terminal | [1] | 2026-11-20 split panes description | each teammate gets its own pane | [1] | 2026-11-20 split panes requirement | Requires tmux, or iTerm2 | [1] | 2026-11-20 setting name | teammateMode | [1] | 2026-11-20 auto mode behavior | "auto" | [1] | 2026-11-20 single-session flag | claude --teammate-mode auto | [1] | 2026-11-20 Sources: [1] Anthropic. "Orchestrate teams of Claude Code sessions". https://code.claude.com/docs/en/agent-teams.md Role: primary. Accessed: 2026-11-20T12:17:49Z Quote: "Agent teams support two display modes: * **In-process" (Supports: display modes) Quote: "**In-process**: all teammates run inside your main terminal." (Supports: in-process description) Quote: "**Split panes**: each teammate gets its own pane." (Supports: split panes description) Quote: "Requires tmux, or iTerm2." (Supports: split panes requirement) Quote: "Teammates run in-process until you change the [`teammateMode`](https://code.claude.com/docs/en/settings-reference#teammatemode) setting." (Supports: setting name) Quote: "With `"auto"`, teammates open in split panes when you run Claude Code inside tmux or iTerm2, and run in-process in other terminals." (Supports: auto mode behavior) Quote: "claude --teammate-mode auto" (Supports: single-session flag) Published: 2026-11-20T03:07:14Z Snapshot SHA-256: 385746eb7ee35908f790bba7d9d69a0613661e1af32a7de07d17f1376ac8e405 (captured 2026-11-18T12:13:32Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-18T12:13:33Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:17:49Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:17:49Z Last attempt: 2026-11-20T12:17:49Z Notes and limitations: Extracted automatically from a single official source (section "Choose a display mode"). Related: https://latestn.com/tool/claude-code/agents-and-automation/choose-hook-type-sdk When should I use which hook type in the Claude Code SDK? https://latestn.com/tool/claude-code/agents-and-automation/claude-write-save-workflow How do I have Claude write and save a workflow in Claude Code? https://latestn.com/tool/claude-code/agents-and-automation/claudesdkclient-interrupts How do I interrupt a running Claude Code session with ClaudeSDKClient in Python? https://latestn.com/tool/claude-code/agents-and-automation/change-system-prompt-existing-session How do I change the system prompt of an existing Claude Code session? https://latestn.com/tool/claude-code/agents-and-automation/check-running-agent-work How do I check on work that Claude Code agents are running in the background? https://latestn.com/tool/claude-code/agents-and-automation/choose-and-weight-graders What grader types exist for Claude Code plugin evals and how do I choose and weight graders? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-19T12:13:31Z | changed | single-session flag: — → claude --teammate-mode auto | [1] 2026-11-19T12:13:31Z | changed | auto mode behavior: — → "auto" | [1] 2026-11-19T12:13:31Z | changed | split panes requirement: — → Requires tmux, or iTerm2 | [1] 2026-11-19T12:13:31Z | changed | split panes description: — → each teammate gets its own pane | [1] 2026-11-19T12:13:31Z | changed | in-process description: — → all teammates run inside your main terminal | [1] 2026-11-19T12:13:31Z | changed | single session flag: --teammate-mode → — | [1] 2026-11-19T12:13:31Z | changed | auto mode value: auto → — | [1] 2026-11-19T12:13:31Z | changed | split pane requirements: tmux, or iTerm2 → — | [1] 2026-11-19T12:13:31Z | changed | second display mode: Split panes → — | [1] 2026-11-14T12:13:31Z | changed | single session flag: — → --teammate-mode | [1] 2026-11-14T12:13:31Z | changed | auto mode value: — → auto | [1] 2026-11-14T12:13:31Z | changed | setting name: — → teammateMode | [1] 2026-11-14T12:13:31Z | changed | split pane requirements: — → tmux, or iTerm2 | [1] 2026-11-14T12:13:31Z | changed | second display mode: — → Split panes | [1] 2026-11-14T12:13:31Z | changed | display modes: — → In-process | [1] 2026-11-14T12:13:31Z | changed | iterm2 mode: "iterm2" → — | [1] 2026-11-14T12:13:31Z | changed | tmux mode: "tmux" → — | [1] 2026-11-14T12:13:31Z | changed | auto mode behavior: "auto" → — | [1] 2026-11-14T12:13:31Z | changed | session flag: --teammate-mode → — | [1] 2026-11-14T12:13:31Z | changed | settings file: ~/.claude/settings.json → — | [1] 2026-11-14T12:13:31Z | changed | settings key: teammateMode → — | [1] 2026-11-14T12:13:31Z | changed | default mode: "in-process" → — | [1] 2026-11-13T03:03:10Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/agents-and-automation/choose-display-mode/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/agents-and-automation/choose-display-mode POST: https://latestn.com/dispute/tool/claude-code/agents-and-automation/choose-display-mode with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/agents-and-automation/choose-display-mode?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I choose the display mode for my Claude Code agent team? Revision 3, last verified 2026-11-20T12:17:49Z. https://latestn.com/tool/claude-code/agents-and-automation/choose-display-mode (accessed 2026-11-21T10:03:43Z). @misc{LatestN_tool_claude_code_agents_and_automation_choose_display_mode_r3, title = {How do I choose the display mode for my Claude Code agent team?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/agents-and-automation/choose-display-mode}}, note = {Revision 3; digest sha256:d8c52bed0c1c2ec7; last verified 2026-11-20T12:17:49Z; accessed 2026-11-21T10:03:43Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/agents-and-automation/choose-display-mode