Desktop application

• diff ビューで変更をレビューしてコメントしてから、CI を通じて結果の PR を監視
• 埋め込みブラウザで実行中のアプリをプレビューし、Claude が独自の変更を検証し、外部サイトを並べて開く
• iOS Simulator ペインで iOS アプリを実行してテストする Claude を監視
• ペインを配置して、チャット、diff、ブラウザ、ターミナル、ファイルエディタを並べて表示
• セッションのコンテキストを使用するサイド質問を尋ねて、セッションを脱線させない
• Claude に他のセッションを確認、メッセージ送信、またはアーカイブさせる
• 外部ツールを接続（GitHub、Slack、Linear など）
• Claude にアプリを開いてスクリーンを制御させる
• マシン上、クラウド上、または SSH 上で実行

セッションを開始する

• 環境：行の最初のコントロールである環境セレクタを使用して、Claude が実行される場所を選択します。環境設定を参照してください。
  • 新しいセッションでプロンプトボックスの下に環境が表示されない場合は、以前のレイアウトの手順に従ってください。
• プロジェクトフォルダ：環境セレクタの隣にあるプロジェクトフォルダコントロールをクリックして、Claude が作業するフォルダを選択します。
  • クラウドセッション：フォルダの代わりにリポジトリを選択します
  • 保存済みのローカルまたは SSH 環境：環境がすでにフォルダを保持しているため、行にはプロジェクトフォルダコントロールが表示されません。フォルダを変更するには、環境を編集します。
• 権限モード：モードセレクタを使用して、Claude がどの程度の自律性を持つかを選択します。セッション中に権限モードを変更できます。
• モデル：行の右端寄りにあるモデルピッカーからモデルを選択します。セッション中にモデルを変更できます。

コードの操作

プロンプトボックスを使用する

提案されたプロンプトを受け入れる

• 提案を使用する：Tab キーまたは Right arrow キーを押すと提案がプロンプトボックスに配置されます。必要に応じて編集してから、Enter キーを押して送信します。提案を受け入れる前に Enter キーを押しても、提案は送信されません。
• 独自のプロンプトを書く：入力を開始します。提案は、プロンプトボックスが空で、添付ファイルがない場合にのみ表示されます。

ファイルとコンテキストをプロンプトに追加する

• @mention ファイル：@ の後にファイル名を入力して、ファイルを会話コンテキストに追加します。
  • クラウドセッションの場合：@ でファイルを一覧表示できるのは、最初のメッセージを送信した後のみです。@ で何も表示されない場合は、ファイルなしで最初のメッセージを送信し、次のメッセージでそのファイルを @mention します。
• ファイルを添付：プロンプトボックスの横の + ボタンから画像、PDF、およびその他のファイルをプロンプトに添付するか、ファイルをプロンプトに直接ドラッグアンドドロップします。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。
  • WSL セッションの場合：+ メニューに Add files or photos ではなく Add image が表示される場合、添付できるのは画像のみです。セッションのフォルダにあるその他のファイルを Claude に渡すには、そのファイルを @mention します。

権限モードを選択する

auto モードの利用可否

アプリをプレビューする

• Browser ペインで実行中のアプリと直接対話する
• Claude が自動的に独自の変更を検証するのを監視する：スクリーンショットを撮影し、DOM を検査し、要素をクリックし、フォームに入力し、見つけた問題を修正します
• Browser ペインのヘッダーにある Dev servers メニューから、サーバーを開始または停止する、またはすべてのサーバーを一度に停止する
• Browser ペインの ⋮ メニューにある Keep cookies で、アプリを終了した後も Browser がクッキーを保持するかどうかを選択し、開発中に再度サインインする必要がないようにする

SSH および WSL セッションで HTML ファイルをプレビューする

• This preview doesn't load anything from the web：ファイルに記述されたスクリプトは実行されますが、ライブラリを Web から読み込むグラフは空のままです。通知に Export ボタンがある場合は、それを選択し、保存したファイルをブラウザで開きます。ブラウザでは Web からのコンテンツが読み込まれます。
• This preview doesn't run scripts or load anything from the web：Claude Desktop v4.23118.0 より前のバージョンでは、これらのプレビューでスクリプトが実行されなかったため、Desktop を更新してファイルを再度開きます。Desktop が最新であっても通知が表示されたままの場合は、Desktop を再起動します。それでも表示される場合は、組織でスクリプトがオフになっている可能性があるため、管理者に問い合わせてください。

組織の SSH および WSL プレビューでスクリプトをオフにする

• ユーザーが開くファイル：プレビューでスクリプトが実行されないため、スクリプトで描画されるグラフや表は空のままになります。通知は This preview doesn't run scripts で始まります。
• スクリプトを実行中のプレビュー：再起動前に Desktop が設定を取得した場合、プレビューは閉じます。ユーザーには This preview closed because scripts are turned off for previews. Open the file again to view it without scripts. と表示されます
• ユーザーがエクスポートするファイル：ユーザーがファイルをエクスポートしてブラウザで開いた場合、この設定の有無にかかわらず、そのファイルのスクリプトはブラウザで実行されます

スクリプトがまだ実行されるコンピューターを確認する

外部サイトを閲覧する

• 安全分類器は、すべての権限モードで、クリックやタイピングなど、外部ページでの Claude の書き込みアクションを確認します。これらはauto モードが使用するのと同じ分類器であり、分類器がアクションを警告した場合、モードに関係なく権限プロンプトが表示されます。
• Auto および Bypass permissions 以外の権限モードでは、Claude が新しいサイトに移動する前にドメイン許可リストチェックも適用されます。

サイトで Claude のアクションを承認する

Browser と Chrome 拡張機能を選択する

組織の外部閲覧を制限する

差分ビューで変更を確認する

• macOS：Cmd+Enterを押す
• Windows：Ctrl+Enterを押す

コードを確認する

• Walk through in diff をクリックすると、差分ビューが開き、結果を 1 つずつ確認できます。現在の差分内の結果は該当する行に表示され、そこで Fix this one をクリックするか、結果を却下できます。
• Apply fixes をクリックすると、まだ未対応の結果を修正するよう Claude に依頼します。

プルリクエストステータスを監視する

• Auto-fix：ローカルセッションでは、ユーザー以外の人が残した新しいレビューコメントにも Claude が対応します。コメントの作成者は、リポジトリのオーナー、組織のメンバー、コラボレーター、または GitHub App である必要があります。
• Merge when ready：PR に対して GitHub の auto-merge をオンにします。ローカルセッションでは、ベースブランチがマージキューを使用していない限り、Desktop はスカッシュマージを要求します。
  • SSH および WSL セッションの場合：Merge when ready は無効になっているため、GitHub でプルリクエストの auto-merge をオンにします
  • リポジトリが auto-merge を許可していない場合：Merge when ready はオンにならないため、先に GitHub リポジトリ設定で auto-merge を有効にします
• 以前のレイアウト：セッションにプルリクエストができたら、ステータスバーの CI をクリックします。

ワークスペースを配置する

• ウィンドウの幅が狭い場合：収まらないボタンはメニューに移動します
• ボタンのないペインの場合：Background tasksやPlanなどのペインは、それらのペインに表示する内容がセッションに生じると一覧に表示されます

セッションの詳細を確認する

セッション詳細パネルを表示または非表示にする

ペインを最小化する

• パネル内：最小化されたペインはパネルのカードの下に配置され、移動やサイズ変更はできません。代わりにチャットの上にフローティング表示するには、パネルを非表示にします。
• チャットの隅：最小化されたペインにホバーするとヘッダーが表示されます。ヘッダーをドラッグすると別の隅に移動できます。サイズを変更するには、最小化されたペインのうちチャットの中央に最も近い角をドラッグします。

ターミナルでコマンドを実行する

ファイルを開いて編集する

• ローカルセッション：セッションの作業ディレクトリ内のファイルを編集できます。ただし、.mcp.jsonや.claude/settings.jsonなど、一部の表示専用ファイルは除きます。これらを変更するには、別のアプリで開いてください。
• クラウド、SSH、WSL セッション：ファイルペインは表示専用のため、Claude に編集を依頼してください。

ファイルペインで編集内容を保存する

ファイルを他のアプリで開く

• Attach as context：ファイルを次のプロンプトに追加
• Open in：VS Code、Cursor、Zed などのインストール済みエディタでファイルを開く
• Show in Finder（macOS）、Show in Explorer（Windows）：含まれるフォルダを開く
• Copy：ファイルのAbsolute path、Relative path、またはFilenameをコピーするサブメニュー

ビューモードを切り替える

キーボードショートカット

• Cmd+Option：Altを押す
• Cmd+Ctrl：Ctrl+Altを押す
• Cmd：Ctrlを押す

使用状況を確認する

• 現在のレイアウト：セッション詳細パネルのContextカードのヘッダーにパーセンテージで表示されます。カードを開くと、ウィンドウを使用している内容をカテゴリ別に確認できます。
• 以前のレイアウト：モデルピッカーの横の使用状況リングをクリックします。そのポップオーバーにコンテキストウィンドウの使用状況が表示されます。

Claude にコンピューターを使わせる

コンピューター操作が使われる場面

