> ## Documentation Index > Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt > Use this file to discover all available pages before exploring further. # Devin クラウドセッション向けの Local Hands > Devin Desktop または devin connect を介して、Devin クラウドセッションがあなたのコンピューター上でコマンドを実行したりファイルを編集したりできるようにします。各ツール呼び出しにはあなたの承認が必要です。 Local Hands (ローカルマシンアクセス) を利用すると、Devin クラウドセッションからあなたのコンピューター上でコマンドを実行したり、ファイルを操作したりできます。未コミットの変更を含むローカルのチェックアウト、ネットワーク内のデバイス、VPN 接続が必要なツール、ローカル build のログなど、あなたのマシン上にしか存在しないものがタスクに必要な場合に利用してください。 あなたのコンピューターがセッションの VM の代わりになるわけではありません。Devin は自身の VM をそのまま使い続け、それに加えてあなたのマシン上で動作するもう 1 組のツールを利用します。2 台のマシンはファイル、作業ディレクトリ、環境がそれぞれ独立しています。Devin がマシン間でデータをやり取りするのは、ファイルコピーなど、あなたが承認したツール呼び出しを介する場合に限られます。 > [!NOTE] > > Local Hands は段階的に提供中です。**Local Hands** 設定が表示されない場合、ご利用の組織ではこの機能をまだ利用できません。 > [!NOTE] > > **Local Hands** は機能名で、アクセスカードやトースト通知では **local machine access** と表記されます。セッションヘッダーでは、接続済みのマシンが **Local Hands** として表示されます。なお、Local Hands は、Devin にプライベートネットワークへのアクセスを提供する [Devin Connect](/ja/enterprise/deployment/devin-connect) とは別の機能です。 ## 仕組み **1. Devin がアクセスをリクエストする** タスクにあなたのマシンが必要になると、Devin はセッション内に **Local machine access requested** カードを投稿します。カードには、リクエストの理由と有効期限が表示されます。Devin Desktop では **Approve** ボタンが、ブラウザでは ペアリングコード付きの `devin connect` コマンドが表示されます。「ローカルマシンでテストを実行して」のように、直接依頼することもできます。 **2. マシンを接続する** Devin に利用させたいマシン上でリクエストを承認します。Devin Desktop で **Approve** をクリックするか、ターミナルで `devin connect` を実行してください。詳しくは[マシンを接続する](#connect-your-machine)を参照してください。 **3. Devin がローカルツールを利用する** Devin のローカルツールが利用可能になり、ヘッダーに **Local Hands** チップが表示されます。[バイパス](#bypass-local-permissions)を有効にしない限り、ツール呼び出しはすべてあなたが個別に承認します。 **4. 接続が終了する** アクセスを失効させた場合、`devin connect` を停止した場合、リクエストを承認した Devin Desktop のウィンドウを閉じた場合、またはセッションが終了した場合に、接続は終了します。それに伴い、ローカルツールも利用できなくなります。 ## 要件 * 自分が所有するクラウドセッションであること。Devin はペアリングコードをセッション所有者のアカウントに発行するため、セッションを閲覧している他のユーザーが自分のマシンを接続することはできません。スケジュールされたセッション、自動化、サービスユーザーが実行する API セッションなど、アクセスを承認するユーザーがいないセッションでは、マシンをリクエストできません。 * 接続するマシンに [Devin CLI](/ja/cli) または [Devin Desktop](/ja/desktop/introducing-devin-desktop) がインストールされており、セッションを所有しているのと同じ Devinアカウントでサインインしていること。CLI の場合は `devin auth login` を実行してください。 * 組織で **Local Hands** 設定が有効になっていること。詳しくは[利用可能状況](#availability)を参照してください。 ## マシンを接続する 最も簡単なのは Devin Desktop を利用する方法です。Devin Desktop でセッションを開き、**Approve** をクリックします。ブラウザから作業している場合は、接続したいマシンのターミナルで、カードに表示されている `devin connect` コマンドを実行します。 リクエストは使い捨てで、Devin が作成してから 10 分で期限切れになります。新しいリクエストが作成されると古いリクエストは置き換えられ、以前のペアリングコードは使用できなくなります。 **Devin Desktop** Devin Desktop でセッションを開くと、カードに **Approve** と **Decline** が表示されます。**Approve** をクリックすると、Devin Desktop が動作しているマシンが接続されます。ペアリングコードやターミナルは不要です。CLI を利用したい場合は、**Use the terminal instead** をクリックするとコマンドが表示されます。 **ターミナル** カードからコマンドをコピーし、接続したいマシンで実行します。 ```bash theme={null} devin connect ``` コマンドを実行した時点で承認となり、改めて確認を求められることはありません。コマンドはフォアグラウンドで動作し続け、Devin が行う各ツール呼び出しを出力しながら、セッションが終了するか `Ctrl+C` を押すまで接続を維持します。 **devin --cloud** [`devin --cloud`](/ja/cli/cloud) で開いたクラウドセッションでは、Devin がアクセスをリクエストすると、そのターミナルのマシンが自動的に接続されます。ただし、各ツール呼び出しには引き続きあなたの承認が必要です。 リクエストの期限が切れた場合は、Devin Desktop のカードで **Connect this machine** をクリックするか、ブラウザで **Request a new code** をクリックしてください。 ### セッションのプライバシー 自分が所有するセッションにマシンを接続すると、Devin はそのセッションを非公開にし、あなただけがメッセージを送信できるようにします。これにより、組織内の他のユーザーが、あなたのコンピューター上でコマンドを実行できるセッションを操作することを防ぎます。 セッションのプライバシー設定を変更せずにそのままにするには、`--public` を指定します。 ```bash theme={null} devin connect --public ``` ## あなたのマシン上で Devin ができること Devin は、シェルコマンドの実行、ファイルの読み取りと検索、ファイルの作成と編集、およびあなたのマシンとセッションの VM との間でのファイルのコピーを行えます。Devin があなたのマシンの画面、キーボード、マウスを操作することはありません。[Computer use](/ja/work-with-devin/computer-use) が適用されるのはセッションの VM のみです。 ## 承認 デフォルトでは、ローカルのツール呼び出しはすべて一時停止し、あなたに確認を求めます。セッションにはツールとその引数が表示され、次の3つから選択できます。 * **Allow once**: この呼び出しを実行します。 * **Allow for this session**: この呼び出しに加え、同じツールに対する以降の呼び出しも、マシンが切断されるまで確認なしで実行します。 * **Deny**: この呼び出しを拒否します。Devin は拒否されたことを把握し、別のアプローチを試すことができます。 Devin CLI の[権限ルール](/ja/cli/reference/permissions)は、ローカルのツール呼び出しにも適用されます。`allow` ルールに一致した呼び出しは確認なしで実行され、`deny` ルールに一致した呼び出しは阻止され、`ask` ルールに一致した呼び出しは毎回確認が求められます。これには、お客様の組織が[チーム設定](/ja/cli/enterprise/team-settings)で設定したルールも含まれます。 ### ローカル権限をバイパスする 呼び出しごとの確認プロンプトを止めるには、アクセスカードまたは **Local Hands** メニューで **Bypass local permissions** をクリックします。以降はマシンが切断されるまで、ローカルのツール呼び出しが確認プロンプトなしで実行されます。保留中のリクエストも即座に承認されます。 すべての接続をバイパス状態で開始するには、Devin CLI の設定で [`local_tools_bypass_permissions`](/ja/cli/reference/configuration/config-file#local_tools_bypass_permissions-user-only) を設定します。セッションからバイパスのオン／オフを切り替えると、CLI がこの設定を更新します。 > [!WARNING] > > バイパスがオンの間、Devin は確認なしでお使いのコンピューター上でコマンドを実行したり、ファイルを変更したりできます。信頼できるセッションやタスクでのみ利用してください。 ### 常に確認を求める呼び出し built-in のルールにより、一部の呼び出しはバイパスが有効な場合でも毎回確認を求めます。これらは **Allow for this session** や独自の `allow` ルールでも承認されません。対象となるのは、認証情報ファイルや秘密鍵、権限昇格、破壊的なコマンド、シェルインタープリター、シークレットストア、およびシェルプロファイルや Git 設定への書き込みです。承認カードには、その呼び出しに明示的な承認が必要な理由が表示されます。あなたが設定した `ask` ルールや組織の `ask` ルールも、同じように動作します。 ## 接続の切断またはアクセスの失効 * **アクセスを失効する**: アクセスカードまたは **Local Hands** メニューで **Revoke access** をクリックします。Devin はただちにローカルツールを利用できなくなります。 * **CLI を停止する**: `devin connect` を実行しているターミナルで `Ctrl+C` を押します。 * **Devin Desktop を閉じる**: リクエストを承認した Devin Desktop ウィンドウを閉じるか、Devin Desktop を終了すると、接続は終了します。 * **セッションを終了する**: セッションが終了すると、接続も終了します。 `devin connect` は、ネットワークが一時的に切断されても自動的に再接続します。マシンがオフラインのままの場合やコマンドを停止した場合は、チップにそのマシンが切断済みとして表示されます。再接続するには、Devin にアクセスを再度リクエストするよう依頼し、新しいコードを使用してください。 ## 利用条件 組織管理者は、[**設定 > Devin**](https://app.devin.ai/settings/devin) の **Local Hands** トグルでこの機能のオン/オフを切り替えられます。このトグルは、エンタープライズに属していない組織ではデフォルトでオン、エンタープライズに属している組織ではデフォルトでオフになっています。 次のいずれかに該当する場合、Local Hands は利用できません。 * セッションで[セキュリティプロファイル](/ja/product-guides/security-profiles)を利用している場合 * ご利用の組織で[ネイティブデプロイメント](/ja/product-guides/deployment-capabilities)がオフになっている場合 * セッションにアクセスを承認するユーザーがいない場合 (スケジュールされたセッション、自動化、サービスユーザーによる API セッションなど) ## トラブルシューティング | 症状 | 対処方法 | | - | - | | カードにリクエストの有効期限切れと表示される | **Request a new code** (Devin Desktop では **Connect this machine**) をクリックします | | カードに、このリクエストは新しいリクエストに置き換えられたと表示される | 最新のカードに表示されているコマンドを利用します | | Devin Desktop に、このマシンでサインインするよう表示される | Devin Desktop で Devin にサインインするか、ターミナルで `devin connect` コマンドを実行します | | `devin connect` で、ローカルツールの利用には Devinアカウントが必要と表示される | `devin auth login` を実行し、Devin でサインインします | | ブラウザでカードに **Approve** ボタンが表示されない | ブラウザからはあなたのマシン上でツールを実行できません。ターミナルで `devin connect` コマンドを実行するか、Devin Desktop でセッションを開きます。 | | バイパスを有効にしたのに、呼び出しで再び確認を求められる | その呼び出しは[常に確認が求められる呼び出し](#calls-that-always-ask)に該当します | ## 関連リソース > **[CLI での Devin Cloud](/ja/cli/cloud)** > > ターミナルからクラウドセッションを開始・操作する > **[CLI の権限](/ja/cli/reference/permissions)** > > ツール呼び出し用の許可 (allow) 、ask、拒否 (deny) ルールを記述する > **[クラウドDevinに引き継ぐ](/ja/work-with-devin/devin-handoff)** > > ローカルのタスクをクラウドセッションに移す > **[Computer Use](/ja/work-with-devin/computer-use)** > > Devin が自身の VM のデスクトップを利用する仕組み This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.