Auto mode は Max、Team、Enterprise、および API プランで利用可能な研究プレビューです。Pro プランまたはサードパーティプロバイダーでは利用できません。Team、Enterprise、および API プランでは Claude Sonnet 4.6、Opus 4.6、または Opus 4.7 が必要です。Max プランでは Claude Opus 4.7 が必要です。

リモートセッションは Auto accept edits と Plan mode をサポートしています。Ask permissions はリモートセッションがデフォルトでファイル編集を自動受け入れするため利用できず、Bypass permissions はリモート環境が既にサンドボックス化されているため利用できません。

エンタープライズ管理者は利用可能な権限モードを制限できます。詳細については、エンタープライズ設定を参照してください。

アプリをプレビューする

Claude は dev サーバーを起動し、埋め込みブラウザを開いて変更を確認できます。これはフロントエンド Web アプリとバックエンドサーバーの両方で機能します：Claude は API エンドポイントをテストし、サーバーログを表示し、見つけた問題を反復処理できます。ほとんどの場合、Claude はプロジェクトファイルを編集した後、サーバーを自動的に起動します。いつでも Claude にプレビューを要求することもできます。デフォルトでは、Claude は編集後に変更を自動検証します。

プレビューペインは、プロジェクトから静的 HTML ファイル、PDF、画像、およびビデオを開くこともできます。チャットで HTML、PDF、画像、またはビデオパスをクリックして、プレビューで開きます。

プレビューペインから、以下を実行できます：

• 埋め込みブラウザで実行中のアプリと直接対話する
• Claude が自動的に独自の変更を検証するのを監視する：スクリーンショットを撮影し、DOM を検査し、要素をクリックし、フォームに入力し、見つけた問題を修正します
• セッションツールバーのPreviewドロップダウンからサーバーを開始または停止する
• ドロップダウンでPersist sessionsを選択して、サーバーの再起動時にクッキーとローカルストレージを保持し、開発中に再度ログインする必要がないようにする
• サーバー設定を編集するか、すべてのサーバーを一度に停止する

Claude はプロジェクトに基づいて初期サーバー設定を作成します。アプリがカスタム dev コマンドを使用する場合、.claude/launch.jsonを編集してセットアップに合わせます。完全なリファレンスについては、プレビューサーバーを設定するを参照してください。

保存されたセッションデータをクリアするには、Settings → Claude Code でPersist preview sessionsをオフに切り替えます。プレビューを完全に無効にするには、Settings → Claude Code でPreviewをオフに切り替えます。

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をオンにします。

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

Code タブはペインを任意のレイアウトで配置できるように構築されています：チャット、diff、プレビュー、ターミナル、ファイル、プラン、タスク、およびサブエージェント。ペインをヘッダーでドラッグして位置を変更するか、ペインエッジをドラッグしてサイズを変更します。macOS ではCmd+\を、Windows ではCtrl+\を押してフォーカスされたペインを閉じます。セッションツールバーのViewsメニューから追加のペインを開きます。

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

統合ターミナルを使用すると、別のアプリに切り替えることなく、セッションと並行してコマンドを実行できます。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を押してモードをサイクルします。

Claude が特定のアクションを実行した理由をデバッグするときは Verbose を使用します。複数のセッションを実行していて結果をすばやくスキャンしたい場合は Summary を使用します。

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

macOS でCmd+/を、Windows でCtrl+/を押して、Code タブで利用可能なすべてのショートカットを表示します。Windows では、以下のショートカットに対してCmdの代わりにCtrlを使用します。セッションサイクリング、ターミナルトグル、およびビューモードトグルはすべてのプラットフォームでCtrlを使用します。

これらのショートカットは Code タブにのみ適用されます。ターミナルベースのインタラクティブモードショートカット（モードをサイクルするためのShift+Tabなど）は Desktop では適用されません。

使用状況を確認する

モデルピッカーの横の使用状況リングをクリックして、現在のコンテキストウィンドウ使用状況とプラン使用状況を確認します。コンテキスト使用状況はセッションごと、プラン使用状況はすべての Claude Code サーフェス全体で共有されます。

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

コンピュータ使用により、Claude はアプリを開き、スクリーンを制御し、あなたがするのと同じ方法でマシンで直接作業できます。iOS シミュレータでネイティブアプリをテストするよう Claude に依頼したり、CLI がないデスクトップツールと対話したり、GUI を通じてのみ機能する何かを自動化したりします。

コンピュータ使用はデフォルトでオフです。設定で有効にして、Claude がスクリーンを制御する前に必要な権限を付与してください。macOS では、Accessibility と Screen Recording の権限も付与する必要があります。

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

