新手第一次用 Claude Code：30 分钟从安装到改完一个小需求
目标不是背 50 条技巧，而是：装好 → 登录 → 进真实项目 → 让它改一个小需求 → 你看懂 diff。按下面时钟走即可；装法细节链到安装文，深度用法链到完整指南。
0–10 分钟：安装并登录
按系统选一篇：
- macOS → macOS 安装
- Windows → Windows 安装
- 总览 / Linux → 完整安装指南
装完最少验收：
claude --version
claude doctor然后在终端执行 claude，用浏览器完成登录。需要 Pro / Max / Team。若 command not found、403、授权码失败，直接查 安装排错；网络与国内访问看 国内使用优化。
10–15 分钟：进入项目，先让它「看地图」
选一个你熟悉、体积别太大的仓库（自己的 side project 最好）：
cd /path/to/your-project
claude进会话后，先别急着「帮我重构全部」。发一句概览请求，例如：
用中文简要说明这个仓库是干什么的、主要目录职责、本地怎么跑起来。先读 README 和明显的配置文件，不要改代码。
你要的是：确认它读对了项目，而不是立刻产出大补丁。若它问能不能读某些文件，第一次会话建议允许读、对写操作再收紧——权限模型详见 permissions / sandbox。
15–25 分钟：丢一个「小到可笑」的需求
小需求示例（挑一个真能合并的）：
- 给 README 加一小节「本地启动」
- 修一个文案错别字 / 过时的端口号
- 给已有函数补 3 行注释或一个早期返回的空值检查
- 加一条
.gitignore里漏掉的本地文件
提示写清楚边界，例如：
只改
README.md里「快速开始」那一节：补上 Node 版本要求和npm run dev。不要动其他文件，改完用简短列表说明改了什么。
要点：
- 范围写死（文件名、章节、禁止事项）。
- 让它改完自述，你对照看。
- 若它想顺手重构，明确拒绝：「这次不要重构。」
25–30 分钟：看 diff，再决定要不要留
在会话里让它展示变更，或你在另一个终端：
git status
git diff检查清单：
- 是否只动了你允许的文件？
- 有没有删掉你需要的段落？
- 命令、端口、路径是否和本机一致？
满意就自己 git add / commit（或让它按你的规范提交——前提是你看过 diff）。不满意就让它回滚该文件或你手动 git checkout -- <file>。
第一次成功 = 你主导范围 + 你验收 diff，不是「全自动 ind 仓库」。
顺带认识两个按钮（先知道存在即可）
Plan mode
复杂改动前，可先让它只读探查、写方案、等你批再改。入口常见是 Shift+Tab 或 /plan（以你版本 UI 为准）。第一次小需求不必强开；等你要动多个模块时再看 Plan mode 专文 和 完整使用指南。
权限弹窗
读文件、跑命令、改文件都可能弹确认。新手建议：
- 读：相对宽松
- 写 / 删 / 网络 / 装包：看一眼再允
- 不要为了省事一上来就全局放行
细规则仍以 permissions / sandbox 为准。
第二次会话可以加什么
今天到「改完并看懂一个小 diff」就够了。技巧清单以后再啃，避免第一次被五十条建议淹没。