• サービス用のコネクタがある場合、Claude はコネクタを使います。
• タスクがシェルコマンドの場合、Claude は Bash を使います。
• タスクがブラウザでの作業で、Claude in Chrome をセットアップ済みの場合、Claude はそれを使います。
• タスクが iOS アプリの実行やテストの場合、Claude は画面操作を使わない iOS Simulator ペインを使います。
• いずれにも該当しない場合、Claude はコンピューター操作を使います。

コンピューター操作を有効にする

アプリの権限

• Denied apps: ここに追加したアプリは、プロンプトを表示せずに拒否されます。Claude が許可されたアプリでのアクションを通じて、拒否されたアプリに間接的に影響を与える可能性はありますが、拒否されたアプリを直接操作することはできません。
• Unhide apps when Claude finishes: コンピューター操作がバックグラウンドで実行されていない場合、Claude は作業中に他のウィンドウを非表示にし、承認されたアプリのみを操作します。Claude の作業が終わると、この設定をオフにしない限り、非表示にしたウィンドウは元に戻ります。

セッションを管理する

セッションで並列に作業する

• 横に並べて表示：macOS で Option を、Windows で Alt を押しながらサイドバーのセッションをクリックするか、セッションを右クリックして Open in、Split view の順に選択します
• 独自のウィンドウで表示：macOS で Cmd を、Windows で Ctrl を押しながらセッションをクリックするか、セッションを右クリックして Open in、New window の順に選択します

セッションを独自の worktree で実行する

• サードパーティプロバイダーを使用する場合：プロンプトボックスの下の行にプロジェクトフォルダのコントロールが表示されていて Worktree がない場合は、そのコントロールをクリックして Worktree をオンにします
• 保存済みのローカル環境または SSH 環境のデフォルトとして設定する場合：環境を作成または編集するときに Worktree を設定します
• 以前のレイアウト：プロンプトボックスの上にあるブランチ名の横の worktree チェックボックスを選択します

• ローカルセッション：Settings > Code または Settings > Claude Code で Worktree location を設定します
• SSH セッション：SSH 接続で Worktree folder を設定します

セッションにフォルダを追加する

• ローカルセッションの開始前：保存済み環境を作成または編集するときに Folders の下にフォルダを追加し、その保存済み環境からセッションを開始します。
• ローカルまたは SSH セッションの実行中：プロンプトボックスの横の + をクリックし、Add folder を選択します。Claude は worktree を使わず、そのフォルダ自体で作業します。

セッションをアーカイブする

セッションのアーカイブ時にコミットされていない変更を保持する

• Desktop が変更について確認してきた場合：Archive anyway を選択して変更を破棄するか、キャンセルしてコミットします
• 変更が追跡されていないファイルのみの場合：セッション内で Claude が作成したプルリクエストがマージされる前に、保持したいファイルをコミットします。マージ後は Desktop が確認なしにそれらを削除できるためです
• それ以外の場合：worktree は変更とともにディスク上に残ります。ローカルセッションの場合、Desktop はセッションがアーカイブされた時点または最後にセッションを開いた時点のいずれか遅いほうから約 30 日後に、その両方を削除します。変更を保持するには、Archived タブからセッションを開き、Unarchive を選択します

セッションを整理して見つける

• 現在のレイアウト：セッションリストの見出しにマウスを合わせると Group and sort アイコンが表示されるので、それをクリックします。アーカイブ済みセッションを見つけるには、メニューの最後の行である View all を選択し、Archived タブを開きます。
• 以前のレイアウト：Filter アイコンはマウスを合わせなくても表示されます。これをクリックし、Group by または Sort by でリストを整理します。アーカイブ済みセッションを表示するには、Status を選択し、次に Archived を選択します。

コンテキストを確認して解放する

セッションの完了時に通知を受け取る

メインセッションを脱線させずにサイドクエスチョンを尋ねる

バックグラウンドタスクを監視する

セッション間で作業する

• Claude がセッションをアーカイブする前に承認カードが表示されます。ただし、auto モードと Bypass permissions モードでは、Claude は承認カードなしでセッションをアーカイブできます。確認を求められるようにするには、Manual に切り替えてください。
• Claude Code は、受信セッションがクロスセッションメッセージング自体を持たない場合でも、このサーフェスからの各メッセージを受信セッションのインバウンドコントロールに対してチェックします。受信セッションでcrossSessionInboundをrefuseに設定した場合、Claude Code はこのサーフェスからのメッセージをドロップします。Claude Code は拒否を Claude デスクトップアプリに報告します。v2.1.234 より前では、Claude Code はこのサーフェスからクロスセッションメッセージングを持たない受信セッションへのすべてのメッセージをドロップしました。
• Claude Code は各受信メッセージを引用して送信元のセッションを明示し、Claude はメッセージに基づいて行動する際も受信セッション自体の権限設定に従います。

Claude が提案するタスクを開始する

• Start：別のセッションでタスクを開始します。デフォルトでは、タスクは現在のセッションの環境で実行されます。その後、カードには開始されたセッションの状態が表示され、サイドバーでは開始されたセッションが現在のセッションの下に表示されます。
• Do it here：タスクをメッセージとして現在のセッションに送信します
• Options：Start をクリックする前に、環境、モデル、worktree、権限などの設定を確認または変更します
• Start all：カードに複数のタスクが表示されている場合、1 つのタスクの完了を待たずに、各タスクをそれぞれ独自のセッションで開始します

長時間実行されるタスクをクラウドで実行する

• 現在のレイアウト：クラウド環境を選択した後、プロンプトボックスの下の行で選択します。
• 以前のレイアウト：プロンプトボックスの上で選択します。別のリポジトリを追加するには、選択されたリポジトリの横の + をクリックします。

別のサーフェスで続行する

• Cloudを選択すると、会話を要約として引き継いだうえで、セッションをクラウドセッションとして続行します。確定する前に、ファイルも移動するかどうか、およびクラウドセッションの準備ができた時点でこのセッションがアーカイブされるかどうかがダイアログに表示されます。SSH 経由または WSL で実行されるセッションは、この方法で移動できません。
• インストール済みのエディタまたはファイルマネージャーを選択すると、セッションのディスク上のフォルダをそこで開きます。

他のデバイスに表示するセッションを制御する

• そのセッションでオンにする：セッションの Remote Control スイッチを使用するか、プロンプトボックスに /remote-control と入力します。
• 開始時に接続される：Settings > Code または Settings > Claude Code で Connect new sessions to Remote Control がオンの間、新しいセッションは自動的に接続されます。ただし、管理設定で remoteControlAtStartup が false の場合を除きます。Connect new sessions to Remote Control を一度も変更していない場合、Desktop はユーザー設定または管理設定の remoteControlAtStartup を使用します。どちらでも設定されていない場合、Desktop は組織のデフォルトを使用し、組織のデフォルトがない場合は Desktop 自体のデフォルトを使用します。

セッションを他のデバイスに表示しないようにする

• 1 つのセッション：そのセッションの Remote Control スイッチをオフにします。開始時に接続されたセッションで /remote-control と入力すると、Remote Control はオンのままとなり、Remote Control is already on. This session connected automatically when it started. と表示されます。切断するには、その行の Turn off をクリックします。
• このコンピュータ上の新しい Desktop セッション：Settings > Code または Settings > Claude Code で Connect new sessions to Remote Control をオフにします。すでにオフと表示されている場合は、一度オンにしてからオフにすると、Desktop が選択を保存します。保存されると、remoteControlAtStartup やデフォルトが接続を指定していても、新しいセッションは自動的に接続されなくなります。
• CLI を含む、このコンピュータ上のすべてのセッション：~/.claude/settings.json で disableRemoteControl を true に設定すると、セッションが接続されなくなります。ファイルを保存した時点ですでに接続されていたセッションは、そのセッションで Remote Control をオフにするまで接続されたままです。
• 管理するコンピュータ上の Desktop セッション：コンピュータの最も優先度の高い MDM ポリシーまたは管理設定ファイルで remoteControlAtStartup を false に設定すると、サーバー管理設定でこのキーが true であっても、そのコンピュータ上のセッションは自動的に接続されなくなります。この目的にはユーザーレベルの HKCU レジストリ値を使用しないでください。ユーザーは引き続き自分でセッションの Remote Control をオンにできます。これを防ぐには、管理コンソールを使用してください。Claude Desktop v4.4212.0 以降が必要です。

Dispatch からのセッション

Dispatch が開始したセッションを追跡する

Dispatch をセットアップする

• プラン：Dispatch には Pro、Max、または Ultra プランが必要であり、Team または Enterprise プランでは利用できません
• セットアップ、ペアリング、Dispatch 設定：Dispatch ヘルプ記事を参照してください

Claude Code を拡張する

外部ツールを接続する

スキルを使用する

プラグインをインストールする

プレビューサーバーを設定する

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

変更を自動検証する

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

設定フィールド

program と runtimeExecutable の使い分け

特定の URL でプレビューを開く

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 8443,
      "url": "https://localhost:8443"
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "url": "https://app.localhost:3000"
    }
  ]
}

ポートの競合

