Mac 系统安装与配置 Claude Code 指南

前提条件

1. 操作系统：macOS 10.15 或更高版本。
2. Node.js 和 npm：Claude Code 基于 Node.js，需安装 Node.js 18+ 和 npm。请检查是否已安装：
   • 打开终端，运行 node --version 和 npm --version。
3. Anthropic API 密钥：需要 Anthropic 账户和 API 密钥：
   • 访问 Anthropic 官网 创建账户。
   • 在'Settings' > 'Billing'中添加支付方式并购买至少 5 美元的 API 信用。
   • 在'API Keys'页面点击'Create Key'，保存生成的密钥（仅显示一次，建议存入 macOS 密码管理器）。

如果未安装 Node.js，可访问 Node.js 官方网站 下载最新 LTS 版本，或使用 Homebrew：

brew install node

安装步骤

1. 全局安装： 在终端中运行以下命令以全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

2. 验证安装： 运行以下命令检查版本及环境状态：

claude doctor

3. 认证配置：
   • 首次运行 claude 命令时，会提示通过 Anthropic Console 进行 OAuth 认证。
   • 若使用 bash，替换 ~/.zshrc 为 ~/.bashrc。
   • 也可将 API 密钥设置为环境变量以实现持久化：

echo 'export ANTHROPIC_API_KEY=你的 API 密钥' >> ~/.zshrc && source ~/.zshrc

4. 开始使用： 导航到项目目录后，运行 claude 进入交互模式：

cd 你的项目目录
claude

示例指令：

summarize this project's architecture

可选：集成开发环境（IDE）

• VS Code：
  • 从 Visual Studio Marketplace 下载 .vsix 文件。
  • 在 VS Code 中：Extensions > More Actions > Install from VSIX，选择下载的文件。
  • 使用快捷键启动 Claude Code，自动获取当前文件上下文。
• JetBrains：