> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 実行環境：あなたのデバイス上とクラウドサーバー

> セッションの 2 つの実行方法を説明します。あなたのデバイス上（インターフェースでは Run on your device と表示され、エージェントがあなたのコンピューターをリモートで操作します）とクラウドサーバーです。選び方、マシンと実行のアクセス権、機密の場所の確認、実行ログ、再接続、デバイスの削除を扱います。

各セッションは開始時に実行方法を選び、後から変更することはできません：

* **あなたのデバイス上**（インターフェースでは **Run on your device** と表示）：クラウド上のエージェントがあなたのコンピューターをリモートで操作します。ファイルの読み書きやコマンドの実行はあなたのコンピューター上で行われ、ローカルの環境とファイルを使うため、ローカルで実行した場合と同じ結果になります。デスクトップアプリにサインインしていて、実行を許可している任意のコンピューターを選べます。
* **クラウドサーバー**：セッションは最初から最後まであなたのクラウドサーバー（Plus に含まれる Linux クラウドサーバー）上で実行され、あなたのコンピューターを経由しません。ノートパソコンを閉じても、セッションは完了まで実行されます。

## 対応環境

| 形態 | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | サインインすると、このコンピューターが自動で選択可能なデバイスになります。実行のアクセス権の変更と機密の場所の確認は、このコンピューター自身のアプリでのみ行えます |
| Web アプリ | 一部対応 | 新しいセッションではクラウドサーバーまたは任意のデバイスを使えます。マシン一覧、実行のアクセス権、実行ログは読み取り専用です |
| モバイル Web | 一部対応 | Web アプリと同じです |

## 比較

