Claude Code
新手起步
Claude code记忆
本文档使用 MrDoc 发布
-
+
首页
新手起步
# Claude Code 新手使用教程:修改代码 既然你已经在工作目录里启动了 `claude`,下面是从零开始改代码的完整流程。 ## 第一步:先让 Claude 了解你的项目(推荐) 在做任何修改前,先运行这个斜杠命令: ``` /init ``` 它会扫描你的代码库,自动生成一个 `CLAUDE.md` 文件,里面记录了项目结构、技术栈、关键命令(比如怎么 build、怎么 test)。这个文件以后每次启动 Claude Code 都会自动加载,相当于给 Claude 一份"项目说明书",省得它每次都要重新摸索。 如果你想让 Claude 先简单了解一下,也可以直接问: ``` 这个项目是做什么的?主要文件在哪里? ``` ## 第二步:用自然语言描述你想改什么 这是最核心的用法——**像跟同事说话一样告诉它需求**,不用记什么特殊语法。 **模糊的提示(不推荐):** > 修一下 bug **清晰的提示(推荐):** > 修复 `src/auth/login.js` 里的登录 bug:用户输入错误密码后页面变空白,应该显示"密码错误"提示。 提示越具体越好:包含**文件路径、现象、期望结果**这三要素,Claude 改对的概率会高很多。 你也可以用 `@` 提及具体文件,例如: ``` 帮我给 @src/utils/validator.js 增加邮箱格式校验 ``` ## 第三步:审查并批准修改(关键!) Claude Code 有个**权限系统**:每次它要修改文件、运行命令时,都会停下来问你是否允许。它会展示一个 **diff(修改对比)**,绿色是新增、红色是删除。 你会看到这样的选项: - `1. Yes` — 批准这一次 - `2. Yes, and don't ask again` — 这个会话里同类操作都自动允许 - `3. No, tell Claude what to do differently` — 拒绝并告诉它怎么改 新手建议**逐个审查**,养成看 diff 的习惯。看到不对的地方,可以选 3 然后说:"不要用 var,改用 const" 或 "把这个函数拆成两个",它会重新做。 ## 第四步:让它自己跑测试 / 验证 改完代码后,可以直接说: ``` 跑一下测试,看看有没有问题 ``` 或者: ``` 运行项目,看能不能正常启动 ``` 它会执行命令、读取报错、自动迭代修复。这是 Claude Code 比网页版 Claude 强的地方——它能**真的执行代码、看到结果**。 ## 必须知道的几个快捷操作 | 操作 | 作用 | |---|---| | `Shift + Tab`(按两下) | 进入 **Plan Mode(计划模式)**,Claude 只规划不动手,适合复杂改动先看方案 | | `/clear` | 清空当前对话上下文,开始新任务前用,避免无关历史干扰 | | `/compact` | 对话太长时压缩历史,节省 token | | `Esc` | 打断 Claude 正在做的事 | | `↑` 箭头 | 调出历史命令 | | `#` 开头的消息 | 自动保存到 CLAUDE.md,用来记项目规则 | ## 给新手的三条实战建议 **1. 改代码前先 `git commit` 一下。** 这是最重要的安全网。即使 Claude 改坏了,你也能 `git reset` 回退。养成"小步提交"的习惯。 **2. 一次只做一件事,做完用 `/clear`。** 不要在同一个对话里又改登录又改支付又改 UI——上下文会越来越乱,Claude 容易出错。任务切换时清空重来。 **3. 复杂改动先用 Plan Mode。** 如果改动会涉及多个文件(比如重构、加新功能),先 `Shift+Tab` 两次进入计划模式,让它先出方案,你确认无误后再让它执行。 ## 一个完整的小例子 假设你想给项目加一个新功能: ``` > /init (等它生成 CLAUDE.md) > 我想在 utils 目录下新增一个文件 dateFormatter.js, 导出一个函数 formatDate(date),把 Date 对象格式化成 "YYYY-MM-DD" 字符串。 写完后帮我加一个简单的单元测试。 (Claude 展示要创建的文件 → 你按 1 批准) (Claude 展示测试文件 → 你按 1 批准) > 跑一下测试 (Claude 执行 npm test,看到结果) ``` 整个过程你只需要看 diff、按确认。 --- 更详细的官方文档可以参考:[docs.claude.com/en/docs/claude-code/overview](https://docs.claude.com/en/docs/claude-code/overview)
koalalove
2026年5月9日 00:47
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码