【Windows】Claude Codeが「コマンドが認識されません」エラーで起動しない時の解決法

はじめに

Windows環境でClaude Codeを使用していたところ、ある日突然以下のエラーが発生しました。

claude: The term 'claude' is not recognized as a name of a cmdlet, 
function, script file, or executable program.

前日まで正常に動作していたため、原因の特定と解決方法をまとめます。

環境

• Windows 10/11
• PowerShell
• Claude Code（自動アップデート後）

問題の原因

Claude Codeの自動アップデートにより、npmインストールからネイティブインストールに自動移行されたことが原因です。

この移行により、実行ファイルの配置場所が変更され、PATH環境変数に含まれなくなりました。

変更内容

項目	変更前（npm）	変更後（ネイティブ）
インストール場所	C:\Users\[username]\AppData\Roaming\npm\	C:\Users\[username]\.local\bin\
PATH追加	npm側で自動	手動で必要

解決方法

ステップ1: PATH環境変数に追加

以下のコマンドをPowerShellで実行します。

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\[username]\.local\bin", "User")

[username]は実際のユーザー名に置き換えてください。

ステップ2: PowerShellを再起動

環境変数の変更を反映させるため、PowerShellを一度閉じて再起動します。

ステップ3: 動作確認

claude --version

バージョンが表示されれば成功です。

GUIで設定する場合

PowerShellコマンドを使いたくない場合は、以下の手順で設定できます。

1. Win + Rキーを押す
2. sysdm.cplと入力してEnterキーを押す
3. 「詳細設定」タブをクリック
4. 「環境変数」ボタンをクリック
5. 「ユーザー環境変数」セクションで「Path」を選択
6. 「編集」ボタンをクリック
7. 「新規」ボタンをクリック
8. C:\Users\[username]\.local\binを入力
9. すべてのダイアログで「OK」をクリック
10. PowerShellを再起動

一時的な対処法

すぐに作業を再開したい場合は、以下の方法で一時的に対処できます。

方法1: フルパスで実行

C:\Users\[username]\.local\bin\claude.exe

方法2: 現在のセッションのみPATHを通す

$env:Path += ";C:\Users\[username]\.local\bin"
claude

この方法は現在のPowerShellセッションのみ有効です。PowerShellを閉じると設定が失われます。

トラブルシューティング

インストール場所が分からない場合

以下のコマンドで確認できます。

where.exe claude.exe

または、再インストールして確認：

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

インストールメッセージに場所が表示されます。

PATHが正しく設定されているか確認

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

何も表示されなければ、PATHに追加されていません。

それでも動作しない場合

1. PowerShellを管理者権限で起動していることを確認
2. システムを再起動（稀にOS側のキャッシュが残る場合がある）
3. Claude Codeを再インストール

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

なぜネイティブインストールに移行したのか

公式ドキュメントによると、以下のメリットがあります：

• Node.jsへの依存を削減
• より安定した自動アップデート
• 単一の実行ファイルで動作

技術的には、ネイティブインストールの方が依存関係がシンプルで保守性が高い選択です。

まとめ

Claude Codeが突然起動しなくなった場合は、以下を確認してください：

1. ネイティブインストールへの自動移行が原因の可能性
2. C:\Users\[username]\.local\binをPATH環境変数に追加
3. PowerShellを再起動

この記事が同じ問題に遭遇した方の助けになれば幸いです。

参考

• Claude Code公式ドキュメント

---

こうした技術的な判断や問題解決のプロセスを、もう少し整理して書いています。興味があれば、こちらにまとめています。