上一章里,我们把 AI 编程工具分成三类,并从中选出了能大幅托付实现的 Claude Code 作为本课程的主角。这一章终于要动手了。安装 → 启动 → 登录 → 第一条指令 → 确认差异——这一整套流程,连同容易卡壳的地方,我们都会仔细走一遍,一直带你到 Claude Code 在你的终端里跑起来。

学完本章,你将能够

目标是「在自己的环境里,让 Claude Code 完成第一份工作」

会安装
备好前提,用一条命令装好 Claude Code 并启动。
会下指令
用自然语言请求,跑通规划→编辑→确认差异→批准的基本循环。
会安全使用
掌握权限模式与 CLAUDE.md 的基础,不让它失控地托付。

什么是 Claude Code(上一章回顾)

再用一句话概括:Claude Code 是 Anthropic 出品的「CLI 智能体」。它不是往浏览器聊天框里复制粘贴代码,而是直接在你的终端里,读取、改写项目文件,执行命令,跑测试。你只需用自然语言说「我想这样」,AI 就会自己制定计划,跨多个文件推进工作。它就是坐在你身边、和你一起动手的搭档。

📖 首先要读的两份官方资料。 本章步骤是入门的路标。准确的系统要求、最新的安装方法、收费方案,请务必以一手信息为准——把官方文档 code.claude.com/docs 和产品页 anthropic.com/claude-code 这两处收藏起来,往后会一直派上用场。

安装 —— 装好它

Claude Code 装在 Node.js 环境里使用。不需要复杂的准备。先备好两样前提。

① Node.js

运行 Claude Code 的地基。若还没装,就从官网 nodejs.org 下 LTS 版装上。是否装好,用 node -v 能显示版本号就 OK。

② 终端

敲命令的窗口。macOS 用「终端」,Windows 用「PowerShell」或 WSL,Linux 用自带终端都行。会上一章讲的基本操作就够了。

准备好之后,在终端里敲入下面这行命令。它做的只是用 npm(Node.js 自带的包管理工具)把 Claude Code 装成整个终端都能用

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

-g 的意思是「装到全局(=从任何目录都能调用)」。装完后,用下面这条命令启动。

终端 —— 启动
claude

⚠️ 若出现 claude: command not found 明明装成功了,却不被识别成命令——这是初学者最先撞上的经典卡点。多半是 Node.js/npm 的路径设置有问题,处理办法是固定的。「command not found/安装错误」的文章里,按操作系统整理了修复方法。

细致的系统要求、各操作系统的推荐步骤、替代安装方式,会因环境而异。最新准确的信息,请务必查阅官方文档 code.claude.com/docs

首次启动与登录

claude 首次启动时,它会要求你用 Anthropic 账号登录(认证)。按屏幕提示走即可,多数情况下会自动打开浏览器,在那里登录后认证便完成,再回到终端。

STEP 1
启动

在终端里输入 claude。首次会出现选择登录方式的界面。

STEP 2
认证

按提示在浏览器里登录 Anthropic 账号。授权后认证通过。

STEP 3
回到终端

回到终端后进入等待输入的界面。这里就是对话的入口。接下来终于要下指令了。

登录方式有两种:用有相应套餐的 Claude 订阅登录,或用 API 密钥登录。哪种可用、费用如何产生,因套餐而异,这里不作断言。适合你自己套餐的方式,请查阅官方文档确认。

🔑 登录不了、出现认证错误时。 浏览器打不开、贴了代码却被拒、中途卡住——认证相关也是经典卡点。按原因分类的处理办法,整理在「登录/认证错误」的文章里。若仍未解决,还可搭配系统讲解脱困的第 5 章「脱困」一起看。

下达第一条指令 —— 基本循环

认证完成后,就要动真格了。首先最重要的一点:要在你想操作的项目文件夹里启动 Claude Code。Claude Code 会把「当前所在文件夹」当作操作对象,弄错了就会去动别的地方。

终端 —— 在项目里启动
cd my-project claude

接下来,只需把想让它做的事用自然语言直接说出来。像「读一下 README,说说这个项目是做什么的」「在首页加一个联系表单」这样,用平常的话请求即可。从这里起,下面 4 步会成为不断重复的基本循环

LOOP 1
请求

用自然语言说出想让它做的事。越具体越少含糊,就越贴合你的意图。

LOOP 2
规划

AI 读取相关文件,理出「改什么、怎么改」的步骤,然后开始动手。

LOOP 3
确认差异

哪一行如何改写,会以差异(diff)展示。绿色是新增,红色是删除。

LOOP 4
批准

认可内容就批准并应用。若不对就驳回,用语言说清怎么改,再来一次。

