Claude Code Mac 完整使用教程：安装配置详细指南

本文档由 Easy Claude Code 出品，辅助用户简单高效优惠地使用 Claude Code。国内用户无需 VPN，推荐使用中转服务，稳定优惠。

重要提示

  • ✅ 国内用户无需翻墙：使用中转服务即可
  • ⚠️ 使用前必做：使用 /model 命令切换 haiku 或 sonnet 模型，省钱且效果够用

目录

安装 Node.js

下载 Node.js

访问 Node.js 下载链接：https://nodejs.org/en/download

下载要求：

  • 选择正确的芯片架构：
    • ARM64（M1/M2/M3 芯片的 Mac）
    • x64（Intel 芯片的 Mac）
  • 确保 Node.js 版本为 18.0 以上

验证安装

下载后点击安装包进行安装。安装完成后，打开终端验证：

node --version
npm --version

如果显示版本号（如 v22.17.1 和 10.9.2），则安装成功。

安装 Claude Code 客户端

打开终端，执行以下命令：

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

如果遇到权限错误

报错示例：

npm error code EACCES
npm error syscall rename
npm error path /usr/local/lib/node_modules/@anthropic-ai/claude-code
npm error errno -13
npm error Error: EACCES: permission denied

解决方法：

# 1. 查看 npm 全局目录
npm prefix -g

# 2. 修复权限
sudo chown -R $(whoami) $(npm prefix -g)/{lib/node_modules,bin,share}

# 3. 重新安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

设置 API 密钥

获取密钥

没有密钥的用户请点击此处购买：https://easyclaude.com/store

激活流程：

  1. 获取密钥后访问控制台
  2. 登录即可自动激活使用（激活后开始计时）
  3. 如不想立即使用，可稍后再激活

密钥信息查看：

  • API Key
  • 已使用配额
  • 剩余配额
  • 有效期

方式 1：配置文件方式（推荐）

使用配置文件方式可以持久化配置，无需每次启动都设置环境变量。

一键配置命令：

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

注意：

  • 将 你的密钥 替换为从 Easy Claude Code 购买的实际密钥
  • 确保 JSON 格式正确

方式 2：环境变量方式

每次启动时通过环境变量配置。

export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_API_KEY=你的密钥
export ANTHROPIC_BASE_URL=https://api.easyclaude.com

# 启动 Claude Code（请先关掉 VPN）
claude

如果报错：

Unable to connect to Anthropic services

请继续执行下一步「绕过 Claude Code 认证」操作。

必做：绕过 Claude Code 认证

为什么需要绕过认证？

首次启动 Claude Code 时，如果不翻墙，会出现以下错误：

Welcome to Claude Code!
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

这是正常现象，我们需要配置文件来绕过认证。

配置步骤

1. 启动 Claude Code（触发配置文件生成）

# 切换到你的项目目录
cd yourproject

# 启动 Claude Code
claude

此时会弹出登录认证网页或提示网络连接失败，不用管，继续下一步。

2. 编辑配置文件

vim ~/.claude.json

或者使用其他编辑器打开 ~/.claude.json 文件。

3. 添加配置

在文件的第一行添加以下字段：

{
  "hasCompletedOnboarding": true,
  "numStartups": 102,
  "installMethod": "unknown",
  "autoUpdates": true
}

重点：

  • "hasCompletedOnboarding": true 是关键配置
  • 确保 JSON 格式正确（逗号、引号等）

4. 启动 Claude Code

配置完成后，在终端启动 Claude Code：

claude

成功示例：

* Welcome to Claude Code!
  /help for help, /status for your current setup
  cwd: /Users/yourname/yourproject

Overrides (via env):
· API Key: sk-ar***
· API Base URL: https://api.easyclaude.com

* Tip: Did you know you can drag and drop image files into your terminal?

>

看到 > 提示符，说明启动成功！

常见问题解决