• true：Claude は空いているポートを自動的に見つけて使用します。ほとんどの開発サーバーに適しています。
• false：Claude はエラーで失敗します。OAuth コールバックや CORS 許可リストなど、サーバーが特定のポートを使用する必要がある場合に使用します。
• 未設定（デフォルト）：以下の 1 つのケースを除き、true の場合と同様に、サーバーには次の空いているポートが割り当てられます。Claude Desktop v2.37337.0 より前では、代わりにサーバーがそのポートを厳密に必要とするかどうかを Claude が尋ね、回答を launch.json に保存します。

• npm、yarn、pnpm、または bun スクリプトを通じてサーバーを起動している。
• 希望するポートがそのスクリプトにハードコードされている、または Claude がスクリプトを検査できない。
• runtimeArgs でポートを渡していない。

例

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "yarn",
      "runtimeArgs": ["dev"],
      "port": 3000
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "frontend",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "cwd": "apps/web",
      "port": 3000,
      "autoPort": true
    },
    {
      "name": "api",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "start"],
      "cwd": "server",
      "port": 8080,
      "env": { "NODE_ENV": "development" },
      "autoPort": false
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "server",
      "program": "server.js",
      "args": ["--verbose"],
      "port": 4000
    }
  ]
}

環境設定

• Local：マシンで実行され、ファイルに直接アクセスできます
• Cloud：デフォルトで Anthropic が管理するインフラストラクチャで実行されます。アプリを閉じても、セッションは続行されます。
• SSH：SSH 経由で接続するリモートマシンで実行されます。たとえば、独自のサーバー、クラウド VM、または dev コンテナなどです。実行中のタスクは Desktop が切断されている間も続行できますが、Claude アカウントの場合はサインインの期限が切れると停止することがあります。
• WSL（Windows）：マシン上の WSL 2 ディストリビューション内で実行され、その Linux ツールチェーンとネイティブパスを使用します

保存済み環境を作成する

Desktop が自動作成する環境

保存済み環境を使用、編集、または削除する

• セッションを開始する: エントリを選択します。
• 編集または削除する: エントリにカーソルを合わせ、歯車アイコンをクリックします。ローカル環境または SSH 環境を削除するには、Edit environment で Delete environment をクリックします。
• クラウド環境をアーカイブする: 環境をアーカイブするを参照してください。

ローカルセッションの環境変数

ローカルセッションの環境変数を設定する

開発サーバーの環境変数を設定する

• macOS と Linux: シェルプロファイルでエクスポートします
• Windows: ユーザー環境変数またはシステム環境変数に追加します
• 任意のプラットフォーム: ローカル環境エディターを開ける場合は、そこに保存します

ローカル環境エディターを使用する

• プロンプトボックスの下にあるセレクター: Local の下の最初にある、自分のコンピューターのエントリにカーソルを合わせます。歯車アイコンが表示されたらクリックします。表示されない場合、エディターは利用できないため、ローカルセッションまたは開発サーバーの変数を別の方法で設定してください。
• プロンプトボックスの上にあるセレクター: Local にカーソルを合わせ、歯車アイコンをクリックします

Claude が実行するコマンドでエクスポートした変数が見つからない、または値が正しくない

Desktop が自身で設定する環境変数

• API_TIMEOUT_MS: ローカルセッションには 900000（15 分）が渡されます。より長いタイムアウトが必要な場合は、Claude Code CLI をインストールし、Desktop の代わりに使用してください。シェルで変数を設定し、ターミナルで claude を実行します。
• ANTHROPIC_BASE_URL: Claude アカウントでサインインしている場合、ローカルセッションには Anthropic の API ホストが渡されます。ゲートウェイを使用するには、代わりに Desktop のサードパーティ推論設定をセットアップしてください。

拡張思考をオフにする

固定の思考予算

管理対象デバイスでのローカルセッション

クラウドセッション

• 環境を追加する: セレクターのメニューの一番下にある New environment を選択し、New environment ダイアログの Cloud タブを選択します
• 自分の環境の 1 つを編集またはアーカイブする：それにマウスを合わせて、ギアアイコンをクリックします

SSH セッション

SSH セッションのリモートマシン要件

• システム：x86_64 または arm64 プロセッサ。マシンは Claude Code のシステム要件も満たす必要があります。Linux では、Claude Code には glibc 2.17 以降、または musl が必要です。マシンがどちらを使用しているかを確認するには、そのマシンで ldd --version を実行します。Alpine Linux などの musl ベースのディストリビューションでは、Claude Code が必要とするパッケージもインストールしてください。
• SFTP：SSH サーバーが SFTP サブシステムを提供している必要があります。これは sshd_config の Subsystem sftp 行で有効になります。確認するには、コンピューターのターミナルで sftp を使用して同じホストとポートに接続します。正常に動作しているサーバーでは sftp> プロンプトが表示されます。
• サーバーでの MaxSessions 1: sshd_config で MaxSessions 1 が設定されているサーバーに接続するには、次のいずれかを行います。
  • コンピューターが macOS または Linux の場合: Claude Desktop v3.1623.0 以降に更新します
  • コンピューターが Windows の場合: Desktop の組み込み SSH クライアントはそのサーバーに接続できないため、Desktop が OpenSSH クライアント経由で接続するようにします
  • サーバーを変更できる場合: MaxSessions を、たとえば OpenSSH のデフォルトである 10 に引き上げます
• MaxSessions 1 でのログイン: SSH エージェントが保持する鍵など、プロンプトなしで機能するログインを使用してください。Desktop は接続または再接続のたびに少なくとも 2 回ログインします。さらに、ターミナルタブごと、および ! で始まるコマンドを実行する Desktop セッションごとに、少なくとも 1 回のログインが追加で発生します。Claude が実行するコマンドではログインは発生しません。
• MaxSessions 1 でのワンタイムコード: ワンタイムコードのようにログインのたびにプロンプトが表示される場合、! コマンドは失敗します。代わりに、それらのコマンドはターミナルタブで実行してください。ターミナルタブでは、独自のペインでプロンプトが表示されます。
• インストールフォルダ：Desktop は、ホームディレクトリの ~/.claude/remote/ の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを noexec でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、リモートマシン上のファイルとプロセスを参照してください。
• シェル：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、sh と同様に、SSH 経由で送信されたコマンドを実行できる必要があります
• ネットワーク: Claude Code はリモートマシン上で実行され、そこからネットワークリクエストを送信するため、マシンには Claude Code が必要とするネットワークアクセスが必要です。マシンが Claude Code をダウンロードできない場合、Desktop が自分のコンピューターでダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。Linux のリモートマシンでプロキシや CA 証明書が必要な場合は、SSH セッション用に設定してください。

リモートマシンのホスト鍵を確認する

• Desktop が Connect to <host> for the first time? と尋ねた場合、または Review new key を選択した場合: Desktop が示すマシン <host>
• Desktop が Connect through <jump host> for the first time? と尋ねた場合: 踏み台ホスト。これは接続が経由するマシンで、接続先のマシンではありません
• ターミナルで ssh が尋ねるか警告した場合: メッセージに示されたマシン。入力したマシンとは異なる場合があります

• 他の人がマシンを管理している場合: ホスト鍵のフィンガープリントを問い合わせます
• 自分が管理していて、Linux または macOS を実行している場合: マシンのコンソールで、またはすでに信頼している接続経由で、ssh-keygen -lf /etc/ssh/ssh_host_<type>_key.pub を実行します。<type> には、Desktop または ssh がフィンガープリントの横に表示する鍵の種類を小文字で指定します。たとえば ED25519 や ssh-ed25519 なら ed25519 です。

• 一致する場合: 鍵を信頼します。Desktop では Trust and connect または Trust new key を選択し、ターミナルでは yes と答えます。
• 一致しない、または確認できない場合: 接続しないでください。Desktop では Cancel を選択し、ターミナルでは no と答えます。他の人がマシンを管理している場合は、表示されたフィンガープリントを伝えてください。

SSH セッションのプロキシまたは CA 証明書を設定する

{
  "env": {
    "HTTPS_PROXY": "http://proxy.example.com:8080",
    "NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"
  }
}

リモートマシンの別の場所で設定されたプロキシまたは CA の変数を見つける

SSH 設定を使用する

• macOS と Linux: Desktop は自分のコンピューター上で OpenSSH クライアントを実行して接続するため、~/.ssh/config を使用します。OpenSSH クライアント経由で接続するには、Claude Desktop v1.37937.0 以降が必要です。
• Windows: Desktop が OpenSSH クライアント経由で接続する場合、%USERPROFILE%\.ssh\config を使用します。サードパーティプロバイダーではなく Claude アカウントを使用している場合、OpenSSH クライアント経由で接続するには、次のすべてが必要です。
  • Claude Desktop v2.2553.0 以降。バージョンを確認するには、バージョンを確認するを参照してください。
  • Microsoft の OpenSSH 9.4 以降
  • このページ上部のダウンロードボタンでインストールした Desktop。Microsoft Store 版の Desktop は OpenSSH クライアント経由で接続しないためです
  これらの要件を満たせない場合、またはサードパーティプロバイダーを使用している場合は、OpenSSH クライアントを使用せずに Windows で接続するを参照してください。

