- あなたのデバイス上(インターフェースでは Run on your device と表示):クラウド上のエージェントがあなたのコンピューターをリモートで操作します。ファイルの読み書きやコマンドの実行はあなたのコンピューター上で行われ、ローカルの環境とファイルを使うため、ローカルで実行した場合と同じ結果になります。デスクトップアプリにサインインしていて、実行を許可している任意のコンピューターを選べます。
- クラウドサーバー:セッションは最初から最後まであなたのクラウドサーバー(Plus に含まれる Linux クラウドサーバー)上で実行され、あなたのコンピューターを経由しません。ノートパソコンを閉じても、セッションは完了まで実行されます。
対応環境
比較
入口
- 新しいセッション:入力欄の上にある Project の横の実行環境ボタン。
- 既存のセッション:トップバーのタイトルの横にある実行環境のピル。
- Settings › Workspace › Machines、または実行環境メニューの下部にある Execution log と Machines & access。
新しいセッションの実行環境を選ぶ
実行環境ボタンをクリックすると、Run environment メニューが開きます。上部に Cloud server があり、その下の Run on your device グループに各デバイスが一覧表示されます(現在のコンピューターには This device タグが付き、2 行目にアクセス範囲と権限の上限が表示されます)。下部には Execution log と Machines & access があります。デフォルトの選択
- ローカルプロジェクトでは、プロジェクトがあるコンピューターがデフォルトです。その他のプロジェクトとプロジェクトのないセッションでは、クラウドサーバーがデフォルトです。
- 手動での選択はこの新しいセッションにのみ適用されます。選択したデバイスが使えなくなった場合、選択はクラウドサーバーに戻ります。
オプションを選べない場合
デバイスの権限の上限
各デバイスには Permission limit を設定できます。そのデバイスを選ぶと、セッションの権限メニューで上限を超えるレベルがグレー表示になります(Above this device’s permission limit)。選択中の権限が上限を超えている場合は、自動で上限まで下げられます。権限レベルについては、入力欄 を参照してください。既存のセッションの実行環境
トップバーのセッションタイトルの横にあるピルには、Cloud server または実行デバイスの名前が表示されます。デバイスがオフラインの場合は Device offline と表示されます。- 実行マシンはセッションの作成時に選ばれ、後から変更できません。別のマシンを使うには、新しいセッションを作成してください。
- メニュー下部の Execution log と Machines & access は、実行デバイスのログと詳細を開きます。
デバイスとマシン一覧
デバイスとは、デスクトップアプリにサインインしているコンピューターです。サインインすると自動でワークスペースに登録され、マシン一覧と実行環境メニューに表示されます。Web アプリはデバイスを登録しません。 Settings › Workspace › Machines には、ワークスペース内のすべてのマシンが一覧表示されます(クラウドサーバーが先頭)。各行には、名前、OS とアプリのバージョン、状態 Online、Offline、Stopped (retained)、Removed のいずれかが表示されます。アプリの再インストール後に残った同じ名前のオフラインの記録は 1 行にまとめられます。使わなくなった場合は、開いて削除してください。 行をクリックするとマシンの詳細が開きます。マシンの詳細と実行のアクセス権
コンピューターとサーバーは、名前の横の鉛筆ボタンで名前を変更できます(最大 64 文字)。- 保存した変更は、新しいセッションにすぐ適用されます。
- クラウドサーバーの詳細には、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 をクリックして確認します。デバイスはすぐに切断され、それを使っているセッションは中断されます。後で再び使うには、そのデバイスで再度サインインしてください。- クラウドサーバーは削除できません。
- 現在のコンピューターはここでは削除できません。削除するにはサインアウトしてください。