文档中心

主题

macOS 安装指南 ​

本教程将指导你在 macOS 系统上安装和配置 Claude Code。

1. 安装 Node.js 环境 ​

Claude Code 需要 Node.js 环境才能运行。

版本要求 ​

Claude Code 要求的 Node.js 版本 ≥ 18.0，最好使用 v20 或更高版本。

macOS 安装方法 ​

方法一：使用 Homebrew（推荐） ​

如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

bash
# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二：官网下载 ​

  1. 访问 https://nodejs.org/
  2. 下载适合 macOS 的 LTS 版本
  3. 打开下载的 .pkg 文件
  4. 按照安装程序指引完成安装

macOS 注意事项 ​

  • 如果遇到权限问题，可能需要使用 sudo
  • 首次运行可能需要在系统偏好设置中允许
  • 建议使用 Terminal 或 iTerm2

验证安装是否成功 ​

安装完成后，打开 Terminal，输入以下命令：

bash
node --version
npm --version

如果显示版本号，说明安装成功了！

2. 安装 Claude Code ​

安装 Claude Code ​

打开 Terminal，运行以下命令：

bash
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code@latest

如果遇到权限问题，可以使用 sudo：

bash
sudo npm install -g @anthropic-ai/claude-code@latest

验证 Claude Code 安装 ​

安装完成后，输入以下命令检查是否安装成功：

bash
claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3. 设置环境变量 ​

安装完成后，需要配置环境变量以连接到你的中转服务。

详细的环境变量配置步骤，请查看 配置说明 页面。

配置方式包括：

  • 临时设置（当前会话）
  • 永久设置（推荐）- Zsh 和 Bash
  • CC-switch 工具（快速配置）

4. 开始使用 Claude Code ​

环境变量配置完成后，你就可以开始使用 Claude Code 了！

启动 Claude Code ​

在 Terminal 中直接运行：

bash
claude

在特定项目中使用 ​

bash
# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

提示 ​

  • 确保已经设置好环境变量后再启动 Claude Code
  • 如果使用永久设置，记得重新打开终端窗口或执行 source ~/.zshrc（或 source ~/.bash_profile）
  • 首次启动可能需要一些时间来初始化

下一步 ​

如有问题，请查看 常见问题解答。