• macOS と Linux でのクライアントのバージョン: ssh -V を実行します。クライアントは OpenSSH 7.6 以降である必要があります。
• Windows でのクライアントのバージョン: Desktop は最初に PATH 上の ssh を試すため、ssh -V を実行します。出力に OpenSSH_for_Windows_ と 9.4 以降が表示されれば、そのクライアントは要件を満たしています。満たしていない場合は、Desktop が次に試す 2 つのフォルダーを確認します。C:\Windows\System32\OpenSSH で .\ssh.exe -V を実行し、次に C:\Program Files\OpenSSH で実行します。
• Windows で要件を満たすクライアントがない場合: Windows で OpenSSH Client オプション機能を追加して保留中の Windows 更新プログラムをインストールするか、Microsoft の新しいビルドをインストールします。その後、Desktop を終了して再度開きます。Desktop が使用可能な OpenSSH クライアントを見つけたかどうかを確認するには、ssh.log で Windows OpenSSH client: とバージョン、または no usable Windows OpenSSH client を探します。
• エントリ: Windows では、バージョンチェックで要件を満たしたクライアントを使用します。ssh devbox のように、Host 名を指定して ssh を実行します。失敗する場合は、先にエントリを修正してください。

• SSH port：ここに入力した値は、エントリの Port を上書きします
• SSH key (optional): OpenSSH クライアントでは、Desktop はエントリの IdentityFile と SSH エージェント内の鍵に加えて、ここで選択した鍵ファイルを提示します。Windows では、ssh は PuTTY の .ppk ファイルを読み込まないため、OpenSSH 形式の鍵を選択してください。

OpenSSH クライアントを使用せずに Windows で接続する

• エントリの設定: Desktop は HostName、User、Port、IdentityFile、ConnectTimeout を使用します。PATH に sh シェルがある場合は ProxyCommand も使用します。
• SSH key (optional): ここで選択した鍵ファイルは IdentityFile を置き換えるため、エントリの IdentityFile を使い続けるにはこのフィールドを空欄のままにします
• CertificateFile と ProxyJump: Desktop は CertificateFile を無視し、エントリで ProxyJump が設定されていると接続は失敗します。いずれかの設定を使用するには、OpenSSH クライアント経由で接続してください。

ジャンプホストの背後にあるマシンに接続する

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com

リモートマシン上のコンテナに接続する

Host devbox-container
  User dev
  ProxyCommand ssh build.example.com docker exec -i devbox /usr/sbin/sshd -i

ProxyCommand でシェルの変数を使用する

macOS と Linux で ProxyCommand に AWS 認証情報を使用する

[profile corp]
region = us-east-1
credential_process = /full/path/to/your-credential-helper

Host i-*
  ProxyCommand sh -c "aws ssm start-session --profile corp --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"

SSH 接続のタイムアウトを延長する

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com
  ConnectTimeout 120

Desktop だけが適用する Match host ブロックを修正する

ssh -G -o HostName=devbox.internal.example.com -l alice devbox

Match host *.internal.example.com !originalhost devbox

Desktop がオフにする転送設定

• リモートマシン上のポートに接続するには：自分で転送します
• リモートマシンから自分の鍵を使用するには：git push 用など、リモートマシン自体に認証情報を設定します

リモートマシン上のポートに接続する

ssh -N -L 3000:localhost:3000 devbox

Windows リモートマシン

• ターミナル：フォルダが C:/projects/app のような Windows パスであるセッションでは、ターミナルは開きません
• サンドボックス：Claude Code はそこではネイティブ Windows 上で実行され、コマンドはサンドボックス化されずに実行されます。サンドボックスが実行される場所を参照してください。
• プラグイン：Desktop は、: を含む名前など、Windows で保存できないファイル名またはフォルダ名を含むプラグインをコピーしません。セッションには、Desktop が除外したプラグインが一覧表示されます。
• MCP サーバー：一部の Windows リモートマシンでは、claude_desktop_config.json の MCP サーバーに対する Claude の呼び出しが Desktop を経由するため、Desktop が切断されている間は Claude がそれらのツールを呼び出せません。Claude Desktop v2.37337.0 より前では、これはすべての Windows リモートマシンに当てはまります。
• worktree：worktree は <project-root>/.claude/worktrees/ に作成されます。別のフォルダを選択しても、Desktop はそれを無視します。
• 以前のメッセージ：SSH サーバーのシェルが cmd.exe または Windows PowerShell の場合、セッションの以前のメッセージを表示するには、接続が必要になることがあります
• フォーク：SSH サーバーのシェルが cmd.exe または Windows PowerShell の場合、セッションをフォークできるのは最初のメッセージの時点のみです
• 切断中の実行：タスクが Desktop の切断中も実行を続けるのは、プログラムを起動した接続が終了した後もそのプログラムが存続することを SSH サーバーが許可している場合のみです。確認するには、リモートマシンをテストしてください。
• 残存プロセス：セッションの終了後も、Claude Code が起動したプログラムが実行を続けている可能性があるため、マシンを確認してください。Desktop がインストールするバックグラウンドヘルパーは、そこでは自動的に停止しません。

Desktop の切断中もタスクを実行し続ける

• スリープまたはネットワーク切断の後：プロセスがまだ実行されており、Desktop がプロンプトなしでログインできる場合、実行中のタスクに戻れます。ログインできない場合は、メッセージを送信してください。
• 終了の後: タスクは実行を続けますが、Desktop がそのプロセスに再参加できない限り、セッションを再度開いたときにタスクは失われます。終了する前に Desktop が再参加できる場合を確認してください。タスクが失われた場合は、メッセージを送信して続行します。

• サインインページ: サインインします。タスクが停止していた場合は、メッセージを送信して続行します。Enterprise プランでは、組織が、アクティブかどうかにかかわらずサインインから一定日数後にサインアウトさせる設定にしている場合があります。Claude アカウントの場合、サインアウト中は Desktop がタスクのサインインを更新しないため、タスクが停止することがあります。
• Desktop が再接続できない：セッションにその理由が表示され、通知でも知らされることがあります。Desktop はログインを必要とする場合があります。
• 認証エラー：サインイントークンまたは認証情報の期限が切れている可能性があります。Claude アカウントの場合は、メッセージを送信して続行します。サードパーティプロバイダーの場合は、SSH remote sessions in Claude Desktop on 3P を参照してください。
• 待機中のリクエスト：それに応答します
• いずれにも該当しない：メッセージを送信して続行します

長いタスクを準備する

• 先に更新する: 長時間のタスクを開始する前に Desktop を更新してください。macOS と Windows では、Desktop はダウンロード済みの更新をインストールするために自動的に再起動することがあります。この再起動は、Claude が SSH タスクで作業している間は待機します。デフォルトでは、更新が 72 時間待機した後、Desktop がその後タスクに再接続できる場合は、タスク中でも再起動が実行されることがあります。
• 終了する前に確認する: 終了や再起動の後、たとえば一部の Desktop の更新後などには、実行中のタスクに必ず戻れるとは限りません。該当するケースについては、Desktop を終了した後にセッションを再度開くを参照してください。
• 古いバージョンでは Desktop を開いたままにする: Windows で v3.1623.0 より前の Claude Desktop を使用している場合、Desktop が終了または再起動すると、実行中のタスクに戻れません。macOS または Linux で v2.42304.0 より前のサードパーティプロバイダーを使用している場合も同様です。どちらの場合も、タスクの実行中は Desktop を開いたままにしてください。バージョンを確認するには、バージョンを確認するを参照してください。
• リクエストを減らす：タスクがユーザーを待つ頻度を減らす権限モード、ルール、またはフックを選択します
• ジャンプホストを確認する：ジャンプホストがサインイン（スマートフォンへのプッシュ通知など）を求める場合は、プロンプトなしで機能するログインに切り替えてください。そうしないと、Desktop は再接続を試みるたびに別のプッシュ通知を送信する可能性があります。
• リモートマシンをテストする：短いタスクを開始し、タスクの実行中に Desktop を終了して、タスクが完了しているはずの時刻を十分に過ぎてからセッションを再度開きます。タスクが完了しておらず、セッションに認証エラーが表示されていない場合は、リモートマシンでタスクを終了させうる要因を確認してください。
• Desktop のターミナルでコマンドを実行しない：リモートマシンがアイドル状態のターミナルをログアウトさせる場合は、Desktop の外部からの SSH ログインで独自のコマンドを実行してください

Desktop の切断中の制限

• サインイントークンまたは認証情報：Claude アカウントの場合、トークンの期限が切れるとタスクは認証エラーで停止します。サードパーティプロバイダーの場合は、シングルサインオンや認証情報ヘルパーから取得したものなど、期限が切れる認証情報にも同じことが当てはまります。SSH remote sessions in Claude Desktop on 3P を参照してください。Claude アカウントの場合は、Desktop がサインインを更新できるように、Desktop を実行して接続したままにしてください。
• リモートマシン：リモートマシンが再起動した場合、または SSH 接続が閉じたときにプロセスを終了させる場合、実行中のタスクは終了します。Desktop が切断されている間、タスクが再開されることはありません。systemd-logind の KillUserProcesses が yes で、それがユーザーに適用される Linux マシンでは、この方法でプロセスが終了されます。そこでタスクを実行し続けるには、KillExcludeUsers などでユーザーを除外するよう管理者に依頼してください。
• アイドル状態のターミナル：一部の Linux リモートマシンは、一定時間誰も入力しないターミナルをログアウトさせます（systemd-logind の StopIdleSessionSec）。macOS または Linux の Desktop では、セッションのターミナルと ! コマンドは、デフォルトで Desktop の SSH 接続を共有します。その場合、このログアウトによって Desktop の接続中に接続が終了し、実行中のタスクも一緒に終了することがあります。ターミナルペインを閉じても防げないため、そのターミナルでコマンドを実行しないでください。
• Desktop のアップデート：アップデートで新しいヘルパーが導入された場合、Desktop は後の接続時にリモートマシン上のヘルパーを置き換えるため、まだ実行中のタスクが終了することがあります
• 長期間の不在：Linux または macOS のリモートマシンで、Desktop が 30 日間接続しない場合、ヘルパーは停止し、その下で実行されているすべての Claude Code プロセスを終了します。それまでに接続してください。

