cmuxの使い方｜AIコーディングエージェント専用ターミナルで開発効率を最大化する方法

cmuxはAIコーディングエージェントが並列作業する時代専用のターミナルだ。垂直タブ・組み込みブラウザ・Socket APIにより、複数エージェントの状態を一画面で把握でき、従来のiTerm2やtmuxとは根本的に設計思想が異なる。

本記事は「Claude Code実践ガイド｜AI開発の生産性を高める運用設計」シリーズの一部です。

この記事でわかること

AIエージェント時代の開発ワークフローに特化したターミナル「cmux」の導入から実務運用までを解説します。

• cmuxの設計思想と従来ターミナル（iTerm2・Warp・tmux）との根本的な違い — AIエージェントのセッション管理に最適化された垂直タブUIの仕組みを理解できます
• インストールから初期設定、Claude Codeとの接続方法 — Homebrewによる導入手順とSocket APIの基本設定を実際のコマンド例で確認できます
• 垂直タブ・分割ペイン・組み込みブラウザの実務活用パターン — ブランチ別のエージェント管理やPR状態の可視化で、マルチタスク開発を効率化する方法がわかります
• Socket APIを活用した外部ツール連携と自動化 — エージェントの状態監視やCI/CDパイプラインとの統合パターンを学べます
• マルチエージェント開発環境における一元管理の設計指針 — 少数精鋭チームがAIエージェントを最大限活用するための運用設計を提案します

対象読者: AIコーディングエージェントを日常的に使う開発者・CTO・テックリード

cmuxとは何か

cmuxは、Lawrence ChenとAustin Wangが2026年2月にリリースしたオープンソースのmacOSネイティブターミナルです。Swift/AppKitで構築されており、AIコーディングエージェントの操作に完全特化した設計がなされています。

名前にmuxが含まれていますが、tmuxとは無関係です。「Claude mux」に由来しており、複数のAIエージェントセッションを多重化（multiplexing）するというコンセプトを表しています。

従来ターミナルとの根本的な違い

従来のターミナル（iTerm2、Hyper、Warpなど）は汎用的なシェル操作を前提に設計されています。一方、cmuxはAIコーディングエージェントが「何をしているか」をリアルタイムに可視化することを最優先にした設計です。

cmuxの価値は「ターミナルの再発明」ではなく「AIエージェント時代の開発ダッシュボード」にあります。エージェントがどのブランチで何を作業し、PRがどの状態にあり、どのポートでサーバーが動いているかを一画面で把握できることが、マルチエージェント開発の生産性を根本から変えます。

インストールと初期設定

cmuxのインストールはHomebrewで完結します。macOS専用のため、LinuxやWindowsでは利用できません。

Homebrewによるインストール

# Homebrewでインストール
brew install --cask cmux

# バージョン確認
cmux --version

GitHub（manaflow-ai/cmux）からdmgファイルを直接ダウンロードしてインストールすることも可能です。

初回起動と基本設定

cmuxを起動すると、デフォルトシェル（zsh/bash）が自動検出されます。既存のシェル設定（.zshrc、.bashrc）はそのまま引き継がれるため、エイリアスや環境変数の再設定は不要です。

# cmuxのターミナル内でClaude Codeを起動
claude

# 別のペインでCodexを起動
codex

# さらに別のペインでGemini CLIを起動
gemini

cmuxは特定のAIツールに依存していません。シェル上で動作するCLIツールであれば、Claude Code、Codex、OpenCode、Gemini CLI、Kiro、Aiderなど、どのツールでもそのまま使えます。

Socket APIの有効化

cmuxのSocket APIを有効にすると、外部スクリプトからエージェントの状態を取得したり、操作を自動化したりできます。

# Socket APIの有効化（設定画面から、またはCLIで）
cmux config set socket-api.enabled true

# APIエンドポイントの確認
cmux config get socket-api.path
# => /tmp/cmux.sock

垂直タブによるエージェント管理

cmuxの最大の特徴は、画面左側に配置された垂直タブです。従来のターミナルのように「Tab 1」「Tab 2」と無機質な名前が並ぶのではなく、各タブにリアルタイムの開発コンテキストが表示されます。

タブに表示される情報

各垂直タブには以下の情報がリアルタイムで表示されます。

• gitブランチ名: 現在チェックアウトしているブランチ
• リンクされたPR状態: Open / Draft / Review Requested / Merged などの状態
• 作業ディレクトリ: カレントディレクトリのパス
• リスニングポート: そのセッションで起動しているサーバーのポート番号

実務での活用パターン

