Claude Code 安装教程（macOS）

0. 前置：安装 Node.js

先装 Node.js（建议 22+）：Nodejs macOS

验证安装：分别执行下面两个命令

node -v

npm -v

如果看到版本号，说明 Node.js 安装成功了。

1. 安装 Claude Code

第一步：打开终端（按 Command + 空格，输入 Terminal，按回车）

第二步：执行安装命令

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

第三步：验证安装

claude --version

如果看到版本号，说明安装成功了。

2. 配置接入AI驿站

Claude Code 的配置统一写在 ~/.claude/settings.json 里，不需要改环境变量。

2.1 创建配置目录

mkdir -p ~/.claude

2.2 写入配置文件（注意替换 API Key）

cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aizhan.space",
    "ANTHROPIC_AUTH_TOKEN": "你的AI驿站 Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
EOF

必须替换：把 你的AI驿站 Key 替换成你从AI驿站官网复制的真实 Key

如何替换？

1. 复制上面整段命令
2. 把 你的AI驿站 Key 这几个字替换成你的真实 Key
3. 然后粘贴到终端执行

配置说明：

• ANTHROPIC_BASE_URL：AI驿站 服务地址，不带 /v1
• ANTHROPIC_AUTH_TOKEN：你的 API Key
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：关闭非必要流量，减少不必要的网络请求

2.3 验证配置文件是否创建成功

cat ~/.claude/settings.json

应该能看到你刚才写入的内容。

3. 启动并验证

第一步：进入你的项目目录

cd /path/to/your/project

把 /path/to/your/project 替换成你实际的项目路径。

第二步：启动 Claude Code

claude

可选：先做环境检查

claude doctor

常见问题

1. npm install -g 报权限错误

原因：没有权限安装全局包。

解决方法：

• 不要用 sudo npm install -g 强制安装
• 推荐回到 Nodejs macOS 用 Homebrew 重新安装 Node.js
• Homebrew 安装的 Node.js 不需要 sudo 权限

2. 提示找不到 claude 命令

原因：全局包路径没有加到 PATH 环境变量里。

解决方法：

1. 检查 Node.js 是否正确安装：node -v
2. 重启终端
3. 如果还不行，重新安装 Claude Code