Claude Media
Claude Code Desktopが起動しない・403エラーの対処法
Claude CodeTips

Claude Code Desktopが起動しない・403エラーの対処法

Desktopアプリの403エラー・画面固まる・セッションが読み込めないといった症状別に、公式が挙げる原因と対処手順をまとめました。

読了目安 約8分

Claude Code Desktopで「Error 403: Forbidden」が出る、起動しても画面が固まったまま進まない、セッションが読み込めない——これらは症状ごとに原因も対処も別々です。公式ドキュメントが挙げる手順を症状別に整理しました。API呼び出し中に出るAPI Error: 500や529 OverloadedのようなランタイムエラーはDesktop固有の不具合ではなく、CLI・Web版と共通のエラーで、起動失敗・認証・MCPまわりの一般的なつまずきはClaude Codeでよくあるエラー10選にまとめています。本記事はDesktopアプリ固有の症状に絞ります。

まずバージョンを確認する

対処に入る前に、いま使っているDesktopアプリのバージョンを控えておきます。サポートに問い合わせる際にも必要な情報です。

  • macOS: メニューバーの「Claude」→「About Claude」
  • Windows: 「Help」→「About」

バージョン番号をクリックするとクリップボードにコピーされます。

403エラー・認証エラーが出る

CodeタブでError 403: Forbiddenのような認証エラーが出たときの対処は、上から順に試します。

  1. アプリメニューからサインアウトしてサインインし直します。もっとも多く効く対処です
  2. 有効な有料サブスクリプションを確認します。Pro・Max・Team・Enterpriseのいずれかの契約が必要です
  3. CLIでは動くのにDesktopだけ動かない場合、ウィンドウを閉じるだけでなくアプリを完全に終了してから再度サインインし直します
  4. インターネット接続とプロキシー設定を確認します

サインアウト・サインインで直らない認証エラーは、症状がDesktop固有ではなくアカウント側にあることがあります。「Not logged in」と出る場合は「Not logged in」エラーの原因と対処法、OAuthトークンが失効している場合は「OAuth token revoked」の対処を確認してください。サインアウトの手順自体を確実に行いたいときはClaude Codeログアウトと認証情報の完全削除ガイドも参考になります。組織アカウントで使っていて2番目のサブスクリプション確認でも解決しない場合は、組織がサブスクリプションアクセスを無効化した場合の対処のように管理者側の設定が原因のこともあります。

起動時に画面が固まる・真っ白になる

アプリは開くのに画面が反応しない、または真っ白なままのときは次の順で確認します。

  1. アプリを再起動します
  2. 保留中のアップデートを確認します。macOSとWindowsは起動時に自動更新されます。Linuxはapt経由での更新が必要です
  3. 管理されたネットワークにいる場合、ファイアウォールがCDNホストを許可しているか確認します
  4. Windowsではイベントビューアーの「Windows Logs → Application」でクラッシュログを確認します

アップデートの自動更新が止まっている、または手動でチャネルを切り替えたい場合はClaude Codeアップデートの方法にまとめています。

ファイアウォールの許可設定を見直すときは、ワイルドカードをまとめて許可するより個別ホストを列挙したほうが安全です。

anthropic.com
api.anthropic.com
claude.ai
assets.claude.ai
downloads.claude.ai
claude.com
platform.claude.com
*.claudeusercontent.com
*.claudemcpcontent.com

これらのホストへの通信はポート443のHTTPSが前提です。カスタムのOTLPエンドポイントやLLMゲートウェイ、MCPサーバーで別ポートを使う設定になっている場合は、そのポートも別途開放します。

「Failed to load session」が出る

Failed to load sessionというエラーは、選択したフォルダーがすでに存在しない、Gitリポジトリに必要なGit LFSがインストールされていない、またはファイルの権限がアクセスを妨げている、のいずれかが原因です。別のフォルダーを選び直すか、アプリを再起動して切り分けます。

ツールが見つからない・PATHが通らない

ClaudeがnpmやnodeなどのCLIコマンドを見つけられない場合は、まず通常のターミナルでそのツールが動くかを確認します。動くのにDesktop側で見つからないなら、シェルプロファイルでPATHが正しく設定されているかを確認し、Desktopアプリを再起動して環境変数を読み直させます。Desktopアプリは、DockやFinderから起動した場合~/.zshrcや~/.bashrcを読んでPATHと決まったClaude Code用変数だけを取り込みます。個別にエクスポートしたその他の環境変数は自動では引き継がれないため、ローカル環境エディター(環境ドロップダウンの歯車アイコン)で明示的に設定する必要があります。

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をインストールしたうえでgit lfs installを実行し、アプリを再起動します。

