​
系統需求

  • 作業系統: macOS 10.15+、Ubuntu 20.04+/Debian 10+，或 Windows 10+（搭配 WSL 1、WSL 2 或 Git for Windows）
  • 硬體: 4GB+ RAM
  • 軟體: Node.js 18+
  • 網路: 需要網際網路連線進行驗證和 AI 處理
  • Shell: 在 Bash、Zsh 或 Fish 中運作最佳
  • 地區: Anthropic 支援的國家

​
標準安裝

To install Claude Code, run the following command:

npm install -g @anthropic-ai/claude-code

請勿使用 sudo npm install -g，因為這可能導致權限問題和安全風險。 如果您遇到權限錯誤，請參閱設定 Claude Code 以獲得建議的解決方案。

某些使用者可能會自動遷移到改進的安裝方法。 安裝後執行 claude doctor 來檢查您的安裝類型。

安裝程序完成後，導航到您的專案並啟動 Claude Code：

cd your-awesome-project
claude

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 進行企業部署，搭配您現有的雲端基礎設施。

Claude Code 安全地儲存您的憑證。詳情請參閱憑證管理。

​
Windows 設定

選項 1: 在 WSL 中使用 Claude Code

  • 支援 WSL 1 和 WSL 2

選項 2: 在原生 Windows 上使用 Git Bash 執行 Claude Code

  • 需要 Git for Windows
  • 對於可攜式 Git 安裝，請指定您的 bash.exe 路徑： 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

​
替代安裝方法

Claude Code 提供多種安裝方法以適應不同環境。

如果您在安裝過程中遇到任何問題，請參閱疑難排解指南。

安裝後執行 claude doctor 來檢查您的安裝類型和版本。

​
全域 npm 安裝

上述安裝步驟中顯示的傳統方法

​
原生二進位安裝（Beta）

如果您已有 Claude Code 的現有安裝，請使用 claude install 開始原生二進位安裝。

對於全新安裝，執行以下命令：

macOS、Linux、WSL:

# 安裝穩定版本（預設）
curl -fsSL https://claude.ai/install.sh | bash

# 安裝最新版本
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安裝特定版本號
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Windows PowerShell:

# 安裝穩定版本（預設）
irm https://claude.ai/install.ps1 | iex

# 安裝最新版本
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# 安裝特定版本號
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

原生 Claude Code 安裝程式支援 macOS、Linux 和 Windows。

確保您移除任何過時的別名或符號連結。 安裝完成後，執行 claude doctor 來驗證安裝。

​
本地安裝

  • 透過 npm 全域安裝後，使用 claude migrate-installer 遷移到本地
  • 避免自動更新程式 npm 權限問題
  • 某些使用者可能會自動遷移到此方法

​
在 AWS 或 GCP 上執行

預設情況下，Claude Code 使用 Anthropic 的 API。

有關在 AWS 或 GCP 上執行 Claude Code 的詳細資訊，請參閱第三方整合。

​
更新 Claude Code

​
自動更新

Claude Code 會自動保持最新狀態，確保您擁有最新功能和安全修復。

  • 更新檢查: 在啟動時和執行期間定期執行
  • 更新程序: 在背景自動下載和安裝
  • 通知: 安裝更新時您會看到通知
  • 套用更新: 更新在您下次啟動 Claude Code 時生效

停用自動更新:

# 透過設定
claude config set autoUpdates false --global

# 或透過環境變數
export DISABLE_AUTOUPDATER=1

​
手動更新

claude update