マルチエージェント開発では、複数のClaude Codeインスタンスがそれぞれ異なるブランチで作業を進めることが一般的です。cmuxの垂直タブを使えば、どのエージェントがどのタスクを担当しているかを一目で把握できます。

[垂直タブの表示イメージ]

┌──────────────────────────┐
│ feature/auth-refactor    │ ← Claude Code (Agent 1)
│ PR #142 Review Requested │
│ ~/project  :3000         │
├──────────────────────────┤
│ fix/api-validation       │ ← Claude Code (Agent 2)
│ PR #145 Draft            │
│ ~/project  :3001         │
├──────────────────────────┤
│ feature/dashboard-ui     │ ← Codex (Agent 3)
│ No PR                    │
│ ~/project  :5173         │
└──────────────────────────┘

この構造により、従来はgit branchやGitHubのPRページを何度も確認していた作業が、視線を動かすだけで完了します。

分割ペインと組み込みブラウザ

分割ペインの操作

cmuxはtmuxに似た分割ペイン機能を備えています。1つのタブ内で画面を水平・垂直に分割し、エージェントの出力とログ、テスト結果を同時に確認できます。

# 垂直分割（左右に分割）
# Cmd + D

# 水平分割（上下に分割）
# Cmd + Shift + D

# ペイン間の移動
# Cmd + [ / Cmd + ]

組み込みブラウザの活用

cmuxには組み込みブラウザが統合されています。開発サーバーのプレビュー、PRのレビュー、ドキュメント参照など、ブラウザへのコンテキストスイッチなしで確認できます。

# 組み込みブラウザでlocalhostを表示
# Cmd + Shift + B で組み込みブラウザを開く
# リスニングポートが検出されると自動的にURLが補完される

組み込みブラウザの最大のメリットは、エージェントがサーバーを起動した瞬間にポートを検出し、ブラウザペインに自動反映される点です。「別ウインドウでChrome開いてlocalhost:3000にアクセスして...」という手順が不要になります。

Socket APIによる外部連携と自動化

cmuxのSocket APIは、エージェントの状態をプログラマティックに取得・操作するためのインターフェースです。UNIXドメインソケットで通信するため、ローカルマシン上のスクリプトやツールから直接アクセスできます。

基本的なAPIの使い方

# 全セッションの状態を取得
curl --unix-socket /tmp/cmux.sock http://localhost/sessions

# 特定セッションの詳細情報
curl --unix-socket /tmp/cmux.sock http://localhost/sessions/{session-id}

# 新しいセッション（タブ）の作成
curl --unix-socket /tmp/cmux.sock -X POST http://localhost/sessions \
  -d '{"command": "claude", "directory": "/path/to/project"}'

自動化スクリプトの例

Socket APIを使えば、プロジェクト開始時にエージェント環境を一括セットアップするスクリプトを作成できます。

#!/bin/bash
# cmux-project-setup.sh
# プロジェクトのマルチエージェント環境を一括起動

PROJECT_DIR="$1"
SOCKET="/tmp/cmux.sock"

# フロントエンド担当エージェント
curl --unix-socket $SOCKET -X POST http://localhost/sessions \
  -d "{\"command\": \"claude\", \"directory\": \"$PROJECT_DIR\", \"name\": \"frontend\"}"

# バックエンド担当エージェント
curl --unix-socket $SOCKET -X POST http://localhost/sessions \
  -d "{\"command\": \"claude\", \"directory\": \"$PROJECT_DIR\", \"name\": \"backend\"}"

# テスト担当エージェント
curl --unix-socket $SOCKET -X POST http://localhost/sessions \
  -d "{\"command\": \"claude\", \"directory\": \"$PROJECT_DIR\", \"name\": \"testing\"}"

echo "3 agents launched in cmux"

対応AIツールと連携方法

cmuxはシェルベースのCLIツールであればすべて動作します。特定のSDKやプラグインのインストールは不要で、通常通りコマンドを実行するだけです。

主要AIコーディングツールとの互換性

Claude Codeとの実務連携

Claude Codeはcmuxとの相性が特に良好です。Claude Codeのマルチエージェント構成（DD-10）でタスクを分散させる際、cmuxの垂直タブが各エージェントのステータスダッシュボードとして機能します。

# cmux上でClaude Codeのマルチエージェント構成を起動
# タブ1: メインオーケストレーター
claude "プロジェクト全体の設計を担当してください"

# タブ2: フロントエンド実装エージェント（別タブで起動）
claude "Reactコンポーネントの実装を担当してください"