Claude はアプリまたはサービスと対話するための複数の方法を持ち、コンピュータ使用は最も広範で最も遅いです。最も正確なツールを最初に試します：

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

アプリごとのアクセス層はこれを強化します：ブラウザはビューのみに制限され、ターミナルと IDE はクリックのみに制限され、Claude をコンピュータ使用がアクティブな場合でも専用ツールに向けます。スクリーン制御は、ネイティブアプリ、ハードウェア制御パネル、iOS シミュレータ、または API のない独自ツールなど、他に何も到達できないものに予約されています。

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

コンピュータ使用はデフォルトでオフです。それが必要な何かをするよう Claude に依頼し、それがオフの場合、Claude は Settings でコンピュータ使用を有効にすれば、タスクを実行できることを伝えます。

アプリ権限

Claude が初めてアプリを使用する必要がある場合、セッションにプロンプトが表示されます。Allow for this sessionまたはDenyをクリックします。承認は現在のセッション、またはDispatch が生成したセッションでは 30 分間有効です。

プロンプトは、Claude がそのアプリに対して取得するコントロールのレベルも表示します。これらの層はアプリカテゴリによって固定され、変更できません：

Terminal、Finder または File Explorer、System Settings または Settings などの広範なリーチを持つアプリは、承認が何を付与するかを知るようにプロンプトに追加の警告を表示します。

Settings > General（Desktop appの下）で 2 つの設定を設定できます：

• Denied apps：ここにアプリを追加して、プロンプトなしで拒否します。Claude は許可されたアプリのアクションを通じて拒否されたアプリに間接的に影響を与える可能性がありますが、拒否されたアプリと直接対話することはできません。
• Unhide apps when Claude finishes：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ファイルを作成します。

サイドバーの上部のコントロールを使用して、ステータス、プロジェクト、または環境でセッションをフィルタリングし、プロジェクトでセッションをグループ化します。セッション名を変更するには、アクティブセッションの上部のツールバーのセッションタイトルをクリックします。コンテキスト使用状況を確認するには、使用状況を確認するを参照してください。コンテキストがいっぱいになると、Claude は自動的に会話を要約して作業を続けます。/compactを入力して要約をより早くトリガーし、コンテキストスペースを解放することもできます。コンテキストウィンドウを参照して、圧縮がどのように機能するかについての詳細を確認してください。

デスクトップアプリは、Code セッションがタスクを完了し、現在そのセッションを表示していない場合に OS 通知を送信します。

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

サイドチャットを使用すると、セッションのコンテキストを使用するが、メインの会話に何も追加しない質問を Claude に尋ねることができます。コードの一部を理解したい、仮定を確認したい、またはセッションを脱線させずにアイデアを探索したい場合に使用します。

macOS で**Cmd+;を、Windows でCtrl+;**を押してサイドチャットを開くか、プロンプトボックスで/btwを入力します。サイドチャットはその時点までのメインスレッドのすべてを読み取ることができます。完了したら、サイドチャットを閉じてメインセッションを続行します。サイドチャットはローカルおよび SSH セッションで利用可能です。

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

タスクペインは、現在のセッション内で実行されているバックグラウンド作業を表示します：サブエージェント、バックグラウンドシェルコマンド、およびワークフロー。Viewsメニューから開くか、レイアウトにドラッグします。

任意のエントリをクリックして、サブエージェントペインで出力を確認するか、停止します。他のセッションが何をしているかを確認するには、サイドバーを使用します。

長時間実行されるタスクをリモートで実行する

大規模なリファクタリング、テストスイート、マイグレーション、またはその他の長時間実行されるタスクの場合、セッションを開始するときにLocalの代わりにRemoteを選択します。リモートセッションは Anthropic のクラウドインフラストラクチャで実行され、アプリを閉じたりコンピュータをシャットダウンしたりしても続行します。いつでも戻ってきて進捗を確認するか、Claude を別の方向に導くことができます。claude.ai/codeまたは Claude iOS アプリからリモートセッションを監視することもできます。

リモートセッションは複数のリポジトリもサポートしています。クラウド環境を選択した後、リポジトリピルの横の**+**ボタンをクリックして、セッションに追加のリポジトリを追加します。各リポジトリは独自のブランチセレクタを取得します。これは共有ライブラリとそのコンシューマーの更新など、複数のコードベースにまたがるタスクに便利です。

リモートセッションがどのように機能するかについての詳細については、Web 上の Claude Codeを参照してください。

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

