blog

Claude Code Desktopとは?CLIとの違い・主な機能・インストール方法を解説【2026年版】

Claude Code Desktopの解説

Claude Code Desktopは、Claudeのデスクトップアプリにある「Code」タブで使うClaude Codeです。ターミナルを使わずに、画面上でClaudeにコードの作業を頼み、変更内容を確認できます。macOS・Windows・Linux(ベータ版)に対応し、利用にはPro・Max・Team・Enterpriseのいずれかの契約が必要です(無料プランでは使えません)。

この記事では、CLI(ターミナル版)との違い、インストール方法、最初の使い方、主な機能、料金、注意点を、Anthropic公式ドキュメント(2026年10月10日確認)にもとづいて解説します。

関連記事Claude Code(クロードコード)とは?できること・料金・使い方を初心者にもやさしく解説【2026年版】 / Claude Code 使用量を完全制御する実装ガイド【2026年版】 / Claude Code ログイン方法・できない時の対処法|2026年版ガイド

Claude Code Desktopとは

Claude Code Desktopは、AnthropicがClaude CodeのGUIフロントエンドとして提供するネイティブアプリケーションです。macOS(Intel/Apple Siliconユニバーサルビルド)・Windows(x64/ARM64)・Linux beta(Ubuntu 22.04以降/Debian 12以降)の各プラットフォームで動作し、Node.jsのセットアップもCLIの別途インストールも不要——インストーラを実行してAnthropicアカウントでサインインするだけでClaude Codeが起動します。

ただし、デスクトップアプリを入れても、ターミナルのclaudeコマンドが使えるようになるわけではありません。ターミナルからclaudeコマンドを使い続けたい場合はCLIを別途導入する必要がある(Claude Code インストール手順ガイド参照)。

設計上の重要な前提として、CLIとDesktopは同一エンジンを共有します。CLAUDE.md・MCPサーバー設定・フック・スキル・settings.jsonといった設定ファイル群は双方で共有されるため、既存のCLI環境をそのまま引き継げます。同一プロジェクト上でDesktopとCLIを同時起動することも可能であり、CI上でCLIを走らせながらローカルではDesktopでdiffレビューを行うという運用は現実的に成立します。

Desktopが付加価値を発揮するのは、並列セッション管理・ビジュアルdiffレビュー・ライブプレビュー・PR監視の自動化という、CLIでは手動操作が介在する領域です。この4点に業務上の必要性があるかどうかが、導入判断の軸になります。

なお、Codeタブの利用にはPro・Max・Team・Enterpriseのいずれかのサブスクリプションが必要で、Freeプランではアップグレードを求めるプロンプトが表示されます。料金体系の詳細はClaude Code 料金の詳細解説を参照してください。

Chat・Cowork・Codeの3タブの違い

Claude Code DesktopのインターフェースはChat・Cowork・Codeの3タブで構成されます。それぞれが異なる実行環境を持ち、エージェントの自律度とファイルアクセスの範囲が根本的に異なる点を正確に理解することが、適切な使い分けの前提になります。

Claude Code Desktop ── 3タブの役割Chatファイルアクセスなしclaude.ai 相当の汎用会話実行環境: ローカル不使用設計の壁打ち・軽量な技術質問自律度↑Cowork別の作業をしている間に自律して進めるバックグラウンドエージェントDispatch・長めの作業任せた作業をあとで確認する制御↑Codeローカルファイルへの直接アクセス変更をリアルタイム承認Local/Cloud/SSH/WSL並列セッション・diffレビュー・PR監視※ Codeタブは Pro/Max/Team/Enterprise プラン必須
Claude Code Desktopの3タブが持つ実行環境の違いと役割分担。左から右に向かうほど開発者による制御が強まり、ローカルファイルへの直接操作が可能になる構造になっています。

Chatタブはファイルシステムへのアクセスを持たない汎用会話インターフェースであり、claude.aiと同等の機能を提供します。コンテキストを持ち込まない軽量な質問や、設計の壁打ちに向いています。

Coworkタブは、利用者が別の作業をしている間に、任された作業を自律的に進めるバックグラウンドエージェントです。公式ドキュメントでは「Dispatchと長めのエージェント作業」のためのタブと説明されています。ChatとCoworkの詳しい使い方はClaudeヘルプセンターで案内されており、Claude Codeの公式ドキュメントが扱うのはCodeタブです。

