Claude Codeで「too many levels of symbolic links」——自己参照シンボリックリンクバグが3回再発した記録
claudeコマンドが「too many levels of symbolic links」で動かなくなる不具合。原因はネイティブインストーラーが~/.local/bin/claudeを自己参照する相対シンボリックリンクに書き換えること。2026年4月から3回報告されながら未修正の経緯と応急処置・再発防止策を整理した。
3 articles
claudeコマンドが「too many levels of symbolic links」で動かなくなる不具合。原因はネイティブインストーラーが~/.local/bin/claudeを自己参照する相対シンボリックリンクに書き換えること。2026年4月から3回報告されながら未修正の経緯と応急処置・再発防止策を整理した。
Claude Codeをインストールしたのに「command not found: claude」「is not recognized」と出る原因をPATH・複数インストールの競合・VS Code拡張機能の落とし穴に分けて解説。macOS/Linux/Windows別のコマンド付き。
Claude Codeのインストールから実務活用まで、実体験ベースで全部書く。初めて動かした時の衝撃、CLAUDE.mdで世界が変わった話、コスト管理で痛い目を見た話まで。2026年最新。