# iOSアプリ

cmux iOSアプリはMacのコンパニオンです。cmuxを実行しているMacとiPhoneまたはiPadをペアリングし、スマートフォンからターミナルにアタッチできます。ターミナル通知の転送もオプションで利用できます。

[iPhone・iPad で cmux を設定する](https://cmux.com/ja/docs/ios#setup)

iOSアプリはベータ版です。TestFlightで「cmux BETA」として提供されています。

## 入手方法

アプリはTestFlightで配布されています。早期アクセスは[cmux Founder's Edition](https://github.com/manaflow-ai/cmux#founders-edition)に含まれ、他の早期機能も利用できます。

## iPhone・iPad で cmux を設定する

iOS 版 cmux は Mac で動作する cmux に接続します。シェルとエージェントは Mac で実行を続け、スマートフォンやタブレットからワークスペースを表示・操作できます。

### 始める前に

-   Mac に最新版の cmux をインストールし、ワークスペースを 1 つ以上開いた状態で起動しておきます。iOS 側で新しい Mac 版が必要と表示されたら、接続先の cmux アプリを更新してください。
-   iPhone または iPad に cmux をインストールします。ベータ版の場合は TestFlight の招待を受け入れ、TestFlight から cmux BETA をインストールします。
-   両方の端末をインターネットに接続し、同じ cmux アカウントを使います。チームを利用している場合は、両方で同じチームを選択します。

[Mac 版 cmux をダウンロード](https://cmux.com/ja) · [iOS 版 cmux を入手](https://cmux.com/ja/ios)

### 1\. Mac でペアリングを有効にする

1.  Mac で cmux を開き、cmux アカウントにログインします。
2.  cmux の設定で「モバイル」を選び、「iOS ペアリングを有効にする」をオンにします。スマートフォンから使いたい Mac 上の各 cmux アプリで設定してください。
3.  cmux を起動したまま、Mac をスリープさせずに保ちます。Mac がスリープ、シャットダウン、または切断されると、スマートフォンからターミナルに接続できません。

ペアリングは初期状態ではオフです。オフの間、その Mac は iOS に表示されません。ログインするだけではペアリングは有効になりません。

### 2\. iOS からログインして接続する

1.  iPhone または iPad で cmux を開き、Mac と同じ cmux アカウントでログインします。複数のアカウントを持っている場合は、両方のメールアドレスを確認してください。
2.  アプリの案内に従います。「通知を有効にする」を選ぶか、「後で」を選んで後から設定します。ペアリングのページで、Mac の iOS ペアリングを有効にしたことを確認します。
3.  「自動接続」を選び、「自分の Mac を確認」をタップします。同じアカウントにログインしている対応 Mac が検出されます。自動接続に Tailscale のインストールは不要です。
4.  Mac が接続されたら「ワークスペースを開く」をタップします。ワークスペースとターミナルを選ぶと、出力の表示や入力ができます。上部の「すべてのコンピュータ」で接続先を切り替えられます。

iOS から求められた場合は、ローカルネットワークへのアクセスを許可してください。以前拒否した場合は、iPhone・iPad の設定アプリで cmux を開き、ローカルネットワークを有効にしてから cmux に戻り、再試行します。

### 任意: Tailscale のみで接続する

1.  Mac と iPhone・iPad に Tailscale をインストールし、同じ Tailscale ネットワークにログインします。両方で Tailscale が接続されていることを確認します。
2.  cmux の設定 > モバイルで iOS ペアリングを有効にしておきます。iOS の接続方法で「Tailscale のみ」を選び、「ペアリングコードをスキャン」を選択します。
3.  Mac の cmux で Mobile Connect を開き、スマートフォンでペアリングコードを読み取ります。求められたらカメラへのアクセスを許可し、画面の案内に従います。
4.  このモードでは、Wi-Fi からモバイル通信に切り替える場合も含め、両方の端末で Tailscale を接続したままにします。Tailscale のアクセスルールで、スマートフォンから Mac への接続を許可する必要があります。

### 3\. エージェント通知を有効にする

1.  アプリの案内で「通知を有効にする」をタップし、iOS の確認画面で許可します。スキップまたは拒否した場合は、iOS の設定 > 通知 > cmux で「通知を許可」を有効にします。
2.  両方の端末で cmux の通知設定を確認し、転送設定が表示される場合は有効にします。新しいエージェント通知を送信できるよう、Mac を起動・接続したままにします。
3.  設定済みのコーディングエージェントがあるワークスペースで通知を発生させます。cmux の通知タブとスマートフォンへの配信を確認します。集中モードや通知の要約により、通知が遅延または消音される場合があります。

[ターミナルとエージェントの通知を設定する](https://cmux.com/ja/docs/notifications)

### 4\. 接続を確認する

1.  スマートフォンからターミナルを開き、pwd などの安全なコマンドを実行します。スマートフォンと Mac の同じワークスペースに出力が表示されることを確認します。
2.  別のワークスペースに切り替えてから戻ります。外出先で使う予定なら、Mac から離れる前にモバイル通信でも試してください。
3.  リモートアクセスには Mac を電源に接続し、スリープさせずに保ちます。設定中にスリープ防止の選択肢が表示された場合は、Mac を接続可能にしておくために利用できます。

### ワークスペースが表示されない場合

設定を修正したらワークスペースに戻り、「再試行」をタップします。保存済みの Mac への再接続、またはワークスペース一覧とアカウントに保存された接続情報の更新を行います。

### Mac が見つからない

接続したい Mac アプリの設定 > モバイルで iOS ペアリングが有効か確認します。両方で同じ cmux アカウントとチームを選び、Mac アプリを起動したままにしてください。「コンピュータ」ボタンで利用可能な Mac を確認し、非表示にしていないか調べます。

### 新しい Mac アプリを求められる

Mac の cmux を更新し、そのアプリを終了して開き直します。複数の cmux バージョンを使っている場合は、更新したものをスマートフォンで選択してください。iOS アプリに表示された最低バージョンに従います。

### Mac は表示されるが接続できない

Mac をスリープから復帰させ、両方のインターネット接続を確認します。求められた場合は iOS のローカルネットワークアクセスを許可します。「Tailscale のみ」では、両方が同じネットワークに接続し、アクセスルールが通信を許可していることを確認してから再試行します。

### 接続できるのに一覧が空

Mac の cmux でワークスペースを作成するか開きます。スマートフォンで「すべてのコンピュータ」を選び、検索やフィルターを解除します。一覧を下に引いて更新するか、空の画面で「再試行」をタップします。

### 解決しない場合

Mac と iOS の cmux バージョン、接続方法、正確なエラー、コンピュータ一覧に Mac が表示されるかをお知らせください。パスワードやペアリングコードは含めないでください。

[cmux サポートに問い合わせる](https://cmux.com/ja/support)

## 前提条件

始める前に、次のものが必要です：

-   cmuxを実行し、サインイン済みのMac。
-   TestFlightからcmux BETAアプリをインストールしたiPhoneまたはiPad。
-   スマートフォンからMacへのネットワーク経路（下記の「持ち込みネットワーク」を参照）。

## 持ち込みネットワーク

cmuxはネットワーク機能を標準では提供しません。ターミナルのストリームはスマートフォンとMacの間を直接流れるため、スマートフォンがネットワーク上でMacに到達できる必要があります。最も簡単なのはプライベートなオーバーレイネットワークです。

### Tailscale（推奨）

Macとスマートフォンの両方に[Tailscale](https://tailscale.com)をインストールし、同じtailnetにサインインします。これでスマートフォンはどこからでも、ポート転送なしでMacのtailnetアドレスに到達できます。

### WireGuard

すでに[WireGuard](https://www.wireguard.com)を運用している場合は、Macとスマートフォンを同じネットワークに置き、MacのWireGuardアドレスを使用します。

どちらを選んでも、接続はあなた自身のものです。cmuxはデバイス間のターミナルトラフィックをプロキシしたり中継したりしません。

## ペアリングと接続

1.  Macで、cmuxのMobile Connectウィンドウを開きます。
2.  スマートフォンでcmux BETAアプリを開き、Mobile Connectに表示されるペアリングを確認します。
3.  ペアリングが完了すると、ワークスペースとターミナルがネットワーク経由でスマートフォンに表示されます。

ペアリングはデバイスごとです。新しいデバイスやアプリの再インストール時は再度ペアリングします。

## 通知

ターミナル通知をスマートフォンに転送するようにオプトインできます。注意が必要なペインがデバイスにプッシュされます。転送が有効な場合、通知のテキスト（ターミナル出力から取得したタイトルと本文）は、配信のためcmuxサーバーを経由してAppleのプッシュサービスに送信されます。通知設定で「コンテンツを隠す」を有効にすると、代わりに汎用的なメッセージが送信され、ターミナルのテキストはデバイスにとどまります。cmuxがどのように通知を発生させるかは[通知](https://cmux.com/ja/docs/notifications)をご覧ください。

## 保存されるデータ

cmuxは、ターミナルがあなたのデバイス間にとどまるように設計されています。cmuxサーバーには、サインインとデバイス接続に必要なものだけを保存します：

-   サインインで取得するアカウント（メールアドレス）。デバイス間であなたを識別するため。
-   デバイスのプッシュトークン。転送されたターミナル通知を配信するため。
-   ペアリングとデバイスのメタデータ。スマートフォンとMacを接続するため。

インタラクティブなターミナルセッション（その内容とキー入力）は、あなた自身のネットワークを通じてスマートフォンとMacの間を直接流れ、cmuxサーバーを経由したり保存されたりすることはありません。唯一の例外は転送される通知テキストで、これはスマートフォンに届くためにcmuxとAppleのプッシュサービスを経由します（「コンテンツを隠す」を有効にしている場合を除く。上記の「通知」を参照）。

## エンタープライズとセルフホスト

セルフホストまたはエアギャップ環境での導入については、[founders@cmux.com](mailto:founders@cmux.com?subject=cmux%20enterprise)までご連絡ください。

Canonical: https://cmux.com/ja/docs/ios

Documentation index: https://cmux.com/llms.txt