Claude Code インストールできない時の対処｜症状別の直し方

公開 2026-11-03更新 2026-11-03著者永上裕之導入とルール

#Claude Code #インストール #エラー #Windows #ログイン

パソコンの前で、インストールの途中で止まった画面を見ながら原因を一つずつ確かめているイメージ

この記事の要点

まず出ているメッセージを症状の表と照らし合わせる。多くは原因が1つに決まる
「入れたのに claude が見つからない」はほぼ PATH。Windows はコマンドの取り違えも多い
ログインの不調は /logout からやり直すと大半が直る。ブラウザが開かない時は c でURLをコピー

Claude Code を入れようとして、途中で止まったり、入れたはずなのに動かなかったりすることがあります。原因の多くは、コマンドの取り違え・PATH・通信・ログイン のどれかです。

この記事では、公式ドキュメント「Troubleshoot installation and login」（2026年11月3日確認）にもとづいて、出ているメッセージから直し方を探せる 形にまとめます。

結論：メッセージを表で探し、無ければ4つの確認を順に

画面に出た英語のメッセージを下の表で探すのが近道です。表に無いときは「通信 → PATH → 重複 → ログイン」の順に確かめます。

インストールのコマンドは、使う場所で違います。まずここが合っているかを見ます。

Mac・Linux のターミナル：

curl -fsSL https://claude.ai/install.sh | bash

Windows の PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows のコマンドプロンプト：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

症状別の早見表

出ているメッセージ・症状	主な原因	直し方
`command not found: claude`／`'claude' is not recognized`	入った場所が PATH に入っていない	下の「PATH を確かめる」
`'irm' is not recognized`	コマンドプロンプトで PowerShell 用を実行した	PowerShell を開いて実行する
`The token '&&' is not a valid statement separator`	PowerShell でコマンドプロンプト用を実行した	PowerShell 用のコマンドを使う
`A parameter cannot be found that matches parameter name 'fsSL'`	Windows で Mac 用のコマンドを実行した	PowerShell 用のコマンドを使う
コマンドの文字が表示されるだけで何も入らない	後半の「iex で実行する部分」を付け忘れた	コマンドを最後まで貼る
`syntax error near unexpected token '<'`	途中の通信機器がスクリプトの代わりにWebページを返した	通信を確かめる
`TLS connect error`／`unable to get local issuer certificate`	証明書の問題（会社のネットワークに多い）	証明書を更新する・会社の証明書を設定する
`Killed`（Linux）	メモリが足りない	メモリを空ける・スワップを足す
下の行に赤字で `Auto-update failed`	裏の自動更新が失敗した	そのまま作業を続けてよい。あとで `claude update`
`OAuth error`／`403 Forbidden`	ログインの問題	下の「ログインをやり直す」

表にある英語は、画面の表示に合わせて英語のままにしています。

確認1：ダウンロード先につながるか

インストーラーは配布用のサーバーからファイルを取ってきます。次のコマンドで、つながるかを確かめます（Windows の PowerShell では curl ではなく curl.exe と書きます）。

curl -sI https://downloads.claude.ai/claude-code-releases/latest

1行目に 200 が出れば、つながっています。 403 なら会社のプロキシや通信の制限で止められている可能性が高く、5xx なら一時的な不調なので数分おいて試します。

会社のプロキシを通す場合は、プロキシの住所をIT担当に確かめてから、次のように設定してインストールします。

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

確認2：PATH を確かめる

インストールは成功したのに claude が見つからない時は、ほぼ PATH の問題です。 インストーラーは本体を ~/.local/bin/claude（Windows はユーザーフォルダの中の .local → bin フォルダにある claude.exe）に置きますが、その場所を PATH に足すところまではしません。インストーラーの出力の Setup notes: に、足し方が表示されます。

Mac の標準（zsh）なら、次の2行で足せます。1行目で次回以降のターミナルに、2行目でいま開いている画面に反映されます。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows の PowerShell で入れた後に見つからない、または古い版が出る時も、同じく PATH に足してから 新しいターミナルを開き直します。

なお、VS Code の拡張機能だけを入れた場合、claude コマンドは入りません。拡張機能は自分専用の本体を持っていて、PATH に足さないためです。ターミナルでも使うなら、上のコマンドで別に入れます。

確認3：何か所にも入っていないか

以前に npm などで入れたものが残っていると、古い版が動いたり、動きがおかしくなったりします。Mac・Linux では次で、見つかる claude をすべて出せます（Windows は where.exe claude）。

which -a claude

2つ以上出たら、使わない方を外します。公式が勧めるのは、上の表のインストーラーで入れる方法です。

確認4：ログインをやり直す

ログインで止まる時は、いったん完全に抜けて入り直す と大半が直ります。

Claude Code の中で /logout を実行する
Claude Code を閉じる
もう一度 claude を起動して、ログインし直す

ブラウザが自動で開かない時は、ログインの画面で c を押すとログイン用のURLがコピー されるので、ブラウザに貼って開きます。リモートの画面などでURLが折り返してクリックできない時も、この方法で進められます。

WSL2 や、ほかのパソコンにつないだ画面では、ブラウザでログインしたあと localhost の接続エラーになることがあります。その時は、ブラウザに表示されたコードを、ターミナルの Paste code here の欄に貼れば完了します。貼っても反応しない時は、ターミナルで claude auth login を実行して同じ手順で進めます。ログインの種類や切り替え方は、Claude Code のログイン方法でくわしく説明しています。

「自動更新に失敗」と出たとき

画面の下に赤字で Auto-update failed · Run claude doctor と出ることがあります。これは 裏での自動更新が入らなかったという知らせで、作業はそのまま続けて大丈夫 です。直したい時は、ターミナルで claude update を実行すると、失敗の理由が表示されます。

それでも直らないとき

起動した後の不具合（API のエラーや動作の不調）は、Claude Code エラーの対処法の範囲です
起動はするのに、設定やフックが効かない時は、設定が効かない時の確かめ方を見てください
ターミナルを使わずに始めたい時は、デスクトップアプリから入れる方法もあります

まとめ

まず メッセージを早見表で探す。Windows はコマンドの取り違えが多い
入れたのに見つからない時は PATH。足したら新しいターミナルで確かめる
ログインの不調は /logout から入り直す。ブラウザが開かない時は c でURLをコピー

出典

Claude Code 公式ドキュメント「Troubleshoot installation and login」

永上裕之

ユニコスクール株式会社代表取締役。AIエージェント専門のスクール＆コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。