• worktree: worktree を使用するセッションでは、Claude がファイルを編集する前に Desktop が各編集を確認します。Desktop が切断されている間、各編集は約 30 秒待機した後に失敗します。シェルコマンドは引き続き実行されます。Linux または macOS のリモートマシンでは、編集が引き続き機能する場合があります。不明な場合は、worktree なしでセッションを開始してください。
• フォルダの制限：組織がセッションで使用できるフォルダを制限している場合、Desktop は worktree の有無にかかわらず、各ファイルの読み取り、検索、編集をチェックします。Desktop が切断されている間、それぞれ最大 10 分間待機した後に失敗します。
• コネクタ：コネクタおよび Desktop が提供するその他のツールは Desktop を経由して実行されるため、Desktop が切断されている間は各呼び出しが約 30 秒後に失敗します
• ワークフロー：Desktop は新しいワークフローをそれぞれ開始前にチェックするため、Desktop が切断されている間、新しいワークフローは最大 10 分間待機した後に失敗します
• MCP サーバー：Claude Code がリモートマシンで起動する MCP サーバーは Desktop を経由しないため、Claude は引き続きそれらのツールを呼び出せます。claude_desktop_config.json のサーバーがこれに含まれるのは、Desktop が組み込みの SSH クライアントを使用していない場合のみです。それ以外の場合、および一部の Windows リモートマシンでは、Desktop が切断されている間、Claude はそれらのツールを呼び出せません。

不在中に届いたリクエストに対応する

• auto モード：利用可能な場合は auto モードを選択します。ブロックが繰り返されると、再度確認が求められます。
• 許可ルール：リモートマシン上のユーザー設定ファイル ~/.claude/settings.json に、タスクに必要なコマンドの許可ルールを追加します。組織が管理設定からの権限ルールのみを受け入れる場合は、リモートマシンに適用される管理設定にそれらを追加するよう管理者に依頼してください。プロジェクトの .claude/settings.json の許可ルールについては、プロジェクトの許可ルールとワークスペースの信頼を参照してください。
• 応答するフック：リモートマシン上の ~/.claude/settings.json に PermissionRequest フックを設定し、ユーザーに代わってリクエストを許可または拒否します
• 通知するフック：同じファイルに permission_prompt matcher を使用した Notification フックを設定し、リクエストが待機しているときに自分宛てにメッセージを送信します
• Claude の完了を知らせるフック：同じファイルに Stop フックを設定し、Claude が応答を終えたときに自分宛てにメッセージを送信します。API エラーによってターンが終了した場合は実行されません。その場合は、StopFailure フックを設定してください。

スリープまたはネットワーク切断の後に再接続する

• 記憶されたパスワード：Desktop に記憶させたパスワードもプロンプトなしで機能しますが、長期間不在にする場合は SSH エージェントが保持する鍵を使用することをお勧めします。そのパスワードでのサインインが途中で切れたり応答しなくなったりする場合、Desktop は再接続を停止してユーザーを待つことがあります。
• その他のプロンプト：リモートマシンがワンタイムコードなど、その他の入力を求める場合、コンピューターに通知が届くことがあります。通知をクリックするか、セッションでメッセージを送信すると、Desktop にプロンプトが表示されます。

Desktop を終了した後にセッションを再度開く

• Windows の Desktop で、v3.1623.0 より前のバージョンで開始したタスク: その後 Desktop が更新されていても、タスクには戻れません。Desktop の起動時にセッションが開くことがあり、セッションが開くとタスクは停止するため、タスクが完了していると予想される時点になってから Desktop を再度起動してください。どのバージョンでタスクを開始したかわからない場合も、タスクが完了していると予想される時点まで待ってください。
• macOS または Linux のサードパーティプロバイダーで、v2.42304.0 より前のバージョンで開始したタスク: タスクには戻れません。タスクが完了していると予想される時点になってから Desktop を再度起動してください。
• その他のタスク: Desktop を起動してセッションを開くと、Desktop が再接続できればタスクは続行されます。一部の Desktop の更新後など、常に再接続できるとは限らないため、長時間のタスクの前に更新してください。

SSH セッションの worktree の作成場所を選択する

1. SSH 接続の Worktree folder
2. リモートマシン上の ~/.claude/settings.json にある worktree.location
3. デフォルトの <project-root>/.claude/worktrees/

既存の接続で worktree フォルダーを設定する

リモートマシン上のファイルとプロセス

• ヘルパー：接続するコンピューターごとに 1 つ以上の server プロセス
• Claude Code：ヘルパーがユーザーのセッションのために起動するプロセス。それぞれ 2.1.295-… のように、バージョンにちなんだ名前のファイルから起動されます

1 つのセッションのプロセスを終了する

プロセスを実行するユーザーを確認する

リモートマシンに接続したユーザーを確認する

ログイン前に閉じる接続

SSH サーバーのログでテストを識別する

SSH サーバー自体がアドレスを拒否しているかどうかを確認する

drop connection #0 from [203.0.113.7]:51234 on [192.0.2.10]:22 penalty: connections without attempting authentication

fail2ban が Desktop のテストをカウントしているかどうかを確認する

• 角かっこ内でモードを指定する filter 行（filter = sshd[mode=aggressive] など）がある場合: そのモードを使用します。
• 標準の filter 行（[mode=%(mode)s]）のみの場合: mode 行を使用し、ない場合は normal を使用します。

fail2ban-regex -o ip lines.log "sshd[mode=aggressive]"

fail2ban による禁止を防ぐ

• mode: jail で設定されている箇所（mode 行、または filter = sshd[mode=aggressive] のような行の角かっこ内）で normal に設定します。ログインを試みずに接続して切断するクライアントのカウントなど、他のモードでのみ行われるカウントはすべて行われなくなります。
• ignoreip: 接続元のアドレスに設定します（例: ignoreip = 203.0.113.7）。fail2ban は、ログイン失敗を含め、それらのアドレスからのものを一切カウントしなくなります。

リモートマシンで設定した MCP サーバーを使用する

リンクから SSH セッションを開く

claude://code/new?ssh_host=dev%40build.example.com&ssh_port=2222&ssh_folder=/srv/payments&q=Investigate%20the%20failed%20deploy

• 既存の接続：ホスト、ユーザー、ポートが既存の接続のいずれかと一致する場合、Desktop はその接続を使用するかどうかを確認し、接続の名前とホスト、およびリンクでフォルダが指定されている場合はそのフォルダを表示します。
• 新しい接続：それ以外の場合、Desktop は SSH 接続を追加するダイアログを開きます。接続を追加すると、Desktop は何かを保存する前に接続するかどうかを確認し、リンクのホスト、およびリンクでポートとフォルダが指定されている場合はそれらを表示します。

• 確認する前に：ホストとフォルダを確認します。
• 送信する前に：プロンプトと選択されている環境を確認します。

• サインアウトしている：サインインしてから、もう一度リンクを開きます。
• 別のダイアログが開いている：そのダイアログを閉じてから、もう一度リンクを開きます。
• リンクが無効である：Desktop は修正すべき点を示すメッセージを表示し、プロンプトは入力しません。
• Desktop が v2.110.0 より古い：以前のバージョンは SSH パラメータを無視し、プロンプトのみを入力した状態で新規セッションページを開きます。
• SSH セッションがオフになっている：管理者が許可リストを空の配列に設定している場合、Desktop は SSH リンクを拒否します。

コマンドから SSH 接続を作成する

{
  "sshHostCommands": [
    {
      "id": "devbox",
      "name": "Dev box",
      "command": "acme-dev create",
      "startDirectory": "~/project"
    }
  ]
}

コマンドを記述する

