VSCodeからcmuxに移行したらClaude Codeの並列実行が圧倒的に楽になった話

記事タイトルとURLをコピーする

AS部DS4課の越後です。

今回は最近Claude Codeの並列実行のために愛用している「cmux」の紹介をさせていただきます。VSCodeユーザーの方はぜひ記事を読んで興味を持っていただければ触ってみて欲しいです!

cmuxにしたらClaude Codeの並列実行が圧倒的に楽になった

Claude Codeを複数同時に走らせるとき、ずっとVSCodeのターミナルを使ってたんですが、ウィンドウの増殖、画面幅の不足、メモリの肥大化……などなどで私のPCは悲鳴をあげていました。 そこでcmux が気になっていたので思い切って移行してみました。

使ってみると思った以上に体験がよく、特に以下の三つが良かったです!

  • 通知機能でエージェントの入力待ちを見逃さなくなった
  • サイドバーのgit情報表示でworktree並列作業の把握が一瞬に
  • Ghosttyベースの描画でペイン分割してもストレスゼロ

ちなみに実際の画面は以下のような感じです。

VSCodeでの並列実行、何がつらかったか

  • ウィンドウが増殖する — 3つ並列ならウィンドウも3つ。Cmd+Tabでの切り替えが地獄に
  • 画面幅が足りない — エディタ+サイドバー+ターミナルで分割するので、Claude Codeの出力が折り返しだらけ。コード差分が読めない
  • メモリ消費が重い — VSCodeウィンドウ1つで数百MB。3つ開くと数GB。Electronが乗るので16GBマシンだとスワップが発生することも

cmuxって何?

cmux は、macOS専用のネイティブターミナルアプリです。ひとことで言うと、「Claude Codeの並列実行に最適化されたターミナル」。無料でオープンソースです。

Ghosttyのlibghosttyをレンダリングエンジンに使っていて、tmuxのようなペイン分割をネイティブアプリのUI(Swift + AppKit)で実現しています。Electronではないので軽量です。

移行の決め手になった3つのポイント

通知機能:入力待ちを見逃さない

cmuxはターミナルのOSCエスケープシーケンス(OSC 9/99/777)を自動検出して通知してくれます。Claude Codeが入力待ちになると、設定不要でそのまま通知が届きます。

通知は3段階です。

  1. ペインに青いリングが表示される
  2. タブが光る(別タブにいても気づける)
  3. macOS通知がポップアップする(ターミナルを見てなくても気づける)

必要な設定は、macOSのシステム設定でcmuxのデスクトップ通知を許可するだけ。.claude/settings.jsonへの追記は不要です。

これで「片方のClaude Codeがレビュー待ちなのに30分気づかなかった」みたいな無駄がなくなりました。

サイドバー :worktreeとの相性が抜群

cmuxのサイドバーには、各ペインのgitブランチ名・PR状態・作業ディレクトリがリアルタイム表示されます。

worktreeで複数ブランチを並行作業してるとき、「どのペインがどのブランチだっけ?」って迷いがゼロになります。VSCodeだとウィンドウタイトルを見るかgit branchを打つしかなかったんですよね。

描画性能:4分割でも滑らか

libghosttyのGPUアクセラレーションのおかげで、ペインを4分割して全部でClaude Codeが出力を流してても描画が滑らかです。VSCodeのターミナルはxterm.js(CPUレンダリング)なので、大量出力でフレーム落ちが目立ってました。

セットアップ

Homebrew Caskに対応してます。

brew install --cask cmux

公式サイト(https://cmux.com/)からdmgでも入れられます。インストール後、macOSのシステム設定 > 通知 でcmuxの通知を許可しておきましょう。

ペイン分割のキーバインドはCmd+D(垂直)/ Cmd+Shift+D(水平)。tmuxユーザーだと最初戸惑いますが、macOSネイティブのCmd系ショートカットに慣れちゃった方が速いです。

実際の運用パターン

  • 複数リポジトリ → タブで分ける — サイドバーにリポジトリ名とブランチ名が出るので、どのタブがどのプロジェクトか一目瞭然
  • worktree並列 → ペインで分ける — 1タブ内を2〜3分割。サイドバーにブランチ名が並ぶので状況がパッとわかる
  • メイン + サブエージェント → ペイン + 通知 — サブペインの完了通知が来たらメイン作業をサッと中断して確認

まとめ

項目 VSCode cmux
並列実行の単位 ウィンドウ複数起動 タブ + ペイン分割
メモリ消費 ウィンドウごとに数百MB Swift+AppKitネイティブで軽量
描画性能 xterm.js(CPU) libghostty(GPU)
通知 なし(目視) 3段階通知(設定不要)
git情報 コマンド実行が必要 サイドバーにリアルタイム表示

Claude Codeを日常的に複数並列で動かしてる人にとって、cmuxは明確に体験が変わるツールだと思います。macOS専用なのは制約ですが、無料なのでぜひ試してみてください。

公式サイト: https://cmux.com/
GitHub: https://github.com/manaflow-ai/cmux

越後 元貴 (記事一覧)

アプリケーションサービス本部ディベロップメントサービス4課

2023年新卒入社