セッションツールバーの右下の VS Code アイコンからアクセスできるContinue inメニューを使用すると、セッションを別のサーフェスに移動できます：

• Claude Code on the Web：ローカルセッションをリモートで実行し続けるために送信します。Desktop はブランチをプッシュし、会話の要約を生成し、完全なコンテキストを持つ新しいリモートセッションを作成します。その後、ローカルセッションをアーカイブするか保持するかを選択できます。これはクリーンなワーキングツリーが必要であり、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 つです。プラットフォームと統合を参照して、Remote Control、Channels、Slack、スケジュール済みタスクと比較してください。

Claude Code を拡張する

外部サービスを接続し、再利用可能なワークフローを追加し、Claude の動作をカスタマイズし、プレビューサーバーを設定します。コネクタ、スキル、プラグインを 1 か所で管理するには、サイドバーのCustomizeをクリックします。

外部ツールを接続する

ローカルおよびSSHセッションの場合、プロンプトボックスの横の**+ボタンをクリックしてConnectorsを選択し、Google Calendar、Slack、GitHub、Linear、Notion などの統合を追加します。セッションの前または中にコネクタを追加できます。+**ボタンはリモートセッションでは利用できませんが、ルーチンはルーチン作成時にコネクタを設定します。

コネクタを管理または切断するには、デスクトップアプリの Settings → Connectors に移動するか、プロンプトボックスの Connectors メニューからManage connectorsを選択します。

接続すると、Claude はカレンダーを読み取り、メッセージを送信し、問題を作成し、ツールと直接対話できます。セッションで設定されているコネクタについて Claude に尋ねることができます。

コネクタはMCP サーバーであり、グラフィカルセットアップフローを備えています。サポートされているサービスとの迅速な統合に使用します。Connectors にリストされていない統合の場合、設定ファイルを介して MCP サーバーを手動で追加します。また、カスタムコネクタを作成することもできます。

スキルを使用する

スキルは Claude ができることを拡張します。Claude は関連する場合に自動的にロードするか、直接呼び出すことができます：プロンプトボックスで/を入力するか、+ボタンをクリックしてSlash commandsを選択して、利用可能なものを参照します。これには組み込みコマンド、カスタムスキル、コードベースからのプロジェクトスキル、およびインストール済みプラグインからのスキルが含まれます。1 つを選択すると、入力フィールドで強調表示されます。その後にタスクを入力して、通常どおり送信します。

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

プラグインは、スキル、エージェント、hooks、MCP サーバー、および LSP 設定を Claude Code に追加する再利用可能なパッケージです。ターミナルを使用せずにデスクトップアプリからプラグインをインストールできます。

ローカルおよびSSHセッションの場合、プロンプトボックスの横の**+ボタンをクリックしてPluginsを選択して、インストール済みプラグインとそのスキルを確認します。プラグインを追加するには、サブメニューからAdd plugin**を選択してプラグインブラウザを開きます。これは、公式 Anthropic マーケットプレイスを含む、設定されたマーケットプレイスから利用可能なプラグインを表示します。Manage pluginsを選択して、プラグインを有効化、無効化、またはアンインストールします。

プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI セッションと同じ方法で Desktop セッションで利用可能です。プラグインはリモートセッションでは利用できません。プラグインの作成を含む完全なプラグインリファレンスについては、プラグインを参照してください。

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

Claude は dev サーバーセットアップを自動的に検出し、セッションを開始するときに選択したフォルダのルートの.claude/launch.jsonに設定を保存します。Preview はこのフォルダを作業ディレクトリとして使用するため、親フォルダを選択した場合、独自の dev サーバーを持つサブフォルダは自動的に検出されません。サブフォルダのサーバーで作業するには、そのフォルダで直接セッションを開始するか、設定を手動で追加します。

サーバーの起動方法をカスタマイズするには、たとえばnpm run devの代わりにyarn devを使用するか、ポートを変更するには、ファイルを手動で編集するか、Preview ドロップダウンの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を追加してプロジェクトごとに無効にするか、Previewドロップダウンメニューから切り替えます。

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [...]
}

無効にすると、プレビューツールは引き続き利用可能であり、いつでも Claude に検証を依頼できます。Auto-verify は編集後に自動的に実行します。

設定フィールド

configurations配列の各エントリは、以下のフィールドを受け入れます：

programとruntimeExecutableを使用する場合

runtimeExecutableをruntimeArgsと共に使用して、パッケージマネージャーを通じて dev サーバーを起動します。たとえば、"runtimeExecutable": "npm"と"runtimeArgs": ["run", "dev"]はnpm run devを実行します。

