teammate の実行方式を選びたい
9. エージェントコマンド / 機能
--teammate-mode in-process|auto|tmux|iterm2チームメイトの起動環境を指定
概要
--teammate-mode フラグまたは settings.json の teammate.mode で、エージェントチームの teammate（チームメンバー）をどう起動するかを制御できます。in-process はプロセス内で軽量に動作、tmux / iterm2 は専用のターミナルセッションで可視化しながら動作、auto は状況に応じて自動選択します。
設定例
# 起動時にモードを指定
claude --teammate-mode in-process
claude --teammate-mode auto
claude --teammate-mode tmux
claude --teammate-mode iterm2
# settings.json でデフォルトを固定
{
"teammate": {
"mode": "auto"
}
}こんな時に使う
- teammate の動作を軽量なプロセス内実行にしたい時
- tmux や iTerm2 で teammate の動きを画面上で確認したい時
- 環境に応じて自動的に最適なモードを選ばせたい時
使い方
- 1claude --teammate-mode <mode> で起動時に指定
- 2または settings.json の teammate.mode で恒常的に設定
- 3tmux / iterm2 は対応する端末アプリがインストールされている必要がある
Tips
- auto モードは teammate を spawn する前に、その是非を自動モード分類器で評価してから実行する（v2.1.178）
- in-process はオーバーヘッドが少なく CI やヘッドレス環境に向いている
- tmux / iterm2 は複数 teammate の動きを目視で追いたい対話的な作業に向いている