【設定・環境構築】tmux + Ghostty + Claude Code で作る最強のターミナル開発環境

はじめに#

Ghostty は HashiCorp 創業者 Mitchell Hashimoto による高速なターミナルエミュレータで、2024 年末の 1.0 リリース以降、macOS / Linux で iTerm2 や Terminal.app の代替候補として急速に普及しています。一方 tmux はターミナルマルチプレクサの定番で、画面分割・セッション永続化・detach/attach といった独自の価値を持ちます。

Ghostty 単体でもタブ・分割は可能ですが、「ターミナルを閉じてもセッションが死なない」「SSH 切断に強い」「同じセッションに別マシンから繋ぎ直せる」 という性質は tmux にしかありません。さらに Claude Code のような長時間実行する CLI エージェントを使う上で、この永続化は実用上ほぼ必須です。

この記事では Ghostty + tmux + Claude Code の三層構成を、ゼロから構築する手順をまとめます。

1. tmux とは何か#

tmux (terminal multiplexer) は 1 つのターミナルウィンドウの中に複数の独立した仮想ターミナルを持てるツールです。役割を整理すると以下の 3 層に分かれます。

tmux が提供する価値は次の 3 点に集約されます。

1. 画面分割: 1 ウィンドウ内に複数のシェルを並べられる
2. セッション永続化: ターミナルを閉じても・SSH が切れてもプロセスが死なない
3. detach / attach: 同じセッションに別マシンから繋ぎ直せる

Ghostty 自体にもタブ・ペイン分割機能はありますが、永続化と detach は tmux にしかありません。これが両方を組み合わせる最大の理由です。

2. インストール#

macOS では Homebrew で即インストールできます。

brew install tmux
tmux -V    # → tmux 3.6 などが表示されれば OK

バージョン確認まで通れば準備完了です。設定ファイルもプラグインも不要で、すぐに起動できます。

tmux       # 起動
exit       # 終了 (またはセッション内のシェルを全部閉じる)

3. 必須の 3 概念: Session / Window / Pane#

tmux を扱う上で絶対に押さえるべきは Session / Window / Pane の階層構造です。

Session (作業プロジェクト単位)
 ├─ Window 1 ("editor" — タブみたいなもの)
 │   ├─ Pane (左: nvim)
 │   └─ Pane (右: shell)
 ├─ Window 2 ("logs")
 │   └─ Pane (docker compose logs -f)
 └─ Window 3 ("git")

各レイヤーの役割は以下の通り。

• Session: プロジェクト 1 個 = セッション 1 個が基本。tmux ls で一覧表示
• Window: ブラウザのタブ的存在。役割ごとに切り分ける (editor, logs, git, など)
• Pane: ウィンドウを縦横に分割した個々のシェル

迷ったら 「Session = プロジェクト / Window = 役割 / Pane = 並列したいもの」 で整理すると良いです。

4. 最低限覚える操作#

tmux の操作は prefix キー → コマンドキー の 2 段押しが基本。デフォルト prefix は Ctrl+b です。

4.1 セッション操作#

4.2 ウィンドウ操作 (タブ的)#

4.3 ペイン操作 (分割)#

4.4 コピーモード (スクロール・コピー)#

5. 実践的なワークフロー#

5.1 開発の定番 3 ペイン構成#

┌──────────────────┬──────────────────┐
│                  │  docker logs -f  │
│   editor (nvim)  ├──────────────────┤
│                  │  shell (test 用) │
└──────────────────┴──────────────────┘

左にエディタ、右上にログ tail、右下に検証用シェル。立ち上げる手順は以下のようになります。

tmux new -s myproject
cd ~/projects/myrepo
nvim .
# Ctrl+b %    # 横分割 → 右側に shell
# Ctrl+b "    # その shell を縦分割 → 上下に
# Ctrl+b ↑   # 右上に移動
docker compose logs -f api
# Ctrl+b ↓   # 右下に移動 → 自由にコマンド検証

5.2 detach して放置するパターン#

長時間ジョブ (build, migration, AI エージェントの自動実行など) を流したら、ターミナルから一旦離れて他の作業に移れます。

# 中で Ctrl+b d を押す → detach (バックグラウンドに回る、プロセスは生き続ける)
tmux ls                # 状態確認
tmux attach -t myproject  # 戻る

5.3 SSH 先での tmux#

リモート作業の必須テクニック。SSH が切れても作業が死にません。

ssh dev-server
tmux new -s deploy    # 初回
# 作業を進める。ネットが切れても問題なし
# 再ログイン後:
tmux attach -t deploy

5.4 タスクごとにセッションを切る#

複数の作業を並行する時はセッションを分けるのが鉄則です。

tmux new -s pr-review    # PR レビュー対応
tmux new -s research     # 別機能の調査
tmux new -s bugfix       # バグ調査

Ctrl+b s でセッション間をスイッチできます。

6. .tmux.conf カスタマイズ入門#

~/.tmux.conf を整備すると一気に快適になります。まず最小構成、慣れたら拡張 が原則です。

