はじめに

エージェントを実行するマシンに ccmux をインストールします。セットアップ後、プロジェクトを作成し、その最初のセッションにアタッチします。

要件

• macOS、Linux、または Windows 経由 WSL2 ( Windows ガイド （GitHub）。ネイティブ Windows 対応は未完了の TODO として管理されています）
• ソース元パスの Homebrew (macOS / Linuxbrew)、curl + POSIX シェル、または Go 1.26+ のいずれか
• tmux および git。 Homebrew はランタイムの依存関係をインストールします。ダウンロード スクリプトは、ccmux バイナリのみをインストールします。走る ccmux setup 依存関係を確認するか、次を使用します。 make bootstrap ソースからビルドする場合。

インストール

ダウンロード スクリプトまたは Homebrew を選択します。 ccmux 自体を開発したい場合は、ソース ビルドを使用します。

ダウンロードスクリプト

curl -fsSL https://ccmux.ai/install | sh
ccmux setup

スクリプトは最新リリースのバイナリを次の場所にインストールします。 ~/.local/bin/。インストーラーからプロンプトが表示されたら、そのディレクトリをシェルの PATH に追加します。できます インストール スクリプトを検査します を実行する前に。

セットアップ ウィザードは依存関係をチェックし、エージェント CLI の設定を支援し、バックグラウンド デーモンをインストールします。セッションを開始する前に、選択したエージェントにサインインします。リモート アクセスの場合は、デバイスを Tailscale にも接続します。

Homebrew

brew trust --tap skzv/tap
brew install skzv/tap/ccmux
ccmux setup

マシンごとに 1 回タップを信頼します。 Homebrew は、ccmux とそのパッケージ化された依存関係 (tmux、Mosh、ripgrep など) をインストールします。

代替案: ソースから

mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/skzv/ccmux.git
cd ccmux && make bootstrap

make bootstrap ビルド チェーンをチェックし、不足しているものをインストールするよう提案し、チェーンします。 make setup。追跡したい場合はこれを使用してください main または ccmux 自体をハッキングします。

後でセットアップ ウィザードを再実行して、構成を確認できます。

最初の実行

ccmux

TUI は初回ツアーで発売されます。プレス ? は、フル キーマップのどの画面でも発生します。

キーバインディング

最初のプロジェクト

TUI: を押します 2 プロジェクトの場合、 n 新しいプロジェクト フォームを開きます。名前を入力し、エージェント (Claude / Codex / Antigravity / Cursor / pi / Grok) を選択して、押します。 Enter。 ccmux は以下にディレクトリを作成します projects.root エージェント セッションをただちに開始します。

シェルから:

ccmux new my-app

ディレクトリを作成し、デフォルトのエージェントでセッションを起動します。 TUI はホーム画面で自動的に開きます。 Enter.

見る チュートリアル 1 完全なウォークスルーについては。

次のステップ

• 複数のセッションを管理する エージェントを停止せずに切断します。
• 携帯電話から接続します または 別のマシンを追加します.
• MCP クライアントを接続します エージェントからのセッションを検査します。
• セットアップが失敗した場合は、実行してください ccmux doctor に従ってください。 メンテナンスガイド.

エラーまたは古いものを見つけましたか? GitHub でこのページを編集します.