以下是基于现有信息的简明安装指南,适用于macOS系统。请按照以下步骤操作:

前提条件

  1. 操作系统:macOS 10.15或更高版本。
  2. Node.js和npm:Claude Code基于Node.js,需安装Node.js 18+和npm。请检查是否已安装:
  • 打开终端,运行 node --versionnpm --version
  • 如果未安装,访问 Node.js官方网站 下载并安装最新LTS版本,或使用Homebrew:
brew install node
  1. Anthropic API密钥:需要Anthropic账户和API密钥:
  • 访问 Anthropic官网 创建账户。
  • 在“Settings” > “Billing”中添加支付方式并购买至少5美元的API信用。
  • 在“API Keys”页面点击“Create Key”,保存生成的密钥(仅显示一次,建议存入macOS密码管理器)。

安装步骤

  1. 打开终端
  • 在Mac上,打开“应用程序”文件夹中的“终端”。
  1. 安装Claude Code
  • 在终端中运行以下命令以全局安装Claude Code:
npm install -g @anthropic-ai/claude-code
  1. 验证安装
  • 安装完成后,运行以下命令检查Claude Code版本:
claude doctor
  • 这将显示安装类型和版本信息。
  1. 认证Claude Code
  • 首次运行 claude 命令时,会提示通过Anthropic Console进行OAuth认证:
claude
  • 按照提示在浏览器中登录Anthropic账户,或输入API密钥。
  • 或者,将API密钥设置为环境变量以实现持久化:
echo 'export ANTHROPIC_API_KEY=你的API密钥' >> ~/.zshrc
source ~/.zshrc
  • 如果使用bash,替换 ~/.zshrc~/.bashrc
  1. 开始使用
  • 导航到项目目录:
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,选择下载的文件。
  • 使用 Cmd+Esc 快捷键启动Claude 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 TerminalZed Editor,它们与Claude Code兼容,提供AI辅助功能。