Mac上安装Claude Code的步骤
以下是基于现有信息的简明安装指南,适用于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辅助功能。