🍏 macOS 平台

（一）安装 Node.js 环境

💡 提示

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

macOS 安装方法：

方法一：使用 Homebrew

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

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

方法二：官网下载

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

macOS 注意事项：

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

验证安装是否成功

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

node --version

npm --version

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

---

（二）安装 Claude Code

系统要求：

MacOS 10.15 (Catalina) 或更高版本

安装步骤：

方法一：Homebrew（推荐）

brew install --cask claude-code

方法二：Curl Script

curl -fsSL https://claude.ai/install.sh | bash

方法三：NPM 安装

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

验证安装

claude -v

正常情况应该输出类似于：1.0.108 (Claude Code)

---

（三）配置环境变量：

方法一：临时设置（当前会话）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.aicy.pro"' >> ~/.bash_profile
source ~/.bash_profile

💡 提示

请注意将 sk-xxx 替换为你自己的专属key！

方法二：通过文件设置（永久设置）

编辑文件 ~/.claude/settings.json 文件添加以下内容(如果没有settings.json文件，请自行创建，不需要时可随意删除，不影响claude使用)：

macOS 系统中通常位于: ​∼/.claude​

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.aicy.pro",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

---

（四）开始使用 Claude Code

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

启动 Claude Code：

claude

在特定项目中使用先cd进入你的项目目录：

cd C:\path\to\your\project

启动 Claude Code：

claude

（五）macOS 常见问题解决

如遇安装时提示权限错误：

尝试以下解决方法：

# 使用 sudo 安装
sudo npm install -g @anthropic-ai/claude-code

# 或者配置 npm 使用用户目录
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

macOS 安全设置阻止运行

如果系统阻止运行 Claude Code：

• 打开"系统偏好设置" → "安全性与隐私"
• 点击"仍要打开"或"允许"
• 或者在 Terminal 中运行：sudo spctl --master-disable

环境变量不生效

检查以下几点：

• 确认修改了正确的配置文件（.zshrc 或 .bash_profile）
• 重新启动 Terminal
• 验证设置：echo $ANTHROPIC_BASE_URL