macOS 安装指南

跟着这个教程，你可以轻松在 macOS 上安装并使用 Claude Code。

我们提供两种安装方式：

全自动安装，适合新手，5分钟快速完成

⚡方法一：一键脚本安装

完全掌控安装过程，适合有经验的用户

🛠️方法二：手工安装

方法一：一键脚本安装（推荐）

使用我们提供的一键安装脚本，可以快速完成所有配置。

运行安装脚本

打开 Terminal，执行以下命令：

curl -fsSL https://academy.claude-code.club/assets/getting-started/installation/claude-code-installation-by-cc-club.sh | bash

脚本会自动完成以下操作：

检测并安装 Homebrew（如果未安装）
检测并安装 Node.js（如果未安装）
安装 Claude Code
配置环境变量和 Shell 配置文件

⚠️

重要提示： 安装过程中需要输入你的 ANTHROPIC_AUTH_TOKEN（API 密钥），请提前准备好。

⚠️

请注意：教程还没结束，教程还没结束，教程还没结束，一定要执行「下一步」：验证和使用。

方法二：手工安装

如果你希望完全掌控安装过程，可以按照以下步骤手动安装。

1. 安装 Node.js 环境

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

macOS 安装方法

方法一：使用 Homebrew（推荐）

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

# 更新 Homebrew
brew update
 
# 安装 Node.js
brew install node

方法二：官网下载

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

⚠️

macOS 注意事项

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

验证安装是否成功

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

node --version
npm --version

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

2. 安装 Claude Code

安装 Claude Code

打开 Terminal，运行以下命令：

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

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

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

验证 Claude Code 安装

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

claude --version

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

3. 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量。

在 Terminal 中运行以下命令设置永久环境变量（一条一条执行）：

# 对于 zsh (默认)
echo 'export ANTHROPIC_BASE_URL="https://claude-code.club/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
 
# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://claude-code.club/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

⚠️

记得将 “你的API密钥” 替换为在上方 “API Keys” 标签页中创建的实际密钥。设置后需要重新打开 Terminal 窗口才能生效。

设置完后用如下命令检查环境变量是否成功：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件，需要在配置文件中进行设置：

配置文件位置： ~/.claude/config.json

如果该文件不存在，请手动创建。

{
  "primaryApiKey": "crs"
}

验证配置文件是否设置成功：

cat ~/.claude/config.json

验证和使用

验证安装

⚠️

请注意：一定要关闭 Terminal 再重新打开！

安装完成后，重新打开 Terminal 或运行 source ~/.zshrc，然后执行：

claude --version

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

开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录
cd /path/to/your/project
 
# 启动 Claude Code
claude

🎉 恭喜你！你已经成功安装并配置了 Claude Code，现在可以开始享受 AI 编程助手带来的便利了。

下一步

通过实际操作学习 Claude Code 的核心功能

🚀快速体验 Claude Code

探索更多实用教程和高级技巧

📚如何用 Claude Code 做这些事

macOS 常见问题

安装时提示权限错误

使用 sudo 命令进行安装

macOS 安全设置阻止运行

在系统偏好设置 → 安全性与隐私中允许运行

环境变量不生效

确认修改了正确的配置文件（zsh 或 bash），并重新加载配置文件

需要帮助？

如果安装遇到疑难杂症，请扫描下方二维码，加入 Claude Code Club 技术交流群。在这里你可以：

与 3000+ 名优秀开发者交流 AI 编程经验，答疑解惑
获取最新的 Claude Code 使用技巧

Windows 安装 Linux / WSL2 安装