Claude Codeが起動しない、重い、インストールできないときの対処法をまとめました。
主にCLIの症状を扱います。
デスクトップアプリ自体が起動しない場合は、CLIのPATH問題とは分けてデスクトップ版の対処法を確認してください。
まずは以下の切り分け表をご確認ください。
| 症状 | 確認するポイント |
|---|---|
command not found | PATHの設定、またはWindows固有の原因 |
| アプリが立ち上がらない | アプリの版・OS・起動ログ。CLIの多重インストールとは分ける |
| インストールが途中で失敗する | 実行しているコマンドが環境と一致しているか |
| ログインできない | 一度ログアウトして再ログインする |
| 動作が重い・固まる | /compact と claude --safe-mode |
| 文字化けする | /terminal-setup |
| ファイルを認識しない | 検索の起点・除外・権限・Search診断を確認し、必要ならripgrepを切り替える |
まず診断コマンドを実行する
原因が分からない場合は、まず以下の診断コマンドを実行してください。
claude doctorインストールの状態と設定をまとめて確認し、警告や対処法を表示します。
Claude Codeが起動する場合は、内部で /doctor を実行すると詳細な診断結果が表示されます。
自動修復に対応している項目は、確認したうえでその場で修正できます。
MCPの状態は /mcp で確認できます。
起動しない・コマンドが見つからない場合
Windowsで claude コマンドを実行するとデスクトップアプリが開く
これはWindows環境特有の気づきにくい原因です。
古いバージョンのデスクトップアプリが、claude コマンドを優先して関連付けている場合があります。
WindowsApps フォルダに登録された実行ファイルがPATHで優先され、コマンドを実行するとアプリが起動します。
デスクトップアプリを最新版にアップデートすると解消します。
command not found と表示される場合
インストール済みの実行ファイルが存在するなら、PATHや実行コマンドの解決先を確認します。
デスクトップアプリやVS Code拡張だけの導入では、単独CLIが使えるとは限りません。
まず、実行ファイルがどこにインストールされているか確認します。
# Mac・Linux
which -a claude
# Windows（PowerShell）
where.exe claude何も表示されないだけでは、未インストールかPATH未設定かを区別できません。
ネイティブ版の配置先はmacOS/Linuxの ~/.local/bin/claude、Windowsの %USERPROFILE%\.local\bin\claude.exe です。
まずファイルの有無を確かめます。
インストーラーの配置先ディレクトリを、環境変数PATHに追加してください。
PATHを追加したあとは、ターミナルを再起動する必要があります。
VS Codeなどの内蔵ターミナルはエディターのPATHを引き継ぐため、エディター自体も終了して開き直してください。
新しいターミナルで claude --version を実行し、バージョンが表示されればコマンドを認識できています。
複数のClaude Codeがインストールされていて挙動が不安定な場合
再インストールを繰り返していると、2つ以上の実行ファイルが存在していることがあります。
バージョンが不一致になったり、古いバイナリが優先して実行されたりします。
| インストール場所 | 導入方法 |
|---|---|
~/.local/bin/claude | 公式インストーラー |
~/.claude/local/ | 古いバージョンが作成した残骸 |
| npmのグローバル領域 | npm install -g |
複数の実行先がある場合は、実際に使う版と導入方法を確認します。
不要なものは元のパッケージ管理ツールや公式のアンインストール手順で整理し、設定・履歴のフォルダまでまとめて削除しないでください。
Windowsで「PowerShellもGit Bashも見つからない」と表示される場合
Claude Code on Windows requires either Git for Windows (for bash) or PowerShell というエラーメッセージです。
どちらか一方のシェル環境が利用できれば動作します。
PowerShellは通常 C:\Windows\System32\WindowsPowerShell\v1.0\ に配置されています。
このディレクトリがPATHに含まれているか確認してください。
Git Bashを使用する場合は、Git for Windowsをインストールして「Add to PATH」を有効にします。
インストール済みで見つからない場合は、実行ファイルのパスを直接指定できます。
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}Git for Windowsでは、例のように bin\bash.exe を指定します。
v2.1.219以降に受け付けるファイル名は、bash.exe・sh.exe・bash・sh です。
別名や存在しないパスは無視され、自動検出へ戻るため、--debug の警告も確認します。
git-bash.exe を指定しても認識されません。
「32ビット版Windowsはサポート外」と表示される場合
64ビットOS環境でもこのメッセージが表示されることがあります。
スタートメニューに Windows PowerShell と Windows PowerShell (x86) の2つがあり、x86版を起動していると32ビットプロセスとして動作します。
[Environment]::Is64BitOperatingSystemTrue と出力されれば、OS自体は64ビットで問題ありません。
x86表記のない64ビット版PowerShellを開き直して、再度実行してください。
インストールできない場合
実行しているコマンドがシェルの種類と合っていない
コピーしたコマンドと、実行中のシェルが一致しているかを確認します。
| 表示されるメッセージ | 主な原因 |
|---|---|
irm is not recognized | PowerShellのつもりでコマンドプロンプト（cmd.exe）を使用している |
&& is not valid | Windows PowerShell 5.1など、&&に未対応のシェルでCMD用コマンドを実行している |
'bash' is not recognized | macOS・Linux用のシェルスクリプトをWindowsでそのまま実行している |
A parameter cannot be found ... 'fsSL' | 同上 |
プロンプトの表記は手がかりですが、カスタマイズできます。
ターミナルのプロファイル名や、PowerShellなら $PSVersionTable.PSVersion も確認します。
PowerShell 7では && 自体を利用できます。
PS C:\ と表示されていればPowerShell、C:\ のみの場合はコマンドプロンプトです。
インストーラーの取得時にHTMLが返ってくる場合
syntax error near unexpected token '<' や curl: (22) ... returned error: 403 が出力されるケースです。
スクリプトファイルではなくエラーページを取得しています。
社内ネットワークのファイアウォールやプロキシで遮断されている可能性があります。
証明書やプロキシ環境の設定方法は、こちらの記事をご確認ください。
Linuxで Killed と表示されて終了する場合
Installation was killed before it could finish (exit code 137) が出力されるケースです。
終了コード137はSIGKILLで終了したことを示します。
メモリの少ないLinux環境ではOOMによる停止がよくありますが、コードだけでメモリ不足と断定せず、OSログやメモリ状態も確認します。
搭載メモリの少ないサーバーや仮想環境で発生しやすいエラーです。
不要なプロセスを停止するか、スワップ領域を追加してから再実行してください。
Windowsで「ファイルが別プロセスで使用中」と出る場合
The process cannot access the file ... because it is being used by another process というエラーです。
前回ダウンロードしたインストーラーファイルがプロセスをつかんでいる可能性があります。
まずロックしているインストーラーなどを特定して終了し、再試行します。
ダウンロード残骸を整理する場合も対象の絶対パスを確認し、プロジェクトや履歴を含むフォルダを削除しないでください。
ログインできない場合
まずは再ログインを試す
認証の不整合が疑われる場合は、ログアウトと再ログインを試します。
契約や組織の権限不足は、この操作だけでは解決しません。
/logoutでサインアウトする- Claude Codeを終了する
claudeで起動し、再度認証を行う
ブラウザが自動で開かない場合は、c キーを押して認証用URLをコピーできます。
SSH接続など、リモート環境側でブラウザが起動してしまう場合にも有効です。
ログイン後に 403 Forbidden が発生する場合
- Pro・Maxプランの場合：サブスクリプション契約が有効か確認する
- Anthropic Consoleの場合：ワークスペースで「Claude Code」または「Developer」のロールが付与されているか確認する
- プロキシ環境の場合：認証通信がプロキシやファイアウォールで遮断されていないか確認する
契約中なのに「Organization is invalid」と表示される場合
見落としやすい原因の一つです。
対話実行で承認済みの ANTHROPIC_API_KEY があると、サブスクリプション認証より優先されます。
非対話の -p では環境変数にあるキーを使用します。
/status で認証方式を確認し、値そのものはログや共有先へ貼らないでください。
過去のプロジェクトや別組織で設定した古いAPIキーが、シェルの設定ファイルに残っているケースです。
心当たりがない場合でも、環境変数の設定を確認してみてください。
認証関連のエラー対処は、こちらの記事でも詳しく解説しています。
動作が重い・応答が固まる場合
順番に切り分ける
/compactを実行する。コンテキスト内の消費トークン量を圧縮する- 一度セッションを終了して開き直す。大きな作業単位ごとにリセットする
- 巨大なビルド出力フォルダを
.gitignoreに追加する claude --safe-modeで起動してみる
4つ目のセーフモードが原因切り分けに効果的です。
セーフモードはCLAUDE.md・スキル・プラグイン・MCPなどのカスタマイズを読み込まずに起動します。
ただし管理ポリシーや管理設定のフックなどは引き続き適用され、認証・標準ツール・権限は通常どおり動作します。
改善するなら、無効化された設定や拡張機能が原因候補になります。
一つずつ戻して切り分け、直ちに特定のプラグインが原因と断定しないでください。
セーフモードでも改善しない場合
/heapdump を実行すると、メモリ使用量の内訳を取得できます。
通常は ~/Desktop に2種類のファイルを出力します。
DesktopフォルダがないLinuxではホームに保存します。
出力ファイルの取り扱いには注意が必要です。
.heapsnapshot には、直前の会話全文や認証情報が含まれます。
公開リポジトリや共有チャットに貼り付けないでください。
不具合報告に添付する場合は、-diagnostics.json のファイルのみを使用してください。
こちらのファイルには会話内容や認証情報は含まれません。
入力に対して反応しなくなった場合
Ctrl + Cで処理の中断を試みる- 中断できない場合はターミナルごと終了する
保存済みの会話は再開できます。
保存を無効にした場合や強制終了直前の未保存部分は例外です。
claude --resume上の claude --resume で一覧から履歴を選びます。
--continue は現在のディレクトリの最新の対象セッションを再開します。
再開は作業ファイルの復元を保証するものではありません。
セッション管理の詳細は、こちらの記事にまとめています。
「Autocompact is thrashing」と表示される場合
Autocompact is thrashing という警告メッセージです。
コンテキストを圧縮した直後に巨大なファイル内容が再読み込みされ、すぐに上限に達してしまう状態です。
- 大きなファイルを読み込ませる際は行数や範囲を区切る
/compact 計画と差分だけ残してのように、残したい焦点を指示して圧縮する- 巨大ファイルの解析作業をサブエージェントに分担させる
/clearでコンテキストを一旦リセットする
/clear の後も同じ圧縮エラーが続く場合は、/context の内訳を確認します。
Messagesが最大なら、新しい会話で読み込んだファイルやツール出力を小さく区切ってください。
Messagesより上の項目の合計が大きければ、起動時に読み込む指示や設定を減らす必要があります。
2026年10月27日に公式の再発時の切り分けで確認した手順です。
コンテキスト上限の仕組みと対策は、こちらの記事をご確認ください。
画面の表示が崩れる場合
文字化けする・四角い記号（豆腐）で表示される
VS CodeやCursorの内蔵ターミナルで発生しやすい現象です。
ターミナルのGPUレンダリング方式が影響している場合があります。
/terminal-setupこの設定によりGPUアクセラレーションを無効化できます。
設定変更後は、ウィンドウを再読み込みしてください。
表の出力が途中で切れる場合
200行を超えるテーブルは、先頭の200行までが表示制限の対象となります。
画面上の表示が省略されているだけで、データ自体は内部に保持されています。
/copy を実行すれば全文をクリップボードにコピーできます。
データ量が極端に多い場合は、ファイルへ直接出力させて確認してください。
ファイルが検索・認識されない場合
検索が動かない原因には、実行フォルダ・除外設定・権限・検索ツールの不調などがあります。
同梱ripgrepが起動できない場合は、システムに導入したripgrepへ切り替えます。
まず claude doctor のSearchを確認し、必要な場合に以下のOS別コマンドでripgrepを導入します。
# Windows
winget install BurntSushi.ripgrep.MSVC
# Mac
brew install ripgrep
# Ubuntu・Debian
sudo apt install ripgrepインストールした rg がPATHから実行できることを確認し、以下の設定で同梱版を無効にします。
このJSONはパスそのものを指定する設定ではありません。
{
"env": {
"USE_BUILTIN_RIPGREP": "0"
}
}設定が反映されたかどうかは claude doctor で確認できます。
Searchの項目に、インストールした実行ファイルのパスが表示されていれば適用完了です。
WSL環境で検索結果が極端に少ない場合
WindowsとLinuxのファイルシステム境界を越えてアクセスすると、I/O性能が低下します。
タイムアウトなどにより検索結果が不完全になる場合があります。
- プロジェクトファイルを
/home/側に配置する（/mnt/c/などのWindowsマウント側を避ける） - 検索対象のディレクトリ範囲を絞り込んで指示する
- Windows環境ネイティブでの実行を検討する
この症状が発生している場合でも、claude doctor ではエラーとして検出されません。
原因特定が難しいため、パフォーマンス低下時はファイル配置を確認してください。
基本的なセットアップ手順は、こちらの記事をご確認ください。
この記事で紹介しているコードは、GitHubのMOTOKI-LLC/cg-method-codeにもまとめています。
Claude Codeのエラー対処は、ほかにも書いています。
まとめ
- 原因切り分けには
claude doctor。起動できるなら/doctor - Windowsで
claudeを実行してデスクトップアプリが開く場合はアプリを更新する - x86版PowerShellを誤って起動していないか確認する
- 動作が重いときは
claude --safe-modeで要因を切り分ける .heapsnapshotは公開しない。会話全文や認証トークンが含まれるため取り扱いに注意する- 保存済みの会話履歴は再開できる。未保存・保存無効は例外。
claude --resumeで作業を再開する - 有料契約中にもかかわらず弾かれる場合は
ANTHROPIC_API_KEYの残留を確認する
2026年10月23日に公式仕様と本文を再照合しました。
各OSの起動障害・修復手順・最新画面は実機で再検証していません。
公式トラブルシューティングはこちらです。
生成AI関連の他の記事は、まとめ一覧からご覧いただけます。
よくある質問：Claude Codeが起動しない・重いとき
Claude Codeが起動しない・重いときは、まず何をすればよいですか？
記事の切り分け表が起点です。
原因の切り分けには claude doctor を使い、起動できるなら対話中に /doctor を実行します。
CLIが見つからなければ本体とPATH、GUIが開かなければアプリの版・OS・ログを確認します。
認証は契約・権限・通信を切り分け、動作が重い場合は /compact やセーフモードで原因候補を調べます。
Windowsで claude を実行したら、デスクトップアプリが開いてしまうのは？
古いバージョンのデスクトップアプリが、claude コマンドを優先して関連付けている場合があります。
WindowsApps フォルダに登録された実行ファイルがPATHで優先され、コマンドを実行するとアプリが起動するもので、デスクトップアプリを最新版にアップデートすると解消します。
「command not found」と出たときは？ 複数入っていて不安定なときは？
まずCLI本体の有無を確認し、存在する場合にPATHと解決先を調べます。
アプリや拡張だけのインストールでは単独CLIが未導入の場合があります。
実行ファイルが存在しているのに検索されない場合は、配置先をPATHに追加し、新しいターミナルで確認します。
再インストールを繰り返していると、2つ以上の実行ファイル（~/.local/bin/claude の公式インストーラー、~/.claude/local/ の古い残骸、npmのグローバル領域）が存在し、バージョンが不一致になったり、古いバイナリが優先されたりします。
複数の実行先がある場合は導入方法と利用中の版を確認し、不要なものを対応するアンインストール手順で整理します。
Windowsで「PowerShellもGit Bashも見つからない」や「32ビット版はサポート外」と出たら？
前者は、Git for Windows（bash）かPowerShellのどちらか一方が使えれば動作します。
PowerShellの配置先がPATHに含まれるか確認し、Git Bashを使う場合はGit for Windowsを導入します。
Git Bashの指定には通常 bin\bash.exe を使い、起動用の git-bash.exe は指定しません。
後者は、スタートメニューの Windows PowerShell (x86) を起動していると32ビットのプロセスとして動くために出ます。
x86表記のない64ビット版PowerShellを使います。
インストールが失敗するときは、何を疑いますか？
エラー文と実行中のシェルを照合します。
Windows PowerShell 5.1は && に未対応ですが、PowerShell 7は対応しています。
irm や curl の解釈も環境で異なるため、使用するシェル向けの公式コマンドを選びます。
PSで始まる表示はPowerShellの手がかりですが、表示は変更できます。
ターミナルのプロファイルとバージョンも確認してください。
「syntax error near unexpected token」や「403」が出るときは、エラーページを取得していて、社内ネットワークのファイアウォールやプロキシで遮断されている可能性があります。
Linuxの137はSIGKILL終了で、メモリ不足が原因候補です。
OSログも確認します。
Windowsのファイル使用中エラーは、該当プロセスとダウンロード先を特定してから対処してください。
ログインできないときや、「403 Forbidden」「Organization is invalid」と出たときは？
原因が分からなければ、一度セッションをリセットして再ログインします。
403は、Pro・Maxなら契約が有効か、Anthropic Consoleならワークスペースで「Claude Code」または「Developer」のロールが付いているか、プロキシ環境なら認証通信が遮断されていないかを確認します。
契約中なのに「Organization is invalid」と出るときは、ANTHROPIC_API_KEY という環境変数が残っていて、アカウント契約より優先して参照されている可能性があります。
過去のプロジェクトや別組織で設定した古いキーが、シェルの設定ファイルに残っているケースなので、心当たりがなくても確認します。
動作が重い・固まるときは、どう切り分けますか？ 「Autocompact is thrashing」とは？
文脈を要約する、再起動する、検索対象を絞る、セーフモードで比較する順に切り分けます。
再起動後は保存済みの履歴を選んで再開できますが、未保存部分や保存無効の履歴は例外です。
セーフモードは多くのカスタマイズを停止しますが、管理ポリシーや管理設定のフックなどは残ります。
軽くなれば無効化された設定を原因候補として、一つずつ確認します。
改善しなければ /heapdump でメモリ使用量の内訳を取れますが、.heapsnapshot には直前の会話全文や認証情報が含まれるため、公開リポジトリや共有チャットには貼らず、不具合報告には -diagnostics.json のファイルのみを使います。
「Autocompact is thrashing」は、圧縮した直後に巨大なファイル内容が再読み込みされ、すぐ上限に達する状態で、読み込ませる行数や範囲を区切る、/compact に残したい焦点を指示する、巨大ファイルの解析をサブエージェントに分担させる、/clear でリセットする、のいずれかで対処します。
文字化けや、表の途切れ、ファイルが検索されないときは？ 記事の確認時点は？
VS CodeやCursorの内蔵ターミナルで起きやすい文字化け・豆腐は、ターミナルのGPUレンダリング方式が影響している場合があり、GPUアクセラレーションを無効化してウィンドウを再読み込みします。
200行を超える表は先頭の200行までが表示され、省略されているだけでデータは保持されているため、/copy で全文をコピーするか、ファイルへ出力させます。
検索の起点・除外設定・権限と claude doctor のSearchを確認します。
同梱版の不調ならシステムのripgrepを導入し、PATHを確認して USE_BUILTIN_RIPGREP=0 を設定します。
WSL環境で検索結果が極端に少ないときは、プロジェクトを /home/ 側に置く（/mnt/c/ などのWindowsマウント側を避ける）、検索範囲を絞る、Windowsネイティブでの実行を検討する、の順に試します（この症状は claude doctor ではエラーとして検出されません）。
2026年10月23日に公式仕様と本文を再照合しました。
実機での障害再現・復旧確認は未実施です。
最新は公式のトラブルシューティングで確認してください。
