常見問題排解

輸入 claude 顯示「command not found」

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

▲ 典型的 command not found 錯誤訊息

Code 模式沒有反應

桌面版的 Code 模式需要 Claude Code 才能運作。請確認你已經完成終端安裝步驟：

• Mac：在終端機執行 curl -fsSL https://claude.ai/install.sh | bash
• Windows：在 PowerShell（系統管理員）執行 irm https://claude.ai/install.ps1 | iex

安裝完成後重新開啟 Claude Desktop，Code 模式就能正常運作。

▲ 終端機安裝 Claude Code 示範

Mac 安裝時卡很久

第一次安裝需要下載 Xcode Command Line Tools，檔案很大，網路不快的情況下可能要 30～60 分鐘。請耐心等待，不要中斷安裝。

▲ 安裝過程中會自動下載必要工具，請耐心等待

Windows PowerShell 執行指令失敗

• 確認是以系統管理員身分執行 PowerShell
• 確認已先安裝 Git for Windows
• 如果還是失敗，試試 winget install Anthropic.ClaudeCode

▲ Windows 環境變數 PATH 設定 — 確認包含 Claude 路徑

安裝成功但無法登入

• 確認你有 Claude 帳號（可在 claude.ai 註冊）
• 確認網路連線正常
• 如果使用公司網路，可能被防火牆擋下，請試試手機熱點

▲ Claude Desktop 登入畫面 — 確認帳號與網路正常

最後更新：2026/07/11 | FutureCorp Consulting