以 2026 年 10 月的版本为准。安装命令如有变化,以 Anthropic 的文档为准。
场景
第一次装 Claude Code,手上是一台 Mac,没怎么用过终端。照着下面做,大概 15 分钟能跑起来。Windows 的步骤不一样,后面单独写。
开始前准备:
- 一台 Mac(macOS 13 以上更省事)
- 一个 Claude 订阅账号(Pro 或 Max),或者 Anthropic 的 API 账号
- 能稳定访问 claude.ai 的网络环境
怎么搭
第 1 步:打开终端
按 Command + 空格,输入「终端」或 Terminal,回车。下面的命令都在这个窗口里输入,每输完一行按回车。
第 2 步:安装 Claude Code
推荐用安装脚本,不需要先装别的东西:
curl -fsSL https://claude.ai/install.sh | bash如果你电脑上已经有 Node.js 18 或更新的版本,也可以用 npm 装:
npm install -g @anthropic-ai/claude-code装完检查一下:
claude --version能看到版本号就说明装好了。提示 command not found 的话,关掉终端重新打开再试一次。
第 3 步:进到你的项目文件夹
Claude Code 能读写的范围是你启动它时所在的文件夹。所以先进到要处理的文件夹,比如桌面上的「周报」:
cd ~/Desktop/周报小技巧
输入
cd(后面有个空格),再把文件夹从访达拖进终端窗口,路径会自动填好。
第 4 步:启动并登录
claude第一次启动会让你选登录方式:有 Claude 订阅的选订阅账号登录,浏览器会打开授权页,点同意就行;用 API 的选 Console 账号。
第 5 步:生成项目说明
在 Claude Code 里输入:
/init它会读一遍文件夹,生成一个 CLAUDE.md。这是给它看的「项目说明书」,以后每次启动都会先读。打开看看,把你的习惯补进去,比如「表格一律用 Excel 格式」「回答用中文」。
第 6 步:跑通第一个任务
直接用中文说你要什么,比如:
把这个文件夹里所有 Excel 合并成一张表,按周汇总销售额它会先告诉你打算怎么做,需要改文件、执行命令时会问你。看清楚再点允许。
搭完的效果
- 在终端里输入
claude就能启动,用中文直接让它干活。 - 文件夹里多了一个
CLAUDE.md,以后每次启动它都知道这个项目是做什么的、你有什么习惯。 - 第一个任务跑通以后,可以接着看 新手用 Claude Code 常踩的 5 个坑,少走弯路。
装不上怎么办
- 在终端里运行
claude doctor,它会检查安装有没有问题。 - 把报错截图存下来,搜一下报错的第一行,大多数问题别人遇到过。
- 折腾半小时还没好,可以找 Zane 远程帮你装。