​
檢查系統需求

  • 作業系統: macOS 10.15+、Ubuntu 20.04+/Debian 10+，或透過 WSL 的 Windows
  • 硬體: 最少 4GB RAM
  • 軟體:
    • Node.js 18+
    • git 2.23+（可選）
    • GitHub 或 GitLab CLI 用於 PR 工作流程（可選）
  • 網路: 需要網際網路連線進行驗證和 AI 處理
  • 地區: 僅在支援的國家提供
WSL 安裝疑難排解目前，Claude Code 無法直接在 Windows 上執行，而是需要 WSL。如果您在 WSL 中遇到問題：
  1. 作業系統/平台偵測問題: 如果您在安裝過程中收到錯誤，WSL 可能正在使用 Windows 的 npm。請嘗試：
    • 在安裝前執行 npm config set os linux
    • 使用 npm install -g @anthropic-ai/claude-code --force --no-os-check 安裝（請勿使用 sudo）
  2. 找不到 Node 錯誤: 如果您在執行 claude 時看到 exec: node: not found，您的 WSL 環境可能正在使用 Windows 安裝的 Node.js。您可以使用 which npm 和 which node 來確認，這些應該指向以 /usr/ 開頭的 Linux 路徑，而不是 /mnt/c/。要修復此問題，請嘗試透過您的 Linux 發行版的套件管理器或透過 nvm 安裝 Node。

​
安裝和驗證

1

安裝 Claude Code

To install Claude Code, run the following command:
npm install -g @anthropic-ai/claude-code
2

導航到您的專案

bash cd your-project-directory
3

啟動 Claude Code

bash claude
4

完成驗證

Claude Code 提供多種驗證選項：1. Anthropic Console: 預設選項。透過 Anthropic Console 連接並完成 OAuth 流程。需要在 console.anthropic.com 啟用計費。2. Claude App（使用 Pro 或 Max 方案）: 訂閱 Claude 的 Pro 或 Max 方案，獲得統一訂閱，包括 Claude Code 和網頁介面。以相同價格獲得更多價值，同時在一個地方管理您的帳戶。使用您的 Claude.ai 帳戶登入。在啟動期間，選擇符合您訂閱類型的選項。3. 企業平台: 配置 Claude Code 使用 Amazon Bedrock 或 Google Vertex AI 進行企業部署，使用您現有的雲端基礎設施。

​
初始化您的專案

對於首次使用者，我們建議：
1

啟動 Claude Code

bash claude
2

執行簡單命令

bash summarize this project
3

生成 CLAUDE.md 專案指南

bash /init
4

提交生成的 CLAUDE.md 檔案

請 Claude 將生成的 CLAUDE.md 檔案提交到您的儲存庫。