Desktop application
Claude Code Desktop をさらに活用する:Git 分離による並列セッション、ドラッグアンドドロップペインレイアウト、統合ターミナルとファイルエディタ、サイドチャット、コンピュータ使用、電話から Dispatch セッションを送信、ビジュアル diff レビュー、アプリプレビュー、PR 監視、コネクタ、エンタープライズ設定。
Claude Desktop アプリには 3 つのタブがあります:Chat は会話用、Cowork は Dispatch とより長い agentic work 用、Code はソフトウェア開発用です。このページは Code タブのリファレンスです。
Intel と Apple Silicon 向けのユニバーサルビルド
x64 プロセッサ向け
Ubuntu と Debian 向けの apt または .deb
Windows ARM64 の場合は、ARM64 インストーラーをダウンロードしてください。Linux では apt でインストールします。Claude Desktop on Linuxを参照してください。
インストール後、Claude を起動してサインインし、Code タブをクリックします。Windows で初めて開く場合、Git for Windows がインストールされている必要があります。インストール後、アプリを再起動してください。最初のセッションのウォークスルーについては、はじめにガイドを参照してください。
Code タブでは、各会話は セッション です:独自のチャット履歴、プロジェクトフォルダ、コード変更を持ち、他のセッションとは独立しています。サイドバーはセッションをリストアップし、複数を並列で実行できます。セッション内では以下のことができます:
- diff ビューで変更をレビューしてコメントしてから、CI を通じて結果の PR を監視
- 埋め込みブラウザで実行中のアプリをプレビューし、Claude が独自の変更を検証し、外部サイトを並べて開く
- iOS Simulator ペインで iOS アプリを実行してテストする Claude を監視
- ペインを配置して、チャット、diff、ブラウザ、ターミナル、ファイルエディタを並べて表示
- セッションのコンテキストを使用するサイド質問を尋ねて、セッションを脱線させない
- Claude に他のセッションを確認、メッセージ送信、またはアーカイブさせる
- 外部ツールを接続(GitHub、Slack、Linear など)
- Claude にアプリを開いてスクリーンを制御させる
- マシン上、クラウド上、または SSH 上で実行
スケジュール済みの定期的な作業、キーボードショートカット、または電話からタスクを送信については、リンクされたページとセクションを参照してください。既にターミナルベースの CLI を使用している場合は、CLI 比較を参照して、何が引き継がれるかを確認してください。
セッションを開始する
最初のメッセージを送信する前に、プロンプト領域で 4 つのことを設定してください:
- 環境:Claude が実行される場所を選択します。ローカルマシンの場合はLocal、クラウドセッションの場合はCloud、管理するリモートマシンの場合はSSH 接続を選択するか、Windows の場合はWSL ディストリビューションを選択します。環境設定を参照してください。
- プロジェクトフォルダ:Claude が作業するフォルダまたはリポジトリを選択します。クラウドセッションの場合、複数のリポジトリを追加できます。
- モデル:送信ボタンの横のドロップダウンからモデルを選択します。セッション中にこれを変更できます。
- 権限モード:モードセレクタから Claude がどの程度の自律性を持つかを選択します。セッション中にこれを変更できます。
タスクを入力してEnterキーを押してセッションを開始します。各セッションは独自のコンテキストと変更を追跡します。
コードの操作
Claude に適切なコンテキストを提供し、それが独立して実行する量を制御し、変更内容を確認します。
プロンプトボックスを使用する
Claude に実行させたいことを入力してEnterキーを押して送信します。Claude はプロジェクトファイルを読み取り、権限モードに基づいて変更を加えてコマンドを実行します。いつでも Claude を中断できます:停止ボタンをクリックして即座に中断するか、修正を入力してEnterキーを押して実行中のアクションを停止せずに送信します。Claude は現在のアクションが完了した後に修正を読み取り、次のステップの前に調整します。
プロンプトボックスの横の**+**ボタンをクリックすると、ファイル添付、スキル、コネクタ、およびプラグインにアクセスできます。
ファイルとコンテキストをプロンプトに追加する
プロンプトボックスは外部コンテキストを取り込む 2 つの方法をサポートしています:
- @mention ファイル:
@の後にファイル名を入力して、ファイルを会話コンテキストに追加します。Claude はそのファイルを読み取り、参照できます。@mention はクラウドセッションおよび WSL セッションでは利用できません。 - ファイルを添付:添付ボタンを使用するか、ファイルをプロンプトに直接ドラッグアンドドロップして、画像、PDF、およびその他のファイルをプロンプトに添付します。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。
権限モードを選択する
権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでもモードを切り替えることができます。権限プロンプトを削減しながら監視を維持するには、Auto に切り替えます。各変更を自分で承認するには、Manual に切り替えます。
新しいローカルセッションのデフォルトモードを設定するには、設定ファイルにpermissions.defaultModeを追加します。デスクトップアプリは CLI と同じ設定ファイルを読み取ります。セレクタで選択したモードはフォルダごとに記憶され、そのフォルダのdefaultModeより優先されます。ただし Plan は現在のセッションにのみ適用されます。
| モード | 設定キー | 動作 |
|---|---|---|
| Manual | default |
Claude はファイルの編集またはコマンドの実行の前に確認を求めます。diff を確認し、各変更を受け入れるか拒否できます。 |
| Accept edits | acceptEdits |
Claude はファイル編集とmkdir、touch、mvなどの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |
| Plan | plan |
Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |
| Auto | auto |
Claude はバックグラウンド安全チェック付きですべてのアクションを実行し、リクエストとの整合性を確認します。権限プロンプトを削減しながら監視を維持します。auto mode が利用可能な場合に表示されます。設定用の個別トグルはありません。 |
| Bypass permissions | bypassPermissions |
Claude は権限プロンプトなしで実行されます。ただし、どのモードも自動承認しないアクション、Claude が外部サイトで機能する場合の安全分類器、またはデスクトップアクション(セッションをアーカイブするなど Claude が常に最初に確認するもの)は除きます。CLI の--dangerously-skip-permissionsと同等です。Pro および Max プランでは、Settings → Claude Code の「Allow bypass permissions mode」で有効にします。Team および Enterprise プランでは設定トグルはなく、組織ポリシーで制御されます。サンドボックス化されたコンテナまたは VM でのみ使用してください。 |
Code タブの以前のバージョンでは、これらのモードを Ask permissions、Auto accept edits、および Plan mode というラベルが付けられていました。
dontAsk権限モードはCLIでのみ利用可能です。
Auto mode は Anthropic API のすべてのユーザーが利用でき、Claude Opus 4.6 以降、Sonnet 4.6 以降、またはFable モデルが必要です。組織管理者はマネージド設定のdisableAutoModeキーで auto mode をオフにできます。
Google Cloud の Agent Platform にルーティングするエンタープライズデプロイメントでは、auto mode もデフォルトで利用可能です。Bedrock、Agent Platform、または Foundry での auto mode の有効化でサポートされているモデルを参照してください。
複雑なタスクを Plan で開始して、Claude が変更を加える前にアプローチをマップアウトするようにします。プランを承認したら、Accept edits または Manual に切り替えて実行します。このワークフローの詳細については、最初に探索してからプランしてからコード化するを参照してください。
クラウドセッションは Accept edits、Plan、および Auto をサポートしています。Accept edits はdefaultモードに対応しています:クラウドセッションはファイル編集を事前に承認するため、セレクタは Manual ではなく Accept edits を表示します。Bypass permissions はクラウドセッションでは利用できません。自己ホスト環境のセッションを含みます。
エンタープライズ管理者は利用可能な権限モードを制限できます。詳細については、エンタープライズ設定を参照してください。
アプリをプレビューする
Claude は dev サーバーを起動し、Browser ペインで開いて変更を確認できます。これはフロントエンド Web アプリとバックエンドサーバーの両方で機能します:Claude は API エンドポイントをテストし、サーバーログを表示し、見つけた問題を反復処理できます。ほとんどの場合、Claude はプロジェクトファイルを編集した後、サーバーを自動的に起動します。いつでも Claude にプレビューを要求することもできます。デフォルトでは、Claude は編集後に変更を自動検証します。
Browser ペインは、プロジェクトから静的 HTML ファイル、PDF、画像、およびビデオを開くこともできます。チャットで HTML、PDF、画像、またはビデオパスをクリックして、Browser ペインで開きます。
Browser ペインから、以下を実行できます:
- Browser ペインで実行中のアプリと直接対話する
- Claude が自動的に独自の変更を検証するのを監視する:スクリーンショットを撮影し、DOM を検査し、要素をクリックし、フォームに入力し、見つけた問題を修正します
- セッションツールバーのサーバードロップダウンからサーバーを開始または停止する
- ドロップダウンでPersist sessionsを選択して、サーバーの再起動時にクッキーとローカルストレージを保持し、開発中に再度ログインする必要がないようにする
- サーバー設定を編集するか、すべてのサーバーを一度に停止する
Claude はプロジェクトに基づいて初期サーバー設定を作成します。アプリがカスタム dev コマンドを使用する場合、.claude/launch.jsonを編集してセットアップに合わせます。完全なリファレンスについては、プレビューサーバーを設定するを参照してください。
保存されたセッションデータをクリアするには、Settings → Claude Code でトグルを使用するか、Browser を完全に無効にするには、Settings → Claude Code でトグルを使用します。
外部サイトを閲覧する
Browser ペインはタブ付きブラウザなので、ドキュメント、issue トラッカー、または実行中のアプリの横に他のサイトを開くことができます。Browser を開くには、macOS でCmd+Shift+B、Windows でCtrl+Shift+Bを押すか、Viewsメニューから選択します。チャットで外部リンクをクリックすると、Browser ペインを使用するOpen in appまたは自分のブラウザを使用するDefault browserを提供するチューザーが表示されます。macOS でCmdキーを押しながらクリックするか、Windows でCtrlキーを押しながらクリックすると、システムブラウザでリンクが直接開きます。Google OAuth などのポップアップサインインフローを含む、ペインのサイトにサインインできます。
Claude はアプリを検証するために使用するのと同じツールを使用して外部ページを読み取り、対話できます。2 つの追加の安全チェックがあります:
- 安全分類器は、すべての権限モードで、クリックやタイピングなど、外部ページでの Claude の書き込みアクションを確認します。これらはauto modeが使用するのと同じ分類器であり、アクションにフラグが立てられた場合、モードに関係なく権限プロンプトが表示されます。
- Auto および Bypass permissions 以外の権限モードでは、Claude が新しいサイトに移動する前にドメイン許可リストチェックも適用されます。
サイトで Claude のアクションを承認する
Claude が外部サイトで初めてアクションを実行すると、権限カードが表示され、Claude は選択を待ちます:Allow once、Always allow、またはDeny。Allow onceは何も保存せずにアクションを承認します。Always allowはそのサイトの承認をデバイスに保存し、Settings で取り消すことができます。サブドメインを含む各サイトは独自の承認が必要です。ローカル dev サーバーとプロジェクトファイルは承認が不要なため、auto-verifyはプロンプトなしで機能し続けます。
承認されたサイトでも、Claude はあなたの入力なしに商品を購入したり、アカウントを作成したり、CAPTCHA をバイパスしたりしません。Browser ペインでの閲覧は、Claude in Chrome 拡張機能と同じ安全モデルを使用します。Claude が機密サイトとリスクのあるアクションをどのように処理するかについては、Claude in Chrome を安全に使用するを参照してください。
Browser と Chrome 拡張機能を選択する
Browser ペインは、個人用ブラウザとは別の、保存されたログインや履歴がないクリーンなブラウザプロファイルを使用します。アプリの構築とテスト、および ID が不要なサイトに使用します。Claude があなたのログイン済みセッションであなたとして機能するようにしたい場合は、代わりにブラウザのログイン状態を共有するClaude in Chrome 拡張機能を使用します。
組織の外部閲覧を制限する
Browser は、Claude in Chrome 拡張機能と同じサイト許可リストとブロックリストコントロールに従います。組織が既に拡張機能用にこれらのリストを設定している場合、Browser は自動的にそれらを尊重します。管理者は、browserExternalPageToolsマネージド設定で外部ページの Claude のツールをオフにすることもできます。ツールが無効になっている場合、ユーザーは外部サイトに移動できます。Claude のツールはそれらを読み取ったり、アクションを実行したりできません。
外部閲覧を完全に無効にするには、disableBrowserExternalNavigationマネージド設定をtrueに設定します。これは Browser 内のすべての外部ナビゲーションをブロックします。組織の許可リストのサイトを含みます。localhost dev サーバーとファイルプレビューは機能し続けます。browserExternalPageToolsを使用して、ユーザーが Claude のツールなしで外部サイトの閲覧を続けられるようにし、disableBrowserExternalNavigationを使用して、ユーザーと Claude の両方に対して外部サイトをブロックします。
diff ビューで変更を確認する
Claude がコードに変更を加えた後、diff ビューを使用して、プルリクエストを作成する前にファイルごとに変更を確認できます。
Claude がファイルを変更すると、+12 -1などの追加および削除された行数を示す diff 統計インジケータが表示されます。このインジケータをクリックして diff ビューアを開きます。左側にファイルリストが表示され、右側に各ファイルの変更が表示されます。
特定の行にコメントするには、diff 内の任意の行をクリックしてコメントボックスを開きます。フィードバックを入力してEnterキーを押してコメントを追加します。複数の行にコメントを追加した後、すべてのコメントを一度に送信します:
- macOS:Cmd+Enterを押す
- Windows:Ctrl+Enterを押す
Claude はコメントを読み取り、要求された変更を加えます。これは確認できる新しい diff として表示されます。
コードを確認する
diff ビューで、右上のツールバーのReview codeをクリックして、Claude にコミット前に変更を評価するよう依頼します。Claude は現在の diff を検査し、diff ビューに直接コメントを残します。任意のコメントに応答するか、Claude に修正を依頼できます。
レビューは高シグナル問題に焦点を当てています:コンパイルエラー、明確なロジックエラー、セキュリティ脆弱性、および明らかなバグです。スタイル、フォーマット、既存の問題、またはリンターが検出するものにはフラグを立てません。
プルリクエストステータスを監視する
プルリクエストを開いた後、CI ステータスバーがセッションに表示されます。Claude Code は GitHub CLI を使用してチェック結果をポーリングし、失敗を表示します。
- Auto-fix:有効にすると、Claude は失敗出力を読み取り、反復することで、失敗した CI チェックを自動的に修正しようとします。
- Auto-merge:有効にすると、Claude はすべてのチェックが成功したら PR をマージします。マージ方法はスカッシュです。Auto-merge がこれを機能させるためにGitHub リポジトリ設定で有効にされている必要があります。
CI ステータスバーのAuto-fixおよびAuto-mergeトグルを使用して、いずれかのオプションを有効にします。Claude Code はまた、CI が完了したときにデスクトップ通知を送信します。PR がマージまたはクローズされた後にセッションを自動的にアーカイブするには、Settings → Claude Code でauto-archiveをオンにします。
PR 監視には、GitHub CLI(gh)がマシンにインストールされ、認証されている必要があります。ghがインストールされていない場合、Desktop は PR を作成しようとする最初の時点でインストールを促します。
ワークスペースを配置する
Code タブはペインを任意のレイアウトで配置できるように構築されています:チャット、diff、ブラウザ、ターミナル、ファイル、プラン、タスク、およびサブエージェント。macOS では iOS Simulator も含まれます。ペインをヘッダーでドラッグして位置を変更するか、ペインエッジをドラッグしてサイズを変更します。macOS ではCmd+\を、Windows ではCtrl+\を押してフォーカスされたペインを閉じます。セッションツールバーのViewsメニューから追加のペインを開きます。
このセクションのペインレイアウト、ターミナル、ファイルエディタ、およびビューモードには Claude Desktop v1.2581.0 以降が必要です。macOS ではClaude → Check for Updatesを、Windows ではHelp → Check for Updatesを開いて更新してください。
ターミナルでコマンドを実行する
統合ターミナルを使用すると、別のアプリに切り替えることなく、セッションと並行してコマンドを実行できます。Viewsメニューから開くか、macOS または Windows でCtrl+`を押します。ターミナルはセッションの作業ディレクトリで開き、Claude と同じ環境を共有するため、npm testやgit statusなどのコマンドは Claude が編集しているのと同じファイルを見ます。2 番目のターミナルタブを開くには、ターミナルペインヘッダーの+をクリックするか、チャットのフォルダを右クリックしてOpen in terminalを選択します。ターミナルはローカルセッションでのみ利用可能です。
ファイルを開いて編集する
チャットまたは diff ビューアのファイルパスをクリックして、ファイルペインで開きます。HTML、PDF、画像、およびビデオパスは代わりにブラウザペインで開きます。スポット編集を行い、Saveをクリックして書き戻します。ファイルを開いてからディスク上で変更された場合、ペインは警告を表示し、オーバーライドまたは破棄できます。Discardをクリックして編集を元に戻すか、ペインヘッダーのパスをクリックして絶対パスをコピーします。
ファイルペインはローカルおよび SSH セッションで利用可能です。クラウドセッションの場合、Claude に変更を加えるよう依頼します。
ファイルを他のアプリで開く
チャット、diff ビューア、またはファイルペイン内のファイルパスを右クリックしてコンテキストメニューを開きます:
- Attach as context:ファイルを次のプロンプトに追加
- Open in:VS Code、Cursor、Zed などのインストール済みエディタでファイルを開く
- Show in Finder(macOS)、Show in Explorer(Windows):含まれるフォルダを開く
- Copy path:絶対パスをクリップボードにコピー
ビューモードを切り替える
ビューモードは、チャットトランスクリプトに表示される詳細の量を制御します。送信ボタンの横のTranscript viewドロップダウンからモードを切り替えるか、macOS または Windows でCtrl+Oを押してモードをサイクルします。
| モード | 表示内容 |
|---|---|
| Normal | ツール呼び出しは要約に折りたたまれ、完全なテキスト応答 |
| Verbose | すべてのツール呼び出し、ファイル読み取り、Claude が実行した中間ステップ |
| Summary | Claude の最終応答と加えた変更のみ |
Claude が特定のアクションを実行した理由をデバッグするときは Verbose を使用します。複数のセッションを実行していて結果をすばやくスキャンしたい場合は Summary を使用します。
キーボードショートカット
macOS でCmd+/を、Windows でCtrl+/を押して、Code タブで利用可能なすべてのショートカットを表示します。Windows では、以下のショートカットに対してCmdの代わりにCtrlを使用します。セッションサイクリング、ターミナルトグル、およびビューモードトグルはすべてのプラットフォームでCtrlを使用します。
| ショートカット | アクション |
|---|---|
Cmd / |
キーボードショートカットを表示 |
Cmd N |
新しいセッション |
Cmd W |
セッションを閉じる |
Ctrl Tab / Ctrl Shift Tab |
次または前のセッション |
Cmd Shift ] / Cmd Shift [ |
次または前のセッション |
Esc |
Claude の応答を停止 |
Cmd Shift D |
diff ペインを切り替え |
Cmd Shift B |
ブラウザペインを切り替え |
Cmd Shift S |
ブラウザで要素を選択 |
Ctrl ` |
ターミナルペインを切り替え |
Cmd \ |
フォーカスされたペインを閉じる |
Cmd ; |
サイドチャットを開く |
Ctrl O |
ビューモードをサイクル |
Cmd Shift M |
権限モードメニューを開く |
Cmd Shift I |
モデルメニューを開く |
Cmd Shift E |
努力メニューを開く |
1–9 |
開いているメニューの項目を選択 |
これらのショートカットは Code タブにのみ適用されます。ターミナルベースのインタラクティブモードショートカット(モードをサイクルするためのShift+Tabなど)は Desktop では適用されません。
使用状況を確認する
モデルピッカーの横の使用状況リングをクリックして、現在のコンテキストウィンドウ使用状況とプラン使用状況を確認します。コンテキスト使用状況はセッションごと、プラン使用状況はすべての Claude Code サーフェス全体で共有されます。
Claude にコンピュータを使用させる
コンピュータ使用により、Claude はアプリを開き、スクリーンを制御し、あなたがするのと同じ方法でマシンで直接作業できます。CLI がないデスクトップツールと対話するよう Claude に依頼したり、GUI を通じてのみ機能する何かを自動化したりしてください。iOS アプリの実行とテストの場合、Desktop はスクリーン制御の代わりに専用の iOS Simulator ペインを開きます。このペインはコンピュータ使用を有効にしなくても機能します。
コンピュータ使用は macOS と Windows の研究プレビューであり、Pro または Max プランが必要です。Team または Enterprise プランでは利用できません。Claude Desktop アプリが実行されている必要があります。
コンピュータ使用はデフォルトでオフです。設定で有効にして、Claude がスクリーンを制御する前に必要な権限を付与してください。macOS では、Accessibility と Screen Recording の権限も付与する必要があります。
サンドボックス化された Bash ツールとは異なり、コンピュータ使用は実際のデスクトップで実行され、承認したものへのアクセス権があります。Claude は各アクションをチェックし、オンスクリーンコンテンツからの潜在的なプロンプトインジェクションにフラグを立てますが、信頼境界は異なります。ベストプラクティスについては、コンピュータ使用安全ガイドを参照してください。
コンピュータ使用が適用される場合
Claude はアプリまたはサービスと対話するための複数の方法を持ち、コンピュータ使用は最も広範で最も遅いです。最も正確なツールを最初に試します:
- サービスのコネクタがある場合、Claude はコネクタを使用します。
- タスクがシェルコマンドの場合、Claude は Bash を使用します。
- タスクがブラウザ作業であり、Chrome の Claudeがセットアップされている場合、Claude はそれを使用します。
- タスクが iOS アプリの実行またはテストの場合、Claude は iOS Simulator ペインを使用します。これはスクリーン制御を使用しません。
- これらのいずれも適用されない場合、Claude はコンピュータ使用を使用します。
アプリごとのアクセス層はこれを強化します:ブラウザはビューのみに制限され、ターミナルと IDE はクリックのみに制限され、Claude をコンピュータ使用がアクティブな場合でも専用ツールに向けます。スクリーン制御は、ネイティブアプリ、ハードウェア制御パネル、または API のない独自ツールなど、他に何も到達できないものに予約されています。
コンピュータ使用を有効にする
コンピュータ使用はデフォルトでオフです。それが必要な何かをするよう Claude に依頼し、それがオフの場合、Claude は Settings でコンピュータ使用を有効にすれば、タスクを実行できることを伝えます。
デスクトップアプリを更新する
Claude Desktop の最新バージョンがあることを確認してください。macOS と Windows では、claude.com/downloadでダウンロードまたは更新してください。Linux では、パッケージマネージャーを通じて更新してください(手順)。その後、アプリを再起動します。
トグルをオンにする
デスクトップアプリで、Settings > General(Desktop appの下)に移動します。Computer useトグルを見つけてオンにします。Windows では、トグルはすぐに有効になり、セットアップは完了です。macOS では、次のステップに進みます。
トグルが表示されない場合は、macOS または Windows で Pro または Max プランを使用していることを確認してから、アプリを更新して再起動します。
macOS 権限を付与する
macOS では、トグルが有効になる前に 2 つのシステム権限を付与します:
- Accessibility:Claude がクリック、入力、スクロールできるようにします
- Screen Recording:Claude がスクリーンに表示されているものを見ることができるようにします
Settings ページは各権限の現在のステータスを表示します。いずれかが拒否されている場合、バッジをクリックして関連するシステム設定ペインを開きます。
アプリ権限
Claude が初めてアプリを使用する必要がある場合、セッションにプロンプトが表示されます。Allow for this sessionまたはDenyをクリックします。承認は現在のセッション、またはDispatch が生成したセッションでは 30 分間有効です。
プロンプトは、Claude がそのアプリに対して取得するコントロールのレベルも表示します。これらの層はアプリカテゴリによって固定され、変更できません:
| 層 | Claude ができること | 適用対象 |
|---|---|---|
| ビューのみ | スクリーンショットでアプリを見る | ブラウザ、取引プラットフォーム |
| クリックのみ | クリックとスクロール、ただし入力またはキーボードショートカットは不可 | ターミナル、IDE |
| フルコントロール | クリック、入力、ドラッグ、キーボードショートカットの使用 | その他すべて |
Terminal、Finder または File Explorer、System Settings または Settings などの広範なリーチを持つアプリは、承認が何を付与するかを知るようにプロンプトに追加の警告を表示します。
Settings > General(Desktop appの下)で 2 つの設定を設定できます:
- Denied apps:ここにアプリを追加して、プロンプトなしで拒否します。Claude は許可されたアプリのアクションを通じて拒否されたアプリに間接的に影響を与える可能性がありますが、拒否されたアプリと直接対話することはできません。
- Unhide apps when Claude finishes:Claude が作業している間、他のウィンドウは非表示になり、承認されたアプリのみと対話します。Claude が完了すると、この設定をオフにしない限り、非表示のウィンドウが復元されます。
セッションを管理する
各セッションは独立した会話であり、独自のコンテキストと変更があります。複数のセッションを並列で実行するか、サイドチャットを分岐させるか、Claude に他のセッションをチェックしてメッセージを送信させるか、作業をクラウドに送信するか、Dispatch にセッションを電話から開始させることができます。
セッションで並列に作業する
サイドバーの**+ New sessionをクリックするか、macOS でCmd+Nを、Windows でCtrl+Nを押して、複数のタスクを並列で作業します。Ctrl+TabとCtrl+Shift+Tab**を押してサイドバーのセッションをサイクルします。Git リポジトリの場合、各セッションはGit worktreesを使用してプロジェクトの独立した分離コピーを取得するため、1 つのセッションの変更は、コミットするまで他のセッションに影響しません。
2 つのセッションを同時に表示するには、macOS でCmdを、Windows でCtrlを押しながらサイドバーのセッションをクリックします。セッションは既に開いているセッションの横の 2 番目のペインで開きます。分割がアクティブな間、別のサイドバーセッションをクリックすると、フォーカスがあるペインが置き換わります。macOS で**Cmd+\を、Windows でCtrl+\**を押して、フォーカスされたペインを閉じて、単一のセッションに戻ります。
Worktrees はデフォルトで<project-root>/.claude/worktrees/に保存されます。Settings → Claude Code の「Worktree location」でカスタムディレクトリに変更できます。また、すべての worktree ブランチ名の前に付加されるブランチプレフィックスを設定することもできます。これは Claude が作成したブランチを整理するのに便利です。完了したら、サイドバーのセッションにマウスを合わせてアーカイブアイコンをクリックして worktree を削除します。PR がマージまたはクローズされた後にセッションを自動的にアーカイブするには、Settings → Claude Code でAuto-archive after PR merge or closeをオンにします。Auto-archive はローカルセッションで実行が完了したものにのみ適用されます。
gitignored ファイル(.envなど)を新しい worktrees に含めるには、プロジェクトルートに.worktreeincludeファイルを作成します。
セッション分離にはGitが必要です。ほとんどの Mac には Git がデフォルトで含まれています。Terminal でgit --versionを実行して確認してください。バージョン番号が表示されれば、Git がインストールされています。Windows では、Code タブが機能するために Git が必要です:Git for Windows をダウンロードし、インストールしてアプリを再起動します。Git エラーが発生した場合は、Cowork タブで Claude に助けを求めてセットアップのトラブルシューティングを行ってください。
サイドバーの上部のコントロールを使用して、ステータス、プロジェクト、または環境でセッションをフィルタリングし、プロジェクトでセッションをグループ化します。セッション名を変更するには、アクティブセッションの上部のツールバーのセッションタイトルをクリックします。
コンテキスト使用状況を確認するには、使用状況を確認するを参照してください。コンテキストがいっぱいになると、Claude は自動的に会話を要約して作業を続けます。/compactを入力して要約をより早くトリガーし、コンテキストスペースを解放することもできます。コンテキストウィンドウを参照して、圧縮がどのように機能するかについての詳細を確認してください。
デスクトップアプリは、Code セッションがタスクを完了し、現在そのセッションを表示していない場合に OS 通知を送信します。
メインセッションを脱線させずにサイドクエスチョンを尋ねる
サイドチャットを使用すると、セッションのコンテキストを使用するが、メインの会話に何も追加しない質問を Claude に尋ねることができます。コードの一部を理解したい、仮定を確認したい、またはセッションを脱線させずにアイデアを探索したい場合に使用します。
macOS で**Cmd+;を、Windows でCtrl+;**を押してサイドチャットを開くか、プロンプトボックスで/btwを入力します。サイドチャットはその時点までのメインスレッドのすべてを読み取ることができます。完了したら、サイドチャットを閉じてメインセッションを続行します。
サイドチャットはローカル、SSH、および WSL セッションで利用可能です。デスクトップアプリはサイドチャットをディスクに保存しないため、アプリを閉じた後に戻ることはできません。
バックグラウンドタスクを監視する
タスクペインは、現在のセッション内で実行されているバックグラウンド作業を表示します:サブエージェント、バックグラウンドシェルコマンド、および動的ワークフロー。Viewsメニューから開くか、レイアウトにドラッグします。
任意のエントリをクリックして、サブエージェントペインで出力を確認するか、停止します。他のセッションが何をしているかを確認するには、サイドバーを使用するか、Claude にそれらをチェックしてもらうことができます。
セッション間で作業する
Claude はあなたの他の Code タブセッションをリストアップし、各セッションが何をしてきたかを読み取り、セッション間でメッセージを送信できます。平易な言語で尋ねてください:「どのセッションが認証リファクタリングに触れましたか?」、「API セッションは何を結論づけましたか?」、または「支払いセッションにスキーマが変更されたことを伝えてください」。また、Claude にセッションの名前変更またはアーカイブを依頼することもできます。Claude はサイドバーのアーカイブアイコンと同じ方法でセッションをアーカイブするため、PR がマージされたセッションをクリーンアップするよう依頼してください。
このサーフェスを通じて、Claude はデスクトップアプリが自身で実行するセッションのみを見ます:ローカル、SSH、および Code タブのWSLセッション。Claude はクラウドセッション、またはターミナル CLI または VS Code 拡張機能から開始したセッションを見ません。同じプロジェクトの worktrees にあっても見ません。そのため、9 つのターミナル worktrees が開いていて 2 つのデスクトップセッションがある場合、それらの 1 つで回答する Claude は他の 1 つのデスクトップセッションを報告します。Claude は質問しているセッションをリストアップしません。デフォルトでは、最近アクティブな 20 個のセッションを見て、アーカイブされたセッションをスキップします。ただし、それらを要求する場合を除きます。クロスセッションメッセージングは、Claude があなたの他の Claude Code セッション(ターミナルセッションを含む)にメッセージを送信することを別途許可します。
Claude がこのサーフェスを通じて別のセッションにメッセージを送信する場合、Claude Code はそこにカードとして表示され、送信セッションのタイトルでラベル付けされ、戻るリンクが付いているため、メッセージがどこから来たかを常に知ることができます。受信セッションがタスクの途中にある場合、Claude Code はメッセージを保持し、Claude は現在の作業が完了したら読み取ります。受信する Claude は返信でき、Claude Code はこのサーフェスを通じて返信を配信します。Claude はアーカイブされたセッションに配信できず、メッセージが通らない場合はあなたに通知します。
Claude Code はセッション間で 4 つの安全動作を適用します:
- セッションをアーカイブする前に、Claude はまずあなたに尋ねます。Auto および Bypass 権限を含むすべての権限モードで承認カードが表示されます。
- このサーフェスを通じて、Claude はスケジュール済みタスク実行など、誰も見ていないセッションからクロスセッションメッセージを送信できず、1 つに配信することもできません。
- Claude Code は、受信セッションがクロスセッションメッセージング自体を持たない場合でも、このサーフェスからの各メッセージを受信セッションのインバウンドコントロールに対してチェックします。受信セッションで
crossSessionInboundをrefuseに設定した場合、Claude Code はこのサーフェスからのメッセージをドロップします。Claude Code は拒否を Claude デスクトップアプリに報告します。v2.1.234 より前では、Claude Code はこのサーフェスからクロスセッションメッセージングを持たない受信セッションへのすべてのメッセージをドロップしました。 - Claude Code は各受信メッセージを引用し、それを送信したセッションに属性を付け、Claude は受信セッション自体の権限設定に従って 1 つに対して行動します。
Claude は新しいセッションを提案することもできます。現在のタスクの範囲外で修正する価値があるものに気付くと、作業をチャットのタスクチップとして提供します。チップをクリックして、独自の worktree を持つ新しいセッションでその作業を開始します。Claude は現在のセッションを中断なく続行します。
長時間実行されるタスクをリモートで実行する
大規模なリファクタリング、テストスイート、マイグレーション、またはその他の長時間実行されるタスクの場合、セッションを開始するときにLocalの代わりにCloudを選択します。Cloud セッションはデフォルトで Anthropic が管理するインフラストラクチャで実行され、アプリを閉じたりコンピュータをシャットダウンしたりしても続行します。いつでも戻ってきて進捗を確認するか、Claude を別の方向に導くことができます。claude.ai/codeまたはClaude モバイルアプリから Cloud セッションを監視することもできます。
Cloud セッションは複数のリポジトリもサポートしています。クラウド環境を選択した後、リポジトリピルの横の**+**ボタンをクリックして、セッションに追加のリポジトリを追加します。各リポジトリは独自のブランチセレクタを取得します。これは共有ライブラリとそのコンシューマーの更新など、複数のコードベースにまたがるタスクに便利です。
Cloud セッションがどのように機能するかについての詳細については、Web 上の Claude Codeを参照してください。
別のサーフェスで続行する
セッションツールバーの右下の VS Code アイコンからアクセスできるContinue inメニューを使用すると、セッションを別のサーフェスに移動できます:
- Claude Code on the Web:ローカルセッションをリモートで実行し続けるために送信します。Desktop はブランチをプッシュし、会話の要約を生成し、完全なコンテキストを持つ新しい Cloud セッションを作成します。その後、ローカルセッションをアーカイブするか保持するかを選択できます。これはクリーンなワーキングツリーが必要であり、SSH セッションでは利用できません。
- Your IDE:現在の作業ディレクトリでサポートされている IDE でプロジェクトを開きます。
Dispatch からのセッション
Dispatchは、Coworkタブに存在する Claude との永続的な会話です。Dispatch にタスクをメッセージで送信すると、それをどのように処理するかを決定します。
タスクは 2 つの方法で Code セッションになります:「Claude Code セッションを開いてログインバグを修正する」など直接要求するか、Dispatch がタスクが開発作業であると判断して自動的に生成するかです。通常 Code にルーティングされるタスクには、バグの修正、依存関係の更新、テストの実行、またはプルリクエストの開くが含まれます。研究、ドキュメント編集、スプレッドシート作業は Cowork に留まります。
どちらの方法でも、Code セッションは Code タブのサイドバーにDispatchバッジ付きで表示されます。完了したときまたは承認が必要なときに、電話でプッシュ通知を受け取ります。
コンピュータ使用が有効な場合、Dispatch が生成した Code セッションもそれを使用できます。これらのセッションのアプリ承認は 30 分後に期限切れになり、通常の Code セッションのようにセッション全体を続けるのではなく、再度プロンプトが表示されます。
セットアップ、ペアリング、Dispatch 設定については、Dispatch ヘルプ記事を参照してください。Dispatch には Pro または Max プランが必要であり、Team または Enterprise プランでは利用できません。
Dispatch は、ターミナルから離れているときに Claude で作業する複数の方法の 1 つです。他のオプションとの比較については、プラットフォームと統合を参照してください。
Claude Code を拡張する
外部サービスを接続し、再利用可能なワークフローを追加し、Claude の動作をカスタマイズし、プレビューサーバーを設定します。コネクタ、スキル、プラグインを 1 か所で管理するには、サイドバーのCustomizeをクリックします。Desktop アプリの Cowork タブは、CLI の ~/.claude ディレクトリではなく、この Customize 設定からスキル、プラグイン、コネクタをソースとし、claude.ai アカウント経由で同期します。
外部ツールを接続する
ローカルおよび SSH セッションの場合、プロンプトボックスの横の**+ボタンをクリックしてConnectorsを選択し、Google Calendar、Slack、GitHub、Linear、Notion などの統合を追加します。セッションの前または中にコネクタを追加できます。+**ボタンはクラウドセッションおよび WSL セッションでは利用できませんが、ルーチンはルーチン作成時にコネクタを設定します。
コネクタを管理または切断するには、デスクトップアプリの Settings → Connectors に移動するか、プロンプトボックスの Connectors メニューからManage connectorsを選択します。
接続すると、Claude はカレンダーを読み取り、メッセージを送信し、問題を作成し、ツールと直接対話できます。セッションで設定されているコネクタについて Claude に尋ねることができます。
コネクタは MCP サーバーであり、グラフィカルセットアップフローを備えています。サポートされているサービスとの迅速な統合に使用します。Connectors にリストされていない統合の場合、設定ファイルを介して MCP サーバーを手動で追加します。また、カスタムコネクタを作成することもできます。
スキルを使用する
スキルは Claude ができることを拡張します。Claude は関連する場合に自動的にロードするか、直接呼び出すことができます:プロンプトボックスで / を入力するか、+ボタンをクリックしてSlash commandsを選択して、利用可能なものを参照します。これには 組み込みコマンド、カスタムスキル、コードベースからのプロジェクトスキル、および インストール済みプラグインからのスキルが含まれます。1 つを選択すると、入力フィールドで強調表示されます。その後にタスクを入力して、通常どおり送信します。
Claude が作業中でも、他のメッセージと同じようにコマンドを送信でき、ターンが終了するとセッションはアイドル状態に戻ります。v2.1.206 より前では、ターン中に送信されたコマンドはセッションを実行中として表示したままにし、その後に送信したメッセージは配信されませんでした。
~/.claude/skills/ 内のパーソナルスキルはローカルセッションに適用されます。SSH セッションは、マシンからではなく、リモートホストのホームディレクトリから ~/.claude/skills/ を読み取ります。クラウドセッションは、代わりに claude.ai アカウント用に有効化されたスキルをロードします。Cowork およびクラウドセッションのスキルを参照してください。
プラグインをインストールする
プラグインは、スキル、エージェント、hooks、MCP サーバー、および LSP 設定を Claude Code に追加する再利用可能なパッケージです。ターミナルを使用せずにデスクトップアプリからプラグインをインストールできます。
ローカルおよび SSH セッションの場合、プロンプトボックスの横の**+ボタンをクリックしてPluginsを選択して、インストール済みプラグインとそのスキルを確認します。プラグインを追加するには、サブメニューからAdd plugin**を選択してプラグインブラウザを開きます。これは、公式 Anthropic マーケットプレイスを含む、設定された マーケットプレイスから利用可能なプラグインを表示します。Manage pluginsを選択して、プラグインを有効化、無効化、またはアンインストールします。
プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI と同じ方法で Desktop セッションで利用可能です。
プラグインブラウザはクラウドセッションでは利用できず、デスクトップアプリからインストールしたプラグインはクラウドセッションでは利用できません。クラウドセッションでプラグインを使用するには、リポジトリの .claude/settings.json の enabledPlugins で宣言して Claude Code が セッション開始時にインストールするか、claude.ai アカウント用に有効化して Claude Code が 同期されたプラグインとしてロードするようにします。プラグインは WSL セッションでは利用できません。プラグインの作成を含む完全なプラグインリファレンスについては、プラグインを参照してください。
プレビューサーバーを設定する
Claude は dev サーバーセットアップを自動的に検出し、セッションを開始するときに選択したフォルダのルートの .claude/launch.json に設定を保存します。Preview はこのフォルダを作業ディレクトリとして使用するため、親フォルダを選択した場合、独自の dev サーバーを持つサブフォルダは自動的に検出されません。サブフォルダのサーバーで作業するには、そのフォルダで直接セッションを開始するか、設定を手動で追加します。
サーバーの起動方法をカスタマイズするには、たとえば npm run dev の代わりに yarn dev を使用するか、ポートを変更するには、ファイルを手動で編集するか、サーバードロップダウンのEdit configurationをクリックしてコードエディタで開きます。ファイルはコメント付き JSON をサポートしています。
{
"version": "0.0.1",
"configurations": [
{
"name": "my-app",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 3000
}
]
}
同じプロジェクトから異なるサーバーを実行するために複数の設定を定義できます。たとえば、フロントエンドと API です。以下の 例を参照してください。
変更を自動検証する
autoVerify が有効な場合、Claude はファイルを編集した後、コード変更を自動的に検証します。スクリーンショットを撮影し、エラーをチェックし、応答を完了する前に変更が機能することを確認します。
Auto-verify はデフォルトで有効です。.claude/launch.json に "autoVerify": false を追加してプロジェクトごとに無効にするか、サーバードロップダウンメニューから切り替えます。
{
"version": "0.0.1",
"autoVerify": false,
"configurations": [
{
"name": "my-app",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 3000
}
]
}
無効にすると、プレビューツールは引き続き利用可能であり、いつでも Claude に検証を依頼できます。Auto-verify は編集後に自動的に実行します。
設定フィールド
configurations 配列の各エントリは、以下のフィールドを受け入れます:
| フィールド | 型 | 説明 |
|---|---|---|
name |
string | このサーバーの一意の識別子 |
runtimeExecutable |
string | 実行するコマンド(npm、yarn、node など) |
runtimeArgs |
string[] | runtimeExecutable に渡される引数(["run", "dev"] など) |
port |
number | サーバーがリッスンするポート。デフォルトは 3000 |
cwd |
string | プロジェクトルートに相対的な作業ディレクトリ。デフォルトはプロジェクトルート。プロジェクトルートを明示的に参照するには ${workspaceFolder} を使用します |
env |
object | { "NODE_ENV": "development" } などのキーと値のペアとしての追加環境変数。このファイルはリポジトリにコミットされるため、ここにシークレットを入れないでください。dev サーバーにシークレットを渡すには、ローカル環境エディタで設定します。 |
autoPort |
boolean | ポート競合の処理方法。以下を参照してください |
program |
string | node で実行するスクリプト。program と runtimeExecutable を使用する場合を参照してください |
args |
string[] | program に渡される引数。program が設定されている場合のみ使用されます |
url |
string | http://localhost:<port> の代わりにプレビューが開くアドレス。特定の URL でプレビューを開くを参照してください |
`program` と `runtimeExecutable` を使用する場合
runtimeExecutable を runtimeArgs と共に使用して、パッケージマネージャーを通じて dev サーバーを起動します。たとえば、"runtimeExecutable": "npm" と "runtimeArgs": ["run", "dev"] は npm run dev を実行します。
node で直接実行したいスタンドアロンスクリプトがある場合は program を使用します。たとえば、"program": "server.js" は node server.js を実行します。args で追加フラグを渡します。
特定の URL でプレビューを開く
デフォルトでは、プレビューは http://localhost:<port> を開きます。サーバーが別のアドレスを必要とする場合は url を設定します。一般的なケースは、ローカル HTTPS が必要なサーバー、*.localhost サブドメインを使用するアプリ、およびリダイレクトを通じてサインインするアプリです。
{
"version": "0.0.1",
"configurations": [
{
"name": "my-app",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"port": 8443,
"url": "https://localhost:8443"
}
]
}
Localhost アドレスは直接開き、デフォルトのポートアドレスとまったく同じです。これには localhost、任意の *.localhost サブドメイン、127.0.0.1、および ::1 が含まれます。セキュリティのため、localhost url はサーバーのオリジンのみである必要があります。パスやクエリはなく、ポートはエントリのポートと一致する必要があります。特定のページを表示するには、プレビューが開いた後、Claude にそこに移動するよう依頼します。パス、クエリ、または一致しないポートを持つ localhost url は、url を名前付けして修正を表示する設定エラーとして報告されます。
他のアドレスの場合、Desktop はプレビューが初めてそれを開くときに許可を求めます。これは、プレビューで新しいサイトを閲覧するときと同じです。外部アドレスはパスを含む場合があります。Always allowを選択して、将来そのサイトのプロンプトをスキップします。プレビューで外部サイトを制限する組織ポリシーは引き続き適用されます。
既に自分で実行しているサーバーをプレビューするには、コマンドなしで url を設定します。Claude はサーバーを起動する代わりに、実行中のサーバーにプレビューを接続します:
{
"version": "0.0.1",
"configurations": [
{
"name": "my-app",
"url": "https://app.localhost:3000"
}
]
}
url は http または https である必要があり、ユーザー名またはパスワードを含まない必要があります。
ポート競合
autoPort フィールドは、優先ポートが既に使用されている場合の処理を制御します:
true:Claude は自動的に空きポートを見つけて使用します。ほとんどの dev サーバーに適しています。false:Claude はエラーで失敗します。OAuth コールバックまたは CORS 許可リストなど、サーバーが特定のポートを使用する必要がある場合に使用します。- 設定されていない(デフォルト):Claude はサーバーがそのポートを必要とするかどうかを尋ねてから、答えを保存します。
Claude が別のポートを選択すると、割り当てられたポートを PORT 環境変数を通じてサーバーに渡します。
例
これらの設定は、異なるプロジェクトタイプの一般的なセットアップを示しています:
この設定は、Yarn を使用してポート 3000 で Next.js アプリを実行します:
{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}
フロントエンドと API サーバーを持つモノレポの場合、複数の設定を定義します。フロントエンドは autoPort: true を使用して、3000 が使用されている場合は空きポートを選択し、API サーバーはポート 8080 を正確に必要とします:
{
"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
}
]
}
パッケージマネージャーコマンドを使用する代わりに Node.js スクリプトを直接実行するには、program フィールドを使用します:
{
"version": "0.0.1",
"configurations": [
{
"name": "server",
"program": "server.js",
"args": ["--verbose"],
"port": 4000
}
]
}
環境設定
セッションを開始するときに選択する環境は、Claude が実行される場所と接続方法を決定します:
- Local:マシンで実行され、ファイルに直接アクセスできます
- Cloud:デフォルトで Anthropic が管理するインフラストラクチャで実行されます。アプリを閉じても、セッションは続行されます。
- SSH:SSH 経由で接続するリモートマシンで実行されます。たとえば、独自のサーバー、クラウド VM、または dev コンテナなどです。
- WSL(Windows):マシン上の WSL 2 ディストリビューション内で実行され、その Linux ツールチェーンとネイティブパスを使用します
ローカルセッション
デスクトップアプリは常にシェル環境全体を継承するわけではありません。macOS では、Dock または Finder からアプリを起動すると、~/.zshrc または ~/.bashrc などのシェルプロファイルを読み取り、PATH と固定された Claude Code 変数セットを抽出しますが、そこでエクスポートする他の変数は取得されません。Windows では、アプリはユーザーおよびシステム環境変数を継承しますが、PowerShell プロファイルは読み取りません。
ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、Local にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、~/.claude/settings.json ファイルの env キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、環境変数を参照してください。
拡張思考はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。Anthropic API では、ローカル環境エディタで MAX_THINKING_TOKENS を 0 に設定して思考をオフにします。これは Fable モデルには効果がなく、常に拡張思考を使用します。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などのその組み合わせを受け入れないことが分かっているモデルに、より高いレベルではなく effort high を送信します。
適応的推論を持つモデルでは、適応的推論が思考の深さを制御するため、0 以外の MAX_THINKING_TOKENS 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING を 1 に設定します。Fable モデル、Sonnet 5、および Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。
管理デバイス上のローカルセッション
管理者は disableDesktopLocalSessions 管理設定でローカルセッションをオフにできます。オフにされた場合、Local は環境ドロップダウンに留まりますが、グレーアウトされて選択できず、組織がオフにしたことを示すツールチップが表示されます。Windows では、WSL エントリも、管理デバイスでの可用性が別途管理される場合、同じようにグレーアウトされます。新しいセッションは、SSH 接続が設定されている場合、最初の SSH 接続にデフォルト設定されます。Desktop は、既存のセッションを続行しようとした場合、このデバイスではローカルセッションが利用できないというメッセージを表示します。代わりに SSH または Cloud 環境を選択するか、IT チームに連絡してください。
クラウドセッション
クラウドセッションはアプリを閉じても、バックグラウンドで続行されます。使用状況はサブスクリプションプランの制限にカウントされ、別の計算料金はありません。
異なるネットワークアクセスレベルと環境変数を持つカスタムクラウド環境を作成できます。クラウドセッションを開始するときに、プロンプトボックスの環境ドロップダウンを開いてそれらを管理します:
- 環境を追加する:Add cloud environment を選択します
- 自分の環境の 1 つを編集またはアーカイブする:それにマウスを合わせて、ギアアイコンをクリックします
ネットワークアクセスと環境変数の設定の詳細については、クラウド環境を設定するを参照してください。
SSH セッション
SSH セッションを使用すると、デスクトップアプリをインターフェイスとして使用しながら、リモートマシンで Claude Code を実行できます。これは、クラウド VM、dev コンテナ、または特定のハードウェアまたは依存関係を持つサーバーに存在するコードベースで作業するのに便利です。
SSH 接続を追加するには、セッションを開始する前に環境ドロップダウンをクリックして、+ Add SSH connection を選択します。ダイアログは以下を要求します:
- Name:この接続のフレンドリーラベル
- SSH Host:
user@hostnameまたは~/.ssh/configで定義されたホスト - SSH Port:空のままの場合はデフォルトの 22、または SSH config からのポート
- Identity File:
~/.ssh/id_rsaなどの秘密鍵へのパス。デフォルトキーまたは SSH config を使用するには空のままにします。
追加されると、接続は環境ドロップダウンに表示されます。それを選択して、そのマシンでセッションを開始します。Claude はリモートマシンで実行され、そのファイルとツールにアクセスできます。
リモートマシンは Linux または macOS を実行する必要があります。Desktop は初回接続時にリモートマシンに Claude Code を自動的にインストールします。接続されると、SSH セッションは権限モード、コネクタ、プラグイン、および MCP サーバーをサポートします。
チームの SSH 接続を事前設定する
管理者は、管理設定ファイルに sshConfigs を追加することで、SSH 接続をチームメンバーに配布できます。この方法で定義された接続は、各ユーザーの環境ドロップダウンに自動的に表示され、管理対象として表示されるため、ユーザーはそれらを選択できますが、アプリで編集または削除することはできません。
次の例は、単一の接続を事前設定しています:
{
"sshConfigs": [
{
"id": "shared-dev-vm",
"name": "Shared Dev VM",
"sshHost": "user@dev.example.com",
"sshPort": 22,
"sshIdentityFile": "~/.ssh/id_ed25519"
}
]
}
各エントリには id、name、および sshHost が必要です。sshPort および sshIdentityFile フィールドはオプションです。ユーザーは、ダイアログを通じて追加された接続が保存される独自の ~/.claude/settings.json に sshConfigs を追加することもできます。
ユーザーが接続できる SSH ホストを制限する
管理者は、管理設定ファイルに sshHostAllowlist を追加することで、Desktop の SSH セッションを承認されたホストのセットに制限できます。設定されると、ユーザーは解決されたホスト名がパターンの 1 つと一致するホストにのみ接続できます。SSH セッションを完全に無効にするには、空の配列に設定します。
次の例は、devboxes.example.com の下のすべてのホストと、単一の名前付きバスティオンホストへの接続を許可しています:
{
"sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}
パターンは大文字と小文字を区別しません。* はすべてのホストと一致し、*.example.com は example.com とすべてのサブドメインと一致します。その他はすべて完全一致です。チェックは ssh -G を経由した ~/.ssh/config 解決後のホスト名に対して実行されるため、Host エイリアスと ProxyCommand/ProxyJump エントリは、解決された HostName が一致する限り許可されます。
sshHostAllowlist は管理設定からのみ読み取られます。ユーザーまたはプロジェクト設定の値は無視されます。Claude Desktop アプリのみがこの設定を尊重します。Claude Code CLI と IDE 拡張機能はこれを読み取らず、Bash ツールを通じて実行される ssh コマンドを制限しません。これは Desktop アプリが接続するホストを管理し、ネットワーク出力ではないため、ハード境界が必要な場合は組織のネットワークまたはゼロトラストコントロールと組み合わせてください。
エンタープライズ設定
Team または Enterprise プランの組織は、管理コンソールコントロール、管理設定ファイル、およびデバイス管理ポリシーを通じてデスクトップアプリの動作を管理できます。
管理コンソールコントロール
これらの設定は管理設定コンソールを通じて設定されます:
- Code in the desktop:組織内のユーザーがデスクトップアプリで Claude Code にアクセスできるかどうかを制御します
- Code in the web:組織のWeb セッションを有効または無効にします
- Remote Control:組織のRemote Controlを有効または無効にします
- Disable Bypass permissions mode:組織内のユーザーが bypass permissions モードを有効にするのを防ぎます
管理設定
管理設定はプロジェクトおよびユーザー設定をオーバーライドし、Desktop の Claude Code セッションに適用されます。これらのキーを組織の管理設定ファイルで設定するか、管理コンソールを通じてリモートでプッシュできます。
| キー | 説明 |
|---|---|
permissions.disableBypassPermissionsMode |
ユーザーが Bypass permissions モードを有効にするのを防ぐには"disable"に設定します。 |
disableAutoMode |
Autoモードをモードセレクタから削除するには"disable"に設定します。permissionsの下でも受け入れられます。 |
autoMode |
組織全体で auto mode 分類器が信頼およびブロックするものをカスタマイズします。auto mode を設定するを参照してください。 |
browserExternalPageTools |
Claude がBrowser ペインの外部ページを読み取るまたは操作するためのツールを使用するのを防ぐには"disabled"に設定します。ユーザーは引き続き外部サイトに自分でナビゲートできます。ローカル開発サーバープレビューは影響を受けません。 |
disableMobileSimulatorTools |
Claude のiOS Simulator ペインでデバイスを制御およびキャプチャするためのツールをブロックするにはtrueに設定します。ペインはユーザー自身のタップに対して使用可能なままです。Claude のアクセスのみが削除されます。 |
disableBrowserExternalNavigation |
Browser ペインの外部ブラウジングを完全にオフにするにはtrueに設定します。ユーザーも Claude も外部サイトにナビゲートできません。localhost 開発サーバープレビューは影響を受けません。値は JSON ブール値trueである必要があります。文字列"true"は無視されます。 |
sshConfigs |
環境ドロップダウンに表示されるSSH 接続を事前設定します。ユーザーは管理接続を編集または削除できません。 |
sshHostAllowlist |
SSH セッションを、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。空の配列は SSH セッションを無効にします。管理設定からのみ読み取られます。 |
disableDesktopLocalSessions |
デバイスで実行されるコードセッションをオフにするにはtrueに設定します。SSH セッションから他のホストへのセッションとクラウドセッションは利用可能なままです。値は JSON ブール値trueである必要があります。管理設定からのみ読み取られます。Claude Desktop v1.37937.0 以降が必要です。 |
managedMcpServers |
MCP サーバー設定をすべてのユーザーにプッシュします。サードパーティ(3P)Desktop デプロイメントでのみ利用可能です。各エントリで、"http"、"sse"、または"stdio"のトランスポート、接続詳細、およびオプションで、そのサーバーのどのツールをユーザーが呼び出せるかを制限するtoolPolicyマップを設定します。管理設定ファイル、MDM、または Claude apps gateway ポリシーのdesktopブロックを通じて配信します。3P デプロイメントは管理コンソール設定を受け取らないためです。ゲートウェイを通じて配信するには、ゲートウェイサーバーで Claude Code v2.1.232 以降が必要です。これはデスクトップアプリ自体のキーです。Claude Code は、異なるエントリ形状を持つ、同じ名前の管理設定を読み取ります。 |
Desktop セッションがどこで実行されるかに応じて、どの管理設定がそのセッションに到達するかが異なります。availableModelsなどのモデル制限は、Desktop の Claude Code セッションでターミナル CLI と同じ方法で適用されます。surface coverageを参照してください。
- このマシン上のローカルセッション:ディスクにデプロイされた管理設定ファイルが適用されます。管理コンソールを通じてリモートでプッシュされた管理設定は、セッションが適格なログインまたはキーで認証する場合、Anthropic の API でこれらのセッションに到達します。ターミナル CLI と同じ設定の優先順位に従います。
- クラウドセッション:サーバー管理設定を受け取ります。デバイスにデプロイされたファイルはこれらのセッションに到達しません。Anthropic が管理する VM で実行されるためです。自己ホスト環境にルーティングされたセッションは、ランナーイメージ内の管理設定ファイルも読み取ります。Claude Code が管理ソースを組み合わせる方法は、そのファイルが適用される場合を示しています。
- SSH セッション:セッションはリモートホストから管理設定ファイルを読み取ります。Desktop 自体は、ローカルマシンの管理設定から
sshConfigs、sshHostAllowlist、およびdisableDesktopLocalSessionsを読み取ります。 - Coworkセッション:このマシン上の Cowork セッションでは、ユーザーが Team または Enterprise アカウントでサインインしている場合でも、Claude Code は管理コンソール設定をフェッチしません。マシンにデプロイされたポリシーを読み取ります。ただし、Claude Desktop 設定が
requireCoworkFullVmSandboxを設定している場合を除きます。リモート Cowork セッションはどちらも受け取りません。ポリシーが適用される場所と時期を参照して、どのデバイスファイルが Cowork に到達するかを確認してください。MCP 権限ルールを参照して、BashおよびWebFetchルールが Cowork のツールにどのように適用されるかを確認してください。
ローカルおよび SSH セッションでは、デスクトップアプリは各ユーザーの接続された claude.ai コネクタを Claude Code に直接配信します。MCP 設定またはmanaged-mcp.jsonはこれらのコネクタに到達しません。使用する設定ソースまたはファイルの場所に関係なく。これらのセッションでコネクタのツールをブロックするには、組織のコネクタツールコントロールを使用してください。コネクタが Claude Code に到達する方法は、各種類のセッションでコネクタを管理する設定を示しています。
permissions.disableBypassPermissionsModeとdisableAutoModeはユーザーおよびプロジェクト設定でも機能しますが、管理設定に配置するとユーザーがそれらをオーバーライドするのを防ぎます。
管理ソースのみが設定できる権限、プラグイン、および配信キーについては、管理設定のみが設定できるキーを参照してください。
デバイス管理ポリシー
IT チームは、macOS の MDM または Windows のグループポリシーを通じてデスクトップアプリを管理できます。利用可能なポリシーには、Claude Code 機能の有効化または無効化、自動更新の制御、およびカスタムデプロイメント URL の設定が含まれます。
- macOS:Jamf または Kandji などのツールを使用して
com.anthropic.claudefordesktopプリファレンスドメインを通じて設定します - Windows:
SOFTWARE\Policies\Claudeのレジストリを通じて設定します
ネットワークアクセス要件
Desktop はアプリケーションコードとユーザーコンテンツを Anthropic CDN ホストから読み込みます。
anthropic.com
*.anthropic.com
claude.ai
*.claude.ai
claude.com
*.claude.com
claude.app
*.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com
トラフィックは HTTPS ポート 443 です。ただし、OTLP、LLM ゲートウェイ、または MCP サーバーのカスタムポートを設定する場合を除きます。
プロキシサーバー、カスタム認証局、mTLS、およびスタンドアロン CLI が必要とするドメインについては、ネットワーク設定を参照してください。
ファイアウォールワイルドカードの数を減らすために、代わりにこれらの Anthropic ホストを許可してください。特定のサブドメインは動的に生成されるため、ワイルドカードのままである必要があります。
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
a-cdn.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com
組織で Claude に対してIP 許可リストが有効になっている場合は、bridge.claudeusercontent.comをclaude.aiおよびapi.anthropic.comと同じプロキシ出口を通じてルーティングしてください。そのようにルーティングできない場合は、プロキシがそのホストに使用する出口アドレスを組織の IP 許可リストに追加してください。ただし、そのアドレスが組織に専用されている場合のみです。共有プロキシ出口範囲は、プロキシベンダーの他のカスタマーも許可します。
Anthropic は、到着元のアドレスを使用して、組織の IP 許可リストに対してそのホストへの接続をチェックします。プロキシがそのホストのトラフィックを、その許可リストにないアドレスを通じて送信する場合、Chrome の Claude およびブリッジを通じて接続する他の機能は機能しなくなりますが、アプリの残りの部分は機能し続けます。
ArtifactがGoogle Fontsからタイプフェイスを読み込む場合、fonts.googleapis.comおよびfonts.gstatic.comもリクエストします。両方のホストはオプションです。それらをブロックする場合、artifact はフォールバックタイプフェイスでレンダリングされます。フォントリクエストが即座に失敗するように、高速拒否でブロックしてください。ページの最初のレンダリングを遅延させるのではなく。
Artifact は、React またはチャートパッケージなどの JavaScript ライブラリをcdnjs.cloudflare.com、cdn.jsdelivr.net、cdn.tailwindcss.com、およびcode.jquery.comから読み込むこともできます。他の外部ホストからは読み込みません。それらのホストをブロックする場合、ライブラリに依存する artifact の部分は機能しません。ブロックされたフォントとは異なり、ブロックされたライブラリにはフォールバックがありません。ここでも高速拒否でブロックしてください。ブロックされたライブラリリクエストが即座に失敗するように。タイムアウトするまでハングするのではなく。
認証と SSO
エンタープライズ組織はすべてのユーザーに SSO を要求できます。プランレベルの詳細については認証を参照し、Setting up SSOで SAML 設定を参照してください。OIDC セットアップはClaude Enterprise Administrator Guideで説明されています。
データ処理
Claude Code はローカルセッションではコードをローカルで処理するか、クラウドセッションでは Anthropic が管理するインフラストラクチャで処理します。組織がそれらを自己ホスト環境にルーティングしない限り。クラウドセッション(自己ホスト環境を含む)は、処理のために会話とコードコンテキストを Anthropic の API に送信します。ローカルおよび SSH セッションは、デプロイメントが設定するモデルプロバイダー(デフォルトでは Anthropic の API)に送信します。データ保持、プライバシー、およびコンプライアンスの詳細については、データ処理を参照してください。
デプロイメント
Desktop はエンタープライズデプロイメントツールを通じて配布できます:
- macOS:Jamf または Kandji などの MDM を使用して
.dmgインストーラーを通じて配布します - Windows:MSIX パッケージを通じてデプロイします。サイレントインストールを含むエンタープライズデプロイメントオプションについては、Deploy Claude Desktop for Windowsを参照してください。
ファイアウォールで許可リストに登録するドメインについては、上記のネットワークアクセス要件を参照してください。プロキシ設定、カスタム認証局、および LLM ゲートウェイについては、ネットワーク設定を参照してください。
完全なエンタープライズ設定リファレンスについては、エンタープライズ設定ガイドを参照してください。
CLI から来ましたか?
既に Claude Code CLI を使用している場合、Desktop は同じ基盤となるエンジンをグラフィカルインターフェイスで実行します。同じマシン上で、同じプロジェクト上でも、両方を同時に実行できます。各々は個別のセッション履歴を保持しますが、CLAUDE.md ファイルを通じて設定とプロジェクトメモリを共有します。
CLI セッションを Desktop に移動するには、ターミナルで /desktop を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは macOS と x64 Windows でのみ利用可能です。Claude サブスクリプションでサインインしている場合に利用できます。API キー認証では利用できず、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry でも利用できません。
Desktop と CLI をいつ使用するか:並列セッションをウィンドウで管理したい場合、ペインを並べて配置したい場合、または変更をビジュアルで確認したい場合は Desktop を使用します。スクリプト、自動化、またはターミナルワークフローが必要な場合は CLI を使用します。
CLI フラグの同等物
このテーブルは、一般的な CLI フラグのデスクトップアプリの同等物を示しています。リストされていないフラグは、スクリプトまたは自動化用に設計されているため、デスクトップの同等物がありません。
| CLI | Desktop の同等物 |
|---|---|
--model sonnet |
送信ボタンの横のモデルドロップダウン |
--resume、--continue |
サイドバーのセッションをクリック |
--permission-mode |
送信ボタンの横のモードセレクタ |
--dangerously-skip-permissions |
Bypass permissions モード。Pro と Max プランでは Settings → Claude Code → 「Allow bypass permissions mode」で有効にします。Team と Enterprise プランでは、組織ポリシーがこれを制御します |
--add-dir |
クラウドセッションで + ボタンで複数のリポジトリを追加 |
--allowedTools、--disallowedTools |
セッションごとの同等物はありません。設定ファイルの権限ルールは引き続き適用されます。 |
--verbose |
Verbose ビューモード(Transcript view ドロップダウン) |
--print、--output-format |
利用できません。Desktop はインタラクティブのみです。 |
ANTHROPIC_MODEL 環境変数 |
送信ボタンの横のモデルドロップダウン |
MAX_THINKING_TOKENS 環境変数 |
ローカル環境エディタで設定します。環境設定を参照してください。 |
共有設定
Desktop と CLI は同じ設定ファイルを読み取るため、セットアップが引き継がれます:
- プロジェクト内の CLAUDE.md および
CLAUDE.local.mdファイルは両方で使用されます ~/.claude.jsonまたは.mcp.jsonで設定された MCP サーバー は両方で機能します- 設定で定義された Hooks および skills は両方に適用されます
~/.claude.jsonおよび~/.claude/settings.jsonの 設定 は共有されます。settings.jsonの権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。- モデル:同じモデルは両方で利用可能です。Desktop では、送信ボタンの横のドロップダウンからモデルを選択します。セッション中にモデルを同じドロップダウンから変更できます。
Claude Desktop チャットアプリからの MCP サーバー
Desktop アプリは claude_desktop_config.json から MCP サーバーをローカル Code タブセッションに読み込みます。これは ~/.claude.json および .mcp.json からのサーバーと並行して行われます。claude_desktop_config.json で定義されたサーバーは Desktop チャットサーフェスとローカル Code タブセッションの両方で利用可能です。
claude_desktop_config.json と ~/.claude.json または .mcp.json で同じサーバー名を定義した場合、ローカルセッションの Code タブは一度接続し、claude_desktop_config.json の定義を使用します。
アプリはまた、~/.claude.json から stdio サーバーをローカルセッションの組み込み CLI に再配信します。~/.claude.json(ユーザースコープ)と .mcp.json のトップレベルが同じ stdio サーバー名を定義する場合、Code タブは ~/.claude.json の定義を使用し、CLI のスコープ階層から外れます。
スタンドアロン CLI は claude_desktop_config.json を読み取りません。macOS と WSL では、claude mcp add-from-claude-desktop を実行して、これらのサーバーを ~/.claude.json にコピーします。Claude Desktop から MCP サーバーをインポートを参照して、インポートフローとスコープオプションを確認してください。
機能比較
このテーブルは、CLI と Desktop の間のコア機能を比較しています。CLI フラグの完全なリストについては、CLI リファレンスを参照してください。
| 機能 | CLI | Desktop |
|---|---|---|
| 権限モード | dontAsk を含むすべてのモード |
Manual、Accept edits、Plan、および Auto。Bypass permissions はモードセレクタに表示されます。Pro と Max プランでは Settings トグルで有効にします。Team と Enterprise プランでは、組織ポリシーがこれを制御します |
| サードパーティプロバイダー | Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry | デフォルトでは Anthropic の API。ゲートウェイルーティングについては、デスクトップアプリをゲートウェイに接続を参照してください。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または自己ホスト型 LLM ゲートウェイで Code タブを実行するには、Claude Desktop on 3Pを参照してください。 |
| MCP サーバー | 設定ファイルで設定 | ローカルおよび SSH セッションの Connectors UI、または設定ファイル |
| Plugins | /plugin コマンド |
プラグインマネージャー UI |
| @mention ファイル | テキストベース | オートコンプリート付き;ローカルおよび SSH セッションのみ |
| ファイル添付 | 利用できません | 画像、PDF |
| セッション分離 | --worktree フラグ |
自動 worktrees |
| 複数セッション | 別のターミナル | サイドバータブ |
| 定期的なタスク | Cron ジョブ、CI パイプライン | スケジュール済みタスク |
| コンピュータ使用 | macOS で /mcp 経由で有効化 |
macOS と Windows でアプリとスクリーン制御 |
| iOS シミュレータ | コンピュータ使用経由でシミュレータを駆動 | iOS Simulator ペインが自動的に開く |
| Dispatch 統合 | 利用できません | Dispatch セッション(サイドバー) |
| スクリプトと自動化 | --print、Agent SDK |
利用できません |
Desktop では利用できないもの
以下の機能は Desktop では利用できません。ただし、以下の場合を除きます:
- サードパーティプロバイダー:Desktop はデフォルトで Anthropic の API に接続します。Desktop をゲートウェイ経由でルーティングするには、またはコード タブを Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または自己ホスト型 LLM ゲートウェイで実行するには、サードパーティプロバイダー行のリンクに従ってください。
- Linux(ベータ版):Linux デスクトップアプリではコンピュータ使用はまだ利用できません。Claude Desktop on Linuxを参照してください。
- インラインコード提案:Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。
- エージェントチーム:チームリーダーとして Claude が共有タスクリストからチームメイトにタスクを割り当てる調整されたチームは、CLIで利用可能であり、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、動的ワークフローを使用します。これは Desktop で実行されます。Claude は他のセッションをメッセージして管理することもできます。
- ターミナルダイアログコマンド:ターミナルで対話型パネルを開く組み込みコマンドは、Code タブでは異なる動作をします。権限ルールと設定を管理するには、設定ファイルを直接編集するか、スタンドアロン CLI からコマンドを実行します。
/permissionsなどの引数形式がないコマンドは、isn't available in this environmentで応答します。/configは Settings → Claude Code を開きます。コマンドの後のテキストは無視されるため、/config theme=darkはテーマを設定しません。
トラブルシューティング
以下のセクションでは、デスクトップアプリに固有の問題について説明します。チャットに表示されるAPI Error: 500、529 Overloaded、429、またはPrompt is too longなどのランタイム API エラーについては、エラーリファレンスを参照してください。これらのエラーとその修正は、CLI、Desktop、Web 全体で同じです。
バージョンを確認する
実行しているデスクトップアプリのバージョンを確認するには:
- macOS:メニューバーのClaudeをクリックしてから、About Claudeをクリック
- Windows:Helpをクリックしてから、Aboutをクリック
バージョン番号をクリックしてクリップボードにコピーします。
Code タブの 403 またはエラー認証エラー
Code タブを使用するときにError 403: Forbiddenまたはその他の認証エラーが表示される場合:
- アプリメニューからサインアウトして再度サインインします。これが最も一般的な修正です。
- アクティブな有料サブスクリプション(Pro、Max、Team、または Enterprise)があることを確認します。
- CLI は機能するが Desktop は機能しない場合、デスクトップアプリを完全に終了し(ウィンドウを閉じるだけではなく)、再度開いてサインインします。
- インターネット接続とプロキシ設定を確認します。
起動時に空白または停止画面
アプリが開いても空白または応答しない画面が表示される場合:
- アプリを再起動します。
- 保留中の更新を確認します。macOS と Windows ではアプリは起動時に自動更新されます。Linux では、Claude Desktop on Linuxで説明されているように apt を使用して更新します。
- マネージドネットワーク上では、ファイアウォールがネットワークアクセス要件の CDN ホストを許可していることを確認します。
- Windows では、Windows Logs → Applicationの Event Viewer でクラッシュログを確認します。
「Failed to load session」
Failed to load sessionが表示される場合、選択したフォルダが存在しなくなった可能性があります。Git リポジトリがインストールされていない Git LFS を必要とする可能性があります。またはファイル権限がアクセスを防ぐ可能性があります。別のフォルダを選択するか、アプリを再起動してみてください。
セッションがインストール済みツールを見つけられない
Claude がnpm、node、またはその他の CLI コマンドなどのツールを見つけられない場合、ツールが通常のターミナルで機能することを確認し、シェルプロファイルが PATH を正しく設定していることを確認し、デスクトップアプリを再起動して環境変数を再度読み込みます。
Git および Git LFS エラー
Windows では、Code タブがローカルセッションを開始するために Git が必要です。「Git is required」が表示される場合、Git for Windowsをインストールしてアプリを再起動します。
「Git LFS is required by this repository but is not installed」が表示される場合、git-lfs.comから Git LFS をインストールし、git lfs installを実行してアプリを再起動します。
Windows で MCP サーバーが機能しない
MCP サーバートグルが応答しない場合、または Windows でサーバーが接続に失敗する場合、サーバーが設定で正しく設定されていることを確認し、アプリを再起動し、Task 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 サポートセンターに直接アクセスします
- スタンドアロン
claudeCLI でも再現される問題については、GitHub Issuesでバグを検索またはファイルします
問題を報告するときは、デスクトップアプリのバージョン、オペレーティングシステム、正確なエラーメッセージ、および関連ログを含めます。macOS では Console.app を確認します。Windows では Event Viewer → Windows Logs → Application を確認します。ログの抜粋を公開イシューに投稿する前に確認してください。環境からのファイルパスおよび他の詳細が含まれる可能性があります。