Claude Code 使用教學：Windows/macOS 一文裝好並上手

這篇 Claude 使用教學專講 Claude Code：從安裝、驗證到綁定 API Key，再到常見報錯排查。按步驟走，10 分鐘內就能在終端裡把 Claude Code 跑起來，用它做程式碼生成、改錯和簡單的開發協作。

一、安裝前準備：Node.js 版本別踩坑

Claude Code 依賴 Node.js 環境，建議先安裝 Node.js 18 及以上版本，再開啟新的終端視窗。Windows 使用者用安裝包一路下一步即可，macOS 可用官方安裝包或套件管理器安裝。裝完後在終端輸入node -v確認版本號正常。

二、安裝 Claude Code：npm 全域安裝與國內鏡像

在終端執行全域安裝命令：npm install -g @anthropic-ai/claude-code，這就是最常用的 Claude Code 安裝方式。若你所在網路存取 npm 官方來源較慢，可改用鏡像來源：npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com。安裝完成後重新開啟終端，輸入claude --version驗證 Claude Code 是否可用。

三、首次執行與綁定 API Key：讓 Claude Code 真正可用

Claude Code 需要 Anthropic 的 API Key 授權，首次執行claude時通常會引導你設定 Key。更穩妥的方式是先在系統裡設定環境變數ANTHROPIC_API_KEY，再啟動 Claude Code，避免每次重複輸入。完成後在專案目錄進入終端，用自然語言描述任務即可，例如讓 Claude Code 分析報錯、生成修復補丁並提示你如何驗證。

四、Claude Code 常見問題：卡住、報錯與中斷怎麼處理

如果 Claude Code 出現請求失敗或頻繁中斷，優先檢查網路穩定性與是否觸發了伺服器端限流；換更穩定的網路環境通常能明顯改善。遇到安裝報錯，多數與 Node.js 版本過低或全域權限有關，升級 Node.js 並用管理員/sudo 權限重裝往往能解決。若claude --version無輸出，建議確認全域 npm 路徑已加入 PATH，並在新終端裡再次執行 Claude Code。