关键在 LOOP 3「确认差异」。Claude Code 在改写文件之前,会先给你看「这里要这样改」的差异,等你批准之后才应用。在这里读内容、判断是否符合意图,正是人的角色。正如上一章所说,读懂它给出的代码、辨别好坏,就是你的工作。

✅ 第一手从「小而可验证」开始。 别一上来就让它大改,先用「解释一下这个文件」「加一个小函数」这类结果能用眼睛核对的小请求来熟悉。顺手了再一点点扩大托付的范围——这才是不绕路的诀窍。

至于请求方式本身(粗略托付的「氛围编程」与先定好规格再让它做的「规格驱动开发」如何取舍),会在第 4 章「会请求」里深入展开。眼下先把这 4 步循环跑通就够了。

权限模式基础 —— 安全地托付

「AI 会不会擅自删文件、执行危险命令?」——这是合情合理的担心。Claude Code 在这一点上设计得很到位:在编辑文件、执行命令这类有影响的操作之前,一定会插入确认环节。这就是权限模式

它的行为分成几档。这里只需把概念大致把握住即可。

🛡 普通模式

每次编辑或执行命令都请求确认。逐条批准,最安全。先用它来熟悉。

📝 计划模式

不做实际改动,只让它拟出「要做什么」的计划。在大动作之前想先定方针时很方便。

⚡ 偏自动批准

省去每次确认,在一定范围内自动推进操作。快,但看内容的次数变少,需更谨慎。

🚨 绕过(无确认)

跳过全部确认直接执行的强力模式。初学者最好避开。使用场景与风险见下方提示。

💡 「嫌确认麻烦就全部绕过」万万不可。 跳过全部确认的模式虽强,但反过来说,你也拦不住不想要的删除或命令执行。若既想安全又想快,正道不是直接开绕过,而是先整理出只放行可信操作的权限规则。此外,还有把工作隔离起来安全运行的「沙箱」这一选项。

这里只需记住「Claude Code 不会擅自失控,会插入确认」「这种行为可以用模式来调整」就足够了。更详细的内容,可在专门的文章和指南里深挖。

🔀 深入了解权限模式

各模式的区别与切换方法,见权限模式详解

⚙️ 设置权限规则

放行、拒绝规则怎么写,见权限规则与设置

📦 隔离起来安全运行

沙箱的思路,见沙箱入门

CLAUDE.md 与设置基础

用久了 Claude Code,你会觉得「每次都要交代同样的注意事项好麻烦」。「缩进用两个空格」「别碰这个文件夹」「回答用中文」——这些项目通用的规则,每次都重新说一遍很低效。

于是就轮到 CLAUDE.md 登场了。在项目根目录放一个这个名字的文件,Claude Code 就会在启动时自动读取,按里面写的规则来工作。它相当于交给搭档的「这个项目的使用说明书」。

CLAUDE.md —— 写法示意
# 关于本项目 - 语言:TypeScript / 框架:Next.js - 回答和注释用中文写 - 缩进用两个空格 - 不碰 src/legacy/ 下的内容 - 提交前先跑通 npm run lint

要点是「短、具体,只写真正想让它守住的」。太长或太含糊,反而更不容易被遵守。先从几行写起,发现「这个我每次都在说」时再补进去,是恰到好处的养成方式。

💡 写进 CLAUDE.md 却不被遵守? 常见原因是:规则太多、太抽象、或彼此矛盾。原因与修法整理在「CLAUDE.md 的规则不生效时」的文章里。掌握「让它生效的诀窍」后,AI 的稳定度会明显提升。

可设置的不止 CLAUDE.md。刚才的权限规则、模型选择、各种行为,都能在设置文件里细调,不过这些以后慢慢来就好。光是「在 CLAUDE.md 里写下几行项目规则」,体感就会不一样。

本章小结
  • Claude Code 是 Anthropic 出品的 CLI 智能体。在 Node.js 环境用 npm install -g @anthropic-ai/claude-code 装好,用 claude 启动。
  • 首次用 Anthropic 账号登录(认证)。卡住就查 command not found/认证错误的相关文章。
  • 基本是请求→规划→确认差异(diff)→批准的循环。读懂差异、判断好坏是人的工作。
  • 权限模式防止失控。初学者避开绕过,边确认边扩大托付范围。
  • CLAUDE.md 里写几行项目规则,AI 会更容易遵守。

至此,Claude Code 已在你的终端里跑起来,第一份工作也能托付给它了。下一章第 3 章「对比着选用工具」里,我们会梳理它与 Cursor、GitHub Copilot、Codex 这些伙伴的区别,学会按场景取舍。