• プログラム: 名前、または / から始まるフルパスを記述します。Desktop は名前のみの指定を、ログインシェルがエクスポートする PATH 上で探します。./acme-dev のような相対パス、~ で始まるパス、シェルのエイリアスや関数は機能しません。
• パス内のスペース: '/Users/you/My Tools/make-devbox' create のように、プログラムのフルパスを単一引用符で囲みます。引用符（単一引用符または二重引用符）には Claude Desktop v4.16336.0 以降が必要で、プログラムのパスを囲む場合にのみ機能します。
• 引数: 引数はスペースで区切ります。引用符の外では、コマンドに含められるのはスペース、ASCII 英字、数字、および文字 +,-./:=@_~ のみで、どの単語も ~ で始めることはできません。引用符で囲んだパスには、(、)、& など、他のいくつかの文字も含められます。
• スクリプト: 引用符で囲んだ引数、パイプ、変数、? や & を含む URL など、それ以外のものがコマンドに必要な場合は、スクリプトに記述します。スクリプトを実行可能にし、#! 行で始め、command に /Users/you/bin/make-devbox のようなフルパスを設定します。macOS では、macOS がブロックする可能性があるため、スクリプトを書類、デスクトップ、ダウンロードフォルダーに置かないでください。
• 入力: プログラムには入力もターミナルも与えられないため、そこでユーザーに入力を求めることはできません。ツールがブラウザーやプロンプトを通じてサインインする場合は、事前にターミナルからサインインし、そのサインインが期限切れになるたびに再度サインインしてください。
• 環境: プログラムはホームディレクトリで、ログインシェルがエクスポートする変数を使って実行されます。Desktop は ProxyCommand の場合と同様に起動時にこれらの変数を読み込むため、変数を変更した後は Desktop を終了して再度開いてください。
• 制限時間: Desktop は 10 分経過してもまだ実行中のプログラムを停止します。Desktop の進行状況メッセージにはプログラムの出力は表示されません。プログラムをより早く停止するには、そのメッセージの横にある Cancel を選択します。

• 1 行: host または user@host。SSH リンクの ssh_host と同じ形式で記述します。ポートを指定するには JSON 形式を使用します。
• 1 つの JSON オブジェクト: sshHost と、オプションで数値の sshPort およびエントリーの値を置き換える startDirectory。例: {"sshHost": "dev@devbox-1234.example.com", "sshPort": 2222}

acme-dev create < /dev/null > host.txt

#!/bin/bash
out=$(mktemp) || exit
trap 'rm -f "$out"' EXIT
acme-dev create > "$out" || exit
tail -n 1 "$out"

Windows でコマンドを記述する

{
  "sshHostCommands": [
    {
      "id": "devbox",
      "name": "Dev box",
      "command": "'C:\\Program Files\\Acme\\acme-dev.exe' create"
    }
  ]
}

• プログラム: \\server\share のようなネットワークパス、%USERPROFILE% のような変数、ASCII 以外の文字を使用しないでください。パスにこれらのいずれかが含まれていると、エントリはグレー表示になります。ユーザーフォルダーの名前にそのような文字が含まれている場合は、プログラムをそのフォルダーの外に置いてください。
• 引数: 「コマンドを記述する」の「引数」のルールに従います。コマンドには \ も含められますが、どの単語も \ で終えることはできません。
• スクリプト: .cmd または .bat ファイルを使用します。Desktop はこれを cmd.exe 経由で実行します。引用符で囲んでいても、ファイルのパスに &、^、; を含めることはできません。自分で作成するファイルでは、引数を %* で読み取ってください。%1 から %9 は、引数を , と = で分割するためです。
• 環境: プログラムには、シェルプロファイルの環境変数ではなく、Desktop アプリの環境変数が渡されます。変数を変更した後は、Desktop を終了して再度開いてください。
• テスト: Desktop が読み取る出力を確認するには、コマンドプロンプトでコマンドを実行します。"C:\Program Files\Acme\acme-dev.exe" create < NUL > host.txt のように、スペースを含むパスは二重引用符で囲み、入力なしには NUL を使用します。ファイルにはホストのみが含まれている必要があります。このテストでもマシンが作成されるため、後でツールを使って削除してください。

他の行を出力する Windows ツールをラップする

@echo off
setlocal
set "host="
set "out=%TEMP%\acme-dev-%RANDOM%.txt"
call "C:\Program Files\Acme\acme-dev.exe" create > "%out%"
set "code=%ERRORLEVEL%"
for /f "usebackq delims=" %%L in ("%out%") do set "host=%%L"
del "%out%"
if not "%code%"=="0" exit /b %code%
setlocal EnableDelayedExpansion
echo(!host!

新しいホストに接続する

• ホストキー: OpenSSH のデフォルトのホストキーチェックでは、キーのフィンガープリントを確認してから、接続するかどうかを選択します。この質問を省略するには、ホストを出力する前に、コマンドでキーを ~/.ssh/known_hosts（Windows では %USERPROFILE%\.ssh\known_hosts）に追加させます。
  • ツールがマシン作成時に取得したキーを使用します
  • 22 以外のポートの場合は、行を [host]:port で始めます
  • ツールがホスト名を再利用する場合は、古いキーの行も削除します
• フォルダー: そのホストで開くフォルダーを信頼するかどうかを選択します。

• ユーザー、コマンド、または別のプログラムが新しいキーを known_hosts に追加した、または古いキーの行を削除した（コマンドがホストキーを追加する場合はコマンドがこれを行います）
• ツールのマシンがホストキーを共有している
• ツールのマシンが、known_hosts が信頼する認証局を共有している
• ユーザーまたは管理者が KnownHostsCommand または VerifyHostKeyDNS yes を設定しているため、SSH が known_hosts 以外からのキーを受け入れる

別のマシンを作成する

• 以前のマシン上のセッション: セレクターには Dev box の現在のマシンが表示され、以前のマシンは表示されないため、サイドバーからセッションを続行します。Desktop は、たとえば起動時などに、それらのマシンに自動的に接続することがあるため、使用を終えたらマシンの使用を停止してください。
• Claude Desktop v4.4212.0 より前に置き換えたホスト: これらのバージョンでは Replace Dev box’s host が表示され、置き換えられたホストへの接続を停止します。そのホスト上のセッションを続行するには、セッションを開いて Add SSH connection を選択し、Desktop が入力した接続を保存します。別のホストを置き換える前に Desktop を更新してください。
• 2 台のマシンでの新しいセッション: sshHostCommands に 2 つ目のエントリを追加します
• まだ応答しない新しいホスト: 新規セッションページが接続を試行し続けている間、最大 10 分間ページを開いたままにします。それでもホストが応答しない場合は、ページのメッセージで Create another Dev box を選択します。
• 直後に別のマシンを作成する: 1 時間以内にコマンドを何度か実行した後は、それ以降の実行ごとに、Desktop が開くコマンドを表示するダイアログで確認します

マシンの使用を停止する

1. サイドバーでそのマシンのセッションを探します。セッションの詳細パネルには、セッションが実行されているホストが表示されます。
2. 各セッションをアーカイブし、アーカイブしたままにします。
3. このマシンを作成した後に同じ sshHostCommands エントリから別のマシンを作成していない場合は、別のマシンを作成するか、エントリを削除もします。それまでは、このマシンがエントリの保存済み接続であり、その接続が選択された状態で新規セッションページを開くと、Desktop がこのマシンに接続する可能性があります。
4. アプリでそのマシンへの他の SSH 接続を削除するか、その sshConfigs エントリを削除します。
5. Desktop を終了して再度開きます。これにより、マシンへの接続が閉じられ、到達の試行が終了します。
6. ツールでマシンを削除します。

エントリを削除する

コマンドをチームに配布する

{
  "sshHostCommands": [
    {
      "id": "acme-devbox",
      "name": "Dev box",
      "command": "/usr/local/bin/acme-dev create"
    }
  ],
  "strictPluginOnlyCustomization": ["hooks"]
}

• キーの配置場所: Claude Code 用の MDM ポリシーですでにポリシーキーを設定している場合は、そこに配置します。そうでない場合は、管理設定ファイルに配置します。デフォルトでは、そのようなポリシーはファイルより優先され、その場合 Desktop はファイル内のエントリーを無視します。サーバー管理設定が適用される環境でも、コンピューター上で設定してください。Desktop はサーバー管理設定、およびプロジェクト設定とローカル設定にあるこのキーを無視します。
• id: ユーザーの sshHostCommands エントリが管理者の id を持っている場合、管理者のエントリのみが機能します。ユーザーの sshConfigs にあるものなど、他の SSH 接続がその ID を持っている場合、管理者のエントリはグレー表示になります。ユーザーが選びそうにない id を選んでください。
• プログラム: フルパスを指定します。macOS と Linux では Desktop は名前のみの指定を各ユーザーの PATH 上で探し、Windows では名前のみの指定のエントリはグレー表示になるためです。プログラムは、そのユーザーの変数を使用して、そのユーザーとして実行されます。
• 各プラットフォーム: Windows コンピューターと、macOS および Linux コンピューターに、それぞれ別のエントリをデプロイします。Windows のパスを含むエントリは macOS と Linux ではグレー表示になり、macOS または Linux のパスを含むエントリは Windows ではグレー表示になります。
• ユーザー独自のエントリー: どちらもコンピューター上でプログラムを実行するため、Desktop はユーザーのエントリーをフックと同様に扱います。管理者のエントリーのみを許可するには、strictPluginOnlyCustomization を ["hooks"] に設定するか、そのリストに "hooks" を追加します。これにより、ユーザー設定、プロジェクト設定、ローカル設定の Claude Code フックも停止され、それらを維持する方法はありません。代わりにこのキーまたは allowManagedHooksOnly を true に設定すると、各キーの項目に記載されているとおり、より多くのものがブロックされます。
• すべてのエントリ: 管理者のエントリもオフにするには、管理設定で disableAllHooks を設定します。disableDesktopLocalSessions、またはどのホストも許可しない sshHostAllowlist を設定した場合、セレクターには Create や Create another の項目は表示されません。
• ロックが有効になる場所: これらのエントリーについて、Desktop は allowManagedHooksOnly、strictPluginOnlyCustomization、disableAllHooks をサーバー管理設定とコンピューター自身のファイルまたはポリシーから読み取り、より厳しい結果を適用します。組織にサーバー管理設定がない場合でも、Desktop が claude.ai でサーバー管理設定を確認するまで、すべてのエントリーはグレー表示のままです。
• 許可されたホスト: sshHostAllowlist を設定する場合は、ツールが出力する各ホスト名にいずれかのパターンが一致するようにし、パターンには user@ を含めないでください。Desktop が出力された名前を確認するのはコマンドの実行後であるため、リストで拒否されたマシンはすでに存在しており、ユーザーはツールを使ってそれを削除する必要があります。各接続時には、解決後の HostName も一致する必要があります。

コマンドが表示されない、またはグレー表示になる場合

• ファイル: ~/.claude/settings.json に無効な JSON またはスキーマで拒否される値がある、キーのスペルを間違えている、またはプロジェクトの設定にキーを記述している。ファイルを修正してください。
• アカウント: Claude アカウントではなくサードパーティプロバイダーを使用している。各ホストを自分で SSH 接続として追加してください。
• Windows: Desktop が v4.16336.0 より古い、または OpenSSH クライアント経由で接続していない。Desktop を更新し、OpenSSH クライアントの要件を満たしてから、Desktop を終了して再度開いてください。
• 組織の設定: 管理者がローカルセッションをオフにしている、または SSH セッションをオフにしている。コマンドを使用できるかどうか管理者に確認してください。
• ssh プログラムがない: Desktop がコンピューター上の OpenSSH クライアントを起動できなかった。インストールするか、管理者に許可を依頼してから、Desktop を再起動してください。

• エントリの誤り: メッセージが示すフィールドまたはコマンドを修正します。id が使用中の場合は、エントリに別の id を付けます。Windows では、コマンドをプログラムのフルパスで始める必要があります。
• 壊れた設定ファイル: 自分の設定ファイルが壊れている間、管理者のエントリーが、ファイル名を示すメッセージとともにグレー表示になることがあります。ファイルを修正してください。
• 新しいホスト: Desktop がホストを保存してから 1 分間、Create another はグレー表示になります。1 分経過後に選択してください。Claude Desktop v4.4212.0 より前では、Replace Dev box’s host が 10 分間グレー表示になります。
• フックがオフまたは制限されている: 自分のエントリーは、自分のフックが実行できる場合にのみ機能します。設定から disableAllHooks を削除するか、管理者に相談してください。
• 設定がまだ読み込み中: Desktop が組織のサーバー管理設定を読み込むまで（通常は起動から数秒）、すべてのエントリーはグレー表示になります。エントリーがグレー表示のままの場合は、claude.ai への接続を確認してください。

チームの SSH 接続を事前設定する

• ユーザーに表示される内容：この方法で定義された接続は、各ユーザーの環境セレクターに自動的に表示されます。
• ユーザーが変更できる内容：ユーザーは管理対象の接続を選択し、その接続に対して独自の Worktree folder を設定できます。その他のフィールドを編集したり、アプリ内で削除したりすることはできません。

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519"
    }
  ]
}

