Claude Codeが起動しない、重い、インストールできないときの対処法をまとめました。
症状ごとに確認する順番を整理しています。
まずは以下の切り分け表をご確認ください。
| 症状 | 確認するポイント |
|---|---|
command not found | PATHの設定、またはWindows固有の原因 |
| アプリが立ち上がらない | 競合しているインストール |
| インストールが途中で失敗する | 実行しているコマンドが環境と一致しているか |
| ログインできない | 一度ログアウトして再ログインする |
| 動作が重い・固まる | /compact と claude --safe-mode |
| 文字化けする | /terminal-setup |
| ファイルを認識しない | ripgrepの再インストール・パス指定 |
まず診断コマンドを実行する
原因が分からない場合は、まず以下の診断コマンドを実行してください。
claude doctorインストールの状態と設定をまとめて確認し、警告や対処法を表示します。
Claude Codeが起動する場合は、内部で /doctor を実行すると詳細な診断結果が表示されます。
自動修復に対応している項目は、確認したうえでその場で修正できます。
MCPの状態は /mcp で確認できます。
起動しない・コマンドが見つからない場合
Windowsで claude コマンドを実行するとデスクトップアプリが開く
これはWindows環境特有の気づきにくい原因です。
古いバージョンのデスクトップアプリが、claude コマンドを優先して関連付けている場合があります。
WindowsApps フォルダに登録された実行ファイルがPATHで優先され、コマンドを実行するとアプリが起動します。
デスクトップアプリを最新版にアップデートすると解消します。
command not found と表示される場合
インストールが完了しているにもかかわらず見つからない場合は、PATHが通っていません。
まず、実行ファイルがどこにインストールされているか確認します。
# Mac・Linux
which -a claude
# Windows（PowerShell）
where.exe claude何も出力されない場合は、PATHに含まれていません。
インストーラーの配置先ディレクトリを、環境変数PATHに追加してください。
PATHを追加したあとは、ターミナルを再起動する必要があります。
複数のClaude Codeがインストールされていて挙動が不安定な場合
再インストールを繰り返していると、2つ以上の実行ファイルが存在していることがあります。
バージョンが不一致になったり、古いバイナリが優先して実行されたりします。
| インストール場所 | 導入方法 |
|---|---|
~/.local/bin/claude | 公式インストーラー |
~/.claude/local/ | 古いバージョンが作成した残骸 |
| npmのグローバル領域 | npm install -g |
which -a claude で複数表示された場合は、使用しないバイナリを削除してください。
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"
}
}指定する実行ファイル名は bash.exe である必要があります。
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 | コマンドプロンプトのつもりでPowerShellを使用している |
'bash' is not recognized | macOS・Linux用のシェルスクリプトをWindowsでそのまま実行している |
A parameter cannot be found ... 'fsSL' | 同上 |
プロンプトの先頭表記で見分けられます。
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) が出力されるケースです。
利用可能なメモリが不足しています。
搭載メモリの少ないサーバーや仮想環境で発生しやすいエラーです。
不要なプロセスを停止するか、スワップ領域を追加してから再実行してください。
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 という環境変数が残っていると、アカウント契約より優先して参照されます。
過去のプロジェクトや別組織で設定した古いAPIキーが、シェルの設定ファイルに残っているケースです。
心当たりがない場合でも、環境変数の設定を確認してみてください。
認証関連のエラー対処は、こちらの記事でも詳しく解説しています。
動作が重い・応答が固まる場合
順番に切り分ける
/compactを実行する。コンテキスト内の消費トークン量を圧縮する- 一度セッションを終了して開き直す。大きな作業単位ごとにリセットする
- 巨大なビルド出力フォルダを
.gitignoreに追加する claude --safe-modeで起動してみる
4つ目のセーフモードが原因切り分けに効果的です。
プラグイン・MCPサーバー・フックをすべて無効化した状態で起動します。
これで動作が軽快になる場合は、無効化した拡張機能のいずれかに原因があります。
セーフモードでも改善しない場合
/heapdump を実行すると、メモリ使用量の内訳を取得できます。
デスクトップに2種類のファイルが出力されます。
出力ファイルの取り扱いには注意が必要です。
.heapsnapshot には、直前の会話全文や認証情報が含まれます。
公開リポジトリや共有チャットに貼り付けないでください。
不具合報告に添付する場合は、-diagnostics.json のファイルのみを使用してください。
こちらのファイルには会話内容や認証情報は含まれません。
入力に対して反応しなくなった場合
Ctrl + Cで処理の中断を試みる- 中断できない場合はターミナルごと終了する
ターミナルを終了しても会話履歴は保持されます。
claude --resume同じ作業ディレクトリで以下のコマンドを実行すれば、直前の状態から再開できます。
セッション管理の詳細は、こちらの記事にまとめています。
「Autocompact is thrashing」と表示される場合
Autocompact is thrashing という警告メッセージです。
コンテキストを圧縮した直後に巨大なファイル内容が再読み込みされ、すぐに上限に達してしまう状態です。
- 大きなファイルを読み込ませる際は行数や範囲を区切る
/compact 計画と差分だけ残してのように、残したい焦点を指示して圧縮する- 巨大ファイルの解析作業をサブエージェントに分担させる
/clearでコンテキストを一旦リセットする
コンテキスト上限の仕組みと対策は、こちらの記事をご確認ください。
画面の表示が崩れる場合
文字化けする・四角い記号（豆腐）で表示される
VS CodeやCursorの内蔵ターミナルで発生しやすい現象です。
ターミナルのGPUレンダリング方式が影響している場合があります。
/terminal-setupこの設定によりGPUアクセラレーションを無効化できます。
設定変更後は、ウィンドウを再読み込みしてください。
表の出力が途中で切れる場合
200行を超えるテーブルは、先頭の200行までが表示制限の対象となります。
画面上の表示が省略されているだけで、データ自体は内部に保持されています。
/copy を実行すれば全文をクリップボードにコピーできます。
データ量が極端に多い場合は、ファイルへ直接出力させて確認してください。
ファイルが検索・認識されない場合
ファイル検索や @ファイル名 による参照が動作しない場合、同梱されている検索ツールが正常に起動していません。
別途ripgrepをインストールし、そちらを参照させます。
# Windows
winget install BurntSushi.ripgrep.MSVC
# Mac
brew install ripgrep
# Ubuntu・Debian
sudo apt install ripgrepインストール後、設定ファイルに対象パスを追加します。
{
"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年9月13日時点で確認しました。
公式トラブルシューティングはこちらです。
生成AI関連の他の記事は、まとめ一覧からご覧いただけます。