nodeで直接実行したいスタンドアロンスクリプトがある場合はprogramを使用します。たとえば、"program": "server.js"はnode server.jsを実行します。argsで追加フラグを渡します。

ポート競合

autoPortフィールドは、優先ポートが既に使用されている場合の処理を制御します：

• true：Claude は自動的に空きポートを見つけて使用します。ほとんどの dev サーバーに適しています。
• false：Claude はエラーで失敗します。OAuth コールバックまたは CORS 許可リストなど、サーバーが特定のポートを使用する必要がある場合に使用します。
• 設定されていない（デフォルト）：Claude はサーバーがそのポートを必要とするかどうかを尋ねてから、答えを保存します。

Claude が別のポートを選択すると、割り当てられたポートをPORT環境変数を通じてサーバーに渡します。

例

これらの設定は、異なるプロジェクトタイプの一般的なセットアップを示しています：

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

環境設定

セッションを開始するときに選択する環境は、Claude が実行される場所と接続方法を決定します：

• Local：マシンで実行され、ファイルに直接アクセスできます
• Remote：Anthropic のクラウドインフラストラクチャで実行されます。アプリを閉じても、セッションは続行されます。
• SSH：SSH 経由で接続するリモートマシンで実行されます。たとえば、独自のサーバー、クラウド VM、または dev コンテナなどです。

ローカルセッション

デスクトップアプリは常にシェル環境全体を継承するわけではありません。macOS では、Dock または Finder からアプリを起動すると、~/.zshrc または ~/.bashrc などのシェルプロファイルを読み取り、PATH と固定された Claude Code 変数セットを抽出しますが、そこでエクスポートする他の変数は取得されません。Windows では、アプリはユーザーおよびシステム環境変数を継承しますが、PowerShell プロファイルは読み取りません。

ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、Local にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、~/.claude/settings.json ファイルの env キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、環境変数を参照してください。

拡張思考はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。思考を完全に無効にするには、ローカル環境エディタで MAX_THINKING_TOKENS を 0 に設定します。適応的推論を持つモデルでは、適応的推論が思考の深さを制御するため、他の MAX_THINKING_TOKENS 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING を 1 に設定します。Opus 4.7 は常に適応的推論を使用し、固定予算モードはありません。

リモートセッション

リモートセッションはアプリを閉じても、バックグラウンドで続行されます。使用状況はサブスクリプションプランの制限にカウントされ、別の計算料金はありません。

異なるネットワークアクセスレベルと環境変数を持つカスタムクラウド環境を作成できます。リモートセッションを開始するときに環境ドロップダウンを選択し、Add environment を選択します。ネットワークアクセスと環境変数の設定の詳細については、クラウド環境を参照してください。

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 を実行する必要があります。デスクトップは初回接続時にリモートマシンに Claude Code を自動的にインストールします。接続されると、SSH セッションは権限モード、コネクタ、プラグイン、および MCP サーバーをサポートします。

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

管理者は、管理設定ファイルに sshConfigs を追加することで、SSH 接続をチームメンバーに配布できます。この方法で定義された接続は、各ユーザーの環境ドロップダウンに自動的に表示され、管理対象として表示されるため、ユーザーはそれらを選択できますが、アプリで編集または削除することはできません。

次の例は、リモートホストの ~/projects で開く単一の接続を事前設定しています：

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

各エントリには id、name、および sshHost が必要です。sshPort、sshIdentityFile、および startDirectory フィールドはオプションです。ユーザーは、ダイアログを通じて追加された接続が保存される独自の ~/.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 が CLI セッションを生成するときに適用されます。これらのキーを組織の管理設定ファイルで設定するか、管理コンソールを通じてリモートでプッシュできます。

ディスク上の各マシンにデプロイされた管理設定ファイルは Desktop セッションに適用されます。管理コンソールを通じてリモートでプッシュされた管理設定は、現在 CLI および IDE セッションにのみ適用されるため、Desktop デプロイメントの場合は MDM 経由でファイルを配布するか、上記の管理コンソールコントロールを使用してください。

permissions.disableBypassPermissionsModeとdisableAutoModeはユーザーおよびプロジェクト設定でも機能しますが、管理設定に配置するとユーザーがそれらをオーバーライドするのを防ぎます。autoModeはユーザー設定、.claude/settings.local.json、および管理設定から読み取られますが、チェックイン済みの.claude/settings.jsonからは読み取られません：クローンされたリポジトリは独自の分類器ルールを注入できません。allowManagedPermissionRulesOnlyとallowManagedHooksOnlyを含む管理専用設定の完全なリストについては、管理専用設定を参照してください。