CodeタブがDesktopの中核です。ローカルファイルへの直接アクセスを持ち、変更をリアルタイムでレビュー・承認できます。実行環境はLocal(自分のマシン)・Cloud(Anthropicが管理するクラウド。アプリを閉じても継続します)・SSH(自分で管理するリモートマシン。初回接続時にClaude Codeが自動でインストールされます)・WSL(Windowsのみ。WSL 2の中で実行します)の4種類から選択します(出典:Get started with the desktop app、Anthropic公式)。

Claude Code DesktopとCLI(ターミナル版)の違い

DesktopとCLIは、同じClaude Codeのエンジンを使っています。違いは操作する画面です。Desktopはグラフィカルな画面で操作し、CLIはターミナルで操作します。公式ドキュメントは、複数のセッションを1つのウィンドウで管理したい・画面を並べたい・変更を目で見て確認したいときはDesktop、スクリプトや自動化に使いたい・ターミナルで作業したいときはCLI、という使い分けを案内しています。

項目CLI(ターミナル版)Desktop
権限モードdontAskを含むすべてのモードManual・Accept edits・Plan・Auto(Bypass permissionsは有効にすると選べる)
複数のセッションターミナルを複数開くサイドバーで切り替える
セッションの分離–worktree フラグセッション開始時にworktreeオプションを選ぶ
ファイルの添付なし画像・PDFを添付できる
@でファイルを指定テキスト入力入力補完つき(ローカル・SSHのセッションのみ)
MCPサーバー設定ファイルで設定コネクタの画面(ローカル・SSHのセッション)または設定ファイル
プラグイン/plugin コマンドプラグイン管理の画面
定期的な実行cron・CIパイプラインスケジュールタスク
パソコンの操作(Computer use)macOSで /mcp から有効にするmacOS・Windowsでアプリと画面を操作できる
スマートフォンからの依頼(Dispatch)なしサイドバーにDispatchのセッションが並ぶ
スクリプト・自動化–print、Agent SDKなし(対話での利用のみ)
Amazon Bedrockなど他社クラウド経由対応既定はAnthropicのAPI(別途の設定で接続する方法が案内されています)

出典:Anthropic公式ドキュメント「Desktop application」の機能比較(2026年10月10日確認)

Desktopでは使えない機能

  • 入力中のコード補完:エディタの自動補完のような機能はありません。会話で頼み、変更を確認する使い方です。
  • Agent teams:リーダー役のClaudeがメンバーに作業を割り振る機能はCLIで提供されています。Desktopでは、1つのセッション内で複数のエージェントを動かす方法や、他のセッションへメッセージを送る方法が案内されています。
  • ターミナル上で対話パネルを開くコマンド:/permissions のようなコマンドは「この環境では使えない」と返ります。権限ルールは設定ファイルを直接編集します。/config は設定画面を開きます。
  • スクリプトからの実行:--print や --output-format に当たる機能はありません。
  • Linux版のComputer use:Linux(ベータ版)では、アプリと画面を操作する機能はまだ使えません。

CLIのセッションをDesktopで続ける方法

CLIで進めていた作業は、Desktopに引き継げます。ターミナルで /desktop を実行すると、セッションを保存してデスクトップアプリで開き、CLIは終了します。シェルから claude --desktop を実行してDesktopを直接開くこともできます(Claude Code v2.1.285以降)。どちらもmacOSとx64版Windowsで、Claudeの契約でサインインしているときに使えます。APIキーでの認証や、Amazon Bedrockなどを経由している場合は使えません。

Desktop側から引き継ぐ場合は、ターミナルのセッションを閉じたうえで、Desktopの入力欄に /resume と入力します。そのパソコンでCLIから始めたセッションの一覧が出るので、続けたいものを選びます(ローカルのセッションで使えます)。

CLIユーザーがDesktopへ移行・併用する際の差分整理

CLIで運用してきたエンジニアがDesktopへ移行・併用を検討する際に整理すべき技術的差分を示します。

設定の共有については、CLAUDE.md・MCP設定・hooks・skillsはCLIとDesktopで共有されるため、既存のCLI設定をそのまま引き継げます。settings.jsonの権限ルールや許可ツールの設定はDesktopのセッションにもそのまま適用されます。

