这篇写给第一次装 Claude Code 的人:照着做,大概 15 分钟能在自己的 Mac 上跑起来。Windows 的步骤不一样,后面单独写。
以 2026 年 10 月的版本为准。安装命令如有变化,以 Anthropic 的文档为准。
开始前准备
- 一台 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 doctor,它会检查安装有没有问题。 - 把报错截图存下来,搜一下报错的第一行,大多数问题别人遇到过。
- 折腾半小时还没好,可以找小格远程帮你装。