Desktop application

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

​

セッションを開始する

• 環境：Claude が実行される場所を選択します。ローカルマシンの場合はLocal、アプリを閉じた後も継続するクラウドセッションの場合はCloud、管理するリモートマシンの場合はSSH 接続を選択するか、Windows の場合はWSL ディストリビューションを選択します。SSH セッション内のタスクは Desktop が切断されている間も継続できますが、Claude アカウントを使用している場合は、サインインの有効期限が切れると停止することがあります。環境設定を参照してください。
• プロジェクトフォルダ：Claude が作業するフォルダまたはリポジトリを選択します。クラウドセッションの場合、複数のリポジトリを追加できます。
• モデル：送信ボタンの横のドロップダウンからモデルを選択します。セッション中にこれを変更できます。
• 権限モード：モードセレクタから Claude がどの程度の自律性を持つかを選択します。セッション中にこれを変更できます。

​

コードの操作

​

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

​

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

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

​

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

• @mention ファイル：@の後にファイル名を入力して、ファイルを会話コンテキストに追加します。Claude はそのファイルを読み取り、参照できます。@mention はクラウドセッションおよび WSL セッションでは利用できません。
• ファイルを添付：添付ボタンを使用するか、ファイルをプロンプトに直接ドラッグアンドドロップして、画像、PDF、およびその他のファイルをプロンプトに添付します。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。

​

権限モードを選択する

​

auto モードの利用可否

​

アプリをプレビューする

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

​

外部サイトを閲覧する

• 安全分類器は、すべての権限モードで、クリックやタイピングなど、外部ページでの 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 CI & address comments：有効にすると、Claude は失敗出力を読み取り、反復することで、失敗した CI チェックを自動的に修正しようとします。ローカルセッションでは、ユーザー以外の人が残した新しいレビューコメントにも Claude が対応します。対象となるのは、コメントの作成者がリポジトリのオーナー、組織のメンバー、コラボレーター、または GitHub App である場合です。
• Auto-merge when ready：有効にすると、Claude はすべてのチェックが成功したら PR をマージします。マージ方法はスカッシュです。先に GitHub リポジトリ設定で auto-merge を有効にしてください。有効になっていない場合、Claude は PR をマージできません。

​

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

​

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

​

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

​

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

• Attach as context：ファイルを次のプロンプトに追加
• Open in：VS Code、Cursor、Zed などのインストール済みエディタでファイルを開く
• Show in Finder（macOS）、Show in Explorer（Windows）：含まれるフォルダを開く
• Copy path：絶対パスをクリップボードにコピー

​

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

​

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

​

使用状況を確認する

​

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

​

コンピュータ使用が適用される場合

• サービスのコネクタがある場合、Claude はコネクタを使用します。
• タスクがシェルコマンドの場合、Claude は Bash を使用します。
• タスクがブラウザ作業であり、Chrome の Claudeがセットアップされている場合、Claude はそれを使用します。
• タスクが iOS アプリの実行またはテストの場合、Claude は iOS Simulator ペインを使用します。これはスクリーン制御を使用しません。
• これらのいずれも適用されない場合、Claude はコンピュータ使用を使用します。

​

コンピュータ使用を有効にする

​

アプリ権限

• Denied apps：ここにアプリを追加して、プロンプトなしで拒否します。Claude は許可されたアプリのアクションを通じて拒否されたアプリに間接的に影響を与える可能性がありますが、拒否されたアプリと直接対話することはできません。
• Unhide apps when Claude finishes：Claude が作業している間、他のウィンドウは非表示になり、承認されたアプリのみと対話します。Claude が完了すると、この設定をオフにしない限り、非表示のウィンドウが復元されます。

​

セッションを管理する

​

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

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

​

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

​

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

​

セッション間で作業する

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

​

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

​

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

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

​

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

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

• 1 つのセッション：そのセッションの Remote Control スイッチをオフにします。開始時に接続されたセッションで /remote-control と入力すると、Remote Control はオンのままとなり、Remote Control is already on. This session connected automatically when it started. と表示されます。切断するには、その行の Turn off をクリックします。
• このコンピュータ上の新しい Desktop セッション：Settings > Claude Code で Connect new sessions to Remote Control をオフにします。すでにオフと表示されている場合は、一度オンにしてからオフにすると、Desktop が選択を保存します。保存されると、remoteControlAtStartup およびデフォルトよりも優先されます。
• CLI を含む、このコンピュータ上のすべてのセッション：~/.claude/settings.json で disableRemoteControl を true に設定すると、セッションが接続されなくなります。ファイルを保存した時点ですでに接続されていたセッションは、そのセッションで Remote Control をオフにするまで接続されたままです。

​

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
    }
  ]
}

​

設定フィールド