スラッシュコマンドはDesktopのCodeタブのプロンプト入力でも有効です。CLIで慣れたコマンド体系をそのまま使えます。コマンド体系の詳細はClaude Code スラッシュコマンド解説を参照してください。

ファイル参照はDesktopでは@構文に加えてドラッグ&ドロップでファイル・画像・PDFをチャットに投入できます。画像やPDFを扱う頻度が高い場合はDesktopの操作性が優位になります。

サイドチャットはDesktop固有の機能です。進行中のセッションのコンテキストを保持したまま、本筋を脱線させずに別の小さな質問ができます。CLIでは別セッションを立ち上げる必要があった操作が、一つのウィンドウ内で完結します。

一方、スクリプトやCIからClaude Codeを呼び出す用途では引き続きCLIが適切です。DesktopはGUIとして設計されており、非インタラクティブな自動化には向いていません。CLIとDesktopの使い分けの考え方についてはClaude Codeとはも参考にしてください。他のAIコーディングツールとの比較を検討している場合はClaude Code vs Cursor 比較も参照できます。

スクリプトからAPIを直接利用するコストモデルを検討している場合はClaude Code API料金の解説も合わせて確認してください。

Desktopが向いている場面・CLIが向いている場面

モデルは送信ボタンの横にあるドロップダウンから選び、セッションの途中でも切り替えられます。CLIと同じモデルが使えるため、並列セッションの用途に応じて使い分けるのが実務的です。

Claude Code Desktopの導入を判断するにあたって技術的に確認すべき論点を整理します。

Desktopが有効な場面は、複数フィーチャーブランチの並列開発・大規模リファクタリングのdiffレビュー・PR監視の自動化・devサーバーを伴うUIコンポーネント開発です。CLIでは手動ステップが多かったこれらの作業について、統合UIによる操作コストの削減が期待できます。

CLIを維持すべき場面は、CI/CDパイプラインへの組み込み・シェルスクリプトからの呼び出し・SSH経由のヘッドレスサーバー操作です。DesktopはこれらのユースケースをCLIと置き換えるものではなく、補完関係にあります。

セキュリティ面では二点を確認してください。一点目は、SSH環境では初回接続時にリモートマシンへClaude Codeが自動インストールされる点を社内ポリシーと照合してください。二点目は、Cloudセッション(Anthropicが管理するクラウドで実行)を利用する際、機密情報を含むリポジトリやネットワークへのアクセス(クラウド環境ごとに設定できるネットワークアクセスの範囲)を事前に整理しておくことです。

また、Claude Code Desktopの使い方をより詳しく知りたい場合はClaude Code 使い方ガイドも合わせて参照してください。


インストール方法と動作環境

プラットフォーム別の要件と注意点を以下に示す(出典:Get started with the desktop app・Claude Desktop on Linux (beta)、Anthropic公式)。

プラットフォーム 対応バージョン・アーキテクチャ インストール方法 必要な追加設定
macOS Intel / Apple Silicon(ユニバーサルビルド) DMGインストーラ なし
Windows x64 x64 Setupインストーラ worktreeでセッションを分ける場合はGit for Windowsが必要
Windows ARM64 ARM64 ARM64専用インストーラ(別URL) worktreeでセッションを分ける場合はGit for Windowsが必要
Linux(beta) Ubuntu 22.04以降 / Debian 12以降(x86_64・arm64) aptリポジトリ または .debパッケージ Anthropicのaptリポジトリ登録(自動更新に必要)

Windowsでは、worktreeでセッションを分ける場合にGit for Windowsが必要になります。Claude Desktop 1.49585.0より前のバージョンでは、ローカルのセッションを始める前に必ずGitを求められていました。worktreeを使っていないのにGitを求められる場合は、アプリを更新すること(出典:Desktop application、Anthropic公式のトラブルシューティング)。

Linuxでは、aptリポジトリ経由でインストールすることで以降のアップデートがapt upgradeで自動適用されます。.debを直接インストールした場合は自動更新されないため、手動管理が必要になります。なお、Linuxサポートは現時点でbeta扱いであり、Chat・Cowork・Codeの3タブはすべて利用可能だ(アプリと画面を操作するComputer useはLinux版ではまだ使えません。Linux版でCoworkを使うには、ハードウェア仮想化(KVM)とQEMUが必要)。署名鍵のフィンガープリントは31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACEであり、gpg --show-keysで検証できる(出典:Claude Desktop on Linux 公式ドキュメント)。

