メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Claude Desktop アプリには 3 つのタブがあります:Chat は会話用、CoworkDispatch とより長い agentic work 用、Code はソフトウェア開発用です。このページは Code タブのリファレンスです。

Download for macOS

Universal build for Intel and Apple Silicon

Download for Windows

For x64 processors
For Windows ARM64, download the ARM64 installer. The desktop app is not available on Linux; use the CLI instead. インストール後、Claude を起動してサインインし、Code タブをクリックします。Windows で初めて開く場合、Git for Windows がインストールされている必要があります。インストール後、アプリを再起動してください。最初のセッションのウォークスルーについては、はじめにガイドを参照してください。 Code タブでは、各会話は セッション です:独自のチャット履歴、プロジェクトフォルダ、コード変更を持ち、他のセッションとは独立しています。サイドバーはセッションをリストアップし、複数を並列で実行できます。セッション内では以下のことができます: スケジュール済みの定期的な作業キーボードショートカット、または電話からタスクを送信については、リンクされたページとセクションを参照してください。既にターミナルベースの CLI を使用している場合は、CLI 比較を参照して、何が引き継がれるかを確認してください。

セッションを開始する

最初のメッセージを送信する前に、プロンプト領域で 4 つのことを設定してください:
  • 環境:Claude が実行される場所を選択します。ローカルマシンの場合はLocal、Anthropic ホスト型クラウドセッションの場合はRemote、管理するリモートマシンの場合はSSH 接続を選択します。環境設定を参照してください。
  • プロジェクトフォルダ:Claude が作業するフォルダまたはリポジトリを選択します。リモートセッションの場合、複数のリポジトリを追加できます。
  • モデル:送信ボタンの横のドロップダウンからモデルを選択します。セッション中にこれを変更できます。
  • 権限モードモードセレクタから Claude がどの程度の自律性を持つかを選択します。セッション中にこれを変更できます。
タスクを入力してEnterキーを押してセッションを開始します。各セッションは独自のコンテキストと変更を追跡します。

コードの操作

Claude に適切なコンテキストを提供し、それが独立して実行する量を制御し、変更内容を確認します。

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

Claude に実行させたいことを入力してEnterキーを押して送信します。Claude はプロジェクトファイルを読み取り、権限モードに基づいて変更を加えてコマンドを実行します。いつでも Claude を中断できます:停止ボタンをクリックするか、修正を入力してEnterキーを押します。Claude は実行を停止し、入力に基づいて調整します。 プロンプトボックスの横の**+**ボタンをクリックすると、ファイル添付、スキルコネクタ、およびプラグインにアクセスできます。

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

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

権限モードを選択する

権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでもモードを切り替えることができます。Ask permissions で開始して Claude が実行する内容を正確に確認してから、慣れてきたら Auto accept edits または Plan mode に移動します。
モード設定キー動作
Ask permissionsdefaultClaude はファイルの編集またはコマンドの実行の前に確認を求めます。diff を確認し、各変更を受け入れるか拒否できます。新規ユーザーに推奨されます。
Auto accept editsacceptEditsClaude はファイル編集とmkdirtouchmvなどの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。
Plan modeplanClaude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。
AutoautoClaude はすべてのアクションをバックグラウンド安全チェック付きで実行し、リクエストとの整合性を確認します。権限プロンプトを削減しながら監視を維持します。Settings → Claude Code で有効にします。利用可能性要件以下を参照してください。
Bypass permissionsbypassPermissionsClaude は権限プロンプトなしで実行され、CLI の--dangerously-skip-permissionsと同等です。Settings → Claude Code の「Allow bypass permissions mode」で有効にします。サンドボックス化されたコンテナまたは VM でのみ使用してください。エンタープライズ管理者はこのオプションを無効にできます。
dontAsk権限モードはCLIでのみ利用可能です。 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 が必要です。
複雑なタスクを Plan mode で開始して、Claude が変更を加える前にアプローチをマップアウトするようにします。プランを承認したら、Auto accept edits または Ask permissions に切り替えて実行します。このワークフローの詳細については、最初に探索してからプランしてからコード化するを参照してください。
リモートセッションは 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キーを押してコメントを追加します。複数の行にコメントを追加した後、すべてのコメントを一度に送信します:
  • macOSCmd+Enterを押す
  • WindowsCtrl+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 では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 testgit 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 が実行した中間ステップ
