Claude Code 是什么
Claude Code 不是普通聊天框。它是一个能进入项目、读取代码、编辑文件、运行检查、调用工具,并在权限边界内完成开发任务的 coding agent。
一句话理解
你不用把项目代码一段段复制给它。你把目标说清楚,Claude Code 会在你的工作空间里寻找相关文件,提出计划,执行修改,并解释自己做了什么。
Claude Code 下文简称 CC。重点不是背命令,而是学会用 Plan Mode、权限模式、项目记忆和验收流程稳定指挥 CC。
它能帮你做什么
- 读懂一个陌生项目,告诉你技术栈、入口、目录和关键脚本。
- 修复 Bug,但前提是你给出现象、复现步骤和期望结果。
- 新增页面、接口、文档、测试和小功能。
- 运行项目已有检查,并用中文解释错误。
- 整理提交前总结、风险和下一步建议。
更具体一点,CC 最擅长的是“有目标、有边界、有验收”的任务。例如:
| 任务 | 合适问法 |
|---|---|
| 读项目 | “请只读分析项目结构,不要修改文件。” |
| 修 Bug | “现象是 A,期望是 B,请先定位原因。” |
| 改页面 | “只改这个页面,不影响其他页面,改完检查移动端。” |
| 补文档 | “只基于项目真实文件写,不要编造命令。” |
| 提交前检查 | “请审查当前 diff,优先找风险。” |
它不能替你做什么
- 不能替你承担安全判断。删除文件、覆盖配置、读取密钥时,你要看懂风险。
- 不能保证第一次方案一定正确。你要会要求它先计划、先解释、再修改。
- 不能替代验收。它可以跑检查,但你要判断结果是否满足业务目标。
也就是说,CC 可以帮你把很多开发动作做得更快,但不能替你决定“这样做是否安全、是否符合业务、是否可以上线”。这部分仍然需要用户负责。
它和普通 AI 聊天有什么区别
普通 AI 聊天通常是“你贴一段代码,它回答一段建议”。Claude Code 的工作方式更接近“进入项目做任务”。
| 普通聊天 | Claude Code |
|---|---|
| 需要用户复制代码 | 可以在项目里读取相关文件 |
| 回答通常停留在建议 | 可以按权限修改文件 |
| 不知道项目真实结构 | 可以先只读分析目录和依赖 |
| 不能直接运行检查 | 可以调用本地工具和脚本 |
| 上下文靠用户描述 | 可以结合 CLAUDE.md、记忆和项目文件 |
这也是为什么学习 CC 时,不能只学“怎么提问”,还要学权限、diff、验收和项目记忆。
第一次不要做什么
第一次使用 CC,不建议做这些:
- 让它重构整个项目。
- 让它修一个原因完全不清楚的线上故障。
- 让它改数据库、部署、权限或支付逻辑。
- 让它读取
.env、Token、密钥文件。 - 让它自动提交、推送或清理 Git 历史。
第一次最好只做只读分析或小范围修改。先建立信任,再逐步放大任务范围。
第一次要建立的信任
信任不是相信 CC 永远正确,而是确认它能按流程工作:
| 能力 | 第一次怎么验证 |
|---|---|
| 能读项目 | 让它只读总结目录和入口 |
| 能分清事实 | 要求标注“来自文件”和“推测” |
| 能遵守边界 | 明确不要修改文件,看它是否遵守 |
| 能给计划 | 让它输出最小修改方案 |
| 能验收 | 让它说明怎么证明任务完成 |
第一次可以这样问
我是第一次使用 Claude Code。 请先只读分析当前项目,不要修改文件。 请告诉我: 1. 这个项目大概是什么。 2. 主要技术栈是什么。 3. 关键目录和入口文件在哪里。 4. 可能的启动和检查方式是什么。 5. 哪些文件或目录不应该随便改。 6. 第一个适合练习的低风险任务是什么。
如果 CC 说不清楚项目结构,先不要继续改代码。让它重新读取关键文件,或者换一个更简单的练习项目。
Claude Code 的核心能力地图
- Plan Mode:先研究项目并生成计划,不直接改文件。
- Permission modes:用 default、acceptEdits、plan、auto 控制审批节奏。
- CLAUDE.md:给项目写长期规则、架构说明和验收要求。
- Auto memory:让 CC 记住从纠错中学到的项目经验。
- Skills:把反复使用的流程封装成可调用能力,例如审查、排障、验收。
- Hooks:在关键动作前后插入自动检查,适合团队安全边界。
- MCP:连接外部资料、设计文档、工单系统和内部工具。
- Subagents:把只读分析、代码审查、测试排查拆给多个 agent 并行处理。
学习顺序不要跳
| 阶段 | 先学什么 |
|---|---|
| 认识阶段 | CC 是 agent,不是聊天框 |
| 安装阶段 | 入口、账号、模型、练习项目 |
| 工作流阶段 | Plan Mode、权限、diff、验收 |
| 记忆阶段 | CLAUDE.md、auto memory |
| 扩展阶段 | Skills、Hooks、MCP、Subagents |
如果前面还不会看权限和验收,不要急着上 Hooks、MCP、Subagents。
真正要学会的工作方式
专业使用 CC 的关键流程是:
目标说清楚 范围收得住 Plan Mode 先确认 权限会判断 修改看 diff 检查让 CC 自己跑 失败继续收敛 最后形成可交付总结
学完后的下一步
请根据我的当前情况推荐下一步学习路径。 请判断: 1. 我是否已经安装 Claude Code。 2. 我是否有安全练习项目。 3. 我是否已经完成只读项目分析。 4. 下一篇应该看哪一篇。 5. 不建议我现在做什么高风险任务。
验收结果
- 你知道 CC 和普通 AI 聊天的区别。
- 你知道 CC 可以读项目、改文件、跑检查,并能通过权限模式控制节奏。
- 你知道安全判断和最终验收仍然要由你负责。
- 你知道第一次使用应该先只读分析,再做低风险小任务。