settings.json

teammateMode

型string既定値in-process記述場所どの設定ファイルでも可

エージェントチームのチームメイトの表示方法を指定します。"auto" は tmux または iTerm2 ではスプリットペインを、それ以外では in-process を選択します。"iterm2"(v2.1.186 で追加)は iTerm2 のネイティブスプリットペインを強制し、it2 CLI が必要です(it2 が無い場合はインストールコマンド付きのエラーを表示します)。デフォルトは "in-process" です(v2.1.179 より前は "auto" でした)。エージェントチームは実験的機能でデフォルトで無効です。有効にするには settings.json または環境に CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を追加してください。

取りうる値

autotmux 内、または `it2` が `PATH` にあって iTerm2 を使っている場合や tmux がインストールされている場合にはスプリットペインで表示し、それ以外では in-process で実行します。
in-process既定チームメイトはメインのターミナルペイン内で実行されます。
tmuxターミナルから検出して、tmux または iTerm2 を使用してスプリットペインを表示します。
iterm2`it2` CLI 経由で iTerm2 のネイティブスプリットペインを表示します(Claude Code v2.1.186 以降)。

記述例

{
  "teammateMode": "auto"
}

使い方・用途

  • エージェントチームのチームメイトをメインターミナルペイン内で表示するか(in-process)、スプリットペインで並べて表示するかを選択します。デフォルトは "in-process"(v2.1.179 より前は "auto")。
  • 選択肢は auto / in-process / tmux / iterm2 の4種類。v2.1.186 で追加された "iterm2" は iTerm2 のネイティブスプリットペインを強制し、it2 CLI が必要(無い場合はインストールコマンド付きのエラーを表示)です。
  • エージェントチーム自体が実験的機能でデフォルトでは無効のため、settings.json または環境変数に CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を追加して有効化する必要があります。
英語原文(公式ドキュメントより)

How agent team teammates display: "auto" picks split panes in tmux or iTerm2, in-process otherwise; "iterm2" (added in v2.1.186) forces iTerm2 native split panes and requires the it2 CLI (it shows an error with the install command if it2 is missing). The default is "in-process" (it was "auto" before v2.1.179). Agent teams are experimental and disabled by default. Enable them by adding CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS to your settings.json or environment. See https://code.claude.com/docs/en/agent-teams#choose-a-display-mode

関連ドキュメント

関連する変更履歴

v2.1.186(1件)

Added
Agent TeamsSettings
teammateMode: "iterm2" 設定が追加されました。また、autoモードで it2 CLIが見つからない場合に警告が表示されるようになりました。
英語原文を表示
Added teammateMode: "iterm2" setting with a warning when auto mode cannot find the it2 CLI

変更前

iTerm2のネイティブペインを利用したい場合でも、明示的な設定項目が不足しており、自動検出に失敗した際のフィードバックも不十分でした。

変更後

設定ファイルで iterm2 モードを明示的に指定できるようになり、依存するCLIツールの欠如に対するエラー通知も改善されました。

ユーザーへの恩恵

iTerm2ユーザーは、エージェントチームの動作環境をより確実に制御でき、設定ミスによる意図しない表示モードへの切り替えを防ぐことができます。

関連ドキュメント