CTS-KB

tmux

てぃーまっくす

Terminal Multiplexer
#CLI #ターミナル #Claude Code #Agent Teams

Terminal Multiplexer — 1 つの端末内に複数の pane / window / session を作り、切断しても状態を残したままプロセスを動かし続けられるターミナル多重化ツール。

概要

tmux の核は「セッションを端末から切り離す(detach)」機能。SSH が切れても、VS Code の統合ターミナルを閉じても、tmux セッション内のプロセスは動き続ける。長時間ビルド・並列作業・Claude Code の Agent Teams など、 複数のコンテキストを同時に保持したい運用 で必須級のツール。

3 階層の概念

階層役割
Session独立した作業単位(プロジェクトごと、用途ごと)
WindowSession 内の「タブ」に相当
PaneWindow 内の分割領域(画面分割)

代表的な操作(Ctrl + B がプレフィックス)

操作機能
tmux new -s <name>新しい session を作成
tmux lssession 一覧
tmux attach -t <name>session に再接続
Ctrl + B → d現在の session から detach
Ctrl + B → cwindow 作成
Ctrl + B → %pane を縦分割
Ctrl + B → “pane を横分割
Ctrl + B → 矢印pane 間を移動
Ctrl + B → zpane 拡大 / 縮小(ズームトグル)

Claude Code Agent Teams との関係

Agent Teams 編で紹介する Claude Code の実験的機能 Agent Teams は、tmux の split-pane を使って複数の Claude インスタンスを並列表示する。teammateMode: "tmux" を設定し、tmux new -s claude の中で claude を起動すると、各 Teammate が独立した pane に展開される。

┌──────────┬──────────┐
│ Lead     │ Teammate │
│ (Claude) │ A        │
├──────────┼──────────┤
│ Teammate │ Teammate │
│ B        │ C        │
└──────────┴──────────┘

VS Code 統合ターミナルでは pane 描画と拡張が競合するため、PowerShell から docker exec で DevContainer に入り、独立ターミナルで tmux を起動するのが安定する。

Windows での利用

環境tmux サポート
macOS(Homebrew)
Linux(apt / yum)
WSL(Ubuntu)
DevContainer(Ubuntu ベース)apt-get install -y tmux
Windows Terminal(ネイティブ)

Windows で Agent Teams を使うなら WSL + DevContainer + tmux のスタックが唯一安定する構成になる。

関連記事

  • Agent Teams 編 — tmux split-pane を使った Claude Code のマルチエージェント運用

関連用語