情報科学屋さんを目指す人のメモ

方法・手順・解説を書き残すブログ。私と同じことを繰り返さずに済むように。

【Claude Code】「認識されません」エラーでclaudeコマンドが実行できない原因と対策

Claude (29)

Windows 11 PCで、PowerShellから「Claude Code」をインストールして成功したはずであるにもかかわらず、claudeコマンドを実行してみると「claude : 用語 'claude' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。名前が正しく記述されていることを確認し、パスが含まれている場合はそのパスが正しいことを確認してから、再試行してください。」エラーが表示されてしまい、claudeコマンドが見つからない/実行できない問題が発生してしまう場合があります。

この、インストールしたはずのClaudeコマンドが利用できない問題の発生原因と、インストール時の注意点について紹介します。

claudeコマンドが認識されない

Claude Codeの公式ドキュメント(2026年最新版)に従うと、PowerShellからのインストールは、次のコマンドを実行することとされています。

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

こちらに従ってインストールを実行した結果、次のメッセージが表示され「インストールが成功した!」と思ったものの、実際にclaudeコマンドを実行して利用しようとした段階でなぜかインストールできていない、コマンドが使えない、と困ってしまう場合があります。

✅ Installation complete!

具体的には、次のエラーが表示されてしまい、コマンドが実行できません。

claude
claude : 用語 'claude' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。名前が正しく記述されていることを確認し、パスが含まれている場合はそのパスが正しいことを確認してから、再試行してください。
発生場所 行:1 文字:1
+ claude
+ ~~~~~~
+ CategoryInfo : ObjectNotFound: (claude:String) [], ParentContainsErrorRecordException
+ FullyQualifiedErrorId : CommandNotFoundException

「名前として認識されません」とあり、これは存在しないコマンドを利用しようとした際に発生するエラーであり、インストールができていないのではないか、PATHが通っていないのではないか、とも考えられるエラーです。

「Installation complete!」がインストール成功ではない

このケースで大きなポイントとなるのが、「インストールには成功したはずなのに」という点です。

その「インストールが成功したはず」と感じた「理由」がポイントで、その理由が「Installation complete!」表示であった場合、実はインストールできていない可能性があります。

具体的には、事前に別のプログラムのインストールが行われていなかった場合に、次のエラーが出てしまった上で、「Installation complete!」が表示される場合があります。

Setting up Claude Code...
Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win). If installed but not in PATH, set environment variable pointing to your bash.exe, similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

赤文字でエラーが表示されてはいたものの、「Installation complete!」が最後に表示されたことで安心してしまい、次の手順の「cd your-project」および「claude」の実行を行ってしまい、コマンドが見つからないエラーになってしまう、という状況です。

対策

元々発生していたエラーメッセージに従い、https://git-scm.com/install/windows にアクセスした上で、「Click here to download」をクリックして「Git-2.53.0-64-bit.exe」をダウンロードしてダブルクリックして実行してインストーラーからインストールを行います。

そして改めてインストールコマンド「irm https://claude.ai/install.ps1 | iex」を実行すると、エラーの発生なしに次のメッセージが表示されます。

Setting up Claude Code...

√ Claude Code successfully installed!

Version: 2.1.42

Location: C:\Users\(ユーザー名)\.local\bin\claude.exe


Next: Run claude --help to get started

‼ Setup notes:
• Native installation exists but C:\Users\(ユーザー名)\.local\bin is not in your PATH. Add it by opening: System Properties → Environment Variables → Edit User PATH → New → Add the path above. Then restart your terminal.

✅ Installation complete!

「√ Claude Code successfully installed!」という部分が緑色の文字で表示され、赤色の文字(エラー)が表示されず、インストールコマンドの実行結果全体で見れば、かなり元の結果とは異なる見た目となっていることが特徴です。

一方で、成功しても失敗してもあくまで「✅ Installation complete!」という最後の行は表示される、という点には注意が必要です。

PATHを設定する

このインストール完了直後に「claude」を実行するとまた同じエラーになってしまいます。

それは、先ほどのインストール完了結果に表示されていた、次の指示を実行していない場合に発生します。

Native installation exists but C:\Users\did2\.local\bin is not in your PATH. Add it by opening: System Properties → Environment Variables → Edit User PATH → New → Add the path above. Then restart your terminal.

この内容に従い、まず最初にWindowsのタスクバーの左端にあるスタートボタン(Windowsロゴボタン)をクリックしてから「システムの詳細設定の表示」と入力して同名の候補表示をクリックすることで、「システムのプロパティ」を表示します。

そうしたら、「詳細設定」タブの一番右下に表示される「環境変数(N)...」をクリックします。

すると「環境変数」ダイアログが表示されるので、上半分に表示されている「○○のユーザー環境変数(U)」の枠内にある表内の「Path」という変数名を選択して「編集(E)...」をクリックします。

「環境変数名の編集」というダイアログが表示されるので、ここに新しい項目を追加するために「新規(N)」をクリックし、「C:\Users\(ユーザー名)\.local\bin」と入力してこう重くを追加し、「OK」で閉じます。元々表示されていた「環境変数」のダイアログまで「OK」で閉じておいて初めて環境変数設定が更新されるため、そこまで閉じるようにしてください。

※「(ユーザー名)」の部分は実際のユーザー名と置き換えます。

そうしてから、PowerShellを一度終了し、再起動します(再起動するまで反映されず、同じエラーが表示され続けてしまいます)。

claudeコマンドのインストール成功

ここまで設定してから「claude」コマンドを実行すると、「Welcome to Claude Code v2.1.42」で始まる画面が表示され、Claude Codeの初期設定を開始することが可能です。

Claude Codeの初期設定

最初に「Choose the text style that looks best with your terminal」と表示されるので、「1. Dark mode √」が選択された状態のままEnterキーを押して先へ進みます。

続いて、「Claude Code can be used with your Claude subscription or billed based on API usage through your Console account.」と表示されるので、Claudeの有料プランを契約しているのであれば、「1. Claude account with subscription」を選択した状態でEnterキーを押します。

すると、ログイン用にブラウザが開き、「Claude CodeさんがClaude chat accountのへの接続を希望しています」と表示されるので、内容を確認して「承認する」をクリックします。

「Logged in as ○○ Login successful. Press Enter to continue...」と表示されたらEnterをクリックし、「Security notes」が表示されたら内容を確認して改めて「Enter」をクリックします。

関連(Claude Desktop上の表示)

なお、Claude Desktopで「コード」に切り替えた場合、同じエラーメッセージに相当する次のメッセージが表示され、こちらでもGit for Windowsのダウンロードが促されます。

ローカルセッションにはGitが必要です。Git for Windowsをダウンロードするか、CLAUDE_CODE_GIT_BASH_PATH環境変数をgit実行ファイルに設定してから、アプリを再起動してください。

コメント(0)

新しいコメントを投稿