git lfs install

アプリが終了しない

  • macOS: Cmd+Qで終了します。反応しない場合はCmd+Option+EscでForce Quitを開き、Claudeを選んで強制終了します
  • Windows: Ctrl+Shift+Escでタスクマネージャーを開き、Claudeプロセスを終了します

403エラー対処の3番目に挙げた「アプリを完全終了してから再サインイン」は、この手順とセットで使います。

Windows固有の問題

  • MCPサーバーのトグルが反応しない・接続に失敗する: サーバー設定を確認し、アプリを再起動したうえでタスクマネージャーでサーバープロセスが動いているかを確認し、サーバーのログで接続エラーを確認する
  • インストール後にPATHが更新されない: 新しいターミナルウィンドウを開く。PATHの更新は新規に開いたターミナルセッションにしか反映されません
  • 「別のインストールが進行中」というエラーが出るが実際には進行中のものがない: インストーラーを管理者として実行し直す

「Branch doesn't exist yet」がCLIで出る

クラウドセッションは、ローカルマシンにまだ存在しないブランチを作ることがあります。セッションツールバーのブランチ名をクリックしてコピーし、ローカルで取得します。

git fetch origin <branch-name>
git checkout <branch-name>

症状別対処 早見表

症状最初に試すこと効かない場合
403 / 認証エラー最初に試すことサインアウト→サインイン効かない場合アプリを完全終了して再サインイン
画面が固まる・真っ白最初に試すことアプリ再起動効かない場合アップデート確認→ファイアウォール確認
Failed to load session最初に試すこと別フォルダーを選び直す効かない場合アプリ再起動、Git LFSの有無を確認
npm/nodeが見つからない最初に試すこと通常のターミナルで動作確認効かない場合シェルプロファイルのPATH確認→再起動
Windowsでビルドツールが動かない最初に試すことGit for Windowsをインストール効かない場合Git LFSも合わせてインストール

それでも直らないとき

アプリのメニューから「Help → Get Support」を開くか、サポートセンター(support.claude.com)に問い合わせます。標準のclaude CLIでも同じ問題が再現する場合は、GitHub Issuesで既存の報告を検索するか新規に起票します。

問題を報告するときは、Desktopアプリのバージョン・OS・エラーメッセージの正確な文言・関連ログを添えます。macOSはConsole.app、WindowsはイベントビューアーのWindows Logs → Applicationでログを確認できます。ログの抜粋を公開のIssueに貼る前には、ファイルパスなど環境の詳細が含まれていないか内容を確認してください。

よくある質問

403エラーはCLIでもDesktopでも同じ原因か

いいえ。DesktopのCodeタブで出る403は多くの場合サインイン状態かサブスクリプションの有効性が原因です。一方、チャット中に出るAPI Error系の403やそれ以外のステータスコードはCLI・Web版と共通のランタイムエラーで、原因の切り分け方が異なります。

アップデートを待てば直る不具合はあるか

画面が固まる・真っ白になる症状は、保留中のアップデートが原因のことがあります。macOSとWindowsは起動時に自動更新されるため、まず最新版になっているかを「About Claude」または「About」から確認してから他の対処に進むと無駄がありません。

Windows以外でもGitが必須か

公式に明示的な必須要件として挙げられているのはWindowsのみです。CodeタブのローカルセッションはGitによるセッション分離(worktree)を使うため、git --versionで確認できない場合は環境に応じてインストールを検討してください。

まとめ

Desktopアプリのトラブルは、症状で原因の見立てが大きく変わります。403エラーはまずサインアウト・サインインから、画面が固まるときはアップデート確認から、セッションが読み込めないときはフォルダーとGit LFSの有無から着手すると遠回りになりません。WindowsだけGitが必須要件になっている点と、Desktopアプリが環境変数を一部しか自動で読まない点は、他の環境では気づきにくいつまずきどころなので先に押さえておくと復旧が早まります。

この記事を共有:XはてブLinkedIn

関連する記事

Claude Code をもっと見る →