| | あなたのデバイス上（Run on your device） | クラウドサーバー |
| - | - | - |
| 操作が実行される場所 | 選んだコンピューター | あなたのクラウドサーバー（Ubuntu 24.04） |
| 使われる環境とファイル | そのコンピューター上の環境とプロジェクトフォルダー | クラウドサーバー上のプロジェクトのコピーと [プロジェクト環境](https://docs.aihubmix.com/jp/cloud/projects/environment-setup.md) |
| 使えるプロジェクト | そのコンピューター上のローカルプロジェクトとプロジェクトのないセッション | クラウドプロジェクトとプロジェクトのないセッション |
| 対応エージェント | 現在は Claude Code のみ | すべて |
| 要件 | コンピューターがオンラインで、**Allow execution** がオン | Plus プラン |
| コンピューターのシャットダウンまたはオフライン | このターンは一時停止し、コンピューターが再接続すると自動で続行されます | 影響を受けません |

## 入口

* 新しいセッション：入力欄の上にある **Project** の横の実行環境ボタン。
* 既存のセッション：トップバーのタイトルの横にある実行環境のピル。
* **Settings › Workspace › Machines**、または実行環境メニューの下部にある **Execution log** と **Machines & access**。

## 新しいセッションの実行環境を選ぶ

実行環境ボタンをクリックすると、**Run environment** メニューが開きます。上部に **Cloud server** があり、その下の **Run on your device** グループに各デバイスが一覧表示されます（現在のコンピューターには **This device** タグが付き、2 行目にアクセス範囲と権限の上限が表示されます）。下部には **Execution log** と **Machines & access** があります。

### デフォルトの選択

* ローカルプロジェクトでは、プロジェクトがあるコンピューターがデフォルトです。その他のプロジェクトとプロジェクトのないセッションでは、クラウドサーバーがデフォルトです。
* 手動での選択はこの新しいセッションにのみ適用されます。選択したデバイスが使えなくなった場合、選択はクラウドサーバーに戻ります。

### オプションを選べない場合

| 理由 | メニューのテキスト |
| - | - |
| デバイスがオフライン | **Device offline**（ローカルプロジェクトがあるコンピューターがオフラインの場合も選択はでき、**Device offline** と表示されます） |
| デバイスで **Allow execution** がオンになっていない | **Not allowed to run** |
| デバイスがワークスペースから削除された | **Device removed. Choose another environment** |
| 現在のプロジェクトがこのデバイス上にない | **This project isn’t on this device** |
| 現在のエージェントが Claude Code ではない | **Running on a device supports only Claude Code for now** |
| ローカルプロジェクトでクラウドサーバーを選択した | **This project is only on this computer. Choose the device it’s on** |

### デバイスの権限の上限

各デバイスには **Permission limit** を設定できます。そのデバイスを選ぶと、セッションの権限メニューで上限を超えるレベルがグレー表示になります（**Above this device’s permission limit**）。選択中の権限が上限を超えている場合は、自動で上限まで下げられます。権限レベルについては、[入力欄](https://docs.aihubmix.com/jp/cloud/sessions/composer.md) を参照してください。

## 既存のセッションの実行環境

トップバーのセッションタイトルの横にあるピルには、**Cloud server** または実行デバイスの名前が表示されます。デバイスがオフラインの場合は **Device offline** と表示されます。

* 実行マシンはセッションの作成時に選ばれ、後から変更できません。別のマシンを使うには、新しいセッションを作成してください。
* メニュー下部の **Execution log** と **Machines & access** は、実行デバイスのログと詳細を開きます。

## デバイスとマシン一覧

**デバイス**とは、デスクトップアプリにサインインしているコンピューターです。サインインすると自動でワークスペースに登録され、マシン一覧と実行環境メニューに表示されます。Web アプリはデバイスを登録しません。

**Settings › Workspace › Machines** には、ワークスペース内のすべてのマシンが一覧表示されます（クラウドサーバーが先頭）。各行には、名前、OS とアプリのバージョン、状態 **Online**、**Offline**、**Stopped (retained)**、**Removed** のいずれかが表示されます。アプリの再インストール後に残った同じ名前のオフラインの記録は 1 行にまとめられます。使わなくなった場合は、開いて削除してください。

行をクリックするとマシンの詳細が開きます。

## マシンの詳細と実行のアクセス権

コンピューターとサーバーは、名前の横の鉛筆ボタンで名前を変更できます（最大 64 文字）。

| グループ | 設定 | 値（デフォルト） | 詳細 |
| - | - | - | - |
| 実行のアクセス権 | 実行を許可 | オン / オフ（コンピューターではデフォルトでオフ） | オンの場合にのみ、クラウドのエージェントがこのマシン上で実行できます |
| 実行のアクセス権 | アクセス範囲 | **Project folder only**、**Selected folders**、**Entire computer**（デフォルト：コンピューター全体） | **Selected folders** の場合、許可するフォルダーを追加します |
| 実行のアクセス権 | 機密の場所 | **Ask each time**（デフォルト）、**Block access**、**Allow access** | SSH、キーチェーン、システム設定など |
| タスクの権限 | 権限の上限 | **No limit**（デフォルト）、**Approve for me**、**Ask for approval** | セッションの権限はこの上限を超えられません |
| タスクの権限 | 送信できるシークレット | **All workspace secrets**（デフォルト）、**Selected secrets only** | このマシンで使えるワークスペースシークレットを選びます |
| 環境変数の上書き | 変数一覧 | なし | このマシンで実行するときに上書きされる環境変数です。シークレットを平文で入力せず、`${VAR}` 参照を使ってください |
| 実行ログ | **View execution log** | なし | 下記を参照してください |
| プラグインと Skills | **Manage this device’s plugins** | なし | [プラグイン、MCP、Skills](https://docs.aihubmix.com/jp/cloud/integrations/plugins-mcp-skills.md) を参照してください |
| デバイスの管理 | **Remove device** | なし | 下記を参照してください |

* 保存した変更は、新しいセッションにすぐ適用されます。
* クラウドサーバーの詳細には、**Allow execution**（読み取り専用）、実行ログ、プラグインの入口のみが表示されます。名前の変更や削除はできません。

### システムの確認

デスクトップアプリでこのコンピューターの実行のアクセス権を広げるとき（**Allow execution** をオンにする、アクセス範囲を広げる、機密の場所を開放する、権限の上限を上げるなど）、確認ダイアログに広げる内容が一覧表示されます。**Allow execution** をオンにすると、このコンピューター上で実行される今後のすべてのセッションに適用されます。アクセスを狭める変更では確認は不要です。**Allow execution** をオフにすると、このデバイスを使っているセッションは一時停止します。

### 変更できる人

実行のアクセス権を変更できるのは、**このコンピューター自身のデスクトップアプリ**のみです。別のデバイスまたは Web アプリで閲覧すると読み取り専用で、**Execution access can only be changed on this device.** と表示されます。クラウドサーバーの設定も読み取り専用です。

## このコンピューターでの初回実行

セッションがこのコンピューター上で実行されるよう設定されているものの、このコンピューターがまだ要件を満たしていない場合、このコンピューターのアプリでセッションを開くと案内が表示されます：

* **Allow execution がまだオンになっていない**：**Open Machines & access** をクリックし、**Allow execution** をオンにしてから戻ります。コマンドはあなたのアカウントの権限で実行されます。
* **このコンピューター上にプロジェクトのフォルダーがまだない**：**Allow** をクリックしてこのコンピューター上のプロジェクトのフォルダーを選ぶと、このプロジェクトについて再度確認されることはありません。**Don’t allow** をクリックすると、このプロジェクトはこのコンピューター上で実行されません。フォルダーはクラウドに同期されません。

プロジェクトのないセッションは、セッション専用の一時フォルダーを使います。該当する場合、ダイアログに `~/.claude/CLAUDE.md` もエージェントに送信されることが注記されます。

## 機密の場所の確認

デバイスの **Sensitive locations** の設定が **Ask each time** で、エージェントが SSH の設定などの場所にアクセスする必要がある場合、実行デバイスのアプリに、理由とアクセス先のパスを示す **Access request** カードが表示されます：

* **Allow once**：今回のみアクセスを許可します。マシンのアクセス権は変更されません。
* **Deny**：アクセスは許可されません。
* 一定時間内に応答しない場合は拒否として扱われます。
* **Later** をクリックすると折りたためます。サイドバーのセッションには **Needs your input** と表示されます。

## 実行ログ

実行環境メニューの **Execution log**（このセッション）またはマシン詳細の **View log**（このマシン上のすべてのセッション）から開きます。エージェントがこのマシン上で行った操作が、対象と結果とともに 1 行ずつ一覧表示されます。

実行デバイス自身のアプリでは、**Stop processes**（進行中の操作とバックグラウンドプロセスを終了）、**Disconnect**、**Reconnect** も使えます。Web アプリや別のデバイスでは、ログの確認のみ行えます。

## 切断と再接続

セッションがコンピューター上で実行されていて、そのコンピューターが切断された場合（シャットダウン、スリープ、オフライン、アプリの終了など）：

* ターンは一時停止し、実行デバイスのアプリのセッション末尾に **This computer disconnected. This turn is paused.** と切断の理由が表示されます。
* 接続が復旧すると、中断したところから自動で続行され、完了済みの操作は再実行されません。**Reconnect** をクリックすることもできます。理由が実行を許可していないことやプロジェクトのフォルダーが紐付けられていないことである場合は、解決方法が案内されます。
* 他のデバイスと Web アプリでは、セッションのピルに **Device offline** と表示されます。

デバイスがオフラインになっても、セッションが自動でクラウドサーバーに切り替わることはありません。

## デバイスを削除する

マシン詳細の下部で **Remove device** をクリックして確認します。デバイスはすぐに切断され、それを使っているセッションは中断されます。後で再び使うには、そのデバイスで再度サインインしてください。

* クラウドサーバーは削除できません。
* 現在のコンピューターはここでは削除できません。削除するにはサインアウトしてください。

## クラウドサーバーモード

**Cloud server** を選ぶと、セッションはすべてあなたのクラウドサーバー上で実行され、プロジェクトはクラウドサーバー上のコピーと [プロジェクト環境](https://docs.aihubmix.com/jp/cloud/projects/environment-setup.md) を使います。クラウドサーバーには Plus が必要です。Plus がない場合、メニューの **Cloud server** には **Available with Plus** と表示されます。クラウドサーバーの入手、状態、リモートデスクトップについては、[クラウドサーバー](https://docs.aihubmix.com/jp/cloud/cloud-host/overview.md) を参照してください。

## よくある質問

### **Run on your device** を使う場合、コンピューターの電源を入れたままにする必要がありますか？

必要です。コンピューターが切断されるとターンは一時停止し、再接続後に自動で続行されます。ノートパソコンを閉じた後もセッションを実行し続ける必要がある場合は、クラウドサーバーを選んでください。

### 既存のセッションをコンピューターからクラウドサーバーに移せますか？

移せません。実行マシンはセッションの作成時に決まります。変更するには、新しいセッションを作成してください。

### Web アプリでコンピューターのアクセス権を変更できないのはなぜですか？

実行のアクセス権は、そのコンピューター自身のデスクトップアプリでのみ変更できます。

### 新しいデバイスを追加するには？

そのコンピューターにデスクトップアプリをインストールし、同じアカウントでサインインします。マシン一覧に自動で表示されます。その後、そのコンピューターのアプリで **Allow execution** をオンにしてください。

## 関連

* [プロジェクト](https://docs.aihubmix.com/jp/cloud/projects/projects.md)
* [プロジェクト環境](https://docs.aihubmix.com/jp/cloud/projects/environment-setup.md)
* [ワークスペース設定](https://docs.aihubmix.com/jp/cloud/settings/workspace.md)
* [新しいセッション](https://docs.aihubmix.com/jp/cloud/sessions/new-session.md)
* [入力欄](https://docs.aihubmix.com/jp/cloud/sessions/composer.md)
* [プラグイン、MCP、Skills](https://docs.aihubmix.com/jp/cloud/integrations/plugins-mcp-skills.md)
* [クラウドサーバー](https://docs.aihubmix.com/jp/cloud/cloud-host/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.