メインコンテンツへスキップ
各セッションは開始時に実行方法を選び、後から変更することはできません:
  • あなたのデバイス上(インターフェースでは 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 をクリックして確認します。デバイスはすぐに切断され、それを使っているセッションは中断されます。後で再び使うには、そのデバイスで再度サインインしてください。
  • クラウドサーバーは削除できません。
  • 現在のコンピューターはここでは削除できません。削除するにはサインアウトしてください。

クラウドサーバーモード

Cloud server を選ぶと、セッションはすべてあなたのクラウドサーバー上で実行され、プロジェクトはクラウドサーバー上のコピーと プロジェクト環境 を使います。クラウドサーバーには Plus が必要です。Plus がない場合、メニューの Cloud server には Available with Plus と表示されます。クラウドサーバーの入手、状態、リモートデスクトップについては、クラウドサーバー を参照してください。

よくある質問

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

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

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

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

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

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

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

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

関連