初めてDesktopを使う場合の最初のセッション手順はClaude Code はじめかたガイドにまとめています。

Claude Code Desktopの使い方——最初のセッションを始める4ステップ

インストールしてサインインし、画面上部の「Code」タブを開いたら、次の4ステップで最初の作業を頼めます(出典:Anthropic公式ドキュメント「デスクトップアプリを始める」)。

  1. 実行環境とフォルダを選ぶ:「Local」を選ぶと、自分のパソコン上のファイルを直接使って動きます。「Select folder」でプロジェクトのフォルダを選びます。公式は、よく知っている小さなプロジェクトから始めることを勧めています。
  2. モデルを選ぶ:送信ボタンの横にあるドロップダウンから選びます。あとから同じ場所で変更できます。
  3. やってほしいことを書く:たとえば「TODOコメントを1つ見つけて直して」「main関数のテストを追加して」「このコードベース向けの指示を書いたCLAUDE.mdを作って」のように入力します。
  4. 変更を確認する:ここからの動きは、送信ボタン横の権限モードで変わります。Manualでは、Claudeが変更を1つずつ提案し、承認するまでファイルは書き換わりません。差分の画面で内容を見て、Accept(承認)かReject(却下)を選びます。AutoやAccept editsでは、Claudeが変更を適用したあとに「+12 -1」のような表示が出るので、クリックして差分を確認します。

慣れてきたら、次の操作も試せます。

  • 途中で止める・方向を変える:停止ボタンで中断できます。修正したい内容を入力してEnterを押せば、動いている作業を止めずに指示を送れます。
  • ファイルを渡す:入力欄で @ファイル名 と入力するか、画像やPDFをドラッグ&ドロップします。
  • 差分にコメントする:差分の画面で特定の行にコメントを付けると、Claudeがそれを読んで直します。/code-review と入力すると、Claude自身に変更を見直させることもできます。
  • 先に計画を立てさせる:込み入った作業はPlanモードで始め、計画を確認してからAccept editsやManualに切り替えて実行するのが、公式の勧める進め方です。

Claude Code Desktopの主な機能

並列セッションとGit worktreeによる分離

Codeタブでは各会話が独立したセッションとして管理されます。セッションごとにチャット履歴・プロジェクトフォルダ・コード変更が分離されており、サイドバーから複数セッションを並列に実行できます。Gitリポジトリでは、ブランチ名の横にあるworktreeオプションを選ぶとセッションごとに独立した作業ツリー(Git worktree)が作られるため、ブランチ競合を気にせず複数の機能開発を同時進行させることが可能です。

worktreeで分けたセッションでは作業中の変更が互いに干渉することはないが、それぞれの成果をマージする段階でのコンフリクト解消は通常のGit運用と同様に開発者側の作業になります。

5つの権限モード——Claudeにどこまで任せるか

権限モードは、Claudeがファイルの編集やコマンドの実行の前に確認を取るかどうかを決める設定で、送信ボタンの横から、いつでも切り替えられます。以前のバージョンでは「Ask permissions」「Auto accept edits」「Plan mode」という名前でした。

モード動き
Manualファイルの編集やコマンドの実行の前に確認を取ります。差分を見て、変更ごとに承認か却下を選ぶ
Accept editsファイルの編集と、mkdir・touch・mvなどの一般的なファイル操作コマンドは自動で承認します。それ以外のターミナルコマンドは実行前に確認を取る
Planファイルを読み、コマンドを実行して調べたうえで計画を提案します。ソースコードは編集しない
Auto通常の確認なしで進めます。シェルコマンドやネットワークへのアクセスなどは、実行前に裏側の判定の仕組みが依頼内容に沿っているかを確認します。Autoモードが使える環境でだけ表示される
Bypass permissions確認なしで実行する(どのモードでも自動承認されない一部の操作を除く)。Pro・Maxでは設定画面の「Allow bypass permissions mode」で有効にし、Team・Enterpriseでは組織のポリシーで決まります。サンドボックス化したコンテナや仮想マシンの中だけで使う

