注記
この記事は、Claude Code（AIアシスタント）と協働でトラブルシュートした実録です。 遠回りした過程もそのまま残しています。結論だけ知りたい方は「原因」と「教訓」をご覧ください。
はじめに
ある日、PowerShellでclaudeと入力してもClaude Codeが起動しなくなりました。
最初は「コマンド名が変わったのか」と疑いましたが、
結論から言うとコマンドはclaudeのままで変わっていませんでした。
原因にたどり着くまでにかなり遠回りをしたので、その過程と教訓を記録します。
切り分けはClaude Code自身に手伝ってもらいました。
皮肉なことに、その支援ツールの実行環境こそが遠回りの元凶でした。
環境
| 項目 | 内容 |
|---|---|
| OS | Windows 11 Pro |
| シェル | PowerShell 7.6.1 |
| Node.js | v24.15.0 |
| npm | 11.12.1 |
| 補助シェル | Git Bash（MINGW64） |
症状
新しいPowerShellを開いてclaudeを実行しても、次のエラーになります。
claude: The term 'claude' is not recognized as a name of a cmdlet, function, script file, or executable program.切り分けの記録
1. 診断ツールが応答しない
まず状況を確認しようとしたところ、
PowerShell側の診断コマンドがWrite-Output "hello"のような最小の内容でも応答しませんでした。
そこで動作するGit Bashへ切り替えて調査を続けました。
このときの「動くほうへ切り替える」という判断が、あとで大きな落とし穴になります。
2. そもそも未インストールだった
Git Bashで調べると、次の状態でした。
| 確認項目 | 結果 |
|---|---|
PATH上のclaude | なし |
| npmグローバル領域 | ディレクトリごと存在しない |
~/.local/bin | 存在しない |
| Node.js / npm | 利用可能 |
~/.claude（設定） | 残存 |
設定は残っているのに本体だけがない状態でした。コマンド名の変更ではなく、
Claude Code本体が消えていたことが原因と判断し、
npm install -g @anthropic-ai/claude-codeを実行しました。
インストールは数秒で完了しました。
3. 再インストールしたのに実機で起動しない
ところが、ユーザー側の実機PowerShellを新しく開いても、依然としてclaudeが見つかりません。
現在のセッションにPATHを一時追加しても結果は同じでした。
4. PATHは登録済み、それでも起動しない
Windowsのレジストリ上のユーザー環境変数PATHを確認すると、
C:\Users\<user>\AppData\Roaming\npmはきちんと登録されていました。
設定自体は正しいのに起動しません。
ここで「ターミナルアプリが古い環境を保持しているのでは」という仮説を立てましたが、これは外れでした。
5. 決定的な発見 — 別環境を見ていた
実機PowerShellで次を実行してもらい、ようやく核心がわかりました。
Test-Path "$env:APPDATA\npm"結果はFalseでした。インストール先のディレクトリが、実機からは存在しないのです。
一方、調査に使っていたGit Bashからは同じパスにファイルがはっきり見えていました。
つまり、診断とnpm installを実行していたGit Bashは、
Claude Codeの支援ツールが動くサンドボックス側の環境であり、
ユーザーが操作している実機とは別のファイルシステムでした。
再インストールは別環境に対して行われ、実機には一切反映されていなかったのです。
最初に「PowerShellの診断が全滅した」のは、そのツールが実機に届いていなかったサインでした。
6. 実機で再インストールして解決
原因がわかれば対応は単純でした。実機のPowerShellで直接インストールします。
npm install -g @anthropic-ai/claude-codeインストール後、フルパスとコマンド名の両方で起動を確認しました。
& "$env:APPDATA\npm\claude.cmd" --version
claude --versionどちらも2.1.143 (Claude Code)を返し、解決しました。
実機のユーザー環境変数PATHにはnpmのパスが元から登録されていたため、
本体さえ入れば新しいセッションでそのまま起動します。
原因
直接の原因は、Claude Code本体が実機に存在しなかったことです （npmグローバル領域がディレクトリごと消失していました）。
遠回りの原因は別にあります。調査と再インストールを、 実機ではなくAI支援ツールのサンドボックス環境に対して行っていたことです。
両者は状態がよく似た別環境だったため、ツール上では成功しているように見えていました。
教訓
今回の遠回りから得た教訓は次のとおりです。
- AI支援ツールの実行環境と実機を同一視しない。
- ツールが動くシェルが、必ずしも自分の実機とは限りません。状態が似ていると混同しやすく、危険です。
- 「動くほうへ切り替える」前に、その環境の正体を確認する。
- 片方のツールが応答しないときの乗り換えは、別環境への乗り換えになっている場合があります。
- 診断値を実機の事実と取り違えない。
npm config get prefixやレジストリの値も、取得した環境のものです。実機での再確認が要ります。
- 状態変更は実機で検証する。
- インストールやPATH変更は、最終的に実機で実行し、実機で起動を確認するまで完了とみなさないようにします。
- 応答しないツールはエラーではなくサインのことがある。
- 出力が空で失敗し続けるのは、対象に届いていない兆候かもしれません。
おわりに
claudeが起動しない原因は、コマンドの変更ではなく本体の消失でした。
そして解決を長引かせた本質は、AI支援ツールの環境と実機の取り違えでした。
支援ツールは便利ですが、その実行環境がどこを指しているのかを意識しないと、 成功したように見えて何も変わっていない、という事態に陥ります。
次に同じ状況へ出会ったら、まず「いま自分はどの環境を見ているのか」を最初に確認しようと思います。