這十個問題佔了 Claude Code 安裝和身份驗證支援工單的絕大多數。每個條目都包含最可靠的解決方案。
1. claude: command not found 安裝後立即出現。
安裝程式已將 claude 新增到您的 PATH，但您目前的 shell 尚未載入。開啟新的終端機，或執行 source ~/.zshrc（或 ~/.bashrc）。在 Windows 上，關閉並重新開啟 PowerShell。
2. npm install 失敗，出現 EACCES / 權限被拒。
這通常表示安裝是使用 sudo 執行的，或您的全域 npm 目錄由 root 擁有。不要使用 sudo。改為使用 curl 安裝程式，或使用 npm config set prefix ~/.npm-global 修復 npm 的前綴，並將該 bin 目錄新增到您的 PATH。
3. "不支援的 Node 版本" 或啟動時無聲崩潰。
Claude Code 需要 Node 18 或更新版本。使用 node -v 檢查您的版本。如果版本較舊，請透過 nvm install --lts 安裝目前版本，或使用 curl 安裝程式，它包含自己的執行時環境，完全避免此問題。
4. WSL：claude 執行 Windows Node 而不是 Linux Node。
Windows PATH 洩漏到 WSL 並覆蓋 nvm。在 ~/.bashrc 中將您的 Linux node 前置到 PATH：export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"
5. 安裝程式在公司網路後面掛起或失敗。
下載主機（storage.googleapis.com）可能被阻止。首先使用 export HTTPS_PROXY=http://your-proxy:port 設定您的代理，然後重新執行安裝程式。如果無法進行，請向您的 IT 團隊要求離線套件。
6. SELF_SIGNED_CERT_IN_CHAIN 或其他 TLS 錯誤。
您的公司注入了自己的憑證。將 Node 指向公司 CA 套件：export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem 將其新增到您的 shell 設定檔以便持續存在。
7. /login 開啟瀏覽器，但終端機永遠無法完成（"等待身份驗證…"）。
這通常表示 localhost 回呼被阻止，這在遠端 SSH、devcontainers 或嚴格防火牆後面很常見。改為使用手動流程：複製終端機中列印的 URL，在任何瀏覽器中完成登入，然後將傳回的代碼貼回終端機。
8. "未驗證" 儘管您設定了 ANTHROPIC_API_KEY。
有三個常見原因：金鑰在不同的 shell 中匯出（執行 echo $ANTHROPIC_API_KEY 檢查），您之前執行了 /login 且 OAuth 工作階段優先（先執行 /logout），或金鑰是主控台金鑰，但您的組織改為需要 SSO 登入。
9. Bedrock / Vertex："無法載入認證。"
Claude Code 使用標準提供者 SDK，因此修復與任何 AWS/GCP CLI 工具相同。對於 Bedrock，確認 aws sts get-caller-identity 有效且 AWS_REGION 設定為啟用您的模型的區域。對於 Vertex，確認已執行 gcloud auth application-default login 且 GOOGLE_CLOUD_PROJECT 已設定。
10. 已安裝並驗證，但每個請求都出現 403 / "模型不可用" 錯誤。
您的帳戶存在，但無法存取 Claude Code 要求的模型。對於企業席位，確認您的席位在您組織的管理員設定中處於活動狀態。在 Bedrock 或 Vertex 上，確認該特定 Claude 模型在該區域或專案中已啟用。作為快速解決方案，執行 /model 並選擇您知道有權存取的模型。
仍然卡住？
從您的正常 shell（不是從 Claude 工作階段內）執行 claude doctor。它會列印診斷報告，您可以附加到支援工單。