Claude Code 保姆级入门：从安装到跑通第一个项目

技术系列第 1 篇。读完你能在自己的项目里启动 Claude Code，走完"读代码、改代码、跑测试、必要时回退"的完整一轮。

一、它是什么，适合谁

Claude Code 是 Anthropic 推出的 AI 编程助手，运行在终端里。你在项目目录里启动它，用自然语言描述需求，它会阅读代码、修改文件、执行命令，每一步都摆在你眼前。

和网页聊天的区别很直接：网页里的 AI 只能看到你粘贴的片段，Claude Code 直接在你的项目里工作，能自己找文件、自己跑测试。

适合的人：

有一点编程基础，会基本的终端操作
手上有真实项目，想让 AI 参与读代码、修 bug、补测试
愿意看清它做了什么，再决定要不要采纳

不太适合的人：

完全没碰过命令行，建议先熟悉 cd、ls 这类基础操作
想要"一句话全自动、完全不用看"。它是助手，不会替你负责
代码不能交给外部服务处理的项目。代码内容会发送给模型，涉密项目请先确认公司规定和官方的数据说明

二、准备工作

开始前要备齐四样东西。具体做法会随版本变化，所以这里只讲"要什么"，不写安装命令：

一个终端：Windows、macOS、Linux 各有各的终端，各系统的支持方式以官方文档为准
Node.js 环境：通常需要先准备，但是否必需、版本要求，随版本变化，以官方文档为准
Git：用来给 AI 的改动兜底，第四节会用到
账号：登录方式、可用套餐、所在地区能否使用，都以官方文档为准

安装命令请直接从官方复制：搜索"Claude Code 官方文档"，打开 Anthropic 官网的文档页即可。别从二手文章或截图里抄命令，包括这篇。

三、第一次启动

用 cd 进入你的项目目录
输入 claude 回车
首次使用会引导你登录，按屏幕提示完成（以官方为准）

一定要在项目目录里启动，它默认围绕当前目录工作。进入后是一个对话界面，底部是输入框，直接打字就行。输入框里有三个特殊开头：

/ 唤出斜杠命令，比如 /help
@ 加文件路径，引用某个文件，如 @src/main.py
! 开头，直接执行 shell 命令，如 !git status

四、第一个任务：读懂、小改、跑测试、回退

用一个虚构项目演示：todo-cli，一个命令行待办工具，支持 add 和 list，带一套测试。路径和命令都是示例，换成你自己的项目即可。

先做一件事：提交。运行 git status 确认没有未提交的改动，有就先 git commit 一次。这样不管 AI 改成什么样，都能回到起点。

第一步，读懂项目。 输入：

请阅读这个项目，说明目录结构、入口文件，以及怎么运行测试。先不要修改任何文件。

第二步，小改动。 输入：

给 list 命令加一个 --done 参数，只显示已完成的待办。动手前先说方案。

它会给出方案，改文件前请求许可，并展示要改的内容。看懂了再同意。

第三步，跑测试。 输入：

运行测试，如果失败，先分析原因再修复。

也可以自己用 ! 跑，比如 !npm test（测试命令以你的项目为准）。

第四步，满意就提交，不满意就回退。 先用 !git diff 看全部改动。满意就 git commit；不满意，用 git restore . 丢弃已跟踪文件的改动。新建的文件不会被它清掉，用 git status 检查后手动处理。

这一轮里有三个提问习惯，值得从第一天就养成：

一次只交代一件事。"加参数、顺便重构、再改文档"混在一起，出错时很难定位
说清范围和验收标准，比如"只改 list 命令，改完要能通过现有测试"
重要改动先问方案。让它先说思路，你点头了再动手，比事后返工省力

五、必会的 8 个命令/操作

/help：查看当前版本支持的全部命令，忘了就查它
/init：扫描项目，生成 CLAUDE.md 草稿
/clear：清空对话，换新任务时用
/compact：压缩上下文，保留要点，对话变长时用
/resume：继续之前的会话
/model：切换模型，可选项因版本和账号而异
Shift+Tab：切换权限模式，其中包含计划模式
Esc：中断它正在做的事，发现跑偏立刻按

六、权限与安全

Claude Code 改文件、跑命令之前，会先请求你的许可。这道关是留给你用的，别养成无脑回车的习惯。每次同意前看三件事：

改的是哪个文件？是不是你期望的范围
命令是什么？看清每个参数，尤其是带删除、覆盖、下载执行的
能不能撤销？能用 Git 撤回的相对放心，撤不回的先停下

这几类操作务必先停下来自己确认：

rm -rf 之类的批量删除
git push --force 这类改写远程历史的操作
读取或上传 .env、密钥、令牌
来历不明的 curl ... | sh

再养成两个习惯。改动较大时，按 Shift+Tab 切到计划模式，让它先出方案，你确认后再动手。另外，不要把密码、密钥贴进对话；如果出现"以后都允许"之类的选项，除非命令无害且固定，否则别点。 )

七、写好第一个 CLAUDE.md

CLAUDE.md 是放在项目里的说明书，Claude Code 会话开始时会读取它，一上手就了解你的项目。运行 /init 能生成草稿。

草稿别原样使用，删到只留这几类：

项目是什么，一两句话
常用命令：安装、运行、测试
代码约定：命名、目录规则
禁区：不能动的文件、不能做的操作

原则是短、具体、可执行。"代码要写得优雅"没用，"改完必须跑测试"才有用。更完整的写法，系列后面会专门展开。

八、常见问题

连不上、登录失败：先确认终端本身能正常联网；账号、地区、网络方面的限制以官方文档为准。对声称能"绕过限制"的第三方工具要谨慎，你的代码和账号信息会经过它
卡住不动：先等一会儿；确实没反应就按 Esc 中断，把需求拆小、说具体后重试
越聊越慢、开始答偏：多半是上下文太长。用 /compact 压缩，换任务时用 /clear，想找回旧对话用 /resume
改坏了：回到 Git，用 git diff 看清楚，再决定提交还是 git restore .
命令不认：多半是版本差异，用 /help 看当前支持的命令，并对照官方文档

结语与预告

这一篇走完了最小闭环：装好、启动、读懂项目、小改动、跑测试、能回退。把它在自己的项目里完整走一遍，比读十篇教程有用。

系列后面会依次聊三个进阶主题：

Hooks：在特定时机自动执行你写好的脚本
子代理：把任务交给专门负责某类事情的助手
Skills：把常用做法打包，反复复用