PaPoo
cover

claude が command not found になるのに、インストール自体は成功したように見える

新しいターミナルを開くたびに claude が見つからない。けれど、インストールの途中では成功メッセージが出ている。そんなときは、まずこの2つの issue が自分の症状に近いかを見たほうがいいです。

1つは、install.shclaude install が「launcher と shell integration を設定した」と表示するのに、~/.local/binPATH に追加していないケースです。報告は macOS / zsh ですが、症状そのものは「入ったはずなのにシェルから見えない」です。該当 issue は #76060 です。

もう1つは、自動更新の途中で optional dependency のダウンロードが詰まり、更新は成功扱いで終わるのに、次の起動で claude: command not found になるケースです。こちらは #72690 です。報告では、bin/claude.exe が fallback stub のまま残り、bin/claude の symlink が作られないと書かれています。

ただし、今回の筆者環境で実際に確認できているのはここまでです。取得できた環境情報は次のとおりです。

[env_summary]
OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-09-03T08:51:17+09:00
$ node --version
v16.15.0

この時点では、claude が見つからない原因が「PATH に入っていない」のか、「インストール成果物が壊れている」のかは、issue の報告だけでは切り分けきれません。少なくとも #76060 では、~/.zshrc / ~/.zprofile / ~/.zshenv を見ても ~/.local/bin が追加されていなかった、と報告されています。つまり、成功メッセージが出ていても shell startup file の更新に失敗している可能性があります。

一方 #72690 は、インストール後ではなく更新後に壊れるパターンです。更新時にエラーが表に出ないまま終わるので、ユーザー側からは「突然 claude が消えた」ように見えるはずです。

もし自分の症状が 新しいターミナルでだけ claude が見えない なら、まず #76060 に近いです。フルパスでは起動する という報告もそこに合っています。逆に、アップデート直後から急に動かなくなったなら #72690 のほうが近いでしょう。

現時点で、これらの issue から言えるのは「成功表示だけでは正常終了と判断できない」ということです。どちらも、見た目は成功していても、実際には claude がシェルから引けない状態に落ちています。


検証環境

OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-09-03T08:51:17+09:00

参照した Issue(anthropics/claude-code): #76060, #72690

同じ著者の記事