Q1: 如何查看消耗用量？

方法 1：查看当前会话消耗

在 Claude Code 对话框中输入：

/cost

输出示例：

> hi
· Hello! How can I help you today?

> /cost
Total cost: $0.0166
Total duration (API): 2m 33.5s
Total duration (wall): 26m 6.9s
Total code changes: 0 lines added, 0 lines removed

Usage by model:
claude-3-5-haiku: 531 input, 72 output, 0 cache read, 0 cache write
claude-sonnet: 3 input, 13 output, 10.8k cache read, 3.3k cache write

方法 2：统计详细用量

打开新的终端窗口，执行：

# 安装 ccusage 工具
npm install -g ccusage --registry=https://registry.npmmirror.com

# 查看消耗
ccusage

输出示例：

(base) ~ ccusage
WARN Fetching latest model pricing from LiteLLM...
Loaded pricing for 1257 models

Claude Code Token Usage Report - Daily

Date        | Models      | Input   | Output  | Cache Create | Cache Read   | Total Tokens | Cost (USD)
2025-08-04  | -sonnet-4   | 2,551   | 111,243 | 5,985,450    | 36,096,143  | 42,195,387   | $34.95
2025-08-05  | -opus-4     | 8,150   | 222,905 | 34,937       | 116,038,103 | 116,304,095  | $172.57
            | -sonnet-4   |         |         |              |             |              |
Total       |             | 10,701  | 334,148 | 6,020,387    | 152,134,246 | 158,499,482  | $207.52

用量计算标准（以日卡举例）：

  • 金额和本地计算的 $10 靠齐
  • Token 差不多一千万

Q2: 如何重装 Claude Code？

# 卸载
npm uninstall -g @anthropic-ai/claude-code

# 清除缓存数据
rm -Rf ~/.claude
rm -f ~/.claude.json

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

重装后必做：

  • 重新设置密钥（参考「设置 API 密钥」部分）
  • 重新配置绕过认证（参考「必做：绕过 Claude Code 认证」部分）

Q3: 如何升级 Claude Code？

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

升级后建议重新执行「绕过 Claude Code 认证」步骤。

Q4: 启动时提示 command not found: claude

原因：环境变量未配置或 npm 全局目录未添加到 PATH。

解决方法：

# 查看 npm 全局目录
npm prefix -g

# 添加到 PATH（根据你的 shell 选择）
# 如果使用 bash
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 如果使用 zsh
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Q5: 如何切换模型？

在 Claude Code 对话框中输入：

# 切换到 Haiku 模型（最省钱）
/model haiku

# 切换到 Sonnet 模型（性价比高）
/model sonnet

# 切换到 Opus 模型（效果最好，最贵）
/model opus

推荐：

  • 日常使用：/model haiku 或 /model sonnet
  • 复杂任务：/model opus

总结

核心步骤回顾

  1. ✅ 安装 Node.js：确保版本 18.0+，选择正确的芯片架构
  2. ✅ 安装 Claude Code：使用 npm 全局安装
  3. ✅ 设置密钥：
    • 推荐：配置文件方式（~/.claude/settings.json）
    • 可选：环境变量方式
  4. ✅ 绕过认证：编辑 ~/.claude.json，添加 "hasCompletedOnboarding": true
  5. ✅ 验证配置：启动 Claude Code，查看是否正常工作

推荐配置流程

# 1. 安装 Node.js（访问官网下载）
# 2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 3. 配置密钥
cat <<EOF | tee ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_API_KEY": "你的密钥",
    "ANTHROPIC_BASE_URL": "https://api.easyclaude.com"
  }
}
EOF

# 4. 首次启动（触发配置文件生成）
cd yourproject
claude
# 此时会报错，按 Ctrl+C 退出

# 5. 绕过认证
vim ~/.claude.json
# 添加 "hasCompletedOnboarding": true

# 6. 正式启动
claude

相关文档