はじめに
話題のClaude Code(ターミナルで動く対話型AIアシスタント)をWindows環境で使ってみようと思い、公式のインストールコマンドを実行しました。
Installation complete! と表示されてインストール自体は成功したはずなのに、いざ起動しようとすると以下のようなエラーが出てしまいました。
発生したエラー
PowerShellで claude と打ち込むと、以下のエラーが出ます。
claude : 用語 'claude' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されま
せん。名前が正しく記述されていることを確認し、パスが含まれている場合はそのパスが正しいことを確認してから、再試行してく
ださい。
発生場所 行:1 文字:1
+ claude
+ ~~~~~~
+ CategoryInfo : ObjectNotFound: (claude:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException
原因
インストーラーによってファイル自体はPCにダウンロードされているのですが、Windows(PowerShell)側が「claudeというコマンドがどこにあるか」を把握できていない(パスが通っていない)のが原因です。
インストール時のログをよく見ると、実は以下のような警告メッセージが出ていました。
Native installation exists but C:\Users\<ユーザー名>\.local\bin is not in your PATH...
指示通りに環境変数(PATH)を追加してあげれば解決します。
解決手順(PATHの追加)
① Windowsのキーボードの「Winキー」を押し、検索バーに 環境変数 と入力します。
② 画面の上半分(ユーザー環境変数)の中にある Path を選択し、「編集」ボタンを押します。
③ 右上の「新規」ボタンをクリックし、以下のパスを追加します。
C:\Users\<自分のユーザー名>\.local\bin
※ <自分のユーザー名> の部分は、ご自身のWindowsのユーザー名に書き換えてください。
自分のユーザー名がわからない場合は、PowerShellで $env:USERNAME と入力すると確認できます。
「OK」を押して、設定画面をすべて閉じます。
【重要】ここで必ず、今開いているPowerShellを一度「×」ボタンで閉じてください。(再起動しないと環境変数が反映されません)
動作確認
新しくPowerShellを開き直し、以下のコマンドを入力します。
claude --version
2.1.71 (Claude Code) のようにバージョン情報が表示されれば、無事にパスが通り、設定完了です!
あとは作業したいプロジェクトのディレクトリに移動して claude と入力すれば、AIとの対話がスタートします。
Windows環境で同じエラーに引っかかった方の参考になれば幸いです!