ユーザーが接続できる SSH ホストを制限する

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

ジャンプホストを許可する

SSH host "bastion.example.com" is not allowed by your organization's managed settings. It is a jump host on the way to "devbox".

ローカルセッションをオフにして SSH 接続を配布する

{
  "disableDesktopLocalSessions": true,
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "dev.example.com"
    }
  ],
  "sshHostAllowlist": ["dev.example.com"]
}

• CLI：どのキーも、開発者が自分のコンピューターで Claude Code CLI を実行することを妨げません
• Cowork：どのキーも Cowork セッションや Cowork のスケジュールタスクには適用されません
• クラウドセッション：どのキーもクラウドセッションを利用できるかどうかを変更しません。クラウドセッションをオフにするには、Admin console controls の Cloud sessions 設定を使用します。

• ホスト名: sshHostAllowlist のパターンが、user@ を除いた各 sshConfigs エントリのホスト名に一致していることを確認してください。一致していないと、開発者はそのホストに接続できません。また、そこに至る途中で Desktop がチェックする各ジャンプホストに一致するパターンも追加してください。Desktop がホスト名を照合する方法については、ユーザーが接続できる SSH ホストを制限するを参照してください。
• バージョン：disableDesktopLocalSessions には Claude Desktop v1.37937.0 以降が必要です
• ファイルの権限：コンピューター上の各開発者のアカウントが管理設定ファイルを読み取れることを確認してください。アカウントが読み取れないファイル内のキーは Desktop によって適用されず、Claude Code もそれらのキーなしで起動します。

エンタープライズ設定

管理コンソールコントロール

• Desktop：組織内のユーザーがデスクトップアプリで Claude Code にアクセスできるかどうかを制御します
• Cloud sessions：組織のクラウドセッションを有効または無効にします
• Remote Control：組織のRemote Controlを有効または無効にします

管理設定

• browserExternalPageTools、disableMobileSimulatorTools、disableBrowserExternalNavigation：Claude Desktop v4.4212.0 以降が必要です
• disableRemotePreviewScripts：Claude Desktop v5.1231.0 以降が必要です

• このマシン上のローカルセッション：ディスクにデプロイされた管理設定ファイルが適用されます。管理コンソールを通じてリモートでプッシュされた管理設定は、セッションが適格なログインで認証する場合、Anthropic の API でこれらのセッションに到達します。ターミナル CLI と同じ設定の優先順位に従います。
• クラウドセッション：サーバー管理設定を受け取ります。デバイスにデプロイされたファイルはこれらのセッションに到達しません。Anthropic が管理する VM で実行されるためです。自己ホスト環境にルーティングされたセッションは、ランナーイメージ内の管理設定ファイルも読み取ります。Claude Code が管理ソースを組み合わせる方法は、そのファイルが適用される場合を示しています。
• SSH セッション：セッションはリモートホストから管理設定ファイルを読み取ります。Desktop 自体は、ローカルマシン上でsshConfigs、sshHostAllowlist、disableSshSavedPasswords、およびdisableDesktopLocalSessionsを読み取ります。複数の管理ソースを配信する場合、Desktop はデフォルトではそのうち 1 つからこれらを読み取ります。ローカルマシンで有効な管理設定でpermissions.disableBypassPermissionsModeまたはdisableAutoModeを設定すると、リモートホストの設定に関係なく、SSH セッションのモードセレクタにはそのモードが表示されません。
• Coworkセッション：このマシン上の Cowork セッションでは、ユーザーが Team または Enterprise アカウントでサインインしている場合でも、Claude Code は管理コンソール設定をフェッチしません。マシンにデプロイされたポリシーを読み取ります。ただし、Claude Desktop 設定がrequireCoworkFullVmSandboxを設定している場合を除きます。リモート Cowork セッションはどちらも受け取りません。ポリシーが適用される場所と時期を参照して、どのデバイスファイルが Cowork に到達するかを確認してください。MCP 権限ルールを参照して、BashおよびWebFetchルールが Cowork のツールにどのように適用されるかを確認してください。

Code タブで動作が異なる Claude Code 設定

デバイス管理ポリシー

• macOS：Jamf または Kandji などのツールを使用してcom.anthropic.claudefordesktopプリファレンスドメインを通じて設定します
• Windows：SOFTWARE\Policies\Claudeのレジストリを通じて設定します
• Linux：/etc/claude-desktop/managed-settings.jsonにある root 所有のファイルを通じて設定します。このファイルはポリシーキーを JSON オブジェクトとして保持します。root 以外のユーザーがファイルまたはそのフォルダに書き込める場合、Desktop はそのファイルを拒否します。これは Claude Code の管理設定ファイルとは別のファイルです。

組織へのサインインを制限する

