乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > Mac Claude code保姆级安装教程

Mac Claude code保姆级安装教程

当前时间： 2026-08-17 17:50:13 分类：办公文件 评论(0)
Mac Claude code保姆级安装教程
安装指南 · TERMINAL EDITION

Claude Code终端安装保姆级教程

专为 Mac 用户打造。全程复制粘贴,不需要任何编程基础。每一步都拆到最细,照着做就行。

芯片 · Apple Silicon / Intel 均可
系统 · macOS 10.15+
耗时 · 约 15 分钟
难度 · 零基础友好
📌 你即将完成的事
打开 Mac 自带的「终端」,粘贴几行命令,装好 Claude Code —— 一个能帮你写代码、改 Bug、解释代码的 AI 工具。终端看起来很专业,其实你只需要照抄照贴,完全不会把电脑弄坏。
⚠️ 开始前必读
Claude Code 需要 Claude Pro / Max 订阅(或者一个 Anthropic API Key)才能用。还没有的话,先去 claude.ai 开通订阅,再回来跟着装。

// 开始前检查清单

  • 一台 Mac 电脑(Apple Silicon M1/M2/M3/M4 或 Intel 都支持)

  • 系统是 macOS 10.15 Catalina 或更新版本

  • 至少 4 GB 内存(推荐 8 GB 以上)

  • 已开通 Claude Pro / Max 订阅 或拥有 Anthropic API Key

  • 能正常上网

  • 大约 500 MB 磁盘空间

1

打开「终端」

// open Terminal.app

终端是 Mac 自带的工具,可以用文字命令控制电脑。我们用它来装 Claude Code。

怎么打开

  1. 按下键盘的 Command + 空格,打开聚焦搜索

  2. 输入 终端 两个字(或者英文 terminal)

  3. 回车,或点击搜索结果里的「终端」

  4. 会弹出一个窗口 —— 这就是终端

✓ 你会看到
一个黑色或白色的窗口,里面有一行文字,结尾是一个 % 符号。这个 % 就是「提示符」,后面就是你输入命令的地方。
2

看懂终端窗口

// understand the prompt

打开终端后,你大概会看到这样一行内容:

TERMINAL
Last login: Mon Jun 15 10:23 on ttys000

拆开来看:

  • 你的用户名@MacBook-Pro —— 你的电脑名称

  • ~ —— 这个波浪号代表「你的个人主文件夹」

  • % —— 输入光标,命令就敲在它后面

💡 记住一个规律
后面凡是让你「输入命令」,都是在 % 后面敲(或粘贴),然后按 回车 Enter 执行。
3

运行官方安装命令

// run the official installer

这是最省事的安装方式。一行命令自动下载并装好 Claude Code,连配置都帮你弄好。

复制下面这一整行命令
复制我 · COPY
curl -fsSL https://claude.ai/install.sh | sh
↑ 选中这一整行,Cmd+C 复制(不要带前面的 % 符号)
在终端里这样做

  1. 鼠标点一下终端窗口(让它处于激活状态)

  2. 按 Command + V 粘贴命令

  3. 按 Enter 回车

  4. 等待 —— 安装程序正在下载和运行

这行命令在干嘛
EXPLAIN
curl# 一个从网上下载文件的工具-fsSL# 安静下载的几个参数install.sh# Claude Code 的官方安装脚本| sh# 把下载到的脚本交给 sh 执行
安装过程中你会看到
OUTPUT
Downloading Claude Code...Installing...Configuring PATH...Claude Code installed successfully!

一堆文字刷过屏幕都是正常的,这是安装程序在工作。看到 installed successfully 就说明装好了。

💡 最后如果提示 command not found
别慌,这只是终端还没「刷新」识别到新命令。下一步重启终端就能解决。
4

重启终端

// restart Terminal

Mac 装完新工具,终端需要重启一下才能识别它。很快。

操作

  1. 按 Command + Q 彻底退出终端

  2. 重新打开终端(聚焦搜索 → 输入「终端」→ 回车)

✓ 完成
终端重新打开,看到结尾是 % 的提示符,就可以继续下一步了。
5

验证是否装好

// verify installation

继续之前,先确认一下 Claude Code 真的装上了。

输入这条命令
复制我 · COPY
claude --version

然后按 Enter 回车。这是在问 Claude Code「你的版本号是多少」。

成功的话会显示
OUTPUT
Claude Code version 0.8.3

只要看到一个版本号(具体数字不重要),就说明 Claude Code 安装成功。

✗ 如果显示 command not found
说明终端还没识别到 claude。再关一次终端(Cmd+Q)重新打开试试。还不行就翻到下面的「常见问题」。
认证与启动
6

配置 API Key(可选)

// only for API key users
先判断你属于哪一类
订阅用户(Claude Pro / Max):跳过这一步,第 8 步会用浏览器登录认证。API Key 用户:才需要做这一步。没有 Key 的话去 console.anthropic.com 申请。

把你的 API Key 写进 shell 配置文件,这样每次打开终端都会自动加载它。

输入命令(把 你的KEY 换成真实的 KEY)
复制我 · COPY
echo 'export ANTHROPIC_API_KEY="你的KEY"' >> ~/.zshrc
💡 怎么替换 Key
粘贴上面这行后,在终端里把引号内的「你的KEY」选中,换成你真实的 API Key(类似 sk-ant-xxxx),再按回车。
让配置立即生效
复制我 · COPY
source ~/.zshrc