クラウドのセッションで選べるのはAccept edits・Plan・Autoです。dontAsk モードはCLIだけで使えます。

権限モードの選択はリスク許容度と速度のトレードオフです。初めてのコードベースではPlanで変更の規模と影響範囲を把握したうえで、Accept editsやManualへ切り替えて実行する段階的アプローチが現実的な運用になります。

ビジュアルdiffレビューと行コメント

Claudeが生成した変更はdiffビューで一覧表示されます。エディタとは独立したペインでdiffを確認でき、特定の行にコメントを付けてClaudeへ修正指示を出すことができる(出典:Desktop application、Anthropic公式)。コードレビューのワークフローに近い操作感で変更を精査できるため、ペアプログラミングの代替として機能します。

PR監視と自動マージ

GitHubのPR監視機能では、CIが失敗した際にClaudeが自動で原因を特定して修正を試みます。全チェックが通過した時点で自動マージを実行する設定も可能です。Cloudセッション(Anthropicが管理するクラウドで実行・アプリを閉じても継続)で作業を走らせれば、手元のマシンを閉じている間もセッション側の処理は継続されます。

PR監視の利用にはGitHub CLI(gh)のインストールと認証が必要で、自動マージはGitHubリポジトリ設定側でauto-mergeを有効化していることが前提になります(マージ方式はsquash)。

注意点として、自動マージを有効にする場合はブランチ保護ルールとの整合性を確認してください。レビュアー承認要件を設けているリポジトリでは自動マージが期待通りに動作しない場合があります。この点は事前にリポジトリの設定を照合しておく必要があります。

スケジュールタスクの実行環境比較

Desktop版のスケジュールタスクはローカルマシン上で動作し、最短1分間隔での実行が可能です。ただし、アプリが開いていてマシンが起動していることが前提になります。クラウドで動作するRoutines(最短1時間間隔)と組み合わせることで用途に応じた使い分けができる(出典:Schedule recurring tasks in Claude Code Desktop、Anthropic公式)。

項目 クラウドRoutines Desktopスケジュールタスク /loopコマンド
実行場所 Anthropicクラウド 自分のマシン 自分のマシン
マシン起動が必要 不要 必要 必要
最短間隔 1時間 1分 1分
ローカルファイルアクセス 不可(新規クローン) 可能 可能
再起動後の永続性 あり あり –resumeで復元可能(未失効の場合)

日次コードレビューや依存パッケージ監査でローカルファイルへのアクセスが不要であれば、クラウドRoutinesに委ねる方が運用安定性は高くなります。ローカルファイルを参照する定期処理に限り、Desktopスケジュールタスクを選択する判断軸になります。

ライブアプリプレビューとdevサーバー統合

Desktopアプリ内の組み込みブラウザでdevサーバーを実行し、Claudeが変更を加えながらその結果をリアルタイムで確認できます。Claudeが自分の変更を視覚的に検証できる環境になるため、UIコンポーネントの生成・修正サイクルにかかる工数を抑えやすくなります。

Claude Code・AIエージェントの業務導入をご検討の方は、自社での開発実例を公開しているクリスタルメソッドの無料相談をご利用ください。

Codeタブの画面と主なショートカット(2026年10月時点)

Claude DesktopアプリにはChat(会話)・Cowork(Dispatchと長めのエージェント作業)・Code(ソフトウェア開発)の3タブがあり、Claude Code DesktopはこのCodeタブを指します。Codeタブはペインを自由に配置でき、チャット・diff・ブラウザ・ターミナル・ファイル・プラン・タスク・サブエージェントを並べられます。ペインはドラッグで移動・サイズ変更でき、別ウィンドウにポップアウトすることもできます(ペインレイアウト・ターミナル・ファイルエディタはClaude Desktop v1.2581.0以降)。

