tmuxとは
tmux(ティーマックス)は、1つのターミナルの中で複数の作業画面を作り、管理するためのソフトウェアです。
分類としては「ターミナルマルチプレクサ」と呼ばれます。LinuxとmacOSで動作し、Windowsで使う場合はWSLなどのLinux環境が必要です。
主な機能は次の2つです。
- 画面を分割する — 1つの端末ウィンドウを左右・上下に分け、それぞれで別のコマンドを動かす
- 作業を保持する — 端末を閉じたりSSHが切れたりしても、tmuxの中のプロセスは動き続け、後から同じ画面に戻れる
ターミナルエミュレータとの違い
Windows Terminal、Ghostty、iTerm2などのターミナルエミュレータは、文字を画面に描画し、キー入力を受け取るアプリです。
tmuxはそのアプリの中で動くプログラムで、担当する層が違います。両者の関係は次の図のとおりです。
「WezTermとtmuxのどちらを使うか」という比較は成り立ちません。どのターミナルエミュレータを使っていても、その中でtmuxを起動できます。

セッション・ウィンドウ・ペインの関係
tmuxの画面は3つの単位で構成されます。この関係を先に押さえておくと、キー操作も覚えやすくなります。
- セッション — 作業のまとまり。プロジェクトごとに1つ作るのが一般的
- ウィンドウ — セッションの中のタブに相当する。画面全体を切り替える
- ペイン — ウィンドウを分割した1区画。それぞれで別のシェルが動く
階層を図にすると次のようになります。
tmuxを起動すると、画面の最下部に緑色のバーが表示されます。
これは「ステータスライン」で、左端にセッション名、その右にウィンドウの一覧が並びます。今どのセッションのどのウィンドウにいるかは、ここで確認できます。
tmuxのインストール
macOSはHomebrew、Ubuntu・Debian(WSLを含む)はaptでインストールできます。
# macOS
brew install tmux
# Ubuntu / Debian / WSL
sudo apt update && sudo apt install tmux
# バージョン確認
tmux -Vtmuxの基本的な使い方
プレフィックスキーの仕組み
tmuxのキー操作は、最初に「プレフィックスキー」を押し、続けて機能キーを押す2段階になっています。初期設定のプレフィックスは Ctrl+b です。たとえば Ctrl+b を押して指を離し、続けて % を押すと、画面が左右に分割されます。
以降は、この操作を「Ctrl+b → %」のように表記します。
私の場合はターミナルは Ghosttyで左下のキー + a を Ctrl + a に変換
Windows と Mac の両方で作業するため、Mac では左下のキー(⬆️)を Command に割り当て、Windows と同じ指の動きでコピーなどができるようにしている(システム設定 →キーボード →修飾キー)。
tmux のプレフィックスも、Windows と同じく左下のキー + a で押したい。ただ、Mac の左下のキーは Command なので、そのままでは全選択になってしまう。
そこで、ターミナルは Ghostty を使い、Ghostty の中でだけ左下のキー + a を Ctrl + a に変換している。左下のキー + c、+ v などは Command のまま。
Ghostty の設定(
~/.config/ghostty/config):keybind = cmd+a=text:\x01tmux のプレフィックス設定(
~/.tmux.conf):unbind C-b set -g prefix C-a bind C-a send-prefix標準のターミナルや Cursor のターミナルでは、この変換は効かない。
セッションを作る・戻る・終了する
セッションの操作は、tmuxの外(普段のシェル)からコマンドで行うのが基本です。
tmux のセッションはメモリ上で動いているプロセスなので、PCを再起動したりシャットダウンしたりすると全部消えます。
| コマンド | 意味 |
|---|---|
tmux | 名前なし(番号)でセッションを作成して入る |
tmux new -s work | 「work」という名前でセッションを作成して入る |
tmux rename-session -t 4 【変更したい名前】 | セッション4の名前を 【変更したい名前】 にする |
tmux ls | セッションの一覧を表示 |
| tmux kill-session -t 0 | セッション0を削除 |
tmux attach | 最後に使っていたセッションに戻る(tmux a でも可) |
tmux attach -t work | 「work」に戻る(tmux a -t work でも可) |
tmux new -A -s work | 「work」があれば戻り、なければ作成して入る |
tmux detach | 今のセッションから抜ける(セッションは裏で動き続ける) |
tmux switch -t work | tmux の中から「work」に切り替える |
tmux rename-session -t 0 work | 「0」という名前のセッションを「work」に変更する |
tmux kill-session -t work | 「work」を終了する |
tmux kill-session -a | 今いるセッション以外をすべて終了する |
tmux kill-server | すべてのセッションを終了し、tmux 自体を止める |
tmux source-file ~/.tmux.conf | 設定ファイルを読み込み直す |
セッションから一時的に抜けるときは Ctrl+b → d を押します。これを「デタッチ」と呼び、抜けた後もセッションは裏で動き続けます。戻る操作が tmux attach で、こちらは「アタッチ」と呼びます。
ウィンドウとペインの操作
よく使うキー操作は次のとおりです。
| 操作 | キー |
|---|---|
| 新しいウィンドウを作る | Ctrl+b → c |
| ウィンドウの名前を変える | Ctrl+b → , |
| 次・前のウィンドウへ移動 | Ctrl+b → n / p |
| 番号でウィンドウを選ぶ | Ctrl+b → 0〜9 |
| ウィンドウ名を変える | Ctrl+b → , |
| 左右に分割 | Ctrl+b → % |
| 上下に分割 | Ctrl+b → " |
| ペイン間を移動 | Ctrl+b → 矢印キー |
| ペインを一時的に最大化・元に戻す | Ctrl+b → z |
| ペインを閉じる | Ctrl+b → x |
| セッションとウィンドウを一覧から選ぶ ★ | Ctrl+b → w |
| キー操作の一覧を表示 | Ctrl+b → ? |
ペインやウィンドウは、中のシェルで exit を実行しても閉じられます。最後のペインを閉じると、そのセッションも終了します。
tmuxが特に役立つのは、SSHで接続したリモートサーバーでの作業です。通常のSSH接続では、回線が切れるとサーバー側で動いていたプロセスも終了します。tmuxの中で動かしていれば、切断後も処理は続きます。その流れを図にすると次のとおりです。
再接続したら tmux attach -t セッション名 を実行すると、切断前と同じ画面に戻れます。ノートPCを閉じて移動するときや、通信が不安定な場所で作業するときに効果があります。
コピーモードで過去の出力をさかのぼる
tmuxの中では、ターミナルエミュレータのスクロールバーやマウスホイールが期待どおりに効かないことがあります。tmuxが自前で画面を管理しているためです。
過去の出力を見るときは Ctrl+b → [ で「コピーモード」に入り、矢印キーやPageUpで移動します。抜けるときは q です。
後述の設定で mode-keys vi を指定すると、Vimと同じく / で検索できます。
.tmux.confの基本設定
tmuxの設定は、ホームディレクトリの ~/.tmux.conf に書きます。最初に入れておくと便利な設定は次のとおりです。
# マウスでペインの選択・サイズ変更・スクロールをできるようにする
# tmux 3.8 では初期値がオン。3.7以前の環境でも同じ動作にするため明記
set -g mouse on
# tmux の中のアプリからのクリップボード書き込みも外側のターミナルへ通す
# iTerm2 や Ghostty など OSC 52 対応ターミナルで有効。Mac 標準のターミナルでは効果なし
set -g set-clipboard on
# コピーモードの操作を Vim 風にする(/ で検索、v で選択開始など)
setw -g mode-keys vi
# 通知や進捗表示などの制御信号を、外側のターミナルへそのまま通す
# Claude Code の完了通知を受け取るために必要
set -g allow-passthrough on
# プレフィックスキーを Ctrl+b から Ctrl+a に変更する
unbind C-b
set -g prefix C-a
# Ctrl+a を2回押すと、シェルに Ctrl+a(行頭へ移動)を送る
bind C-a send-prefix
# マウスでドラッグして指を離したら、選択範囲を Mac のクリップボードにコピーする
# Mac 標準のターミナルでもドラッグだけでコピーできるようにするための設定
bind -T copy-mode-vi MouseDragEnd1Pane send -X copy-pipe-and-cancel "pbcopy"保存したら、tmuxの中で次のコマンドを実行すると反映されます。
tmux source-file ~/.tmux.conf
mouse on にすると、ドラッグでの文字選択もtmuxが受け取るようになります。
ターミナルエミュレータ本来の選択でコピーしたいときは、Shiftキー(iTerm2ではOptionキー)を押しながらドラッグします。
Claude Codeとtmuxを組み合わせる理由
Claude Codeは、端末の中で長時間動く対話型のCLIです。1回の依頼で数分から数十分動き続けることもあります。tmuxの「画面を分ける」「作業を残す」という2つの機能と相性がよく、組み合わせて使う人が増えています。
SSH先で切断されても処理が止まらない
リモートの開発サーバーでClaude Codeを動かしている途中にSSHが切れると、通常はClaude Codeごと終了します。tmuxの中で起動しておけば、PCを閉じて移動しても処理は続き、戻ってから結果を確認できます。
ssh dev-server
tmux new -s claude
claude
# 作業を依頼したら Ctrl+b → d でデタッチしてよい
ただし、Claude Codeがコマンド実行の許可を求めて止まっている場合は、アタッチして応答するまで先に進みません。デタッチする前に、よく使う操作を許可設定に入れておくと待ち時間を減らせます。
複数のClaude Codeを並べて動かす
ペインを分けて、別々の作業を任せたClaude Codeを同時に動かす使い方もあります。1つが時間のかかる作業をしている間に、隣のペインで別の作業を進められます。
構成の一例を図にすると次のとおりです。
同じリポジトリの同じディレクトリで複数のClaude Codeを動かすと、同じファイルを同時に書き換えて衝突することがあります。git worktreeで作業ディレクトリを分けておくと安全です。
# ブランチごとに別ディレクトリを作る
git worktree add ../myapp-login -b feature-login
git worktree add ../myapp-cache -b fix-cache
それぞれのペインで対応するディレクトリに移動してから claude を起動します。tmux上の複数のClaude Codeについて、作業中か入力待ちかをまとめて確認できる管理ツール(claude-tmuxなど)も、有志によって公開されています。
エージェントチームを分割ペインで表示する
Claude Codeには、複数のClaude Codeが「リーダー」と「チームメイト」に分かれて協調する「エージェントチーム」という機能があります。2026年10月時点では実験的機能の扱いで、初期状態では無効です。
表示方法は2種類あります。初期値は、1つの端末の中でチームメイトを切り替えて見る in-process モードです。分割ペインモードにすると、チームメイトごとにペインが作られ、全員の作業を同時に見渡せます。
分割ペインモードを使うには、tmuxか、it2 CLIを導入したiTerm2が必要です。Windows Terminal、Ghostty、VS Codeの統合ターミナルは、端末自身の分割機能では対応していません。これらの端末を使っている場合でも、中でtmuxを起動し、その中でClaude Codeを動かせば分割表示を使えます(WindowsではWSL上で動かします)。
Claude Codeをtmuxの中で使うときの設定
Shift+Enterと通知を有効にする
tmuxの初期設定のままClaude Codeを動かすと、次の2つの問題が起きます。
- Shift+Enterで改行できず、そのまま送信されてしまう
- 処理完了のデスクトップ通知や進捗表示が、外側のターミナルまで届かない
外側のターミナルがShift+Enterや通知に対応していても、間にtmuxが入ると情報が途中で落ちるためです。Claude Codeの公式ドキュメントでは、~/.tmux.conf に次の4行を追加する方法が案内されています。
set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'
allow-passthrough は、通知や進捗表示を外側のターミナルへ通すための設定です。extended-keys の2行は、tmuxがShift+Enterと通常のEnterを区別できるようにします。追加したら tmux source-file ~/.tmux.conf で反映し、Claude Codeを再起動してください。
設定前でも、Ctrl+J か「\ を入力してからEnter」であれば改行できます。こちらはtmuxの設定に関係なく使えます。
VS Codeの統合ターミナルやAlacritty(0.16より前)などで /terminal-setup を実行する場合は、tmuxの外で実行します。このコマンドは外側のターミナルの設定ファイルを書き換えるためです。
画面のちらつきが気になる場合
Claude Codeの出力中に画面がちらついたり、スクロール位置が飛んだりする場合は、Claude Code側で /tui fullscreen を実行すると全画面の描画モードに切り替わります。このモードでは、スクロールはtmuxのコピーモードではなく、Claude Codeの中でマウスやPageUpを使って行います。
エージェントチームの分割表示を有効にする
~/.claude/settings.json に次の設定を追加します。
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
},
"teammateMode": "auto"
}
"auto" は、tmuxの中で起動したときは分割ペインを使い、それ以外では in-process モードに戻る設定です。tmuxを起動してから claude を実行し、「3人のチームメイトでこのPRをレビューして」のように自然文で依頼すると、チームメイトのペインが作られます。
作業中のウィンドウでチームを起動すると、既存のペインの横にチームメイトのペインが追加され、配置が崩れやすくなります。Ctrl+b → c でチーム用の新しいウィンドウを作ってから起動すると扱いやすくなります。
tmuxからherdrに移行する
herdr(ハーダー)は、AIコーディングエージェントを動かす用途に向けたターミナルマルチプレクサです。tmuxと同じく画面の分割とデタッチ・アタッチができるうえに、マウスでも操作でき、Claude Code・Codex・Cursor Agentの状態をサイドバーにまとめて表示します。
公式ドキュメント: https://herdr.dev/ja/tui/docs/
以下は2026年11月時点、herdr 0.9.5での手順です。
インストール
macOSはHomebrewでインストールできます。
brew install herdrインストールしたら、ターミナルで herdr を実行すると起動します。
tmuxの中では起動しないでください。 プレフィックスキーがtmuxとherdrで同じだと、キーをtmuxが先に受け取ってしまい、herdrに届きません。tmuxをデタッチするか、ターミナルの新しいタブを開いてから起動します。
初回起動時のエージェント連携
初回起動時に、エージェント連携(agent integrations)の画面が表示されます。インストール済みのエージェントには available と表示されていて、Enter を押すとまとめてインストールされます。
連携を入れると、herdrを再起動したあとも同じエージェントのセッションに戻れるようになります。インストール時には、各ツールの設定ディレクトリに次のファイルが書き込まれます。
| ツール | 書き込まれるもの |
|---|---|
| Claude Code | ~/.claude/hooks/herdr-agent-state.sh と ~/.claude/settings.json へのフック追加 |
| Codex | ~/.codex/herdr-agent-state.sh、~/.codex/hooks.json、~/.codex/config.toml |
| Cursor Agent | ~/.cursor/herdr-agent-state.sh と ~/.cursor/hooks.json |
あとから入れる場合は herdr integration install claude のようにコマンドでも入れられます。
tmuxとの対応
| herdr | tmux |
|---|---|
| session | tmuxサーバー全体に近い。普段は1つで足りる |
| workspace | session。リポジトリごとに1つ作る |
| tab | window |
| pane | pane |
herdrでは、tmuxのsessionとwindowのあいだに workspace という単位があります。左のサイドバーにworkspaceの一覧が並び、作業ディレクトリ名とgitのブランチ名が表示されます。
デフォルトのキー操作の違い
デフォルトのプレフィックスはtmuxと同じ Ctrl+b です。c(新しいタブ)、n / p(次・前のタブ)、1〜9(番号のタブへ移動)、z(最大化)、x(ペインを閉じる)、[(コピーモード)はtmuxと同じ動作です。
違うのは次のキーです。
| 操作 | tmux | herdr |
|---|---|---|
| 左右に分割 | % | v |
| 上下に分割 | " | - |
| ペイン間を移動 | 矢印キー | h / j / k / l |
| デタッチ | d | q |
| ウィンドウ(タブ)名の変更 | , | Shift+t |
コマンドは次のように対応します。
| tmux | herdr |
|---|---|
tmux attach | herdr |
tmux ls | herdr session list |
tmux attach -t work | herdr session attach work |
tmux kill-server | herdr server stop |
tmuxと同じキー操作にする設定
herdrには、tmuxの配置を一括で適用するプリセットはありません。ただ、~/.config/herdr/config.toml でアクションごとにキーを割り当て直せるので、tmuxの操作にかなり寄せられます。値を配列にすると、herdrのデフォルトのキーを残したままtmuxのキーを追加できます。
私はtmuxのプレフィックスを Ctrl+a にしていて、Ghosttyで左下のキー + a を Ctrl+a に変換しています(前述の設定)。herdrのプレフィックスも Ctrl+a にすれば、Ghosttyの設定を変えずに同じ指の動きで操作できます。
prefix = “ctrl+a”
分割(tmux の % と “)。s は会社の tmux に合わせた上下分割
split_vertical = [“prefix+v”, “prefix+%”]
split_horizontal = [“prefix+minus”, “prefix+””, “prefix+s”]
herdr の設定画面は標準で prefix+s なので Shift+s に移す
settings = “prefix+shift+s”
ペイン移動(tmux の矢印キー / o / ;)
focus_pane_left = [“prefix+h”, “prefix+left”]
focus_pane_down = [“prefix+j”, “prefix+down”]
focus_pane_up = [“prefix+k”, “prefix+up”]
focus_pane_right = [“prefix+l”, “prefix+right”]
cycle_pane_next = [“prefix+tab”, “prefix+o”]
last_pane = “prefix+;”
リサイズ(tmux の Ctrl+矢印)
resize_pane_left = “prefix+ctrl+left”
resize_pane_down = “prefix+ctrl+down”
resize_pane_up = “prefix+ctrl+up”
resize_pane_right = “prefix+ctrl+right”
タブ(tmux の , と &)
rename_tab = [“prefix+shift+t”, “prefix+comma”]
close_tab = [“prefix+shift+x”, “prefix+ampersand”]
デタッチ(tmux の d)
detach = [“prefix+q”, “prefix+d”]
保存したら、次のコマンドで書き方の誤りを確認してから反映します。
herdr config check
herdr server reload-config
herdr config check は、存在しないキー名を書くと invalid keybinding と表示します。今有効なキーの一覧は、herdrの画面でプレフィックス → ? を押すと確認できます。
workspaceを作ってエージェントを動かす
- プレフィックス →
Shift+nで新しいworkspaceを作る cdで作業したいリポジトリに移動する。workspaceの名前は自動でディレクトリ名になるclaude、codex、cursor-agentなどのエージェントを起動する
Cursorのエージェントを起動するコマンドは cursor-agent です。cursor はエディタのアプリを開くコマンドなので注意してください。
起動したエージェントは、サイドバー下部の「agents」欄にworkspace名とエージェント名で表示されます。workspaceを移動するときは、サイドバーをクリックするか、プレフィックス → w で一覧から選びます。