デバイス管理ポリシー

IT チームは、macOS の MDM または Windows のグループポリシーを通じてデスクトップアプリを管理できます。利用可能なポリシーには、Claude Code 機能の有効化または無効化、自動更新の制御、およびカスタムデプロイメント URL の設定が含まれます。

• macOS：Jamf または Kandji などのツールを使用してcom.anthropic.Claudeプリファレンスドメインを通じて設定します
• Windows：SOFTWARE\Policies\Claudeのレジストリを通じて設定します

認証と SSO

エンタープライズ組織はすべてのユーザーに SSO を要求できます。プランレベルの詳細については認証を参照し、SAML および OIDC 設定についてはSSO の設定を参照してください。

データ処理

Claude Code はローカルセッションではコードをローカルで処理するか、リモートセッションでは Anthropic のクラウドインフラストラクチャで処理します。会話とコードコンテキストは処理のために Anthropic の API に送信されます。データ保持、プライバシー、およびコンプライアンスの詳細については、データ処理を参照してください。

デプロイメント

Desktop はエンタープライズデプロイメントツールを通じて配布できます：

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

ネットワーク設定（プロキシ設定、ファイアウォール許可リスト、LLM ゲートウェイなど）については、ネットワーク設定を参照してください。

完全なエンタープライズ設定リファレンスについては、エンタープライズ設定ガイドを参照してください。

CLI から来ましたか？

既に Claude Code CLI を使用している場合、Desktop は同じ基盤となるエンジンをグラフィカルインターフェイスで実行します。同じマシン上で、同じプロジェクト上でも、両方を同時に実行できます。各々は個別のセッション履歴を保持しますが、CLAUDE.md ファイルを通じて設定とプロジェクトメモリを共有します。

CLI セッションを Desktop に移動するには、ターミナルで /desktop を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは macOS と Windows でのみ利用可能です。

CLI フラグの同等物

このテーブルは、一般的な CLI フラグのデスクトップアプリの同等物を示しています。リストされていないフラグは、スクリプトまたは自動化用に設計されているため、デスクトップの同等物がありません。

共有設定

Desktop と CLI は同じ設定ファイルを読み取るため、セットアップが引き継がれます：

• プロジェクト内の CLAUDE.md および CLAUDE.local.md ファイルは両方で使用されます
• ~/.claude.json または .mcp.json で設定された MCP サーバー は両方で機能します
• 設定で定義された Hooks および skills は両方に適用されます
• ~/.claude.json および ~/.claude/settings.json の 設定 は共有されます。settings.json の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。
• モデル：Sonnet、Opus、および Haiku は両方で利用可能です。Desktop では、送信ボタンの横のドロップダウンからモデルを選択します。セッション中にモデルを変更できます。

機能比較

このテーブルは、CLI と Desktop の間のコア機能を比較しています。CLI フラグの完全なリストについては、CLI リファレンスを参照してください。

Desktop では利用できないもの

以下の機能は CLI または VS Code 拡張機能でのみ利用可能です：

• サードパーティプロバイダー：Desktop は Anthropic の API に直接接続します。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを 管理設定経由で設定できます。Bedrock または Foundry の場合は、CLIを使用します。
• Linux：デスクトップアプリは macOS と Windows でのみ利用可能です。Linux では、CLIを使用します。
• インラインコード提案：Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。
• エージェントチーム：マルチエージェントオーケストレーションは CLI および Agent SDK を通じて利用可能であり、Desktop では利用できません。
• ターミナルダイアログコマンド：/permissions、/config、/agents、/doctor などのターミナルで対話型パネルを開く組み込みコマンドは、Code タブでは利用できず、isn't available in this environment で応答します。設定ファイルを直接編集して権限ルールと設定を管理するか、スタンドアロン CLI からコマンドを実行します。

トラブルシューティング

以下のセクションでは、デスクトップアプリに固有の問題について説明します。チャットに表示される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またはその他の認証エラーが表示される場合：

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

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

アプリが開いても空白または応答しない画面が表示される場合：

1. アプリを再起動します。
2. 保留中の更新を確認します。アプリは起動時に自動更新されます。
3. 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>

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

• GitHub Issuesでバグを検索またはファイルします
• Claude サポートセンターにアクセスします

バグをファイルするときは、デスクトップアプリのバージョン、オペレーティングシステム、正確なエラーメッセージ、および関連ログを含めます。macOS では Console.app を確認します。Windows では Event Viewer → Windows Logs → Application を確認します。