← 教程

Claude Code 从零配环境(macOS 版)

2026-10-24 · 教程

这篇写给第一次装 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,它会检查安装有没有问题。
  • 把报错截图存下来,搜一下报错的第一行,大多数问题别人遇到过。
  • 折腾半小时还没好,可以找小格远程帮你装。

自己装不上?

远程一对一,装好、跑通、教会。

看指导服务