> ## 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.

# あなたのデバイス上で実行する

> クラウドの Agent に自分のコンピューターでセッションを実行させます。コンピューターの承認、デバイスを選んでのセッション開始、機密の場所へのアクセスの確認、実行ログの確認、切断とデバイス削除への対応について説明します。

**あなたのデバイス上での実行**とは、クラウドの Agent があなたのコンピューターの 1 台をリモートで操作することです。そのコンピューターのローカル環境とファイルを使ってファイルの読み書きやコマンドの実行を行い、ローカルで実行した場合と同じ結果になります。アプリではこのオプションを **Run on your device** と呼びます。

## あなたのデバイスかクラウドサーバーかを選ぶ

各セッションは開始時に実行方法を選択します。開始後に変更することはできません。

| | あなたのデバイス | クラウドサーバー |
| - | - | - |
| 操作が行われる場所 | 選択したコンピューター | あなたの[クラウドサーバー](https://docs.aihubmix.com/jp/cloud/environments/cloud-host.md) |
| 使用する環境とファイル | そのコンピューター上の環境とプロジェクトフォルダー | クラウドサーバー上のプロジェクトのコピーとプロジェクト環境 |
| 利用できるプロジェクト | そのコンピューター上のローカルプロジェクト、またはプロジェクト外のセッション | クラウドプロジェクト、またはプロジェクト外のセッション |
| 対応する Agent | 現在は Claude Code のみ | すべて |
| 要件 | コンピューターがオンラインで、**Allow execution** がオン | Plus サブスクリプション |
| コンピューターのシャットダウンまたはオフライン時 | 現在のタスクは一時停止し、再接続後に続行 | 影響なし |

ノート PC を閉じた後も実行を続ける必要があるタスクには、クラウドサーバーを選択してください。

## コンピューターでセッションを実行できるようにする

**1. そのコンピューターでデスクトップアプリにサインインする**

デスクトップアプリをインストールし、同じアカウントでサインインします。[ダウンロードとサインイン](https://docs.aihubmix.com/jp/cloud/getting-started/install-and-sign-in.md)を参照してください。サインインすると、そのコンピューターは自動的にワークスペースに追加されます。Web アプリではデバイスは追加されません。

**2. マシンの詳細を開く**

**Settings › Workspace › Machines** を開き、対象のコンピューターをクリックします。一覧には各マシンのオペレーティングシステム、クライアントのバージョン、オンライン状態が表示されます。

**3. Allow execution をオンにする**

**Allow execution**(コンピューターでは既定でオフ)をオンにし、確認ダイアログで緩和される内容を確認します。オンにすると、以降このコンピューターで実行されるすべてのセッションに適用されます。

**4. 必要に応じて承認内容を調整する**

アクセス範囲、機密の場所、権限の上限を設定します。保存すると、変更はすぐに新しいセッションに適用されます。

![マシン一覧](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/machines.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=7e1df978d48ba5be7f5a7a9edeb30f68)

Settings › Workspace › Machines

マシンの詳細では次の項目を調整できます。

* **Access scope**: プロジェクトフォルダーのみ、選択したフォルダー、またはコンピューター全体(既定)。
* **Sensitive locations**: SSH、キーチェーン、システム設定など。毎回確認する(既定)、アクセスをブロックする、アクセスを許可する、から選択します。
* **Permission limit**: セッションの権限はこの上限を超えられません。上限なし(既定)、自動で承認する、承認を求める、から選択します。
* **Allowed secrets**: このコンピューターで使用できるワークスペースのシークレット。既定ではすべてです。
* **Environment variable overrides**: このコンピューターで実行するときに上書きする環境変数。プレーンテキストのシークレットはここに入力しないでください。

承認内容を緩和するときは確認が求められます。厳しくするときは確認されません。**Allow execution** をオフにすると、このコンピューターを使用しているセッションは一時停止します。コマンドは、このコンピューター上のあなたのアカウントの権限で実行されます。

> [!NOTE]
>
> 実行の承認は、そのコンピューターのデスクトップアプリでのみ変更できます。他のデバイスや Web アプリでは表示のみが可能です。

## デバイスを選んでセッションを開始する

**1. 実行環境メニューを開く**

新しいセッションの入力ボックスの上で、プロジェクトの横にある実行環境ボタンをクリックします。

**2. デバイスを選ぶ**

**Run on your device** の下でコンピューターを選択します。各デバイスの下に、アクセス範囲と権限の上限が表示されます。

**3. タスクを送信する**

タスクを入力して送信します。セッションが開始されると、そのセッションはこのコンピューター上で実行され続けます。

* ローカルプロジェクトでは、プロジェクトがあるコンピューターが既定になります。それ以外はクラウドサーバーが既定です。
* デバイスがオフラインの場合、Allow execution がオフの場合、プロジェクトがそのデバイス上にない場合、現在の Agent が Claude Code でない場合は、そのデバイスを選択できません。メニューに理由が表示されます。
* デバイスを選択すると、その権限の上限を超える権限は選択できなくなります。
* 別のコンピューターやクラウドサーバーに切り替えるには、新しいセッションを開始します。

コンピューターで初めてセッションを実行するとき、Allow execution がまだオンになっていない場合や、そのコンピューターにプロジェクトに対応するフォルダーがない場合は、そのコンピューターのクライアントにメッセージが表示されます。**Open Machines & access** をクリックして Allow execution をオンにするか、**Allow** をクリックしてプロジェクトフォルダーを選択します(フォルダーはクラウドに同期されません)。プロジェクト外のセッションは、専用の一時フォルダーを使用します。

## 機密の場所へのアクセスを確認する

機密の場所が「毎回確認する」に設定されている場合、Agent が SSH 設定などの場所にアクセスする前に、実行中のデバイスのクライアントに理由とパスが表示されます。

* **Allow once**: 今回の 1 回だけ許可します。マシンの承認内容は変更されません。
* **Deny**: 許可しません。一定時間応答がない場合は拒否として扱われます。
* **Respond later**: メッセージを一時的に非表示にし、サイドバーでそのセッションに対応が必要であることが表示されます。

## 実行ログを確認する

実行環境メニューの下部で **Execution log** をクリックすると、このセッションの操作を確認できます。マシンの詳細で **View execution log** をクリックすると、このコンピューター上のすべてのセッションの操作を確認できます。ログの各行には、Agent が行ったこと、操作の対象、結果が表示されます。

実行中のデバイスのクライアントでは、プロセスの停止、切断、即時の再接続も行えます。それ以外の場所では表示のみです。

## コンピューターが切断された場合

コンピューターがシャットダウン、スリープ、オフラインになった場合や、クライアントを終了した場合、現在のタスクは一時停止します。接続が戻ると、停止した箇所から自動的に続行し、完了済みの操作は繰り返されません。**Reconnect** をクリックすることもできます。他のデバイスや Web アプリでは、そのセッションにデバイスがオフラインであることが表示されます。

デバイスがオフラインになっても、セッションが自動的にクラウドサーバーに移ることはありません。接続の問題については [FAQ とトラブルシューティング](https://docs.aihubmix.com/jp/cloud/reference/troubleshooting.md)を参照してください。

## デバイスを削除する

マシンの詳細の下部で **Remove device** をクリックし、確認します。

> [!WARNING]
>
> 削除するとデバイスはすぐに切断され、そのデバイスを使用しているセッションは中断されます。後でこのコンピューターを再び使用するには、そのコンピューターで再度サインインしてください。

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


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