Mac 配置教程

开通后拿到密钥,按下面步骤即可在终端用官方 Claude Code。

💡 本站 api.claudequick.com 国内可直连,无需翻墙。若开着代理/加速器,请确保对该域名放行或直连。

1. 安装 Node.js

到 nodejs.org/en/download 下载 LTS(18 以上):M 系列选 ARM64,Intel 选 x64。验证:

node --version
npm --version

2. 安装 Claude Code

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

若报 EACCES 权限错误:

sudo chown -R $(whoami) $(npm prefix -g)/{lib/node_modules,bin,share}

3. 绕过官方登录(必做)

先 claude 启动一次生成配置,再编辑 ~/.claude.json,在最外层对象加一行:

{
  "hasCompletedOnboarding": true,
  ...其余保持不变
}

4. 配置密钥

方式一(推荐 · 持久化):写进 ~/.claude/settings.json:

cat <<'EOF' | tee ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.claudequick.com",
    "ANTHROPIC_AUTH_TOKEN": "你的密钥"
  }
}
EOF

方式二(环境变量):写进 ~/.zshrc 后 source ~/.zshrc:

export ANTHROPIC_BASE_URL=https://api.claudequick.com
export ANTHROPIC_AUTH_TOKEN=你的密钥

⚠️ 若提示 401:确认密钥没填错/没过期;仍不行把 ANTHROPIC_AUTH_TOKEN 换成 ANTHROPIC_API_KEY 再试,或联系客服。

5. 启动

cd 你的项目目录
claude

常见问题

省钱提示 —— 日常用 /model haiku 或 /model sonnet 足够;复杂任务再 /model opus。
command not found: claude —— npm prefix -g 看目录,把其 /bin 加进 ~/.zshrc 的 PATH。
查用量 —— npm i -g ccusage --registry=https://registry.npmmirror.com 后 ccusage。
升级 —— npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com。
重装/重置 —— 卸载后 rm -rf ~/.claude && rm -f ~/.claude.json,再重装 + 重新配置。