Claude Desktop アプリには 3 つのタブがあります:Chat は会話用、Cowork は Dispatch とより長い agentic work 用、Code はソフトウェア開発用です。このページは Code タブのリファレンスです。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.
Download for macOS
Universal build for Intel and Apple Silicon
Download for Windows
For x64 processors
- diff ビューで変更をレビューしてコメントしてから、CI を通じて結果の PR を監視
- 埋め込みブラウザで実行中のアプリをプレビューし、Claude が独自の変更を検証
- ペインを配置して、チャット、diff、プレビュー、ターミナル、ファイルエディタを並べて表示
- セッションのコンテキストを使用するサイド質問を尋ねて、セッションを脱線させない
- 外部ツールを接続(GitHub、Slack、Linear など)
- Claude にアプリを開いてスクリーンを制御させる
- マシン上、クラウド上、または SSH 上で実行
セッションを開始する
最初のメッセージを送信する前に、プロンプト領域で 4 つのことを設定してください:- 環境:Claude が実行される場所を選択します。ローカルマシンの場合はLocal、Anthropic ホスト型クラウドセッションの場合はRemote、管理するリモートマシンの場合はSSH 接続を選択します。環境設定を参照してください。
- プロジェクトフォルダ:Claude が作業するフォルダまたはリポジトリを選択します。リモートセッションの場合、複数のリポジトリを追加できます。
- モデル:送信ボタンの横のドロップダウンからモデルを選択します。セッション中にこれを変更できます。
- 権限モード:モードセレクタから Claude がどの程度の自律性を持つかを選択します。セッション中にこれを変更できます。
コードの操作
Claude に適切なコンテキストを提供し、それが独立して実行する量を制御し、変更内容を確認します。プロンプトボックスを使用する
Claude に実行させたいことを入力してEnterキーを押して送信します。Claude はプロジェクトファイルを読み取り、権限モードに基づいて変更を加えてコマンドを実行します。いつでも Claude を中断できます:停止ボタンをクリックするか、修正を入力してEnterキーを押します。Claude は実行を停止し、入力に基づいて調整します。 プロンプトボックスの横の**+**ボタンをクリックすると、ファイル添付、スキル、コネクタ、およびプラグインにアクセスできます。ファイルとコンテキストをプロンプトに追加する
プロンプトボックスは外部コンテキストを取り込む 2 つの方法をサポートしています:- @mention ファイル:
@の後にファイル名を入力して、ファイルを会話コンテキストに追加します。Claude はそのファイルを読み取り、参照できます。@mention はリモートセッションでは利用できません。 - ファイルを添付:添付ボタンを使用するか、ファイルをプロンプトに直接ドラッグアンドドロップして、画像、PDF、およびその他のファイルをプロンプトに添付します。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。
権限モードを選択する
権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでもモードを切り替えることができます。Ask permissions で開始して Claude が実行する内容を正確に確認してから、慣れてきたら Auto accept edits または Plan mode に移動します。| モード | 設定キー | 動作 |
|---|---|---|
| Ask permissions | default | Claude はファイルの編集またはコマンドの実行の前に確認を求めます。diff を確認し、各変更を受け入れるか拒否できます。新規ユーザーに推奨されます。 |
| Auto accept edits | acceptEdits | Claude はファイル編集とmkdir、touch、mvなどの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |
| Plan mode | plan | Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |
| Auto | auto | Claude はすべてのアクションをバックグラウンド安全チェック付きで実行し、リクエストとの整合性を確認します。権限プロンプトを削減しながら監視を維持します。Settings → Claude Code で有効にします。利用可能性要件以下を参照してください。 |
| Bypass permissions | bypassPermissions | Claude は権限プロンプトなしで実行され、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 が必要です。
リモートセッションは 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/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を押す
コードを確認する
diff ビューで、右上のツールバーのReview codeをクリックして、Claude にコミット前に変更を評価するよう依頼します。Claude は現在の diff を検査し、diff ビューに直接コメントを残します。任意のコメントに応答するか、Claude に修正を依頼できます。 レビューは高シグナル問題に焦点を当てています:コンパイルエラー、明確なロジックエラー、セキュリティ脆弱性、および明らかなバグです。スタイル、フォーマット、既存の問題、またはリンターが検出するものにはフラグを立てません。プルリクエストステータスを監視する
プルリクエストを開いた後、CI ステータスバーがセッションに表示されます。Claude Code は GitHub CLI を使用してチェック結果をポーリングし、失敗を表示します。- Auto-fix:有効にすると、Claude は失敗出力を読み取り、反復することで、失敗した CI チェックを自動的に修正しようとします。
- Auto-merge:有効にすると、Claude はすべてのチェックが成功したら PR をマージします。マージ方法はスカッシュです。Auto-merge がこれを機能させるためにGitHub リポジトリ設定で有効にされている必要があります。
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 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 の最終応答と加えた変更のみ |
キーボードショートカット
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 P | プレビューペインを切り替え |
Cmd Shift S | プレビューで要素を選択 |
Ctrl ` | ターミナルペインを切り替え |
Cmd \ | フォーカスされたペインを閉じる |
Cmd ; | サイドチャットを開く |
Ctrl O | ビューモードをサイクル |
Cmd Shift M | 権限モードメニューを開く |
Cmd Shift I | モデルメニューを開く |
Cmd Shift E | 努力メニューを開く |
1–9 | 開いているメニューの項目を選択 |
Shift+Tabなど)は Desktop では適用されません。
使用状況を確認する
モデルピッカーの横の使用状況リングをクリックして、現在のコンテキストウィンドウ使用状況とプラン使用状況を確認します。コンテキスト使用状況はセッションごと、プラン使用状況はすべての Claude Code サーフェス全体で共有されます。Claude にコンピュータを使用させる
コンピュータ使用により、Claude はアプリを開き、スクリーンを制御し、あなたがするのと同じ方法でマシンで直接作業できます。iOS シミュレータでネイティブアプリをテストするよう Claude に依頼したり、CLI がないデスクトップツールと対話したり、GUI を通じてのみ機能する何かを自動化したりします。コンピュータ使用は macOS と Windows の研究プレビューであり、Pro または Max プランが必要です。Team または Enterprise プランでは利用できません。Claude Desktop アプリが実行されている必要があります。
コンピュータ使用が適用される場合
Claude はアプリまたはサービスと対話するための複数の方法を持ち、コンピュータ使用は最も広範で最も遅いです。最も正確なツールを最初に試します:- サービスのコネクタがある場合、Claude はコネクタを使用します。
- タスクがシェルコマンドの場合、Claude は Bash を使用します。
- タスクがブラウザ作業であり、Chrome の Claudeがセットアップされている場合、Claude はそれを使用します。
- これらのいずれも適用されない場合、Claude はコンピュータ使用を使用します。
コンピュータ使用を有効にする
コンピュータ使用はデフォルトでオフです。それが必要な何かをするよう Claude に依頼し、それがオフの場合、Claude は Settings でコンピュータ使用を有効にすれば、タスクを実行できることを伝えます。デスクトップアプリを更新する
Claude Desktop の最新バージョンがあることを確認してください。claude.com/downloadでダウンロードまたは更新してから、アプリを再起動します。
トグルをオンにする
デスクトップアプリで、Settings > General(Desktop appの下)に移動します。Computer useトグルを見つけてオンにします。Windows では、トグルはすぐに有効になり、セットアップは完了です。macOS では、次のステップに進みます。トグルが表示されない場合は、macOS または Windows で Pro または Max プランを使用していることを確認してから、アプリを更新して再起動します。
アプリ権限
Claude が初めてアプリを使用する必要がある場合、セッションにプロンプトが表示されます。Allow for this sessionまたはDenyをクリックします。承認は現在のセッション、またはDispatch が生成したセッションでは 30 分間有効です。 プロンプトは、Claude がそのアプリに対して取得するコントロールのレベルも表示します。これらの層はアプリカテゴリによって固定され、変更できません:| 層 | Claude ができること | 適用対象 |
|---|---|---|
| ビューのみ | スクリーンショットでアプリを見る | ブラウザ、取引プラットフォーム |
| クリックのみ | クリックとスクロール、ただし入力またはキーボードショートカットは不可 | ターミナル、IDE |
| フルコントロール | クリック、入力、ドラッグ、キーボードショートカットの使用 | その他すべて |
- 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ファイルを作成します。
セッション分離にはGitが必要です。ほとんどの Mac には Git がデフォルトで含まれています。Terminal で
git --versionを実行して確認してください。Windows では、Code タブが機能するために Git が必要です:Git for Windows をダウンロードし、インストールしてアプリを再起動します。Git エラーが発生した場合は、Cowork タブで 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 をサポートしています。
変更を自動検証する
autoVerifyが有効な場合、Claude はファイルを編集した後、コード変更を自動的に検証します。スクリーンショットを撮影し、エラーをチェックし、応答を完了する前に変更が機能することを確認します。
Auto-verify はデフォルトで有効です。.claude/launch.jsonに"autoVerify": falseを追加してプロジェクトごとに無効にするか、Previewドロップダウンメニューから切り替えます。
設定フィールド
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が設定されている場合のみ使用されます |
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 はサーバーがそのポートを必要とするかどうかを尋ねてから、答えを保存します。
PORT環境変数を通じてサーバーに渡します。
例
これらの設定は、異なるプロジェクトタイプの一般的なセットアップを示しています:- Next.js
- 複数のサーバー
- Node.js スクリプト
この設定は、Yarn を使用してポート 3000 で Next.js アプリを実行します:
環境設定
セッションを開始するときに選択する環境は、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 を使用するには空のままにします。
チームの SSH 接続を事前設定する
管理者は、管理設定ファイルにsshConfigs を追加することで、SSH 接続をチームメンバーに配布できます。この方法で定義された接続は、各ユーザーの環境ドロップダウンに自動的に表示され、管理対象として表示されるため、ユーザーはそれらを選択できますが、アプリで編集または削除することはできません。
次の例は、リモートホストの ~/projects で開く単一の接続を事前設定しています:
id、name、および sshHost が必要です。sshPort、sshIdentityFile、および startDirectory フィールドはオプションです。ユーザーは、ダイアログを通じて追加された接続が保存される独自の ~/.claude/settings.json に sshConfigs を追加することもできます。
ユーザーが接続できる SSH ホストを制限する
管理者は、管理設定ファイルにsshHostAllowlist を追加することで、Desktop の SSH セッションを承認されたホストのセットに制限できます。設定されると、ユーザーは解決されたホスト名がパターンの 1 つと一致するホストにのみ接続できます。SSH セッションを完全に無効にするには、空の配列に設定します。
次の例は、devboxes.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 セッションを生成するときに適用されます。これらのキーを組織の管理設定ファイルで設定するか、管理コンソールを通じてリモートでプッシュできます。| キー | 説明 |
|---|---|
permissions.disableBypassPermissionsMode | ユーザーが Bypass permissions モードを有効にするのを防ぐには"disable"に設定します。 |
disableAutoMode | ユーザーがAutoモードを有効にするのを防ぐには"disable"に設定します。モードセレクタから Auto を削除します。permissionsの下でも受け入れられます。 |
autoMode | 組織全体で auto mode 分類器が信頼およびブロックするものをカスタマイズします。auto mode を設定するを参照してください。 |
sshConfigs | 環境ドロップダウンに表示されるSSH 接続を事前設定します。ユーザーは管理接続を編集または削除できません。 |
sshHostAllowlist | SSH セッションを、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。空の配列は SSH セッションを無効にします。管理設定からのみ読み取られます。 |
managedMcpServers | MCP サーバー設定をサードパーティデプロイメント内のすべてのユーザーにプッシュします。各エントリは"http"、"sse"、または"stdio"のトランスポート、接続詳細、およびオプションで、そのサーバー内のどのツールをユーザーが呼び出せるかを制限するtoolPolicyマップを指定します。サードパーティ(3P)Desktop デプロイメントでのみ利用可能です。 |
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を参照してください。
CLI から来ましたか?
既に Claude Code CLI を使用している場合、Desktop は同じ基盤となるエンジンをグラフィカルインターフェイスで実行します。同じマシン上で、同じプロジェクト上でも、両方を同時に実行できます。各々は個別のセッション履歴を保持しますが、CLAUDE.md ファイルを通じて設定とプロジェクトメモリを共有します。 CLI セッションを Desktop に移動するには、ターミナルで/desktop を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは macOS と Windows でのみ利用可能です。
CLI フラグの同等物
このテーブルは、一般的な CLI フラグのデスクトップアプリの同等物を示しています。リストされていないフラグは、スクリプトまたは自動化用に設計されているため、デスクトップの同等物がありません。| CLI | Desktop の同等物 |
|---|---|
--model sonnet | 送信ボタンの横のモデルドロップダウン |
--resume、--continue | サイドバーのセッションをクリック |
--permission-mode | 送信ボタンの横のモードセレクタ |
--dangerously-skip-permissions | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします。エンタープライズ管理者はこの設定を無効にできます。 |
--add-dir | リモートセッションで + ボタンで複数のリポジトリを追加 |
--allowedTools、--disallowedTools | 設定ファイルの権限ルールは引き続き適用されます。Desktop の同等物はありません。 |
--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 セッションに適用されます。- モデル: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 リファレンスを参照してください。| 機能 | CLI | Desktop |
|---|---|---|
| 権限モード | dontAsk を含むすべてのモード | Ask permissions、Auto accept edits、Plan mode、Auto、および Settings 経由の Bypass permissions |
--dangerously-skip-permissions | CLI フラグ | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします |
| サードパーティプロバイダー | Bedrock、Vertex、Foundry | Anthropic の API がデフォルト。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを設定できます。エンタープライズ設定ガイドを参照してください。 |
| MCP サーバー | 設定ファイルで設定 | ローカルおよび SSH セッションの Connectors UI、または設定ファイル |
| Plugins | /plugin コマンド | プラグインマネージャー UI |
| @mention ファイル | テキストベース | オートコンプリート付き;ローカルおよび SSH セッションのみ |
| ファイル添付 | 利用できません | 画像、PDF |
| セッション分離 | --worktree フラグ | 自動 worktrees |
| 複数セッション | 別のターミナル | サイドバータブ |
| 定期的なタスク | Cron ジョブ、CI パイプライン | スケジュール済みタスク |
| コンピュータ使用 | macOS で /mcp 経由で有効化 | macOS と Windows でアプリとスクリーン制御 |
| Dispatch 統合 | 利用できません | Dispatch セッション(サイドバー) |
| スクリプトと自動化 | --print、Agent 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: 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 は機能しない場合、デスクトップアプリを完全に終了し(ウィンドウを閉じるだけではなく)、再度開いてサインインします。
- インターネット接続とプロキシ設定を確認します。
起動時に空白または停止画面
アプリが開いても空白または応答しない画面が表示される場合:- アプリを再起動します。
- 保留中の更新を確認します。アプリは起動時に自動更新されます。
- 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」
リモートセッションはローカルマシンに存在しないブランチを作成できます。セッションツールバーのブランチ名をクリックしてコピーしてから、ローカルでフェッチします:まだ立ち往生していますか?
- GitHub Issuesでバグを検索またはファイルします
- Claude サポートセンターにアクセスします