{
  "forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

• Claude Console 組織：Claude Console 組織の ID を指定してforceLoginOrgUUIDを単独でデプロイしないでください。そうすると、組織のメンバーが Claude Desktop を使用できなくなります。代わりにWhich devices offer the Claude API account sign-inを参照してください。
• Enterprise Admin Console：これがコンピューターの Claude Desktop 設定を配信している場合は、先にそれらのコンピューターを Claude Desktop v2.37337.0 以降に更新してください。それより前のバージョンでは、このキーが設定されるとその設定が無視されるためです。Keep a device on its managed profileを参照してください。
• サードパーティプロバイダー：ユーザーがアプリ内で独自のサードパーティ推論設定を行っている場合、このキーをデプロイした後の次回起動時から、Claude Desktop はその設定を無視します。ユーザーが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または LLM ゲートウェイを引き続き使用できるようにするには、同じ Claude Desktop ポリシーで、ユーザーのコンピューターに設定をデプロイしてください。

ネットワークアクセス要件

anthropic.com
*.anthropic.com
claude.ai
*.claude.ai
claude.com
*.claude.com
claude.app
*.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

anthropic.com
api.anthropic.com
a-api.anthropic.com
a-cdn.anthropic.com
s-cdn.anthropic.com
assets-proxy.anthropic.com
claude.ai
a.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
sso.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

認証と SSO

データ処理

デプロイ

• macOS：Jamf または Kandji などの MDM を使用して.dmgインストーラーを通じて配布します
• Windows：MSIX パッケージを通じてデプロイします。サイレントインストールを含むエンタープライズデプロイのオプションについては、Deploy Claude Desktop for Windowsを参照してください。

CLI から移行する場合

claude --desktop --resume <session-id>

1. ターミナルでセッションを閉じます。
2. Desktop のプロンプトボックスで /resume と入力します。Desktop は、このコンピューターで CLI から開始したセッションをリストアップします。タイトル、フォルダ、またはブランチで検索し、各セッションがどこで終了したかをプレビューします。
3. セッションを選択します。アプリで完全な会話とコンテキストとともに続行されます。

CLI フラグの同等物

共有設定

• プロジェクト内の CLAUDE.md および CLAUDE.local.md ファイルは両方で使用されます
• ~/.claude.json または .mcp.json で設定された MCP サーバー は両方で機能します
• 設定で定義された フック および スキル は両方に適用されます
• ~/.claude.json および ~/.claude/settings.json の 設定 は共有されます。settings.json の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。一部のキーはコードタブでは異なる動作をします。
• モデル：同じモデルが両方で利用可能です。Desktop では、プロンプトボックスの下の行にあるモデルピッカーからモデルを選択します。セッション中にも同じピッカーからモデルを変更できます。

Claude Desktop チャットアプリからの MCP サーバー

機能比較

Desktop で利用できない機能

• サードパーティプロバイダー：Desktop はデフォルトで Anthropic の API に接続します。Desktop をゲートウェイ経由でルーティングするか、Code タブを Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または自己ホスト型 LLM ゲートウェイで実行するには、サードパーティプロバイダー行のリンクに従ってください。
• Linux（ベータ）：Linux デスクトップアプリではコンピューター使用はまだ利用できません。Claude Desktop on Linuxを参照してください。
• インラインコード提案：Desktop はオートコンプリートスタイルのコード補完を提供しません。会話型プロンプトと明示的なコード変更を通じて機能し、Claude の応答後に次のプロンプトを提案できます。
• エージェントチーム：Claude がチームリーダーとして共有タスクリストからチームメイトにタスクを割り当てる調整されたチームは、CLIで利用可能で、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、Desktop で実行される動的ワークフローを使用します。Claude は他のセッションに直接メッセージを送信して管理することもできます。
• ターミナルダイアログコマンド：ターミナルで対話的パネルを開く組み込みコマンドは、コードタブで異なる動作をします。設定ファイルを直接編集して権限ルールと設定を管理するか、スタンドアロン CLI からコマンドを実行します。
  • /permissions などの引数形式がないコマンドは、isn't available in this environment で応答します。
  • /config は 設定 > Code または 設定 > Claude Code を開きます。

トラブルシューティング

バージョンを確認する

• macOS：メニューバーのClaudeをクリックしてから、About Claudeをクリック
• Windows：Helpをクリックしてから、About Claudeをクリック

Code タブの Claude Code バージョン

使用しているレイアウトを確認する

• v2.37337.0 より前の Desktop：更新すると現在のレイアウトになります。macOS では Claude > Check for Updates…、Windows では Help > Check for Updates… を選択します。
• サードパーティプロバイダーでセッションをコンピューター上で実行している場合：現在のレイアウトには Claude Desktop v3.1623.0 以降が必要なため、バージョンを確認してください。更新するには、macOS では Claude > Check for Updates…、Windows では Help > Check for Updates… を選択します。組織が自動更新をオフにしている場合、Check for Updates… は非表示になるため、管理者に v3.1623.0 以降を依頼してください。
• サードパーティプロバイダーでセッションを組織のインフラストラクチャ上で実行している場合：現在のレイアウトには Claude Desktop v4.29.0 以降が必要なため、バージョンを確認してください。それより古いバージョンを使用している場合は、管理者に v4.29.0 以降を依頼してください。セッションがどこで実行されているかわからない場合は、管理者に確認してください。

Code タブの 403 またはエラー認証エラー

1. アプリメニューからサインアウトして再度サインインします。これが最も一般的な修正です。
2. アクティブな有料サブスクリプション（Pro、Max、Ultra、Team、または Enterprise）があることを確認します。
3. CLI は機能するが Desktop は機能しない場合、デスクトップアプリを完全に終了し（ウィンドウを閉じるだけではなく）、再度開いてサインインします。
4. インターネット接続とプロキシ設定を確認します。

起動時に空白または停止画面

1. アプリを再起動します。
2. 保留中の更新を確認します。macOS と Windows ではアプリは起動時に自動更新されます。Linux では、Claude Desktop on Linuxで説明されているように apt を使用して更新します。
3. マネージドネットワーク上では、ファイアウォールがネットワークアクセス要件の CDN ホストを許可していることを確認します。
4. Windows では、Windows Logs → Applicationの Event Viewer でクラッシュログを確認します。

「Failed to load session」

セッションがインストール済みツールを見つけられない

Git および Git LFS エラー

Windows で MCP サーバーが機能しない

SSH host key verification failed

• Couldn't connect to <host> カードの View details に表示される SSH host key verification failed または Host denied (verification failed)
• プロンプトボックスの横、または Test connection の後に表示される Connection failed: Host key changed or not trusted
• 切断されたセッションに表示される <host>'s host key is not trusted または <host>'s host key has changed

• Windows を使用していて、Desktop に Connection failed: Host key changed or not trusted と表示される場合：まず OpenSSH クライアントがない可能性を除外します
• Desktop が UserKnownHostsFile を設定するよう指示する場合：~/.ssh/config でこれを ~/.ssh/known_hosts に設定してから、ターミナルからキーを確認します
• Review new key ボタンが表示される場合：それを選択し、Desktop が表示するフィンガープリントをそのマシン自体のフィンガープリントと比較します。一致する場合は Trust new key を選択して保存済みのキーを置き換えます。一致しない場合は Cancel を選択します。
• Review new key ボタンが表示されない、Desktop に Couldn't show the new key と表示される、または Trust new key の後も Desktop がキーを再び拒否する場合：ターミナルからキーを確認します

ターミナルからホストキーを確認する

• ssh が接続を続行するかどうか尋ねる場合：表示されるフィンガープリントをそのマシン自体のフィンガープリントと比較します。一致する場合にのみ yes と答えます。
• ssh がホストキーが変更されたと警告する場合：警告のフィンガープリントをそのマシン自体のフィンガープリントと比較します。一致する場合にのみ、Offending <type> key in <file>:<line> が示す行を削除して ssh を再実行します。ssh が別の行について再び警告する場合は、同様に比較、削除、再実行を行います。
• ssh が尋ねることなく未知のキーを拒否する場合：そのマシンの known_hosts 行を、確認対象の接続経由ではなく、そのマシンの管理者から入手します。ssh のメッセージに含まれる名前をホスト名としてその行を known_hosts ファイルに追加し、ssh を再実行します。
• ssh がホストキーについて尋ねずにそのままサインインに進む場合：まだパスワードを入力しないでください。ssh がすでに信頼しているキーを確認します。

ssh がすでに信頼しているキーを確認する

• ジャンプホストに Server host key: 行がない場合：ssh -v -S none <jump host> も実行し、そのフィンガープリントも同じ方法で比較します。
• フィンガープリントが一致しない、または確認できない場合：再度接続しないでください。保存されているキーを削除します。Host '<name>' is known の下にある Found key in <file>:<line> 行に、そのキーを保持するファイルが示されています。ssh-keygen -R "<name>" -f <file> を実行します。ホストキーを複数のファイルに保存している場合は、それぞれのファイルからキーを削除します。ファイルを変更できない場合は、コンピューターの管理者に伝えてください。
• すべてのフィンガープリントが一致する場合：Desktop で再試行します。Desktop が再びキーを拒否する場合は、SSH の問題について Desktop のログを取得するを参照してください。

OpenSSH クライアントがない Windows で SSH ホストキーが拒否される

ログイン後に SSH 接続が失敗する

SSH の問題について Desktop のログを取得する

• macOS：Show Logs in Finder
• Windows：Show Logs in File Explorer
• Linux：Show Logs in File Manager

• remote-server.log：ヘルパーの最新の実行のログです。
• remote-server.log.old（存在する場合）：その前の実行のログです。Desktop が次回接続してヘルパーを再起動する必要が生じると失われるため、できるだけ早くコピーしてください。

アプリが終了しない

• macOS：Cmd+Q を押します。アプリが応答しない場合、Cmd+Option+Esc で Force Quit を使用し、Claude を選択して Force Quit をクリックします。
• Windows：Ctrl+Shift+Esc で Task Manager を使用して Claude プロセスを終了します。

Windows 固有の問題

• インストール後に PATH が更新されない：新しいターミナルウィンドウを開きます。PATH の更新は新しいターミナルセッションにのみ適用されます。
• 同時インストールエラー：別のインストールが進行中であるというエラーが表示されるが、実際には進行中でない場合、インストーラーを管理者として実行してみてください。

CLI で開くときに「Branch doesn’t exist yet」

git fetch origin <branch-name>
git checkout <branch-name>

まだ立ち往生していますか？

• デスクトップアプリで Help → Get Support を開くか、Claude サポートセンターに直接アクセスします
• スタンドアロンclaude CLI でも再現される問題については、GitHub Issuesでバグを検索またはファイルします