tmux, herdr とは?基本の使い方とClaude Codeで使うときの設定

目次

tmuxとは

tmux(ティーマックス)は、1つのターミナルの中で複数の作業画面を作り、管理するためのソフトウェアです。

分類としては「ターミナルマルチプレクサ」と呼ばれます。LinuxとmacOSで動作し、Windowsで使う場合はWSLなどのLinux環境が必要です。

主な機能は次の2つです。

  • 画面を分割する — 1つの端末ウィンドウを左右・上下に分け、それぞれで別のコマンドを動かす
  • 作業を保持する — 端末を閉じたりSSHが切れたりしても、tmuxの中のプロセスは動き続け、後から同じ画面に戻れる

ターミナルエミュレータとの違い

Windows Terminal、Ghostty、iTerm2などのターミナルエミュレータは、文字を画面に描画し、キー入力を受け取るアプリです。

tmuxはそのアプリの中で動くプログラムで、担当する層が違います。両者の関係は次の図のとおりです。

ターミナルエミュレータ Windows Terminal / Ghostty / iTerm2 など。文字の描画とキー入力を担当 tmux(ターミナルマルチプレクサ) 画面の分割と、セッションの保持を担当 シェル bash / zsh Claude Code AIエージェント Vim / Neovim エディタ

「WezTermとtmuxのどちらを使うか」という比較は成り立ちません。どのターミナルエミュレータを使っていても、その中でtmuxを起動できます。

あわせて読みたい
ターミナルエミュレータおすすめ6選【2026年版】Windows・Mac両対応で選ぶ 用途別のおすすめ早見表 2026年10月時点で候補に挙がるのは次の6製品です。WindowsとMacの両方で使うかどうかを決めると、選択肢が半分に絞れます。 こんな人におすすめ...

セッション・ウィンドウ・ペインの関係

tmuxの画面は3つの単位で構成されます。この関係を先に押さえておくと、キー操作も覚えやすくなります。

  • セッション — 作業のまとまり。プロジェクトごとに1つ作るのが一般的
  • ウィンドウ — セッションの中のタブに相当する。画面全体を切り替える
  • ペイン — ウィンドウを分割した1区画。それぞれで別のシェルが動く

階層を図にすると次のようになります。

セッション「work」 ウィンドウ1「editor」 ウィンドウ2「server」 ペイン Neovim ペイン シェル ペイン 開発サーバー ペイン ログ監視 セッションの中にウィンドウ、ウィンドウの中にペインがある

tmuxを起動すると、画面の最下部に緑色のバーが表示されます。

これは「ステータスライン」で、左端にセッション名、その右にウィンドウの一覧が並びます。今どのセッションのどのウィンドウにいるかは、ここで確認できます。

tmuxのインストール

macOSはHomebrew、Ubuntu・Debian(WSLを含む)はaptでインストールできます。

# macOS
brew install tmux

# Ubuntu / Debian / WSL
sudo apt update && sudo apt install tmux

# バージョン確認
tmux -V

tmuxの基本的な使い方

プレフィックスキーの仕組み

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:\x01

tmux のプレフィックス設定(~/.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 worktmux の中から「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の中で動かしていれば、切断後も処理は続きます。その流れを図にすると次のとおりです。

手元のPC ターミナル リモートサーバー tmuxサーバー セッション「claude」 Claude Code 実行中 (切断後も処理を継続) SSHが切断 再接続して tmux attach 接続が切れても、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 ① ~/myapp-login > ログイン画面を実装して 作業中… Claude Code ② ~/myapp-cache > キャッシュの不具合を調査して 許可待ち シェル ~/myapp $ npm test $ git log –oneline [dev] 1:claude* 2:server

同じリポジトリの同じディレクトリで複数の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との対応

herdrtmux
sessiontmuxサーバー全体に近い。普段は1つで足りる
workspacesession。リポジトリごとに1つ作る
tabwindow
panepane

herdrでは、tmuxのsessionとwindowのあいだに workspace という単位があります。左のサイドバーにworkspaceの一覧が並び、作業ディレクトリ名とgitのブランチ名が表示されます。

デフォルトのキー操作の違い

デフォルトのプレフィックスはtmuxと同じ Ctrl+b です。c(新しいタブ)、n / p(次・前のタブ)、1〜9(番号のタブへ移動)、z(最大化)、x(ペインを閉じる)、[(コピーモード)はtmuxと同じ動作です。

違うのは次のキーです。

操作tmuxherdr
左右に分割%v
上下に分割"-
ペイン間を移動矢印キーh / j / k / l
デタッチdq
ウィンドウ(タブ)名の変更,Shift+t

コマンドは次のように対応します。

tmuxherdr
tmux attachherdr
tmux lsherdr session list
tmux attach -t workherdr session attach work
tmux kill-serverherdr 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を作ってエージェントを動かす

  1. プレフィックス → Shift+n で新しいworkspaceを作る
  2. cd で作業したいリポジトリに移動する。workspaceの名前は自動でディレクトリ名になる
  3. claude、codex、cursor-agent などのエージェントを起動する

Cursorのエージェントを起動するコマンドは cursor-agent です。cursor はエディタのアプリを開くコマンドなので注意してください。

起動したエージェントは、サイドバー下部の「agents」欄にworkspace名とエージェント名で表示されます。workspaceを移動するときは、サイドバーをクリックするか、プレフィックス → w で一覧から選びます。

TECHSCORE BLOG
herdr を使いこなす: 複数 AI エージェントの連携から自作プラグインまで - TECHSCORE BLOG herdr の基本操作から、複数 AI エージェントの連携・自動化・セッション永続化まで実例で紹介します。足りない機能をプラグインで自作する方法も扱います。
目次