CC逆引きリファレンス

teammateの起動方法を設定したい

5. 設定・カスタマイズ

コマンド / 機能

"teammate.mode": "in-process" | "auto" | "tmux" | "iterm2"

サブエージェント(teammate)の実行方式を指定

概要

settings.json の teammate.mode で、spawnされるteammate(サブエージェント)をどう実行するかを指定できます。in-process(同一プロセス内)、auto(自動判定)、tmux、iterm2 から選択可能です。CLIの --teammate-mode フラグでも同様に指定できます。

設定例

// ~/.claude/settings.json
{
  "teammate": {
    "mode": "tmux"
  }
}

# CLIフラグでの指定
claude --teammate-mode tmux
claude --teammate-mode iterm2
公式ドキュメントを見る

こんな時に使う

  • 複数のteammateを別々のtmuxペインで可視化しながら作業したい時
  • iTerm2のタブ機能を使ってteammateごとに画面を分けたい時
  • 軽量に同一プロセス内でteammateを動かしたい時(in-process)

使い方

  1. 1settings.json に teammate.mode を追加
  2. 2in-process / auto / tmux / iterm2 のいずれかを指定
  3. 3一時的に変えたい場合は --teammate-mode フラグを使う

Tips

  • tmux / iterm2 を指定するとteammateごとに独立したターミナルが開き視認性が上がる
  • auto は環境に応じて適切な方式を自動選択する
  • TeamCreate/TeamDelete は廃止され、セッションごとに暗黙のチームが作られてteammateを直接spawnする方式になった