跳轉到主要內容

​
系統需求

  • 作業系統：macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或 Windows 10+（使用 WSL 1、WSL 2 或 Git for Windows）
  • 硬體：4GB+ RAM
  • 軟體：Node.js 18+（僅 NPM 安裝時需要）
  • 網路：驗證和 AI 處理需要網際網路連線
  • Shell：在 Bash、Zsh 或 Fish 中效果最佳
  • 位置：Anthropic 支援的國家

​
其他依賴項

  • ripgrep：通常包含在 Claude Code 中。如果搜尋功能失敗，請參閱搜尋疑難排解。

​
標準安裝

To install Claude Code, use one of the following methods:
某些使用者可能會自動遷移到改進的安裝方法。
安裝程序完成後，導航到您的專案並啟動 Claude Code： 
cd your-awesome-project
claude
Claude Code 提供以下驗證選項：
  1. Claude Console：預設選項。透過 Claude Console 連線並完成 OAuth 程序。需要在 console.anthropic.com 上有有效的帳單。系統會自動建立「Claude Code」工作區用於使用情況追蹤和成本管理。請注意，您無法為 Claude Code 工作區建立 API 金鑰 - 它專門用於 Claude Code 使用。
  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：使用 Git Bash 在原生 Windows 上執行 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 以檢查您的安裝類型和版本。

​
原生安裝選項

原生安裝是推薦的方法，並提供多項優勢：
  • 一個自包含的可執行檔
  • 無 Node.js 依賴
  • 改進的自動更新程式穩定性
如果您已有 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
Alpine Linux 和其他 musl/uClibc 型發行版：原生建置需要您安裝 libgcc、libstdc++ 和 ripgrep。安裝（Alpine：apk add libgcc libstdc++ ripgrep）並設定 USE_BUILTIN_RIPGREP=0。
透過 Homebrew 安裝的 Claude Code 將在 brew 目錄外自動更新，除非使用 DISABLE_AUTOUPDATER 環境變數明確停用（請參閱自動更新部分）。
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
Windows CMD： 
REM 安裝穩定版本（預設）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM 安裝最新版本
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM 安裝特定版本號
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
確保在安裝前移除任何過時的別名或符號連結。

​
NPM 安裝

對於偏好或需要 NPM 的環境： 
npm install -g @anthropic-ai/claude-code
請勿使用 sudo npm install -g，因為這可能導致權限問題和安全風險。 如果您遇到權限錯誤，請參閱設定 Claude Code 以獲得建議的解決方案。

​
本機安裝

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

​
在 AWS 或 GCP 上執行

根據預設，Claude Code 使用 Claude API。 有關在 AWS 或 GCP 上執行 Claude Code 的詳細資訊，請參閱第三方整合。

​
更新 Claude Code

​
自動更新

Claude Code 會自動保持最新狀態，以確保您擁有最新的功能和安全修復。
  • 更新檢查：在啟動時和執行時定期執行
  • 更新程序：在背景中自動下載和安裝
  • 通知：安裝更新時您會看到通知
  • 套用更新：更新在您下次啟動 Claude Code 時生效
停用自動更新： 在您的 shell 或 settings.json 檔案中設定 DISABLE_AUTOUPDATER 環境變數： 
export DISABLE_AUTOUPDATER=1

​
手動更新

claude update