6.1 ミニマム版 (これだけで体感が変わる)#

# 1. prefix を Ctrl-b → Ctrl-a に変更 (押しやすい位置)
unbind C-b
set-option -g prefix C-a
bind-key C-a send-prefix

# 2. マウス操作を有効化 (クリック・スクロール・リサイズ)
set -g mouse on

# 3. 分割キーを直感的に (| と -)
unbind '"'
unbind %
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

# 4. ウィンドウ番号を 1 から始める
set -g base-index 1
setw -g pane-base-index 1

# 5. 設定リロードをショートカット化
bind r source-file ~/.tmux.conf \; display "Reloaded!"

# 6. スクロールバックを増やす (長い出力を遡れる)
set -g history-limit 50000

# 7. ESC キーの遅延を削除 (Vim/Neovim 用)
set -sg escape-time 0

設定の反映は tmux 内なら Ctrl+a r、外からなら tmux source-file ~/.tmux.conf で行います。

6.2 Vim ライクなペイン移動#

矢印キーよりも hjkl を使ったほうが手の移動が少なく済みます。

# hjkl でペイン移動
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# Shift+hjkl でペインリサイズ
bind -r H resize-pane -L 5
bind -r J resize-pane -D 5
bind -r K resize-pane -U 5
bind -r L resize-pane -R 5

6.3 コピーモードを vi 式に + macOS クリップボード連携#

選択 → y でシステムクリップボードにコピーされるようにしておくと便利です。

setw -g mode-keys vi
bind-key -T copy-mode-vi v send-keys -X begin-selection
bind-key -T copy-mode-vi y send-keys -X copy-pipe-no-clear "pbcopy"