{
  "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 は自動的に空きポートを見つけて使用します。ほとんどの dev サーバーに適しています。
• false：Claude はエラーで失敗します。OAuth コールバックまたは CORS 許可リストなど、サーバーが特定のポートを使用する必要がある場合に使用します。
• 設定されていない（デフォルト）：true の場合と同様に、サーバーには次の空きポートが割り当てられます。ただし、以下の 1 つのケースは例外です。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 ツールチェーンとネイティブパスを使用します

​

ローカルセッション

​

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

​

クラウドセッション

• 環境を追加する：Add cloud environment を選択します
• 自分の環境の 1 つを編集またはアーカイブする：それにマウスを合わせて、ギアアイコンをクリックします

​

SSH セッション

• Name：この接続のフレンドリーラベル
• SSH host：user@hostname または ~/.ssh/config で定義されたホスト
• SSH port：空のままの場合はデフォルトで 22 になるか、SSH config のポートが使用されます
• SSH key (optional)：~/.ssh/id_ed25519 などの秘密鍵へのパス。SSH config または SSH エージェントを使用するには空のままにします。
• Worktree folder：新しいセッションが worktree を作成する、リモートマシン上のフォルダ（~/worktrees など）。リモートマシンのデフォルトを使用するには空のままにします。

​

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> プロンプトが表示されます。
• 接続あたりのセッション数：macOS と Linux の Desktop は、1 つの SSH 接続で複数のセッションを開きます。サーバーの sshd_config で MaxSessions 1 が設定されている場合は、OpenSSH のデフォルトである 10 などに引き上げてください。
• インストールフォルダ：Desktop は、ホームディレクトリの ~/.claude/remote/ の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを noexec でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、リモートマシン上のファイルとプロセスを参照してください。
• シェル：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、sh と同様に、SSH 経由で送信されたコマンドを実行できる必要があります
• ネットワーク：Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには Claude Code が必要とするネットワークアクセスが必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。Linux のリモートマシンで、それらのリクエストにプロキシが必要な場合は、SSH セッション用に設定してください。

​

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

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

​

macOS と Linux で SSH 設定を使用する

• クライアントのバージョン：ssh -V を実行します。クライアントは OpenSSH 7.6 以降である必要があります。
• エントリ：ssh devbox のように、Host 名を指定して ssh を実行します。失敗する場合は、先にエントリを修正してください。

• SSH port：ここに入力した値は、エントリの Port を上書きします
• SSH key (optional)：Desktop は、エントリの IdentityFile と SSH エージェント内の鍵に加えて、選択した鍵ファイルを提示します

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

[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'"

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

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

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

• リモートマシン上のポートに接続するには：自分で転送します
• リモートマシンから自分の鍵を使用するには：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 がプロンプトなしでログインできる場合、実行中のタスクに戻れます。ログインできない場合は、メッセージを送信してください。
• 終了後、macOS または Linux の Desktop で Claude アカウントを使用している場合：Desktop がプロセスに再参加できれば、実行中のタスクに戻れます。再参加できない場合、タスクは停止します。停止したままの場合は、メッセージを送信してください。
• 終了後、Windows の Desktop またはサードパーティプロバイダーを使用している場合：Desktop はセッションを開いたときにプロセスを終了するため、実行中のタスクは失われます。続行するにはメッセージを送信してください。

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

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

• サインイントークンまたは認証情報：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 を使用するセッションでは、Desktop は Claude がファイルを編集する前に各編集をチェックします。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 にプロンプトが表示されます。

• macOS または Linux の Desktop で Claude アカウントを使用している場合：Desktop を起動してセッションを開きます。Desktop がプロセスに再参加できると、実行中のタスクに戻れます。一部の Desktop アップデートの後や、組織が管理設定を変更した後など、常に再参加できるとは限りません。
• macOS または Linux で、Desktop が再参加できない場合：Desktop はプロセスを終了し、会話の保存された履歴から新しいプロセスを開始します。実行中のタスクは停止し、待機していた承認や質問は失われます。アップデートの後は、Desktop がその後 Claude に続行を指示することがあります。タスクが停止したままの場合は、メッセージを送信してください。
• Windows の Desktop、または任意のプラットフォームでサードパーティプロバイダーを使用している場合：タスクが完了していると見込まれるときにのみ Desktop を再起動してください。Desktop は終了後に再参加することがないため、実行中のタスクには戻れません。Desktop はセッションを開いたときにプロセスを終了し、これは Desktop の起動時に発生することがあります。メッセージを送信して続行してください。

​

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

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

​

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

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

​

ログイン前に閉じる接続

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

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

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

• 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 接続を事前設定する

{
  "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 接続を配布する

{
  "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 がホスト名を照合する方法については、ユーザーが接続できる SSH ホストを制限するを参照してください。
• バージョン：disableDesktopLocalSessions には Claude Desktop v1.37937.0 以降が必要です
• ファイルの権限：コンピューター上の各開発者のアカウントが管理設定ファイルを読み取れることを確認してください。アカウントが読み取れないファイル内のキーは Desktop によって適用されず、Claude Code もそれらのキーなしで起動します。

​

エンタープライズ設定

​

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

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

​

管理設定

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

​

デバイス管理ポリシー

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

​

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

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
*.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 は設定 → Claude Code を開きます。コマンド後のテキストは無視されるため、/config theme=dark はテーマを設定しません。

​

トラブルシューティング

​

バージョンを確認する

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

​

Code タブの Claude Code バージョン

​

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

1. アプリメニューからサインアウトして再度サインインします。これが最も一般的な修正です。
2. アクティブな有料サブスクリプション（Pro、Max、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 接続が失敗する

​

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

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

​

アプリが終了しない

• 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でバグを検索またはファイルします