SummaryClaude の最終応答と加えた変更のみ
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 [次または前のセッション
EscClaude の応答を停止
Cmd Shift Ddiff ペインを切り替え
Cmd Shift Pプレビューペインを切り替え
Cmd Shift Sプレビューで要素を選択
Ctrl `ターミナルペインを切り替え
Cmd \フォーカスされたペインを閉じる
Cmd ;サイドチャットを開く
Ctrl Oビューモードをサイクル
Cmd Shift M権限モードメニューを開く
Cmd Shift Iモデルメニューを開く
Cmd Shift E努力メニューを開く
19開いているメニューの項目を選択
これらのショートカットは Code タブにのみ適用されます。ターミナルベースのインタラクティブモードショートカット(モードをサイクルするためのShift+Tabなど)は Desktop では適用されません。

使用状況を確認する

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

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

コンピュータ使用により、Claude はアプリを開き、スクリーンを制御し、あなたがするのと同じ方法でマシンで直接作業できます。iOS シミュレータでネイティブアプリをテストするよう Claude に依頼したり、CLI がないデスクトップツールと対話したり、GUI を通じてのみ機能する何かを自動化したりします。
コンピュータ使用は macOS と Windows の研究プレビューであり、Pro または Max プランが必要です。Team または Enterprise プランでは利用できません。Claude Desktop アプリが実行されている必要があります。
コンピュータ使用はデフォルトでオフです。設定で有効にして、Claude がスクリーンを制御する前に必要な権限を付与してください。macOS では、Accessibility と Screen Recording の権限も付与する必要があります。
サンドボックス化された Bash ツールとは異なり、コンピュータ使用は実際のデスクトップで実行され、承認したものへのアクセス権があります。Claude は各アクションをチェックし、オンスクリーンコンテンツからの潜在的なプロンプトインジェクションにフラグを立てますが、信頼境界は異なります。ベストプラクティスについては、コンピュータ使用安全ガイドを参照してください。

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

Claude はアプリまたはサービスと対話するための複数の方法を持ち、コンピュータ使用は最も広範で最も遅いです。最も正確なツールを最初に試します:
  • サービスのコネクタがある場合、Claude はコネクタを使用します。
  • タスクがシェルコマンドの場合、Claude は Bash を使用します。
  • タスクがブラウザ作業であり、Chrome の Claudeがセットアップされている場合、Claude はそれを使用します。
  • これらのいずれも適用されない場合、Claude はコンピュータ使用を使用します。
アプリごとのアクセス層はこれを強化します:ブラウザはビューのみに制限され、ターミナルと IDE はクリックのみに制限され、Claude をコンピュータ使用がアクティブな場合でも専用ツールに向けます。スクリーン制御は、ネイティブアプリ、ハードウェア制御パネル、iOS シミュレータ、または API のない独自ツールなど、他に何も到達できないものに予約されています。

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

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

デスクトップアプリを更新する

Claude Desktop の最新バージョンがあることを確認してください。claude.com/downloadでダウンロードまたは更新してから、アプリを再起動します。
2

トグルをオンにする

デスクトップアプリで、Settings > GeneralDesktop appの下)に移動します。Computer useトグルを見つけてオンにします。Windows では、トグルはすぐに有効になり、セットアップは完了です。macOS では、次のステップに進みます。トグルが表示されない場合は、macOS または Windows で Pro または Max プランを使用していることを確認してから、アプリを更新して再起動します。
3

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

セッションを管理する

各セッションは独立した会話であり、独自のコンテキストと変更があります。複数のセッションを並列で実行するか、サイドチャットを分岐させるか、作業をクラウドに送信するか、Dispatch にセッションを電話から開始させることができます。

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

サイドバーの**+ New sessionをクリックするか、macOS でCmd+Nを、Windows でCtrl+Nを押して、複数のタスクを並列で作業します。Ctrl+TabCtrl+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を実行して確認してください。Windows では、Code タブが機能するために Git が必要です:Git for Windows をダウンロードし、インストールしてアプリを再起動します。Git エラーが発生した場合は、Cowork タブで Claude に助けを求めてセットアップのトラブルシューティングを行ってください。
サイドバーの上部のコントロールを使用して、ステータス、プロジェクト、または環境でセッションをフィルタリングし、プロジェクトでセッションをグループ化します。セッション名を変更するには、アクティブセッションの上部のツールバーのセッションタイトルをクリックします。コンテキスト使用状況を確認するには、使用状況を確認するを参照してください。コンテキストがいっぱいになると、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配列の各エントリは、以下のフィールドを受け入れます:
フィールド説明
namestringこのサーバーの一意の識別子
runtimeExecutablestring実行するコマンド(npmyarnnodeなど)
runtimeArgsstring[]runtimeExecutableに渡される引数(["run", "dev"]など)
portnumberサーバーがリッスンするポート。デフォルトは 3000
cwdstringプロジェクトルートに相対的な作業ディレクトリ。デフォルトはプロジェクトルート。プロジェクトルートを明示的に参照するには${workspaceFolder}を使用します
envobject{ "NODE_ENV": "development" }などのキーと値のペアとしての追加環境変数。このファイルはリポジトリにコミットされるため、ここにシークレットを入れないでください。dev サーバーにシークレットを渡すには、ローカル環境エディタで設定します。
autoPortbooleanポート競合の処理方法。以下を参照してください
programstringnodeで実行するスクリプト。programruntimeExecutableを使用する場合を参照してください
argsstring[]programに渡される引数。programが設定されている場合のみ使用されます
programruntimeExecutableを使用する場合
runtimeExecutableruntimeArgsと共に使用して、パッケージマネージャーを通じて 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環境変数を通じてサーバーに渡します。

これらの設定は、異なるプロジェクトタイプの一般的なセットアップを示しています:
この設定は、Yarn を使用してポート 3000 で Next.js アプリを実行します:
{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "yarn",
      "runtimeArgs": ["dev"],
      "port": 3000
    }
  ]
}

環境設定

セッションを開始するときに選択する環境は、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_TOKENS0 に設定します。適応的推論を持つモデルでは、適応的推論が思考の深さを制御するため、他の MAX_THINKING_TOKENS 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING1 に設定します。Opus 4.7 は常に適応的推論を使用し、固定予算モードはありません。

リモートセッション

リモートセッションはアプリを閉じても、バックグラウンドで続行されます。使用状況はサブスクリプションプランの制限にカウントされ、別の計算料金はありません。 異なるネットワークアクセスレベルと環境変数を持つカスタムクラウド環境を作成できます。リモートセッションを開始するときに環境ドロップダウンを選択し、Add environment を選択します。ネットワークアクセスと環境変数の設定の詳細については、クラウド環境を参照してください。

SSH セッション

SSH セッションを使用すると、デスクトップアプリをインターフェイスとして使用しながら、リモートマシンで Claude Code を実行できます。これは、クラウド VM、dev コンテナ、または特定のハードウェアまたは依存関係を持つサーバーに存在するコードベースで作業するのに便利です。 SSH 接続を追加するには、セッションを開始する前に環境ドロップダウンをクリックして、+ Add SSH connection を選択します。ダイアログは以下を要求します:
  • Name:この接続のフレンドリーラベル
  • SSH Hostuser@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"
    }
  ]
}
各エントリには idname、および sshHost が必要です。sshPortsshIdentityFile、および startDirectory フィールドはオプションです。ユーザーは、ダイアログを通じて追加された接続が保存される独自の ~/.claude/settings.jsonsshConfigs を追加することもできます。

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

管理者は、管理設定ファイルに sshHostAllowlist を追加することで、Desktop の SSH セッションを承認されたホストのセットに制限できます。設定されると、ユーザーは解決されたホスト名がパターンの 1 つと一致するホストにのみ接続できます。SSH セッションを完全に無効にするには、空の配列に設定します。 次の例は、devboxes.example.com の下のすべてのホストと、単一の名前付きバスティオンホストへの接続を許可しています:
{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}
パターンは大文字と小文字を区別しません。* はすべてのホストと一致し、*.example.comexample.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 セッションを生成するときに適用されます。これらのキーを組織の管理設定ファイルで設定するか、管理コンソールを通じてリモートでプッシュできます。
キー説明
permissions.disableBypassPermissionsModeユーザーが Bypass permissions モードを有効にするのを防ぐには"disable"に設定します。
disableAutoModeユーザーがAutoモードを有効にするのを防ぐには"disable"に設定します。モードセレクタから Auto を削除します。permissionsの下でも受け入れられます。
autoMode組織全体で auto mode 分類器が信頼およびブロックするものをカスタマイズします。auto mode を設定するを参照してください。
sshConfigs環境ドロップダウンに表示されるSSH 接続を事前設定します。ユーザーは管理接続を編集または削除できません。
sshHostAllowlistSSH セッションを、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。空の配列は SSH セッションを無効にします。管理設定からのみ読み取られます。
managedMcpServersMCP サーバー設定をサードパーティデプロイメント内のすべてのユーザーにプッシュします。各エントリは"http""sse"、または"stdio"のトランスポート、接続詳細、およびオプションで、そのサーバー内のどのツールをユーザーが呼び出せるかを制限するtoolPolicyマップを指定します。サードパーティ(3P)Desktop デプロイメントでのみ利用可能です。
ディスク上の各マシンにデプロイされた管理設定ファイルは Desktop セッションに適用されます。管理コンソールを通じてリモートでプッシュされた管理設定は、現在 CLI および IDE セッションにのみ適用されるため、Desktop デプロイメントの場合は MDM 経由でファイルを配布するか、上記の管理コンソールコントロールを使用してください。 permissions.disableBypassPermissionsModedisableAutoModeはユーザーおよびプロジェクト設定でも機能しますが、管理設定に配置するとユーザーがそれらをオーバーライドするのを防ぎます。autoModeはユーザー設定、.claude/settings.local.json、および管理設定から読み取られますが、チェックイン済みの.claude/settings.jsonからは読み取られません:クローンされたリポジトリは独自の分類器ルールを注入できません。allowManagedPermissionRulesOnlyallowManagedHooksOnlyを含む管理専用設定の完全なリストについては、管理専用設定を参照してください。

デバイス管理ポリシー

IT チームは、macOS の MDM または Windows のグループポリシーを通じてデスクトップアプリを管理できます。利用可能なポリシーには、Claude Code 機能の有効化または無効化、自動更新の制御、およびカスタムデプロイメント URL の設定が含まれます。
  • macOS:Jamf または Kandji などのツールを使用してcom.anthropic.Claudeプリファレンスドメインを通じて設定します
  • WindowsSOFTWARE\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 でのみ利用可能です。
Desktop と CLI をいつ使用するか:並列セッションをウィンドウで管理したい場合、ペインを並べて配置したい場合、または変更をビジュアルで確認したい場合は Desktop を使用します。スクリプト、自動化、またはターミナルワークフローが必要な場合は CLI を使用します。

CLI フラグの同等物

このテーブルは、一般的な CLI フラグのデスクトップアプリの同等物を示しています。リストされていないフラグは、スクリプトまたは自動化用に設計されているため、デスクトップの同等物がありません。
CLIDesktop の同等物
--model sonnet送信ボタンの横のモデルドロップダウン
--resume--continueサイドバーのセッションをクリック
--permission-mode送信ボタンの横のモードセレクタ
--dangerously-skip-permissionsBypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします。エンタープライズ管理者はこの設定を無効にできます。
--add-dirリモートセッションで + ボタンで複数のリポジトリを追加
--allowedTools--disallowedTools設定ファイルの権限ルールは引き続き適用されます。Desktop の同等物はありません。
--verboseVerbose ビューモード(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 セッションに適用されます。
  • モデル:Sonnet、Opus、および Haiku は両方で利用可能です。Desktop では、送信ボタンの横のドロップダウンからモデルを選択します。セッション中にモデルを変更できます。
MCP サーバー:デスクトップチャットアプリと Claude Code:Claude Desktop チャットアプリの claude_desktop_config.json で設定された MCP サーバーは Claude Code とは別であり、Code タブに表示されません。Claude Code で MCP サーバーを使用するには、~/.claude.json またはプロジェクトの .mcp.json ファイルで設定します。詳細については、MCP 設定を参照してください。

機能比較

このテーブルは、CLI と Desktop の間のコア機能を比較しています。CLI フラグの完全なリストについては、CLI リファレンスを参照してください。
機能CLIDesktop
権限モードdontAsk を含むすべてのモードAsk permissions、Auto accept edits、Plan mode、Auto、および Settings 経由の Bypass permissions
--dangerously-skip-permissionsCLI フラグBypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします
サードパーティプロバイダーBedrock、Vertex、FoundryAnthropic の API がデフォルト。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを設定できます。エンタープライズ設定ガイドを参照してください。
MCP サーバー設定ファイルで設定ローカルおよび SSH セッションの Connectors UI、または設定ファイル
Plugins/plugin コマンドプラグインマネージャー UI
@mention ファイルテキストベースオートコンプリート付き;ローカルおよび SSH セッションのみ
ファイル添付利用できません画像、PDF
セッション分離--worktree フラグ自動 worktrees
複数セッション別のターミナルサイドバータブ
定期的なタスクCron ジョブ、CI パイプラインスケジュール済みタスク
コンピュータ使用macOS で /mcp 経由で有効化macOS と Windows でアプリとスクリーン制御
Dispatch 統合利用できませんDispatch セッション(サイドバー)
スクリプトと自動化--printAgent SDK利用できません

Desktop では利用できないもの

以下の機能は CLI または VS Code 拡張機能でのみ利用可能です:
  • サードパーティプロバイダー:Desktop は Anthropic の API に直接接続します。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを 管理設定経由で設定できます。Bedrock または Foundry の場合は、CLIを使用します。
  • Linux:デスクトップアプリは macOS と Windows でのみ利用可能です。Linux では、CLIを使用します。
  • インラインコード提案:Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。
  • エージェントチーム:マルチエージェントオーケストレーションは CLI および Agent SDK を通じて利用可能であり、Desktop では利用できません。

トラブルシューティング

以下のセクションでは、デスクトップアプリに固有の問題について説明します。チャットに表示されるAPI Error: 500529 Overloaded429、またはPrompt is too longなどのランタイム API エラーについては、エラーリファレンスを参照してください。これらのエラーとその修正は、CLI、Desktop、Web 全体で同じです。

バージョンを確認する

実行しているデスクトップアプリのバージョンを確認するには:
  • macOS:メニューバーのClaudeをクリックしてから、About Claudeをクリック
  • WindowsHelpをクリックしてから、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 がnpmnode、またはその他の 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>

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

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