設定 Claude Code
在您的開發機器上安裝、驗證並開始使用 Claude Code。
系統需求
- 作業系統: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 支援的國家
額外相依性
- ripgrep:通常隨 Claude Code 一起包含。如果搜尋功能失效,請參閱搜尋疑難排解。
標準安裝
To install Claude Code, run the following command:
請勿使用 sudo npm install -g
,因為這可能導致權限問題和安全風險。
如果您遇到權限錯誤,請參閱設定 Claude Code 以獲得建議的解決方案。
某些使用者可能會自動遷移到改良的安裝方法。
安裝後執行 claude doctor
來檢查您的安裝類型。
安裝程序完成後,導航到您的專案並啟動 Claude Code:
Claude Code 提供以下驗證選項:
- Anthropic Console:預設選項。透過 Anthropic Console 連接並完成 OAuth 程序。需要在 console.anthropic.com 啟用計費。
- Claude App(搭配 Pro 或 Max 方案):訂閱 Claude 的 Pro 或 Max 方案,獲得包含 Claude Code 和網頁介面的統一訂閱。以相同價格獲得更多價值,同時在一個地方管理您的帳戶。使用您的 Claude.ai 帳戶登入。在啟動期間,選擇符合您訂閱類型的選項。
- 企業平台:設定 Claude Code 使用 Amazon Bedrock 或 Google Vertex AI 進行企業部署,搭配您現有的雲端基礎設施。
Claude Code 安全地儲存您的憑證。詳情請參閱憑證管理。
Windows 設定
選項 1:WSL 中的 Claude Code
- 支援 WSL 1 和 WSL 2
選項 2:原生 Windows 上的 Claude Code 搭配 Git Bash
- 需要 Git for Windows
- 對於可攜式 Git 安裝,請指定您的
bash.exe
路徑:
替代安裝方法
Claude Code 提供多種安裝方法以適應不同環境。
如果您在安裝過程中遇到任何問題,請參閱疑難排解指南。
安裝後執行 claude doctor
來檢查您的安裝類型和版本。
全域 npm 安裝
上述安裝步驟中顯示的傳統方法
原生二進位安裝(Beta)
如果您已有 Claude Code 的現有安裝,請使用 claude install
開始原生二進位安裝。
對於全新安裝,執行以下命令:
macOS、Linux、WSL:
Alpine Linux 和其他基於 musl/uClibc 的發行版:原生建置需要您安裝 ripgrep
。安裝(Alpine:apk add ripgrep
)並設定 USE_BUILTIN_RIPGREP=0
。
Windows PowerShell:
原生 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 時生效
停用自動更新: