Claude Code macOS 安装

macOS 默认用 zsh，所以环境变量写到 ~/.zshrc 里。整个流程分三步：装包、写配置、验证。

0. 前置：Node.js 22+

node -v
npm -v

不满足请回到 Node.js macOS 安装。

1. 安装 Claude Code

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

能看到版本号就装好了。

2. 配置环境变量

2.1 环境变量的作用

Claude Code 启动时不会交互地问你 Key 和中转地址，而是从 shell 环境里读 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。我们要把这两个值写到 zsh 的启动文件里，让它每次开终端自动加载。

2.2 写入 ~/.zshrc

用任意编辑器打开 ~/.zshrc（没有就新建），在文件末尾追加两行：

export ANTHROPIC_BASE_URL="https://aitongdao.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

保存关闭。

如果你用的是 bash（极少数 macOS 用户会自己改成 bash），把同样的两行写到 ~/.bashrc 或 ~/.bash_profile。

2.3 让配置生效并验证

让当前终端立刻加载新配置：

source ~/.zshrc

验证：

echo "$ANTHROPIC_BASE_URL"
echo "$ANTHROPIC_AUTH_TOKEN"

两行都有正确输出就 OK。

3. 启动并验证

claude doctor
claude

claude doctor 会做一次完整的自检。通过后 claude 启动交互界面，随便问一句话确认模型响应正常即可。

常见问题

1. npm install -g 报权限错误

如果你是用 Homebrew 装的 Node，不应该遇到这个问题。用 .pkg 装的系统 Node 经常会因为要写 /usr/local/lib/node_modules 而报 EACCES。两种解决方式：

• 卸掉 pkg 装的 Node，改用 Homebrew（brew install node）
• 或者装 nvm，把 Node 放到 ~/.nvm 下，完全规避权限问题

2. 配置写了但 claude 读不到

检查：

• source ~/.zshrc 有没有报错
• 环境变量行有没有写错引号
• echo $SHELL 是不是 zsh，如果不是，你改错文件了

打开一个新终端窗口再试一遍也是常用的排错手段。

3. 提示"claude: command not found"

说明 npm 全局安装目录不在 PATH 里。先跑 npm config get prefix 看一下路径，然后把 <prefix>/bin 加到 ~/.zshrc 的 PATH：

export PATH="$(npm config get prefix)/bin:$PATH"

保存后 source ~/.zshrc 重新加载。

4. 想用 OpenAI 协议调用 Claude 模型

那你应该看 Codex 或 OpenCode 的教程，用 https://ai.aitongdao.com/v1 这个地址。Claude Code 本身只走 Anthropic 协议。