これで Ctrl+a [ でコピーモードに入り、v で選択開始、y でクリップボードに飛びます。

6.4 ステータスバー (最小カスタム)#

上部に置くと視線移動が少なくて良いです。

set -g status-position top
set -g status-style bg=black,fg=white
set -g status-left "[#S] "
set -g status-right "%Y-%m-%d %H:%M "
set -g status-interval 5

7. プラグイン: TPM で導入する#

tmux のプラグインは TPM (Tmux Plugin Manager) で管理するのが標準です。

7.1 TPM インストール#

まずリポジトリを clone します。

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

次に ~/.tmux.conf の 末尾 に以下を追記します。

# プラグインリスト
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'     # resurrect の自動化
set -g @plugin 'christoomey/vim-tmux-navigator'  # Vim とペイン移動を統合
set -g @plugin 'catppuccin/tmux'                 # 見た目テーマ

# tmux-continuum 自動復元
set -g @continuum-restore 'on'
set -g @continuum-save-interval '15'

# これは必ず最後に書く
run '~/.tmux/plugins/tpm/tpm'

設定後、Ctrl+a I (大文字) でプラグイン一括インストール。これで永続化と見た目が一気に整います。

7.2 重要プラグインの効能#

7.3 「Oh My Tmux!」という選択肢#

設定をゼロから書くのが面倒なら gpakosz/.tmux (通称 Oh My Tmux!) という設定一式を使う手もあります。

cd ~ && git clone https://github.com/gpakosz/.tmux.git
ln -s -f .tmux/.tmux.conf
cp .tmux/.tmux.conf.local .

カスタマイズは .tmux.conf.local だけ触れば本体は壊れない設計で、初心者の最短ルートとしては最適です。

8. Ghostty との連携で押さえる 3 点#

Ghostty で tmux を使うと、デフォルトのままだと地味に不具合が出ます。以下の設定を .tmux.conf に追加しておくと安全です。

8.1 True Color (24bit カラー)#

Ghostty は RGB フルカラー対応ですが、tmux 側で明示的に許可しないとテーマがくすみます。

set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",xterm-256color:RGB"
set -ga terminal-overrides ",xterm-ghostty:RGB"

8.2 拡張キーボードプロトコル (CSI-u / kitty keyboard)#

Ghostty は Ctrl+Shift+... 系の細かいキー入力を区別できる拡張プロトコルを話します。tmux に伝えないと文字化けして表示されます。

set -g extended-keys on
set -as terminal-features 'xterm*:extkeys'

8.3 画像パススルー (sixel / kitty graphics)#

tmux 内で画像を表示するツール (lazygit など一部) を使う場合に有効化します。

set -g allow-passthrough on

8.4 Ghostty 起動時に tmux を自動 attach#

~/.config/ghostty/config に以下を書くと、Ghostty を開いた瞬間に tmux セッションへ入れます。

command = /bin/zsh -l -c "tmux attach -t main || tmux new -s main"

これで「Ghostty 起動 = main セッション復帰」が成立。tmux-continuum と組み合わせれば、再起動後も全ペインが復元されます。

9. Claude Code との組み合わせ#

ここからが本題。tmux + Ghostty に Claude Code を載せる運用パターンです。

9.1 基本パターン#

tmux new -s claude-myproject
cd ~/projects/myrepo
claude

これだけで以下が成立します。

• ターミナル閉じても会話継続
• /loop や background agent が detach 中も走り続ける
• 別マシンから tmux attach で同じ会話に再接続できる

9.2 推奨ペイン構成#

┌──────────────────┬──────────────────┐
│                  │  docker logs -f  │
│   claude         ├──────────────────┤
│                  │  検証用 shell    │
└──────────────────┴──────────────────┘

左で claude にコードを書かせ、右で自分の手で挙動確認。Claude が書いたコードは自分の目で並行して検証する のが鉄則です。

9.3 並列タスクは別セッションで#

Claude を複数走らせるなら、タスクごとに tmux session を切ります。

tmux new -s claude-pr-review
tmux new -s claude-bugfix
tmux new -s claude-research

git worktree add と組み合わせるとブランチが分離されて事故りません。

git worktree add ../myrepo-pr-review origin/feature/xyz
tmux new -s claude-pr-review -c ../myrepo-pr-review

9.4 危険操作は claude のペインの外で#

terraform apply / git push --force / rm -rf のような不可逆操作は 必ず別ペインで自分の手で実行 します。AI エージェントに権限を持たせすぎないという原則に沿って、tmux の物理的な分離をもう 1 段のガードとして使うイメージです。

10. つまずきポイント FAQ#

Q. prefix を押すのが面倒#

Ctrl+b を Ctrl+a か Ctrl+Space に変更しましょう。さらに OS レベルで Caps Lock を Ctrl にリマップすると劇的に楽になります。

Q. macOS の Cmd+K で画面クリアしたら tmux のスクロールバックも消えた#

tmux のスクロールバックは独立しています。Ctrl+a [ でコピーモードに入ってから遡るか、clear-history で明示的にクリアしてください。

Q. ペインの中の Vim が色化けする#

true color 設定漏れです。セクション 8.1 の terminal-overrides を入れてください。

Q. Ghostty のタブと tmux のウィンドウ、どっちを使えば?#

tmux のウィンドウを優先するのがおすすめです。Ghostty タブは「全く別の作業 (個人 dotfiles 編集など)」用に使い分けると衝突しません。

Q. tmux ネスト (tmux の中で tmux) したい#

内側の prefix を Ctrl+a a のように 2 度押しに設定すれば共存できます。SSH 先で tmux を使う時に発生しがちな構成です。

Q. なんか変な状態になった#

tmux kill-server で全セッション破棄、tmux kill-session -t name で特定セッションだけ。困ったらリセットが早いです。

Tips / ベストプラクティス#

学習ロードマップ#

いきなり全部覚える必要はありません。段階的に拡張していくのが現実的です。

1. Day 1: brew install → tmux new → Ctrl+b % Ctrl+b " Ctrl+b 矢印 Ctrl+b d tmux attach。これだけで価値の 80% は取れる
2. Day 2-3: ~/.tmux.conf に prefix 変更・マウス・分割キーだけ書く
3. Week 1: TPM + tmux-resurrect + continuum で永続化を獲得する
4. Week 2: catppuccin / vim-tmux-navigator など見た目と統合系を整備
5. Week 3+: Ghostty command = で自動 attach。Claude Code を tmux 配下で運用するワークフロー確立

参考リンク#

公式・一次情報#

• tmux/tmux Wiki — Getting Started
• tmux/tmux Wiki — Installing
• tmux Homebrew Formulae

設定・カスタマイズ#

• Ham Vocke — A Guide to Customizing Your tmux.conf
• gpakosz/.tmux (Oh My Tmux!)
• Built In — tmux Config Guide

プラグイン#

• tmux-plugins/tpm
• tmux-plugins/tmux-resurrect
• tmux-plugins/tmux-continuum
• rothgar/awesome-tmux

Ghostty 連携#

• Mansoor Barri — Tmux & Ghostty
• SubDepthTech — Tmux + Ghostty Workflow
• darren.sh — Dev Terminal Setup with Ghostty + Tmux + Neovim

まとめ#

• Ghostty / tmux / Claude Code は役割が違う 3 層 — エミュレータ・マルチプレクサ・CLI を組み合わせることで永続性と並列性を獲得
• インストールは brew install tmux で即完了 — 設定ゼロでも基本機能は使える
• 覚えるべきは Session / Window / Pane の 3 概念とそれぞれのキーバインド — Ctrl+b ? でいつでも参照できる
• .tmux.conf は最小構成から始める — prefix 変更・マウス・分割キー・base-index・history-limit だけで体感が劇的に変わる
• TPM + resurrect + continuum で永続化を完全自動化 — マシン再起動を意識しなくてよくなる
• Ghostty 連携には true color / extended-keys / passthrough の 3 設定が必須
• Claude Code は tmux セッション内で起動 — 並列タスクは別セッション + git worktree で完全分離

慣れてくると tmux なしの開発に戻れなくなります。まずは Day 1 の「最小操作だけ覚える」から始めて、徐々に設定とプラグインを足していくのがおすすめです。