cmuxでSSHリモート開発する方法

cmuxとSSHリモート開発の考え方

こんにちは！今日は「cmuxでSSHリモート開発する方法」について学びましょう。

「cmuxはローカルのAIエージェント開発に特化したターミナルだったよね？それでリモート開発ってどういうこと？」と思った方、鋭いですね。

まず大前提を整理しておきましょう。cmuxはGhosttyのレンダリングエンジンを搭載したmacOSネイティブのターミナルで、AIコーディングエージェント連携に特化したアプリです。cmuxアプリそのものはローカルマシン（macOS）上で動作し、リモートサーバーにインストールして動かすものではありません。

では「cmuxでSSHリモート開発する」とはどういうことか。それは、ローカルで起動したcmuxをSSHクライアントとして使い、リモートサーバー上の作業を行うということです。役割を分けて考えると分かりやすくなります。

接続の基本

cmuxのペインからSSH接続する

cmuxのペインは通常のシェルなので、sshコマンドがそのまま使えます。新しいワークスペースやペインを開いて、いつも通りSSHで接続するだけです。

# リモートサーバーに接続
ssh user@example.com

# ポートを指定して接続
ssh -p 2222 user@example.com

# 鍵ファイルを指定して接続
ssh -i ~/.ssh/id_ed25519 user@example.com

cmuxの画面分割を使えば、複数のサーバーへ同時に接続して並べて作業できます。例えば左ペインでアプリケーションサーバー、右ペインでデータベースサーバーに接続する、といった使い方です。

# 左右に分割: Cmd+D
# 上下に分割: Cmd+Shift+D
# ペイン移動: Option+Cmd+矢印キー

SSH configで接続を整理する

接続先が増えてくると、毎回ホスト名やポート、鍵を指定するのは面倒です。~/.ssh/configに設定をまとめておくと、短い名前で接続できるようになります。これはcmux固有の機能ではなく、標準的なSSHの仕組みです。

# ~/.ssh/config の例
# Host dev
#   HostName 203.0.113.10
#   User developer
#   Port 2222
#   IdentityFile ~/.ssh/id_ed25519

この設定があれば、次のように短く接続できます。

# config の Host 名で接続
ssh dev

接続をまとめて開くスクリプト

cmuxはCLIやSocket API経由でスクリプトから制御できるため、よく使う開発環境を一発で立ち上げることもできます。ここではまず、SSH接続自体をシェルスクリプトでまとめる素朴な例を示します。

#!/bin/bash
# connect-dev.sh
# よく使うリモートサーバーへ接続する

ssh dev

cmuxのCLI・Socket APIを組み合わせれば、ワークスペース作成からSSH接続までを自動化することも可能です。具体的なコマンド体系は変わる可能性があるため、最新の挙動は公式ドキュメントを確認してください。

セッションの維持・復元

リモート開発で最初にぶつかる壁が「接続が切れると作業が消える」問題です。ノートPCを閉じたり、Wi-Fiが切れたりすると、SSHセッションが切断され、実行中のプロセスも一緒に止まってしまうことがあります。

cmuxのセッション復元とは役割が違う

ここで混同しやすいのが、cmux自身のセッション復元機能です。cmuxはアプリを再起動してもレイアウトや作業ディレクトリを自動で復元しますが、ターミナル内で実行中のプロセスの状態までは復元しません。

つまり、cmuxを再起動するとSSH接続は切れ、再接続が必要になります。だからこそ、リモート側でのセッション永続化が重要になります。

リモート側でtmux/screenを使う

リモートサーバー上でtmuxやscreenを使うのが定番の解決策です。これらはSSH接続が切れてもサーバー上でセッションを維持し続けるため、再接続してattachするだけで作業を再開できます。

# リモートにSSH接続したあと、tmuxセッションを開始
tmux new -s work

# 接続が切れたら、再接続後にアタッチして再開
ssh dev
tmux attach -t work

# screen を使う場合
screen -S work       # セッション開始
# 切断後
screen -r work       # 再開

長時間ジョブを切断に強くする

ビルドやデータ移行のような長時間ジョブは、tmux/screenの中で実行しておけば、接続が切れても処理は続行されます。完了後にcmux側の通知機能と組み合わせると、ローカルで結果を受け取れて便利です。

# リモートの tmux セッション内で長時間ジョブを実行
tmux new -s build
npm run build
# ここで接続が切れても、リモート上ではビルドが継続する

🔄 使い分けのポイント: cmuxはローカルのUI・通知・並列表示を、tmux/screenはリモートのセッション永続化を担当します。両方を重ねて使うことで「快適な操作感」と「切断に強い実行環境」を両立できます。

リモートでのAIエージェント活用

cmuxはAIコーディングエージェントとの連携に特化したターミナルです。リモート開発でもこの強みを活かせます。ポイントは「エージェントをどこで動かすか」を決めることです。

パターン1: エージェントをローカルで動かす

