共计 2606 个字符,预计需要花费 7 分钟才能阅读完成。
文章目录[显示]
Claude Code 从入门到脱发 · Day 2
昨天我们把 Claude Code 装好了,也跟它打了个招呼。今天正式开工——学会它最基础也最实用的三个能力:读代码、改代码、问问题。
这三招听起来朴素,但用好了能覆盖你日常 80% 的开发场景。毕竟大多数时候我们不是在写全新的代码,而是在理解别人的代码、修改已有的代码、搞清楚某段逻辑到底在干什么。
本文你将学到:
- 如何让 Claude Code 帮你读懂陌生代码
- 如何精准指示它修改代码
- 提问的技巧:什么样的问题能得到好答案
- Plan Mode 的正确用法
阅读时间 :8 分钟 | 实操时间 :20 分钟 | 难度:入门
第一斧:读代码
接手一个新项目,最痛苦的事情是什么?读代码。几万行代码,文档缺失或过时,变量名缩写到你怀疑人生。这是 Claude Code 最擅长的事情之一。
项目全局概览
> 帮我梳理一下这个项目的整体架构,包括目录结构、技术栈、入口文件
Claude Code 会自动扫描项目文件,给你一份结构化的概览。
理解特定文件
> 读一下 src/services/auth.ts,解释它的核心逻辑
注意,你可以直接给文件路径。Claude Code 支持 Tab 补全,敲几个字母按 Tab 就能自动补全路径,非常方便。
追踪调用链
> 用户点击 "登录" 按钮后,代码的执行流程是怎样的?从前端到后端帮我理一遍
这种跨文件的调用追踪,人工做起来得翻好几个文件,Claude Code 几秒钟就能给你画出来。
小技巧:给它一个 URL
Claude Code 能读取 URL 内容。如果你要修复一个 GitHub Issue:
> 看一下这个 issue https://github.com/xxx/yyy/issues/123,分析一下问题原因
它会去读 Issue 内容,然后结合你的代码给出分析。
第二斧:改代码
这是 Claude Code 跟纯聊天 AI 拉开差距的地方——它真的能改你的文件。
简单修改
> 把 src/config.ts 里的 API_URL 从 localhost 改成 api.example.com
Claude Code 会展示 diff(差异对比),等你确认后修改文件。
功能添加
> 给 UserService 加一个 deleteUser 方法,参数是 userId,需要先检查用户是否存在
它会读取现有的 UserService 代码,理解已有的模式和风格,然后按照同样的方式添加新方法。
Bug 修复
> 运行 npm test 之后有个测试失败了,帮我看看哪里出了问题并修复
它会运行测试、读取错误信息、定位问题代码、修复,然后再运行一次测试验证。这整个流程它一气呵成。
重构
> 把这个 500 行的 utils.ts 按功能拆分成多个小文件
Claude Code 会分析文件里的函数,按功能分组,创建新文件,更新所有 import 引用。
改代码的黄金法则
这里有个很重要的经验:指令要具体。
不好的指令:
> 优化一下这个项目
好的指令:
> src/utils/date.ts 里的 formatDate 函数不支持时区,请添加一个可选的 timezone 参数,默认使用 UTC
越具体,结果越准确。含糊的指令会让 Claude Code 发挥想象力,而 AI 的想象力有时候比你的发际线还不受控制。
第三斧:问问题
Claude Code 不仅能改代码,也是个很好的技术顾问。它能结合你的项目上下文回答问题,比在 Google 里搜强多了。
问架构决策
> 这个项目用 Redux 做状态管理,如果要迁移到 Zustand,工作量大吗?需要改哪些地方?
问性能问题
> 分析一下 src/pages/Dashboard.tsx 有没有性能问题,特别是不必要的重渲染
问最佳实践
> 我这个 Express 中间件的错误处理写法对吗?有没有更好的方式?
问 Debug
> 我运行 npm start 的时候报错了,错误信息如下:> [粘贴错误信息]
> 帮我分析一下原因
Plan Mode:先想后做
Claude Code 有个特别实用的模式叫 Plan Mode。按两次 Shift+Tab 切换进去,Claude 进入 " 只读模式 "——它可以分析、思考、规划,但不会执行任何操作。
这在什么时候有用?大型改动之前。
比如你想重构认证模块,直接让 Claude Code 动手可能改出一堆问题。正确的做法是:
第一步:进入 Plan Mode
按两次 Shift+Tab,提示符会变,表示进入了规划模式。
第二步:让它规划
> 我想把用户认证从 Session 改成 JWT,帮我做一个改动计划
它会列出需要改的文件、改动顺序、潜在风险、需要注意的兼容性问题。
第三步:确认后执行
再按两次 Shift+Tab 退出 Plan Mode,然后告诉它执行计划。
这种 " 先想后做 " 的模式,能避免很多翻车事故。你不会让一个陌生人直接装修你家,你会先让他出个方案对吧?
实操练习
找一个你手头的项目,跟着做:
练习 1:读代码
> 帮我梳理这个项目的目录结构和核心文件
练习 2:问问题
> 这个项目有哪些地方的代码写得不够好?列出最严重的三个问题
练习 3:改代码
> 给 README.md 加一段 "快速开始" 的说明,包含安装和运行步骤
练习 4:Plan Mode
[Shift+Tab x2 进入 Plan Mode]
> 如果要给这个项目加单元测试,应该怎么规划?
常见问题 Q&A
Q1:Claude Code 修改文件后能撤销吗?
能。Claude Code 每次修改前会展示 diff,而且你的代码应该在 Git 管理下。最简单的撤销方式:
git checkout -- # 撤销单个文件
git stash # 暂存所有改动
Q2:它会不会改错文件?
Claude Code 每次修改都需要你确认。它展示要改什么,你按 y 才会执行。如果你不确定,可以按 e 在编辑器里详细看看。
Q3:上下文会不会太长导致变卡?
会。随着对话变长,Claude Code 的响应会变慢,还会自动压缩历史消息。建议每完成一个任务就 /clear 清一下上下文,保持它的头脑清醒——你自己摸鱼太久也会走神,AI 也一样。
小结
今天学了 Claude Code 的三板斧:
- 读代码:让它帮你理解项目结构、文件逻辑、调用链
- 改代码:指令要具体,它会展示 diff 等你确认
- 问问题:结合项目上下文的技术咨询
- Plan Mode:大改动前先让它出方案
这三招能覆盖日常 80% 的场景。但你很快会发现一个问题:Claude Code 虽然聪明,但它不了解你团队的代码规范,不知道你偏好的编码风格,每次都要重复交代一堆背景信息。
怎么解决?明天 Day 3,我们聊 CLAUDE.md——一个让 Claude Code " 记住你的规矩 " 的魔法文件。
明天见。
系列进度:2/10