「command not found: claude」「'claude' is not recognized」の直し方
答え：このエラーの原因は、ほとんどの場合「PATH（パス）」です。 Claude Code本体は入っているのに、パソコンが「claude という命令がどこにあるか」を知らない状態です。公式の推奨インストールでは、本体は次の場所に置かれます。
- Mac・Linux：
~/.local/bin/claude - Windows：
%USERPROFILE%\.local\bin\claude.exe
この場所をPATHに登録して、ターミナルを開き直せば直ります。
📌 本記事は2026年10月時点の公式ドキュメント「Troubleshoot installation and login」に基づいています。
まず試す3ステップ（どのOSでも共通）
| 順番 | やること | 理由 |
|---|---|---|
| 1 | ターミナルを全部閉じて、新しく開き直す | インストールした時に開いていたターミナルは、古い設定のまま動いているため |
| 2 | 下の「OS別の確認コマンド」で、PATHに登録されているかを調べる | 登録されていなければ、それが原因 |
| 3 | 登録されていなければPATHに追加し、もう一度ターミナルを開き直して claude --version |
バージョン番号（例：2.1.211 (Claude Code)）が出れば成功 |
ターミナルが苦手な方は、デスクトップアプリ版を使うのも手です。公式も「ターミナルを使いたくない場合はデスクトップアプリで」と案内しています。詳しくは「Claude Codeデスクトップアプリの始め方」をご覧ください。
エラーメッセージで見分ける
表示は違っても、意味はすべて「claude という命令が見つからない」です。
| 使っている環境 | 表示されるエラー |
|---|---|
| Mac（標準のzsh） | zsh: command not found: claude |
| Linux（bash） | bash: claude: command not found |
| Windows（コマンドプロンプト） | 'claude' is not recognized as an internal or external command |
| Windows（PowerShell） | claude : The term 'claude' is not recognized as the name of a cmdlet |
Macの直し方
① PATHに入っているか確認する
ターミナルに次の1行を貼り付けて実行します。
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
/Users/あなたの名前/.local/binと表示された → PATHは登録済みです。後述の「それでも直らないとき」へ- 何も表示されない → 登録されていません。②へ進みます
② PATHに追加する
Macの標準（zsh）の場合は、次の2行を実行します。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
1行目は「設定ファイル（.zshrc）に、置き場所を書き足す」、2行目は「その設定を今すぐ読み直す」という意味です。
最後に claude --version でバージョンが出れば完了です。
💡 古い設定のままbashを使っているMacでは、
.zshrcの代わりに~/.bash_profileに書き足します（公式の案内）。どちらを使っているかはecho $SHELLで確認できます（/bin/zshならzsh）。
Windowsの直し方
① PATHに入っているか確認する
PowerShell（スタートメニューで「PowerShell」と検索）を開き、次を実行します。
$env:PATH -split ';' | Select-String '\.local\\bin'
何も表示されなければ、PATHに登録されていません。
② PATHに追加する（画面操作でできる方法）
- スタートメニューで「環境変数」と検索し、「環境変数を編集」を開く
- 上の段（ユーザー環境変数）の「Path」を選んで「編集」
- 「新規」を押して、次を貼り付ける
%USERPROFILE%\.local\bin - 「OK」で全部の画面を閉じる
- 開いているPowerShellやコマンドプロンプトを全部閉じて、新しく開く
claude --versionでバージョンが出れば完了
⚠️ 既存の行を消さないように、必ず「新規」で追加してください。
Windowsでよくある別の原因
| 状況 | 原因と対処（公式の案内） |
|---|---|
アップデートした直後に急に 'claude' is not recognized が出た |
更新の途中で claude.exe が置き換えに失敗し、バックアップ（claude.exe.old.数字）だけが残っていることがあります。PowerShellで次を実行すると元に戻せます。Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe 直らなければ irm https://claude.ai/install.ps1 | iex で入れ直します |
claude と打つとデスクトップアプリが開いてしまう |
古いClaude Desktopが同じ名前を先に登録していることがあります。Claude Desktopを最新版に更新してください |
| PowerShellのインストールは成功したのに見つからない | 上の②でPATHを追加し、新しいターミナルを開きます |
Linuxの直し方
bashの場合は、次の2行でPATHに追加します。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
確認は claude --version です。fishなど別のシェルを使っている場合は、そのシェルの書き方で ~/.local/bin をPATHに加えてください。
それでも直らないとき
① そもそもインストールされているか確認する
Mac・Linuxでは次で確認できます。
ls -la ~/.local/bin/claude
「No such file or directory」と出たら、本体が入っていません。インストールし直しましょう。
| OS | 公式のインストールコマンド |
|---|---|
| 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 |
インストール後は、必ず新しいターミナルを開いてから claude --version を試します。
💡 VS Codeの拡張機能だけを入れた場合、ターミナル用の
claudeは入りません。拡張機能は自分専用のコピーを中に持っているだけで、PATHには登録しないためです（公式の説明）。ターミナルでも使いたい場合は、上のコマンドで別途インストールします。
② 複数のインストールがぶつかっていないか確認する
昔の方法（npm）で入れたものと新しい方法で入れたものが混在すると、古い方が動いたり、うまく起動しなかったりします。Mac・Linuxでは次で一覧できます。
which -a claude
2つ以上表示されたら、公式推奨の ~/.local/bin/claude だけを残します。npmで入れた古いものは、次のコマンドで削除できます。
npm uninstall -g @anthropic-ai/claude-code
③ 自動診断を使う
claude が起動できるようになったら、Claude Codeの中で /doctor と打つと、インストールや設定の問題を自動でチェックしてくれます。起動すらできない場合は、ターミナルで claude doctor を実行します。
よくある質問
Q1. Node.jsを入れ直す必要はありますか？ A. 公式の推奨インストール（上の表のコマンド）では、Node.jsは不要です。昔の記事にある「Node.js 18以上が必要」という説明は、npmで入れていた頃のものです。
Q2. PATHって何ですか？
A. パソコンが命令（コマンド）を探しに行くフォルダの一覧です。claude と打つと、この一覧に載っているフォルダだけを順番に探します。一覧に載っていないフォルダにある命令は、ファイルがあっても見つかりません。
Q3. 設定ファイルを書き換えるのが怖いです。
A. 先に cp ~/.zshrc ~/.zshrc.backup でコピーを取っておけば、いつでも元に戻せます。また、上の手順は設定ファイルの末尾に1行を書き足すだけなので、既存の設定は消えません。
Q4. irm が認識されないと言われます（Windows）。
A. コマンドプロンプトでPowerShell用のコマンドを打っています。PowerShellを開いて打ち直すか、上の表の「コマンドプロンプト」用のコマンドを使ってください。
Q5. 会社のパソコンで直りません。 A. セキュリティソフトや社内ネットワークの制限が原因のこともあります。「表示されたエラー文」「試したこと」をメモして、社内のIT担当者に相談するのが近道です。
まとめ
- 原因はほとんどがPATH。本体は
~/.local/bin（Windowsは%USERPROFILE%\.local\bin）にある - ターミナルを開き直す → PATHを確認 → 追加して開き直す、の順で直る
- Windowsで更新直後に出たら、
claude.exeのバックアップ復元を試す - 入っていなければ公式コマンドで入れ直す。Node.jsは不要
- ターミナルが苦手なら、デスクトップアプリ版という選択肢もある
