WSL2 Ubuntu 中 Claude CLI “command not found” 故障排查與修復環境Windows 11 WSL2 Ubuntu 22.04 Node.js (nvm) Claude Code CLI問題長期使用的claude命令突然提示command not found1. 現象在終端中輸入claude --dangerously-skip-permissions報錯claude: command not found檢查~/.local/bin/claude不存在source ~/.bashrc也無效。2. 排查過程2.1 檢查是否真正安裝過find/home/lium-nameclaude-typef2/dev/null輸出/home/lium/.nvm/versions/node/v20.20.2/lib/node_modules/anthropic-ai/claude-code/node_modules/anthropic-ai/claude-code-linux-x64/claude /home/lium/.vscode-server/extensions/anthropic.claude-code-2.1.220-linux-x64/resources/native-binary/claude說明二進制文件確實存在但未在PATH中暴露。2.2 檢查 PATH 是否包含 Node 的 bin 目錄echo$PATH|grepv20.20.2/bin無輸出說明 nvm 管理的 Node.js 二進制目錄不在 PATH 中或被其他配置覆蓋。2.3 檢查 PATH 整體$PATH中包含大量 Windows 路徑如C:\...和一個錯誤片段Unknown command: bin嚴重干擾了 Linux 命令查找。3. 根本原因Claude CLI 實際是通過 npm 全局安裝的anthropic-ai/claude-code包提供的其可執行文件位于 node_modules 深層目錄。安裝時本應自動創建軟鏈接到$HOME/.nvm/versions/node/v20.20.2/bin/下但該鏈接丟失或從未創建可能是 npm 全局鏈接損壞、手動清理或權限問題。同時PATH 環境變量混亂未包含該 bin 目錄導致即使文件存在也無法識別。4. 解決方案4.1 手動創建軟鏈接無需重新下載ln-sf/home/lium/.nvm/versions/node/v20.20.2/lib/node_modules/anthropic-ai/claude-code/node_modules/anthropic-ai/claude-code-linux-x64/claude ~/.nvm/versions/node/v20.20.2/bin/claude4.2 將 Node 的 bin 目錄添加到 PATH 并持久化echoexport PATH$HOME/.nvm/versions/node/v20.20.2/bin:$PATH~/.bashrcsource~/.bashrc4.3 驗證claude --dangerously-skip-permissions成功啟動 Claude Code 界面問題解決。5. 補充建議國內用戶由于網絡環境重新下載可能較慢。本方案利用已有二進制無需下載。若需重新安裝建議先配置 npm 鏡像npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude并確保 nvm 的 bin 目錄在 PATH 中。6. 預防措施檢查 PATH 是否包含$HOME/.nvm/versions/node/$(nvm current)/bin。避免將 Windows 路徑直接放入 WSL 的 PATH可在~/.bashrc開頭重置 PATH。定期檢查全局 npm 包的鏈接是否完整。一句話總結command not found不一定代表軟件未安裝很多時候只是可執行文件沒有被正確鏈接到 PATH 中找到真實文件并恢復鏈接即可快速修復。