以下是基于現有信息的簡明安裝指南,適用于macOS系統。請按照以下步驟操作:
前提條件
- 操作系統:macOS 10.15或更高版本。
- Node.js和npm:Claude Code基于Node.js,需安裝Node.js 18+和npm。請檢查是否已安裝:
- 打開終端,運行
node --version
和npm --version
。 - 如果未安裝,訪問 Node.js官方網站 下載并安裝最新LTS版本,或使用Homebrew:
brew install node
- 打開終端,運行
- Anthropic API密鑰:需要Anthropic賬戶和API密鑰:
- 訪問 Anthropic官網 創建賬戶。
- 在“Settings” > “Billing”中添加支付方式并購買至少5美元的API信用。
- 在“API Keys”頁面點擊“Create Key”,保存生成的密鑰(僅顯示一次,建議存入macOS密碼管理器)。
安裝步驟
-
打開終端:
- 在Mac上,打開“應用程序”文件夾中的“終端”。
-
安裝Claude Code:
- 在終端中運行以下命令以全局安裝Claude Code:
npm install -g @anthropic-ai/claude-code
- 避免使用
sudo
,若遇到權限問題,請檢查npm配置(參考Anthropic官方文檔)。
- 在終端中運行以下命令以全局安裝Claude Code:
-
驗證安裝:
- 安裝完成后,運行以下命令檢查Claude Code版本:
claude doctor
- 這將顯示安裝類型和版本信息。
- 安裝完成后,運行以下命令檢查Claude Code版本:
-
認證Claude Code:
- 首次運行
claude
命令時,會提示通過Anthropic Console進行OAuth認證:claude
- 按照提示在瀏覽器中登錄Anthropic賬戶,或輸入API密鑰。
- 或者,將API密鑰設置為環境變量以實現持久化:
echo 'export ANTHROPIC_API_KEY=你的API密鑰' >> ~/.zshrc source ~/.zshrc
- 如果使用bash,替換
~/.zshrc
為~/.bashrc
。
- 首次運行
-
開始使用:
- 導航到項目目錄:
cd 你的項目目錄
- 運行
claude
進入交互模式,開始與Claude Code交互,例如:claude > summarize this project's architecture
- 導航到項目目錄:
可選:集成開發環境(IDE)
- VS Code:
- 安裝Claude Code的VS Code擴展:
- 從 Visual Studio Marketplace 下載
.vsix
文件。 - 在VS Code中:Extensions > More Actions > Install from VSIX,選擇下載的文件。
- 從 Visual Studio Marketplace 下載
- 使用
Cmd+Esc
快捷鍵啟動Claude Code,自動獲取當前文件上下文。
- 安裝Claude Code的VS Code擴展:
- JetBrains:
- 在JetBrains IDE(如PyCharm)中,從JetBrains Marketplace安裝Claude Code插件。
- 在IDE終端中運行
claude
,或使用Cmd+Esc
快捷鍵。
注意事項
- 安全性:API密鑰需妥善保存,避免泄露。若需撤銷,可在Anthropic Console中刪除密鑰。
- 費用:Claude Code使用Anthropic API按使用量計費,建議監控使用情況。可考慮Claude Pro($20/月)或Max($100/月)訂閱以獲得更高配額。
- 更新:Claude Code會自動檢查并安裝更新,運行時會顯示通知。
- 問題排查:若遇到安裝問題,運行
claude doctor
查看錯誤,或參考 Anthropic官方文檔 或 mac.install.guide。
其他建議
- 推薦安裝 Warp Terminal 或 Zed Editor,它們與Claude Code兼容,提供AI輔助功能。