tmuxチートシート - セッション・ウィンドウ・ペイン操作リファレンス

概要

tmux（terminal multiplexer）は 1 つのターミナル内で複数のセッション・ウィンドウ・ペインを管理できるツールです。SSH 接続が切れてもセッションを維持できる、画面分割で複数のシェルを並べて作業できる、設定ファイルでキーバインドや見た目を自由にカスタマイズできる、といった理由でサーバー作業や開発環境として広く使われています。本チートシートは tmux 3.x 系を対象にします。

起動と接続

prefix キー

既定の prefix は Ctrl+b。本ドキュメントでは <prefix> と表記します。多くのユーザーは .tmux.conf で Ctrl+a に変更しています。

セッション操作

ウィンドウ操作

ペイン操作

レイアウト

コピーモード

<prefix> [ でコピーモードに入り、q で抜けます。

vi モードは setw -g mode-keys vi で有効化できます。

コマンドモード

<prefix> : でコマンドプロンプトに入り、tmux コマンドを直接入力できます。

主要 tmux コマンド

設定ファイル例 ~/.tmux.conf

# プレフィックスを Ctrl+a に
unbind C-b
set -g prefix C-a
bind C-a send-prefix

# マウス操作を有効化
set -g mouse on

# ウィンドウ番号を 1 から
set -g base-index 1
setw -g pane-base-index 1

# ペインを閉じても番号を詰める
set -g renumber-windows on

# 履歴
set -g history-limit 50000

# vi キーバインド（コピーモード）
setw -g mode-keys vi
bind -T copy-mode-vi v send-keys -X begin-selection
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"

# ペイン分割を | と - に
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
unbind '"'
unbind %

# 設定リロード
bind r source-file ~/.tmux.conf \; display "Reloaded!"

# ステータスバー
set -g status-position bottom
set -g status-interval 5
set -g status-left-length 40
set -g status-right "#[fg=cyan]%Y-%m-%d %H:%M"

# 256 色端末
set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",*256col*:Tc"

# エスケープ遅延を短く
set -sg escape-time 10

実用レシピ

1. 名前付きセッションで作業を整理

2. 既存セッションがあればアタッチ、なければ作成

3. SSH 先で永続セッション

4. 起動時に複数ペインを準備

tmux new -d -s dev -n editor 'vim'
tmux split-window -t dev:editor -h 'npm run dev'
tmux split-window -t dev:editor -v 'tail -f log/app.log'
tmux attach -t dev

5. キー送信で全ペインに同じコマンド

6. コピーした内容をシステムクリップボードへ

7. レイアウトを保存して再現

8. ペインのカレントディレクトリを引き継いで分割

9. 起動スクリプト

~/bin/tmux-dev:

#!/usr/bin/env bash
SESSION=dev
tmux has-session -t $SESSION 2>/dev/null && exec tmux attach -t $SESSION
tmux new -d -s $SESSION -n code
tmux send-keys -t $SESSION:code 'cd ~/project && nvim' C-m
tmux new-window -t $SESSION -n server
tmux send-keys -t $SESSION:server 'cd ~/project && npm run dev' C-m
exec tmux attach -t $SESSION

10. ステータスバーに Git ブランチを表示

よく使うオプション早見表

トラブルシューティング

Tips & ベストプラクティス

• セッションには用途別の名前を付けて tmux ls で見渡せるようにする。
• tmux new -A -s <name> を alias 化すると「あれば attach、なければ作成」が一発でできる。
• 重い処理は tmux 内で実行しておけば、SSH が切れても継続する。
• ペインのズーム（<prefix> z）はログ確認時に便利。元に戻すのも同じキー。
• マウスを有効化するとペインのリサイズや選択が直感的になる。コピーは Shift を押しながらドラッグするとターミナル側の選択になり、貼り付けが楽。
• vi モードに慣れると検索・コピー操作が高速化する。
• synchronize-panes は複数サーバへの一括操作に便利だが、危険なので終わったらすぐ off にする。
• 設定ファイルは git で管理し、複数マシンで共有する。
• tmux 3.2 以降で導入された popup 機能（display-popup）でフローティングウィンドウを開けるので、一時的なコマンド実行に活用する。
• プラグイン管理は TPM (Tmux Plugin Manager) を使うと導入がシンプル。

ステータスバーのカスタマイズ

ステータスバーは status-left, status-right, window-status-format などのオプションで自由に組み立てられます。フォーマット文字列内で #{...} を使うことで tmux の変数を埋め込めます。

set -g status-left  "#[fg=green]#S #[fg=default]| "
set -g status-right "#[fg=cyan]#(whoami)@#h #[fg=yellow]%Y-%m-%d %H:%M"
set -g window-status-current-format "#[bg=blue,fg=white] #I:#W "
set -g window-status-format         " #I:#W "

色は colour0-colour255 または #rrggbb（True Color 端末）で指定できます。

ポップアップウィンドウ (display-popup)

tmux 3.2 で導入されたフローティングウィンドウ機能です。一時的なコマンドや別作業を素早く呼び出すのに便利です。

bind P display-popup -E "htop"
bind G display-popup -w 80% -h 80% -E "lazygit"
bind N display-popup -d "#{pane_current_path}" -w 60% -h 60% -E "$SHELL"

バッファとペーストバッファ

コピーした内容は tmux のペーストバッファにスタックされます。

フック

特定イベントで自動実行されるコマンドを設定できます。

代表的なフック: session-created, client-attached, pane-focus-in, pane-focus-out, window-linked, after-resize-pane, after-new-window。

TPM (Tmux Plugin Manager)

プラグインで機能を拡張できます。~/.tmux.conf の末尾に以下を追加し <prefix> I でインストール。

set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-continuum'

run '~/.tmux/plugins/tpm/tpm'

代表的プラグイン:

• tmux-resurrect: セッションを保存して再起動後も復元
• tmux-continuum: tmux-resurrect を自動化
• tmux-yank: クリップボード連携を簡単に
• tmux-sensible: 推奨デフォルト設定をまとめて適用
• tmux-prefix-highlight: prefix 入力中の表示
• tmux-fzf: fzf ベースのセッション/ウィンドウ検索
• tmux-battery: バッテリー残量をステータスバーに表示
• tmux-online-status: ネットワーク接続状態を表示

プラグインのインストールは <prefix> I、更新は <prefix> U、アンインストールは <prefix> alt+u で行えます。

参考リソース

• tmux 公式 Wiki
• tmux man page
• TPM (Tmux Plugin Manager)
• tmux GitHub リポジトリ