按回车。没有任何输出是正常的,说明命令已经默默执行成功。

验证 KEY 写进去了没
复制我 · COPY
echo $ANTHROPIC_API_KEY

按回车,如果屏幕打印出你的 Key,就说明配置正确。

⚠️ 用的是 Bash 不是 Zsh?
macOS Catalina 之后默认都是 Zsh。如果你的系统比较老用的是 Bash,把上面命令里的 ~/.zshrc 全部换成 ~/.bash_profile 即可。
7

进入你的项目文件夹

// cd into your project

Claude Code 是在代码项目里工作的。你需要让终端切换到项目所在的文件夹。没有现成项目?那就新建一个。

情况 A · 已经有项目
复制我 · COPY
cd ~/Documents/我的项目# 换成你自己的路径
情况 B · 新建一个练手项目
复制我 · COPY
mkdir ~/my-claude-project# 建文件夹cd ~/my-claude-project# 进入它
💡 不知道项目路径?
打开「访达 Finder」,找到项目文件夹 → 右键 →「拷贝 ... 作为路径名称」。然后在终端里先输入 cd 加一个空格,再粘贴。
CD 是什么意思

cd = change directory,「切换目录」。波浪号 ~ 是你的个人主文件夹的简写。切换成功后,提示符会显示你当前所在的文件夹名。

8

启动 Claude Code

// launch & authenticate

到了最后一步 —— 启动 Claude Code。第一次运行需要认证(证明是你本人)。

输入这一个词
复制我 · COPY
claude

按 Enter 回车。接下来根据你的认证方式有所不同:

🔑 订阅用户(Claude Pro / Max)
会自动弹出浏览器,打开 Claude 登录页。用你的账号登录、点击授权,看到「Authorization complete」就认证好了,回到终端即可。浏览器没弹出?把终端里出现的那串网址复制到浏览器手动打开,步骤一样。
🔑 API Key 用户
你已经在第 6 步配好了 Key,Claude Code 会自动认证,不需要打开浏览器。
成功后会看到
OUTPUT
Welcome to Claude Code!Ready for commands. Type your request:
📄 首次会弹服务条款
读一下(就是说 Claude Code 会读取你的代码文件),输入 yes 回车同意即可。这个只出现一次。
✓ Claude Code 已经跑起来了!
现在你进入了一个对话界面,可以让 Claude 帮你写代码、改 Bug、解释代码。试着输入一句:看看这个项目里有哪些文件想退出时,输入 exit 回到终端。
常见问题排查
❌ 输入 claude 提示 command not found
终端没识别到 claude 命令,一般是安装后没重启终端。
解决方法:

  1. 按 Cmd+Q 彻底退出终端

  2. 重新打开终端

  3. 输入 claude --version 验证

  4. 还不行就用完整路径:~/.local/bin/claude

❌ 安装跑到一半报错了
安装脚本中途失败,通常是断网或磁盘空间不足。
解决方法:

  1. 确认 Mac 至少有 500 MB 空闲空间(苹果菜单 → 关于本机 → 储存空间)

  2. 确认网络稳定

  3. 重新运行一次安装命令:curl -fsSL https://claude.ai/install.sh | sh

❌ 启动时提示 Authentication failed
Claude Code 尝试认证但连不上服务器,或者凭据不对。
解决方法:

  1. 检查网络是否正常

  2. 确认你登录的是正确的 Claude 账号(claude.ai)

  3. 用 API Key 的话,去 console.anthropic.com 确认 Key 没填错、没过期

  4. 重新输入 claude 再试一次

❌ 安装时提示 Permission denied
安装程序没有创建文件的权限,常见于错误地用了 sudo。
解决方法:

  1. 不要用 sudo,那会导致权限混乱

  2. 重新跑一遍安装命令,让它自动处理权限

  3. 如果之前误用了 sudo,先执行 chown -R $(whoami) ~/.local 修复归属,再重装

❌ 启动后提示 API key not found
你用的是 API Key,但终端里没配置好。
解决方法:

  1. 输入 echo $ANTHROPIC_API_KEY 检查

  2. 能打印出 Key → 配置正确,关掉终端重开一次

  3. 什么都没显示 → Key 没保存成功,重做第 6 步

❌ 第一次启动很慢(5~10 秒)
这是 Apple Silicon Mac 上的正常现象,不是错误。
无需处理: 首次启动需要做进程初始化,

🎉 全部搞定!

恭喜,Claude Code 已经装好,可以在你的 Mac 上随时使用了。接下来你可以:

  • 随时开用:进入任意代码项目文件夹,输入 claude 即可

  • 让它干活:改 Bug、写测试、重构代码、解释某段代码怎么运作

  • 自动更新:官方安装会在后台自动升级,你永远用的是最新版

  • 放个说明书:在项目里建一个 CLAUDE.md 文件写上项目背景和规范,Claude 会读取它,给出更贴合的建议

Claude Code 官方文档 →
docs.claude.com
Claude 支持中心 →
support.claude.com
Anthropic 控制台 →
申请 API Key
Claude.ai →
开通 Pro / Max 订阅
本教程为零基础用户准备。如遇到本文未覆盖的问题,可查阅上方官方资源。更新时间 · 2026 年 6 月  |  适用 · Apple Silicon(M1/M2/M3/M4)及 Intel Mac