「command not found: claude」エラーPATHの確認と直し方

更新 2026.10.09
公開 2026.10.09
出典 2件
約7分で読めます

Claude Codeで「command not found: claude」と出る原因と直し方を整理。macOS・Linux・WindowsのPATH設定と確認コマンドを、公式の手順で紹介します。

公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて

「command not found: claude」エラーとは

Claude Code のインストールが終わったのに、claude と入力すると「command not found」や「’claude’ is not recognized」と表示されることがあります。公式のトラブルシューティングでは、インストール自体は成功していても、インストール先のフォルダが PATH（コマンドを探す場所の一覧）に入っていないことが原因だと説明されています。

公式の説明では、インストーラーは claude を、macOS と Linux では ~/.local/bin/claude、Windows では %USERPROFILE%\.local\bin\claude.exe に置きます。このフォルダを PATH に加えれば、多くの場合は直ります。

基本（表示と原因）

プラットフォームごとの表示は、公式のページに次のとおり載っています。

環境	表示
macOS	zsh: command not found: claude
Linux	bash: claude: command not found
Windows CMD	‘claude’ is not recognized as an internal or external command
PowerShell	claude : The term ‘claude’ is not recognized as the name of a cmdlet

主な原因は、次のとおりです。

原因	見分け方
インストール先が PATH にない	PATH の一覧に `.local/bin` が出てこない
端末を開き直していない	インストール直後の同じ端末で実行している
VS Code 拡張だけを入れている	拡張は、`claude` を PATH に追加しない
Windows で更新直後に起きた	`claude.exe` がバックアップに戻る手順が必要な場合がある

具体例（確認コマンドと直し方）

macOS・Linux

PATH に入っているかを確認します。

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

何も出なければ、シェルの設定ファイルに追加します。macOS の Zsh の場合は、次のとおりです。

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

Linux の Bash は ~/.bashrc に同じ行を追加します。macOS の Bash は、~/.bash_profile に追加します。

Windows PowerShell

$env:PATH -split ';' | Select-String '\.local\\bin'

出力がなければ、ユーザーの PATH に追加します。

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

その後、端末を開き直します。CMD の場合は echo %PATH% | findstr /i "local\bin" で確認し、出力がなければ、システムの環境変数の設定画面で、ユーザーの PATH に %USERPROFILE%\.local\bin を追加すると公式に案内されています。

更新の直後から Windows で「not recognized」と出るようになった場合は、%USERPROFILE%\.local\bin に claude.exe が残っているかを確認します。公式の説明では、更新時に古い claude.exe を claude.exe.old.<数字> という名前に退避するため、更新に失敗すると退避ファイルだけが残ることがあります。その場合は、退避ファイルの名前を claude.exe に戻すか、インストールコマンドを実行し直します。

「command not found: claude」エラーの実践ステップ

新しい端末を開き直し、claude --version を実行する。直る場合があります。
直らなければ、インストール先が PATH にあるかを、上のコマンドで確認する。
なければ、環境に合わせて PATH に追加する。
端末を開き直して、claude --version で版番号が出ることを確認する。
版番号が出ても古い版の場合は、複数のインストールが混在していないか確認する（macOS・Linux は which -a claude、Windows は where.exe claude）。
残る場合は、claude doctor で診断する。

「command not found: claude」エラーの注意点

VS Code 拡張は、自分専用の Claude Code を内部に持ちますが、PATH には追加しません。端末で claude を使うには、別に標準のインストールをします。
複数の場所に Claude Code が入っていると、版の食い違いが起きます。公式は、ネイティブインストールの1つに絞り、不要なものを削除することを勧めています。
npm の全体インストールを削除するコマンドは、npm uninstall -g @anthropic-ai/claude-code です。
Windows で、古い Claude Desktop が claude コマンドを横取りすることがあります。その場合は、Claude Desktop を最新にします。

「command not found: claude」エラーでよくあるミス

インストールした同じ端末で、すぐに claude を実行する。新しい端末を開き直すのが基本です。
設定ファイルを間違える（macOS の Zsh なのに .bashrc に書く、など）。
PATH の設定の保存先を、ユーザーではなくシステム全体にして、管理者権限が必要になる。
インストールコマンドを、別の OS・別のシェル用のものにしてしまう。

「command not found: claude」エラーのチェックリスト

新しい端末で claude --version を試したか。
インストール先（~/.local/bin など）が PATH にあるか確認したか。
使っているシェル（Zsh、Bash、PowerShell）に合った設定ファイルを直したか。
複数のインストールが混在していないか確認したか。
claude doctor を実行したか。

「command not found: claude」エラーのFAQ（よくある質問）

Q. インストールが成功したかを確認するには。
A. 新しい端末で claude --version を実行します。「2.1.211 (Claude Code)」のような版番号が出れば、成功です。

Q. PATH の変更は、再起動が必要ですか。
A. 端末の開き直しが必要です。パソコンの再起動までは、通常は求められません。

Q. それでも直らないときは。
A. 公式のトラブルシューティングの「Find your error」の表で、表示された文言に合う項目を探してください。ネットワークの確認方法も載っています。

筆者の見解（「command not found: claude」エラー）

私見では、「command not found」が出たときに再インストールから始めるのは、最も遠回りな対処です。多くはインストール先が PATH にないだけなので、まず新しい端末を開き直し、それでもだめなら PATH の確認、という順番を守るほうが早いと考えます。見落としやすいのは、再インストールを重ねた結果、npm 版と Homebrew 版とネイティブ版が混在し、「動くけれど古い版が起動する」という別の問題に変わることです。直ったあとに which -a claude（Windows は where.exe claude）で一つだけになっているかを確かめておくと、後の更新トラブルも防げると考えます。

「command not found: claude」エラーの関連項目

出典（一次情報）

本記事は一般的な情報の提供を目的としています。Claude Code の料金・利用上限・機能・エラーメッセージ・コマンドは頻繁に更新されるため、最新の内容は Anthropic の公式ドキュメントとお使いのバージョンで必ずご確認ください。契約・請求・セキュリティに関する判断は、公式サポートや社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。