Claude Code
Claude Code 入門指南
了解如何安裝、驗證和開始使用 Claude Code。
檢查系統需求
- 作業系統:macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或透過 WSL 使用 Windows
- 硬體:最低 4GB RAM
- 軟體:
- 網路:需要網際網路連接進行驗證和 AI 處理
- 地區:僅在支援的國家可用
WSL 安裝疑難排解
目前,Claude Code 無法直接在 Windows 上運行,而需要 WSL。如果您在 WSL 中遇到問題:
-
OS/平台檢測問題:如果您在安裝過程中收到錯誤,WSL 可能正在使用 Windows 的
npm
。請嘗試:- 在安裝前執行
npm config set os linux
- 使用
npm install -g @anthropic-ai/claude-code --force --no-os-check
進行安裝(請勿使用sudo
)
- 在安裝前執行
-
找不到 Node 錯誤:如果在運行
claude
時看到exec: node: not found
,您的 WSL 環境可能正在使用 Windows 安裝的 Node.js。您可以通過which npm
和which node
確認這一點,這些命令應該指向以/usr/
開頭的 Linux 路徑,而不是/mnt/c/
。要解決此問題,請嘗試通過 Linux 發行版的套件管理器或通過nvm
安裝 Node。
安裝和驗證
1
安裝 Claude Code
Install NodeJS 18+, then run:
Do NOT use sudo npm install -g
as this can lead to permission issues and
security risks. If you encounter permission errors, see configure Claude
Code for recommended solutions.
2
導航到您的專案
3
啟動 Claude Code
4
完成驗證
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 進行企業部署,利用您現有的雲端基礎設施。
初始化您的專案
對於首次使用者,我們建議:
1
啟動 Claude Code
2
執行簡單命令
3
生成 CLAUDE.md 專案指南
4
提交生成的 CLAUDE.md 檔案
請 Claude 將生成的 CLAUDE.md 檔案提交到您的儲存庫。