Mac 专属教程

Mac 上安装 Claude Code

跟着这 5 步走,大约 30 分钟就能搞定。每步都有详细说明,不用怕。

1 装 Node.js 2 拿 API Key 3 安装 4 配置 5 启动!
1
安装 Node.js
给电脑装一个运行 Claude Code 的"底座"
≈ 8 分钟

Node.js 是一个运行环境,Claude Code 需要它才能跑起来。别担心,你不用理解它是什么,只需要安装就行。

💡

新手看这里:本节没有任何技术操作,只是去官网下载一个安装包,然后双击安装。跟装微信一样简单。

① 下载 Node.js

点击下方按钮,去 Node.js 官网下载 Mac 版本的安装包(推荐选择左侧的"LTS"长期支持版)。

🖼 打开页面后,你会看到两个绿色按钮。
点击左边那个写着 "LTS" 的按钮,它会自动下载一个 .pkg 文件。

② 安装下载好的文件

找到下载文件夹里的 node-vXX.pkg 文件(XX 代表版本号),双击打开,一路点"继续"→"安装"就行。可能需要输入电脑密码。

ℹ️
安装过程中如果弹出"是否允许安装",点"允许"。如果提示输入密码,输入你电脑开机/解锁用的密码。

③ 验证安装成功

安装完成后,打开"终端"(找不到的话看提示),输入以下命令检查是否装好了:

终端
node --version
🔍

怎么看结果?如果终端里显示了一行类似 v20.18.0 的文字,就说明安装成功了!如果提示"command not found",说明没装好,重新下载安装一次即可。

⚠️
找不到"终端"?在 Mac 上按键盘的 ⌘ Command + 空格,弹出搜索框,输入"终端"(或 Terminal),按回车就能打开。
▼ 完成了就往下滑 ▼
2
获取 API Key(钥匙)
给你的 Claude Code 配一把"钥匙",才能使用 AI 能力
≈ 10 分钟

API Key 就像一把钥匙,让 Claude Code 能够连接到 AI 服务。因为我们在国内,所以用 DeepSeek 的 API Key(DeepSeek 提供了兼容 Anthropic 协议的接口,可以直接给 Claude Code 用)。

① 注册 DeepSeek 账号

点击下方按钮去 DeepSeek 官网注册。

🖼 打开后用手机号或邮箱注册。登录后进入控制台。

② 创建 API Key

登录后在左侧菜单找到 "API Keys",点击进入。然后点击 "创建 API Key" 按钮。

🖼 给你的 Key 取个名字(比如 "for-claude-code"),点击创建。你会看到一串以 sk- 开头的密钥。
🔐
非常重要:这串 Key 只会显示一次!马上复制并保存好(可以存到备忘录里)。如果丢了,只能重新创建一个新的。
💰

关于充值:DeepSeek 新用户注册送一定额度(通常几百万 token),足够用很久。用完后在"计费管理"充值即可,非常便宜。

▼ 继续往下 ▼
3
安装 Claude Code
用一行命令安装 Claude Code
≈ 5 分钟

打开"终端"(跟第一步一样),复制粘贴下面这行命令,按回车执行。

📋

操作方式:点右边的"复制"按钮,然后回到终端窗口,按 ⌘ Command + V 粘贴,最后按 回车 执行。

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

执行后终端会开始下载安装,过程可能需要 1-3 分钟。看到类似下面的画面就说明在下载了:

npm notice
npm notice 📦 @anthropic-ai/claude-code@0.x.xx
npm notice ╭─────────────────────────────────────╮
npm notice │ 装完后会显示"added XX packages" │
npm notice ╰─────────────────────────────────────╯
npm notice
added 1234 packages in 45s
安装成功的标志:终端最后没有显示红色的错误信息,而是回到了你最初的样子(显示你的电脑名字和 $ 符号)。
⚠️
如果看到 EACCES 或 permission 错误:这是因为权限问题。在命令前面加上 sudo(即 sudo npm install -g @anthropic-ai/claude-code),然后输入你的电脑密码(输入时屏幕不会显示任何字符,这是正常的),再按回车。
▼ 快完成了! ▼
4
配置 API Key
把刚才拿到的钥匙给 Claude Code 用上
≈ 3 分钟

现在要把你第二步保存的 DeepSeek API Key 配置到电脑里。因为 DeepSeek 用的是兼容接口,需要告诉 Claude Code 访问地址和 key。

在终端里依次执行以下 3 条命令:

📋

执行完一条再执行下一条。每条都点"复制",回终端粘贴,按回车。

终端 — 命令 1/3:设置 Key
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek密钥"' >> ~/.zshrc
终端 — 命令 2/3:设置接口地址
echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"' >> ~/.zshrc
终端 — 命令 3/3:设置模型名
echo 'export ANTHROPIC_MODEL="deepseek-chat"' >> ~/.zshrc
✏️
注意替换:第一条命令中的 sk-你的DeepSeek密钥 要换成你第二步复制的真实 API Key。例如你的 key 是 sk-abc123,那这一部分就是 sk-abc123

3 条命令都执行完后,再执行下面这行,让配置生效:

终端 — 使配置生效
source ~/.zshrc

验证是否生效:

终端 — 验证
echo $ANTHROPIC_AUTH_TOKEN

验证结果:如果终端显示了你的 DeepSeek Key(以 sk- 开头的一串字符),说明配置成功!如果什么都没显示,重新检查一下有没有粘贴对了。

▼ 最后一步了! ▼
5
启动 Claude Code 🚀
终于可以用了!
≈ 2 分钟

在终端里输入以下命令,启动 Claude Code:

终端
claude

第一次启动时,它会做一些初始化。稍等一会儿,当你看到终端里出现一个对话界面,就说明可以用了!

🎯

试试看:启动后输入 /help 查看所有可用命令,或者直接问它问题试试。

📖 常用命令速查

命令说明
claude启动 Claude Code
/help查看帮助
/clear清空对话
/quit 或 Ctrl+C退出 Claude Code
问"帮我写一个网页"直接用中文告诉它你想做什么
💡
小提示:Claude Code 支持中文对话,直接用中文跟它说你想做什么就行。比如"帮我创建一个简单的个人主页"或者"解释一下这段代码是什么意思"。

🎉 恭喜你!

你已经成功在 Mac 上装好了 Claude Code!现在你可以像跟一个程序员朋友聊天一样,在终端里用 AI 帮你写代码了。

← 返回选择页 🪟 看 Windows 版