やりたいこと操作(macOS)ポイント
新しいセッションを並列で始めるサイドバーの「+ New session」または Cmd+NGitリポジトリではworktreeを選ぶとセッションごとに作業ツリーが分かれる(既定の保存先は <project-root>/.claude/worktrees/)
2つのセッションを並べて見るCmdを押しながらサイドバーのセッションをクリック2番目のペインに開く
セッションを切り替えるCtrl+Tab / Ctrl+Shift+Tab—
コマンドを実行する(統合ターミナル)タイトルバーの「Terminal」または Ctrl+`セッションの作業ディレクトリで開き、Claudeと同じ環境を共有する
変更差分を確認するCmd+Shift+D(diffペイン)—
アプリやドキュメントを横に開くCmd+Shift+B(ブラウザペイン)タブ付きブラウザ。Cmd+Shift+Sで画面上の要素を選択できる
本題を崩さずに質問する(サイドチャット)Cmd+; またはプロンプトで /btwメインの会話を読めるが、メインには何も追加しません。ディスクに保存されないのでアプリを閉じると消える
権限モード・モデル・effortを変えるCmd+Shift+M / Cmd+Shift+I / Cmd+Shift+E—
ショートカット一覧を見るCmd+/—

WindowsではCmdの代わりにCtrlを使います(セッション切り替え・ターミナル・ビューモードの切り替えはどちらもCtrl)。CLIとの違いとして、Shift+Tabによるモード切り替えなど、ターミナル版のショートカットはDesktopでは使えません。

また、Codeタブでは「どのセッションが認証まわりを変更した?」のように尋ねると、Claudeが他のセッションの作業内容を読み取って答えたり、セッション間でメッセージを送ったりできます。対象はDesktopアプリが自分で動かしているローカル・SSH・WSLのセッションだけで、CLIやVS Code拡張、クラウドで始めたセッションは見えません。

出典:Anthropic公式ドキュメント「Desktop application」(2026年10月6日確認)

Claude Code Desktopの料金と必要なプラン

Codeタブを使うには、Pro・Max・Team・Enterpriseのいずれかの契約が必要です。無料プランでCodeタブを開くと、アップグレードを求める表示が出ます。

プラン料金(個人向け)Codeタブ
Free無料使えない
Pro月額20ドル(年払いは月あたり17ドル)使える
Max月額100ドルから使える
Team・Enterprise公式の料金ページを参照使える

料金はClaude公式の料金ページ(2026年10月10日確認)によります。日本円での請求額は為替や税で変わるため、契約前に公式ページで確認してください。

利用量については、公式ドキュメントに次の記載があります。

  • プランの利用量は、Desktop・CLIなど、Claude Codeを使うすべての場所で共通です。モデル選択の横にある利用量のリングをクリックすると、いまのセッションのコンテキスト使用量と、期間内のプラン利用量を確認できます。
  • クラウドで動かすセッションの利用量も、契約プランの上限に数えられます。計算資源に対する別料金はありません。

プランごとの違いや選び方はClaude Codeの料金プラン解説にまとめています。

使う前に知っておきたい注意点と、つまずいたときの対処

注意点

  • Bypass permissionsは隔離した環境だけで使う:確認なしで実行するモードです。公式は、サンドボックス化したコンテナや仮想マシンの中だけで使うよう案内しています。
  • ローカルのスケジュールタスクは、アプリが開いていてパソコンが起きている間だけ動く:予定の時刻にパソコンがスリープしていると、その回は実行されません。
  • シェルの環境変数がすべて引き継がれるわけではない:macOSでDockやFinderから起動した場合、シェルの設定ファイルから読み込まれるのはPATHと一部の変数だけです。WindowsではPowerShellのプロファイルは読み込まれません。必要な変数は、実行環境のドロップダウンで「Local」の歯車アイコンから開く編集画面で設定します。
  • セッションの種類で使える機能が変わる:@でのファイル指定は、クラウドとWSLのセッションでは使えません。サイドチャットはローカル・SSH・WSLのセッションで使え、内容は保存されません。
  • 会話が長くなると自動で要約される:コンテキストがいっぱいになると、Claudeが会話を要約して作業を続けます。/compact で早めに要約させることもできます。

よくあるつまずきと対処

症状公式ドキュメントが案内している対処
Codeタブで「Error 403: Forbidden」などの認証エラーが出るアプリのメニューからサインアウトして、もう一度サインインします。有料プランが有効か確認します。CLIは動くのにDesktopが動かない場合は、ウィンドウを閉じるだけでなくアプリを完全に終了してから開き直す
起動しても画面が真っ白、または固まるアプリを再起動します。更新が残っていないか確認する(macOS・Windowsは起動時に自動更新、Linuxはaptで更新)
「Failed to load session」と表示される選んだフォルダが残っているか、Git LFSが必要なリポジトリでないか、ファイルの権限に問題がないかを確認します。別のフォルダを選ぶか、アプリを再起動する
npmやnodeなどのコマンドが見つからないふだんのターミナルで動くか確認し、シェルの設定ファイルでPATHが通っているか見直して、アプリを再起動する
「Git is required」と表示されるworktreeで分けるセッションにはGitが必要。Git(WindowsではGit for Windows)をインストールする
アプリが終了しないmacOSはCmd+Q(反応しなければCmd+Option+Escで強制終了)。WindowsはCtrl+Shift+Escでタスクマネージャーを開き、Claudeのプロセスを終了する

出典:Anthropic公式ドキュメント「Desktop application」のトラブルシューティング(2026年10月10日確認)

運用視点で見た「Desktopの並列セッション」

クリスタルメソッドは、AI・ディープラーニングの研究開発の現場で、Claude Codeを1年以上・数十端末にわたり日常的に運用してきました。その実務経験から、Claude Code Desktopが打ち出す「並列セッション」という設計は、単なるUIの利便性ではなく運用負荷の配分を変える機能だと捉えています。CLIを1端末ずつ回していた頃に最も時間を奪われていたのは、コードそのものより「どの作業がどの端末で、どのブランチ上を走っているか」を人間の頭で追い続けることでした。Desktopがセッションごとにgit worktreeを分離し、権限モードを画面上で切り替えられるようにしたのは、この“管理コスト”を機械側へ寄せる方向の設計です。

一方で、実運用の立場からは注意点も見えます。並列度が上がるほど、各セッションが本番リソース(外部API・共有ファイル・データベース)に同時に触れる確率も上がるため、権限モードの初期設定と作業ディレクトリの境界を最初に固めておかないと、便利さがそのままリスクに転じます。開発現場では、変更前に影響範囲をコマンドで機械的に洗い出す手順を標準化しており、Desktopで並列作業を評価する際も「速さより、触れる範囲を先に区切る」ことを最優先の判断軸に置いています。導入検討の際は、機能一覧よりも先に並列前提での権限・作業境界の運用ルールを設計することをお勧めします。

並列worktree運用で実際に起きたつまずきと、その回避フロー

Desktopの並列セッションとGit worktree分離は便利ですが、実運用では注意点もあります。複数セッションで別々のブランチを並列に進めていると、どのセッションがどの作業をしているか見失いやすく、似た変更を別セッションで重ねて着手してしまう「作業の重複着手」が起きやすくなります。また、あるセッションでの変更意図を別セッションのセッションに引き継いだつもりで実は引き継げておらず、コンテキストが混ざったまま指示を出してしまうケースもあります。こうした事故を防ぐため、開発現場ではセッション着手前に対象ブランチと目的を明示してから作業を始める運用に加えて、Claude Code Hooksによるファイル編集前の自動バックアップ(PreToolUse Hook)を全セッション共通で有効化し、Desktopのビジュアルdiffで変更内容を確認してから適用する、という二段構えのレビューフローを取っています。CLI単独運用時には無かった「セッションをまたぐ確認コスト」は、この仕組みを組み込むことで実務上ほぼ吸収できています。

よくある質問

Q. Claude Code Desktopとは何ですか?
A. AnthropicがClaude CodeのGUIフロントエンドとして提供するネイティブアプリケーションです。macOS・Windows・Linux betaの各プラットフォームで動作し、Node.jsのセットアップもCLIの別途インストールも不要で、インストーラを実行してAnthropicアカウントでサインインするだけでClaude Codeが起動します。

Q. Desktopアプリでターミナルのclaudeコマンドは使えますか?
A. 使えません。Desktopアプリはランタイムを内蔵していますが、そのランタイムをシェル環境に公開する設計になっていないため、ターミナルからclaudeコマンドを使い続けたい場合はCLIを別途導入する必要があります。

Q. CLIとDesktopは設定を共有できますか?
A. 共有できます。CLAUDE.md・MCPサーバー設定・フック・スキル・settings.jsonといった設定ファイル群は双方で共有されるため、既存のCLI環境をそのまま引き継げます。同一プロジェクト上でDesktopとCLIを同時起動することも可能です。

Q. Desktopの3タブ(Chat・Cowork・Code)はそれぞれ何をしますか?
A. Chatタブはファイルシステムへのアクセスを持たない汎用会話インターフェースです。Coworkタブは、利用者が別の作業をしている間に、任された作業を自律的に進めるバックグラウンドエージェントです。Codeタブはローカルファイルへの直接アクセスを持ち、変更をリアルタイムでレビュー・承認できるDesktopの中核機能です。

Q. Codeタブの権限モードにはどんな種類がありますか?
A. 権限モードは5種類です。Manualはファイルの編集やコマンドの実行の前に確認を取ります。Accept editsはファイルの編集と一般的なファイル操作コマンドを自動で承認し、それ以外のターミナルコマンドは確認を取ります。PlanはClaudeが調べたうえで計画を提案し、ソースコードは編集しません。Autoは通常の確認なしで進め、実行前に裏側の判定の仕組みが内容を確認します。Bypass permissionsは確認なしで実行するモードで、隔離した環境だけで使います。

Q. Desktopのスケジュールタスクとクラウド Routinesはどう違いますか?
A. Desktopのスケジュールタスクはローカルマシン上で動作し最短1分間隔で実行できますが、アプリが開いてマシンが起動していることが前提です。クラウドで動作するRoutinesは最短1時間間隔ですがマシン起動は不要です。ローカルファイルアクセスが不要ならRoutines、ローカルファイルを参照する定期処理にはDesktopスケジュールタスクを選ぶ、という判断軸になります。

Q. Codeタブの利用にはどんなプランが必要ですか?
A. Pro・Max・Team・Enterpriseのいずれかのサブスクリプションが必要で、Freeプランではアップグレードを求めるプロンプトが表示されます。

Q. CLIで進めていたセッションをDesktopに引き継げますか?
A. 引き継げます。ターミナルで /desktop を実行するとセッションを保存してデスクトップアプリで開きます。Desktopの入力欄で /resume と入力して、CLIから始めたセッションを選ぶこともできます。/desktop はmacOSとx64版Windowsで、Claudeの契約でサインインしているときに使えます。

Q. Windows版Desktopをインストールする際の注意点はありますか?
A. worktreeでセッションを分ける場合は、Git for Windowsが必要です。Claude Desktop 1.49585.0より前のバージョンでは、ローカルのセッションを始める前に必ずGitを求められていました。worktreeを使っていないのにGitを求められる場合は、アプリを更新してください。


参考文献

関連記事

監修

河合 継(クリスタルメソッド株式会社 代表取締役)

AI・ディープラーニングに関する特許16件の発明者。過去、国立がん研究センターとの共同研究や、テレビ番組でのAI解説実績を持つAI研究者として、AIの研究開発を主導している。
運営会社について | 編集方針

Claude Code・AIエージェントの業務活用をご検討の方へ

クリスタルメソッドは、Claude Codeを実務投入している開発会社として、AIエージェント・社員AIの導入と開発効率化を支援しています。自社サイトの表示速度をAI社員(Claude Code)で12.89秒→2.03秒に短縮した実例も事例記事として公開しています。「自社の開発・業務にAIをどう組み込むか」といったご相談を承っています。

AIブログ購読

 
クリスタルメソッドがお届けする
AIブログの更新通知を受け取る

Read next

あわせて読みたい

  • 対話・チャットLLMのイメージ

    Claude Code(クロードコード)とは?できること・料金・使い方を初心者にもやさしく解説【2026年版】

    ターミナル上で動作するAIエージェント型コーディングツールのイメージ Claude Code(クロードコード)とは、Anthropic社が提供するAIツールです...

  • Claude Code 使用量を完全制御する実装ガイド【2026年版】のイメージ

    Claude Code 使用量を完全制御する実装ガイド【2026年版】

    最終更新:2026年7月29日 よくある質問:Claudeの使用量・上限について Claudeの使用量上限とは? Claude(Claude.aiのチャット、お...

  • claude code ログインできない|2026年版ガイド

    Claude Code ログイン方法・できない時の対処法|2026年版ガイド

    Claude(クロード) Codeを使おうとしたら「ログインできない」「認証エラーが出る」「コマンドが通らない」――そんな状況で作業が止まってしまった経験はあり...

View more