複数のコーディングセッションを並列で管理・切り替えできるtmuxに挑戦して、たった1日で封印した話
今日、私はtmuxに挑戦しました。そして、その日のうちに封印しました。
「tmuxとClaude Codeを組み合わせれば、複数のプロジェクトを並列に処理する『マルチプロジェクト/マルチエージェント環境』が作れる」——そんな期待を抱いて始めた実験の、率直な記録です。同じ構成を検討している方の時間節約になれば幸いです。
やりたかったこと:AIを2人同時に働かせる
私の手元には、性質の異なる2つの進行中プロジェクトがあります。SAP-データ移行と、CauSync v4(自社プラットフォームのSTEP 3.5設計、機密度:低)です。
両者は技術的に独立しており、「並列に動かせれば理想的」という状況。Anthropic社が4月14日にClaude Codeデスクトップ版の並列エージェント機能を強化したニュースにも刺激され、「既存のWSL + Claude Code環境でも同じことができるはず」と考えたのが発端でした。
仮説はこうです。tmuxで1つのターミナルを左右に分割し、両方でClaude Codeを起動すれば、AIアシスタント2人を同時表示・同時操作できる。
■実行:最初はあっさり成功した
環境はWSL2 Ubuntu + PyCharm統合ターミナル + Claude Code v2.1.86(Opus 4.6)。tmuxはUbuntu標準で3.2aが入っていました。
起動スクリプトを書いて実行すると、左右paneに2つのClaude Codeセッションがきれいに並びました。
#!/bin/bash
SESSION="dual-workspace"
tmux new-session -d -s $SESSION -c "$PROJECT_A"
tmux send-keys -t $SESSION:0 'claude' Enter
tmux split-window -h -t $SESSION:0 -c "$PROJECT_B"
tmux send-keys -t $SESSION:0.1 'claude' Enter
tmux attach -t $SESSION
「勝った」と思いました。ここまでは。
ぶつかった3つの壁
■壁①:Ctrl+b がClaude CodeのRewindと衝突
tmuxのprefixキーはデフォルトで Ctrl+b。ところがこれを押すと、Claude Code v2.x の「Rewind(会話巻き戻し)」メニューが開いてしまうのです。tmuxは1回もコマンドを受け取れない。事前情報としてこの衝突を把握していれば……と思った瞬間でした。対策として ~/.tmux.conf でprefixを Ctrl+a に変更。ここは乗り切れました。
■壁②:Alt+矢印 がPyCharmのタブ切替と衝突
次はpane切替。tmuxに Alt+←/→ でpane切替するキーバインドを追加しました。設定は正しく反映されていることも確認済みです。ところが実際に Alt+→ を押すと、動くのはPyCharmのターミナルタブ。キー入力がtmuxに届かないのです。PyCharmの「IDEのショートカットをオーバーライドする」設定をONにしても、ターミナルパネル自体のタブ切替は別レイヤーで動いていました。
■壁③:コピペが不安定
マウス操作を有効にすると(set -g mouse on)、テキスト選択が通常のターミナルと異なる挙動になりました。通常ドラッグではtmuxがマウスイベントを吸収して選択不能、Shift+ドラッグはPyCharm統合ターミナルでは動作せず、tmuxコピーモードはWindowsクリップボードに連携しない。
Claude Codeが生成した長文の設計内容を他アプリに貼れない。日常業務として致命的でした。
■撤退判断
3〜4時間格闘した時点で、撤退を決めました。
理由は4つ。
1.コピペが安定しない。
2.キー衝突が3層(Claude Code + PyCharm + tmux)にわたり完全解決が困難。
3.3層構造(PyCharmタブ + tmuxセッション + pane)の認知負荷が大きい。4.設定の煩雑さに対して得られる効果が割に合わない。
「tmuxが悪い」のではありません。「私の環境(Windows + PyCharm + マルチモニター + マウス多用)には合わない」だけです。
tmuxが真価を発揮するのはSSH越しのサーバー管理、Linux/Macネイティブ、キーボード中心の文化。前提が違いすぎました。
結論として、PyCharmの複数ターミナルタブ運用に回帰。Alt+←/→ はタブ切替として素直に動くので、これが最適解でした。
学び:道具選びの5つのチェックリスト
今回の失敗から、新しいツール導入前に必ず確認すべき項目を整理しました。
1. 環境との適合性:自分のOS・IDE・作業スタイルとの相性
2. 他ツールとのキー衝突:既存ツールのキーバインド競合
3. 基本操作の維持:コピペ等の頻出操作が通常通り動くか
4. 学習曲線 vs 期待効果:習熟コストと効果のバランス
5. 撤退容易性:合わなかった場合にすぐ撤退できるか
特に②は盲点でした。Claude Codeのような新しいツールは仕様が頻繁に変わります。「tmuxのprefixと同じキー」という点を、事前にチェックしていませんでした。
それでも得られたもの
撤退はしましたが、この1日は無駄ではありませんでした。
tmuxを使って実際に並列作業をしている間、MDL2側ではRecovery2の精査を完了し、CauSync側ではSTEP 3.5の設計(AD-1〜AD-10の10項目、6 Phase構成のロードマップ)を仕上げることができたのです。
「並列でAIを働かせる」という発想そのものは正しかった。道具がtmuxではなくPyCharmの複数タブだっただけ。両プロジェクトを同時進行する作業パターンは、これから自分の標準運用になります。
まとめ
tmuxは優れたツールです。しかし、Windows + PyCharm + Claude Code v2.x という組み合わせでは、得られる効果に対してコストが見合いません。
もし同じ検討をされている方がいれば、結論だけお伝えします。PyCharmの複数ターミナルタブで十分です。セッション永続性が欲しければ、Claude Code側の /resume 機能で代替できます。
試して、合わないと判断して、撤退する——この一連のプロセス自体に、道具選びの判断基準を明確化するという副産物がありました。失敗は、次に進むための情報になります。