Claude Code Mac使用指南¶

强烈推荐：优先使用 install_script_macos.sh 一键完成全部环境部署。只要遇到安装或配置问题，第一选择就是重新运行该脚本。

(一) 一键安装脚本（推荐）¶

想一次性完成 Node.js、npm 镜像、Claude Code / Codex / Gemini / Droid CLI / OpenClaw 以及环境变量配置，请优先使用随文档提供的 install_script_macos.sh，而不是手动逐步安装。

下载或找到官方一键安装脚本 install_script_macos.sh。

打开 Terminal，赋予执行权限并运行：

chmod +x install_script_macos.sh
bash install_script_macos.sh

按照脚本提示依次完成：
检查 / 安装 Homebrew（推荐，可选国内镜像加速）。
检查 / 安装 Node.js 和 npm。
将 npm 源切换为 https://registry.npmmirror.com。
安装或更新 Claude Code / Codex CLI / Gemini CLI / Droid CLI / OpenClaw。
提示输入 API Base（默认 https://api.share-ai.woolen.wang）和 API Token（如 sk-xxxx），脚本会自动写入环境变量和配置文件。

脚本执行结束后，加载环境变量并验证：

source ~/.zshrc  # 或 source ~/.bash_profile
claude --version

只有在不方便使用脚本或脚本执行失败时，才需要参考下面的"手动安装"步骤。

(二) 手动安装 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

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

(二) 安装 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-code --version

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

(三) 设置环境变量¶

配置 Claude Code 环境变量¶

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

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

在 Terminal 中运行以下命令：

export ANTHROPIC_BASE_URL="https://api.share-ai.woolen.wang"
export ANTHROPIC_API_KEY="你的API密钥"

注意：记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件（根据你使用的 shell）：

对于 zsh (默认)：

echo 'export ANTHROPIC_BASE_URL="https://api.share-ai.woolen.wang"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

echo 'export ANTHROPIC_BASE_URL="https://api.share-ai.woolen.wang"' >> ~/.bash_profile
echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

(四) 开始使用 Claude Code¶

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

启动 Claude Code

claude-code

在特定项目中使用

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

(五) 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

🎉 恭喜你！

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

如果在使用过程中遇到任何问题，可以查看官方文档或社区讨论获取帮助。