macOS 安装与使用
Last updated on
给 macOS 用户的一条完整主线：装依赖、配 API Key、安装 Claude Code、第一次启动。
先选对系统页
如果你不是 macOS 用户，直接改看：
这一页只做一件事：让你在 macOS 上把 Claude Code 跑通
你不需要先拆成准备、安装、使用三页来回跳。
这一页会直接带你完成：准备依赖、准备 API Key、安装 Claude Code、第一次启动。
第 1 步：装好 Node.js、npm 和 Git
Claude Code 在 macOS 上的基础依赖还是这 3 个：Node.js、npm 和 Git。
下面这些命令用什么终端运行？
你可以直接打开 macOS 自带的 Terminal。
如果你已经在用 iTerm，也可以继续用它。
1. 安装 Node.js 和 npm
先去 Node.js 官网 下载 macOS 安装包。
对大多数人，优先选 LTS 版本。
安装完成后，运行：
node -v
npm -v如果都能返回版本号，说明 Node.js 和 npm 已经装好。
第 2 步：准备可用的 API Key
先登录 api.dingjiai.com，完成充值并创建新的 API Key。
创建完成后，把这串 Key 保存到一个稳定好找的位置，同时不要发给别人，也不要提交到公开仓库。
第 3 步：安装 Claude Code
1. 打开 Terminal 或 iTerm
如果你没有特殊偏好，直接用系统自带的 Terminal 就够了。
2. 运行安装命令
npm install -g @anthropic-ai/claude-code第 4 步：把 API Key 配进当前终端
第一次先用临时方式验证
先确认 Claude Code 能启动，再决定要不要写成长期配置。
当前终端临时生效
export ANTHROPIC_API_KEY="你的 API Key"如果你的接入方式还要求 Base URL，再补一条：
export ANTHROPIC_BASE_URL="你的 Base URL"想长期生效，再写进 shell 配置
macOS 默认常见的是 zsh，可以执行：
echo 'export ANTHROPIC_API_KEY="你的 API Key"' >> ~/.zshrc如果还需要 Base URL，再补一条：
echo 'export ANTHROPIC_BASE_URL="你的 Base URL"' >> ~/.zshrc写完后执行：
source ~/.zshrc如果你用的不是 zsh，就把同样的内容写进你实际在用的 shell 配置文件。
第 5 步：进入项目并启动 Claude Code
macOS 下最常见的 3 个问题
1. claude --version 跑不通
先检查：
node -v
npm -v如果这两条也不正常，问题优先在依赖，不在 Claude Code 本身。
2. 能装但不能启动
优先检查 API Key 和 Base URL 有没有配好。
很多第一次启动失败的问题，不是安装没完成，而是接入凭证没有配成一套。
3. 启动后回答不对项目
最常见原因还是目录错了。
先确认你是不是在正确的项目目录里运行的 claude。
做到什么状态算完成
满足下面这几条，就说明 macOS 这条路线已经跑通了
- Node.js、npm 和 Git 都可用
- 你已经准备好 API Key
- 你已经成功运行过
npm install -g @anthropic-ai/claude-code claude --version能正常返回版本号- 你已经在项目目录里成功启动过
claude
跑通后，下一步继续看 更多。