tmuxとClaude Codeを組み合わせて長時間セッションを守る

「リモートのサーバーでClaude Codeを動かしていたら、SSH(リモートログイン)が切れてセッションが消えました」 — 同僚から聞いた話です。重い処理を任せて昼休みに席を立ち、戻ってきたら全部やり直し、というあるあるです。

この記事は、tmuxというツールとClaude Codeを組み合わせて、こうした事故を物理的に防ぐ運用を整理したものです。エンジニア寄りの内容なので、ふだんサーバーに触らないマーケや経理の方は読み飛ばしてもらって構いません。リモートのサーバーを触る人だけが必要になる話です。

tmuxは「ターミナルの中に独立した作業環境を持つ」仕組み

tmux(ティーマックス)は、ターミナルマルチプレクサと呼ばれる種類のツールです。簡単にいうと、ひとつのターミナル画面の中に、複数の独立した作業空間を持てるようにする仕組み。

tmux 公式

github.com

決定的な特徴は、tmuxの中で動かしたプロセス(プログラム)は、ターミナルを閉じたりSSHが切れたりしても動き続けること。あとで tmux attach でその作業空間にまた入り直せます。

Claude Codeのような「長く動かしたいセッション」と、相性が抜群です。

SSHが切れてもClaude Codeは生き続ける

具体的な使い方を順を追って書きます。

# サーバーにSSHでログイン
ssh user@my-server

# tmuxセッションを新規作成
tmux new -s claude

# tmuxセッションの中でClaude Codeを起動
claude

これで、tmuxセッション「claude」の中でClaude Codeが動き始めます。

ここでうっかりノートPCの蓋を閉じてSSHが切れたとします。ふつうなら起動中のClaude Codeはそこで終わり、ですが、tmuxセッションは生きたまま。あとでもう一度SSHでつなぎ直して、tmux attach -t claude を打てば、Claude Codeが続きから動いている状態に戻れます。

これだけでも、リモート作業の安心感が大きく変わります。

ペイン分割で複数セッションを並走

tmuxのもうひとつの便利な機能が、画面を分割して複数の作業空間を同時に見える化することです。tmuxの言葉で「ペイン」と呼びます。

たとえば、ひとつのtmuxウィンドウを左右に分割して、左で記事執筆用のClaude Code、右で別案件の検証用のClaude Codeを並走させる。Claude Codeの並列実行の選択肢のひとつとして、これが効きます。

Claude Codeを並列に走らせる現実的なやり方

claudecodelab.jp

複数のターミナルウィンドウを開くのとの違いは、ひとつの画面で完結することと、SSH切断に強いこと。私はリモート作業ではほぼtmuxで完結しています。

基本のキーバインド

tmuxを少しだけ覚えれば、ふだんの作業がぐっと楽になります。最低限のキー操作を表で。

操作	キー(デフォルト)
プレフィックスキー	`Ctrl+b`
縦に分割	`Ctrl+b` の後に `%`
横に分割	`Ctrl+b` の後に `"`
ペイン間移動	`Ctrl+b` の後に矢印キー
ウィンドウ作成	`Ctrl+b` の後に `c`
セッションから抜ける	`Ctrl+b` の後に `d`