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：把常用做法打包，反复复用