Claude CodeなどのエージェントをローカルのcmuxペインでSSH接続中に動かすシンプルなパターンです。エージェントの状態に応じてcmuxの通知リングが光るため、入力待ちを見落としません。

# ローカルのcmuxペインでSSH接続
ssh dev

# 接続したリモートシェル上でコマンドを実行しながら作業
# cmux側の通知リング・サイドバーバッジで状態を把握

パターン2: エージェントをリモートで動かす

リモートサーバー上にエージェント環境を用意し、tmuxセッション内でエージェントを実行するパターンです。GPUや大容量メモリが必要なケース、リポジトリがリモートにしかないケースで有効です。

# リモートでtmuxセッションを開始し、その中でエージェントを起動
ssh dev
tmux new -s agent
# tmuxセッション内でAIエージェントを実行

この場合、cmuxの通知リングはローカルのターミナル出力（エスケープシーケンスなど）に反応します。リモートのエージェントからローカルの通知へどこまで連携できるかは環境に依存するため、確実に通知が必要な場合はリモート側の仕組み（メール・チャット通知など）も併用すると安心です。

ローカルとリモートを橋渡しする

実務では「リポジトリはローカル、実行はリモート」のように混在することもあります。cmuxの画面分割で複数の役割を並べると、行き来がスムーズになります。

# 左ペイン: ローカルでコード編集・git操作
# 右上ペイン: SSHでリモートに接続しビルド・テスト
# 右下ペイン: 内蔵ブラウザでリモートの開発サーバーを確認

# Cmd+D で左右分割
# 右ペインで Cmd+Shift+D で上下分割
# 右下ペインで Cmd+Shift+L で内蔵ブラウザを開く

🔍 注目ポイント: リモートの開発サーバーにアクセスするには、SSHポートフォワーディング（ssh -L）でローカルポートに転送すると、cmuxの内蔵ブラウザからlocalhostとして確認できます。

# リモートの3000番ポートをローカルの3000番に転送
ssh -L 3000:localhost:3000 dev
# これでローカルブラウザから http://localhost:3000 にアクセスできる

注意点

リモート開発を快適かつ安全に行うために、押さえておきたいポイントをまとめます。

1. cmuxの機能はローカルに効く

繰り返しになりますが、cmuxの画面分割・通知・内蔵ブラウザ・セッション復元はすべてローカル側の機能です。リモートでの永続化やプロセス管理はtmux/screenに任せましょう。レイヤーを分けて考えるのが混乱しないコツです。

2. 接続断に備える

モバイル回線やVPN経由では接続が不安定になりがちです。重要な作業は必ずリモートのtmux/screenセッション内で行い、切断されても再アタッチで復帰できる状態にしておきましょう。

3. SSHのセキュリティ基本を守る

リモート開発ではSSHのセキュリティ設定が前提になります。これはcmux固有の話ではなく、一般的なSSH運用の範囲です。

• パスワード認証ではなく公開鍵認証を使う
• 鍵には適切なパーミッション（chmod 600）を設定する
• 可能であれば多要素認証や踏み台サーバー（bastion）を併用する

# 鍵ファイルのパーミッションを確認・修正
ls -l ~/.ssh/id_ed25519
chmod 600 ~/.ssh/id_ed25519

4. 機密情報の扱いに注意する

リモートにAIエージェントを置く場合も、ローカルで動かす場合も、認証情報やトークンの取り扱いには注意が必要です。.envファイルや鍵をリポジトリに含めない、ログに出力しないといった基本を徹底しましょう。

🎮 理解度チェック

Q1: cmuxでSSHリモート開発するときの正しい考え方は？

Q2: SSH接続が切れても作業を失わないためには？

Q3: リモートの開発サーバーをcmuxの内蔵ブラウザで確認するには？

よくある質問

📝 まとめ

今回は「cmuxでSSHリモート開発する方法」について学びました！

ポイントは、cmuxとリモート環境の役割分担を理解することでした。覚えておきたい点をまとめます。

• cmuxはローカル専用: 画面分割・通知・内蔵ブラウザはすべてローカルマシン側の機能
• SSHは普通に使える: cmuxのペインでsshコマンドを実行すれば、いつものリモート接続がそのまま使える
• 永続化はtmux/screen: 接続断に備えてリモート側でセッションを維持し、再アタッチで作業を再開
• 内蔵ブラウザ × ポートフォワーディング: ssh -Lでリモートの開発サーバーをローカルブラウザから確認
• セキュリティの基本を守る: 公開鍵認証・鍵のパーミッション・機密情報の取り扱いに注意

cmuxのローカルでの快適さと、tmux/screenによるリモートの堅牢さを組み合わせれば、リモート開発でも生産性を落とさずに作業できます。

cmuxの基本機能をまだ押さえていない方は、cmuxでAIコーディングを加速するを、cmuxとtmuxの違いを詳しく知りたい方はcmux vs tmuxの記事もぜひチェックしてみてください！