# タブ3: テスト・品質管理エージェント（別タブで起動）
claude "テストコードの作成とレビューを担当してください"

各タブのブランチ名とPR状態を見れば、オーケストレーターがmainブランチで設計し、実装エージェントがfeatureブランチでコードを書き、テストエージェントがテストブランチでCIを回している状況がリアルタイムで確認できます。

マルチエージェント開発環境の設計指針

cmuxを導入する際に考慮すべき運用設計のポイントをまとめます。

ブランチ戦略とタブの対応関係

マルチエージェント開発では、エージェントごとにブランチを分離するのが基本です。cmuxの垂直タブはブランチ名を表示するため、「1タブ = 1ブランチ = 1エージェント = 1タスク」の対応を守ると可視性が最大化されます。

推奨構成:
  タブ1: main          → オーケストレーター（設計・レビュー）
  タブ2: feature/auth  → 実装エージェントA（認証機能）
  タブ3: feature/api   → 実装エージェントB（API層）
  タブ4: test/e2e      → テストエージェント（E2Eテスト）

リソース管理の注意点

複数のAIエージェントを同時に起動すると、CPU・メモリ・APIコストが増加します。Claude Codeのコスト最適化（BY-7）で解説している手法と組み合わせて、エージェント数を適切に管理してください。

• 同時起動は3〜5エージェント程度を目安にする
• 完了したタスクのエージェントはすぐに終了する
• コンテキスト圧縮（DD-2）を活用し、各エージェントのトークン消費を抑える

少数精鋭チームでの活用

StartLinkでは、少数精鋭のチームがAIエージェントを最大限に活用する開発スタイルを推奨しています。cmuxはこのアプローチと非常に相性が良いツールです。

1人の開発者が複数のAIエージェントを同時に管理し、それぞれに異なるタスクを割り当てる。cmuxの垂直タブで全体を俯瞰しながら、必要に応じてペインを切り替えてエージェントに指示を出す。この「1人 + N体のAIエージェント」というワークフローが、cmuxの最も自然な使い方です。

よくある質問（FAQ）

Q. cmuxはtmuxの派生ですか？

いいえ、cmuxとtmuxは完全に別のソフトウェアです。cmuxはSwift/AppKitで一から構築されたmacOSネイティブアプリケーションであり、tmuxのコードは一切使用していません。名前の「mux」はmultiplexing（多重化）の略で、複数のAIエージェントセッションを多重管理するというコンセプトを表しています。

Q. cmuxは無料で使えますか？

はい、cmuxは完全に無料のオープンソースソフトウェアです。GitHubリポジトリ（manaflow-ai/cmux）でソースコードが公開されています。Anthropic公式のツールではなく、サードパーティによる開発です。

Q. macOS以外で使えますか？

現時点ではmacOS専用です。Swift/AppKitで構築されているため、LinuxやWindowsには対応していません。Linux/Windowsでマルチエージェント管理を行う場合は、tmux + 独自スクリプトの組み合わせが代替手段になります。

Q. 既存のターミナル設定（.zshrcなど）は引き継がれますか？

はい、cmuxはシステムのデフォルトシェルを起動するため、既存の.zshrcや.bashrcの設定はそのまま引き継がれます。エイリアス、環境変数、PATHの設定を再定義する必要はありません。

Q. Claude Code以外のAIツールでも垂直タブの情報は表示されますか？

垂直タブのgitブランチ名・作業ディレクトリ・リスニングポートはシェルレベルで検出されるため、どのAIツールを使っていても表示されます。PR状態の表示はGitHub CLIとの連携で実現しているため、GitHubでホストされているリポジトリであれば、使用するAIツールに関係なく表示されます。

まとめ

cmuxはAIコーディングエージェント時代のターミナルとして、従来ツールにはない価値を提供します。

• 垂直タブ・組み込みブラウザ・Socket APIの3機能が、AIエージェントが何をしているかを把握するという新しい課題に直接応えている
• 「1人 + N体のAIエージェント」ワークフローでは、各エージェントのブランチ・PR状態・ポートを一画面で管理できるcmuxの価値は特に大きい
• Homebrewで即インストール可能で、Claude Codeとの統合から始めるスモールスタートが現実的なアプローチ
• オープンソースで活発に開発が進んでいるため、GitHub（manaflow-ai/cmux）をウォッチし最新機能を把握しておくことを推奨

少数精鋭チームで複数のAIエージェントを同時に走らせる開発スタイルを実現するために、まずはHomebrewでインストールしてClaude Codeとの組み合わせを試してみてください。