Claude Code 实战指南：编辑模式、Review 工作流与后端开发最佳实践

最近在使用 Claude Code 开发 FastAPI 和 Java 后端项目时，整理了一套比较稳定的使用方式。本文主要介绍编辑模式、常用命令、代码审查流程以及项目开发中的一些经验，希望能帮助刚接触 Claude Code 的开发者少踩一些坑。

适用场景：

• FastAPI 项目开发
• Spring Boot 项目开发
• 毕业设计项目
• Web 后端开发
• 项目重构与维护
• 上线前代码审查

---

一、先理解 Claude Code 的四种编辑模式

很多开发者刚开始接触 Claude Code 时，更关注命令和提示词，但实际上编辑模式才是决定开发体验的关键因素。

不同模式决定了 Claude 是否可以直接修改代码，以及修改前是否需要人工确认。

如图为Claude Code的四种编辑模式

1. Ask Before Edits

这是最保守、最安全的模式。
当 Claude 需要：

• 修改代码
• 新建文件
• 删除文件
• 执行终端命令时，都会先征求你的确认。

适用场景

• 支付模块
• 权限系统
• 数据库事务
• 核心业务逻辑
• 生产环境代码

如果涉及线上业务，建议优先使用该模式。

---

2. Edit Automatically

这是开发新功能时效率最高的模式。

Claude 可以直接：

• 创建文件
• 修改代码
• 补充实现
• 完善模块结构

只有执行终端命令时需要确认。

适用场景

• 从零搭建模块
• CRUD开发
• DTO生成
• Service层实现
• 工具类开发

使用建议

开发前先提交一次 Git：

git add .
git commit -m "backup before ai changes"

这样即使出现问题，也能快速恢复。

---

3. Plan Mode

Plan Mode 本质上是一个只读模式。

Claude 可以：

• 阅读代码
• 分析架构
• 设计方案
• 梳理调用链路

不会真正修改项目

适用场景

• 接手陌生项目
• 大规模重构
• 新需求设计
• 架构评估

推荐流程：

Plan
 ↓
Review
 ↓
Coding

先让 Claude 理清思路，再开始写代码，通常效果更稳定。

---

4. Auto Mode

Auto Mode 介于前两者之间。

对于低风险操作：

• 新建文件
• 添加代码

Claude 会直接执行。

对于高风险操作：

• 删除文件
• 修改核心逻辑

则会要求确认。

适用场景

• 日常开发
• 修复Bug
• 小功能迭代

如果没有特殊需求，大部分时间使用 Auto Mode 即可

---

模式选择建议

场景	推荐模式
新建业务模块	Edit Automatically
修改核心逻辑	Ask Before Edits
架构设计与重构	Plan Mode
日常开发	Auto Mode

---

二、开发中最常用的几个命令

相比代码生成，我们使用频率更高的其实是分析和审查类命令。

---

/review

用于代码评审。

例如：

/review backend/app/reserve/

Claude 会重点检查：

• 潜在Bug
• 边界条件
• 代码规范
• 逻辑问题
• 可维护性

比较适合：

• 提交PR前自检
• 功能开发完成后审查

---

/context

快速理解项目结构。

适用于：

• 刚打开项目
• 新开会话
• 接手历史项目

例如：

/context

通常我会先执行一次，再开始开发。

---

/find

全局搜索代码。

例如：

/find db.session.commit

适用于：

• 查找事务提交位置
• 定位关键代码
• 分析调用链路

大型项目中非常实用。

---

/lint

整理代码风格。

主要包括：

• 格式化代码
• 规范修复
• 注释补充

适合作为开发完成后的收尾步骤。

---

/compact

压缩上下文。

当对话达到几十轮甚至上百轮时，Claude 的上下文压力会明显增加。

执行：

/compact

可以压缩历史内容并保留核心信息。

---

三、推荐的开发工作流

经过多个项目实践后，目前比较稳定的一套流程如下。

新功能开发

第一步：需求分析

切换到 Plan Mode。

让 Claude 输出：

• 需求分析
• 数据库设计
• 接口设计
• 模块划分

---

第二步：方案审查

执行：

/review

重点检查：

• 数据一致性
• 并发场景
• 权限控制
• 异常处理

---

第三步：生成代码

切换到 Edit Automatically。

实现：

• Controller
• Service
• Repository
• DTO

---

第四步：代码审查

开发完成后再次执行：

/review

检查新增代码。

---

第五步：测试验证

Python项目：

pytest

Java项目：

mvn test

确认功能正常后再提交代码。

---

四、注意事项！！！

不要把 Claude 当成自动驾驶

Claude 更适合作为：

• 代码助手
• 架构顾问
• Review工具
• Bug排查工具

关键业务逻辑仍然需要开发者确认。

---

不要在自动模式下修改核心配置

例如：

• application.yml
• application.yaml
• .env
• JWT配置
• 数据库配置
• 鉴权模块

这些内容建议使用人工确认模式。

---

长对话要及时整理

很多开发者会遇到：

前面写得很好，后面开始跑偏。

原因通常不是模型能力问题，而是上下文已经过长。

定期执行：

/compact

通常会有明显改善。

---

Git 永远是最后一道保险

无论使用什么 AI 工具，都建议保持以下习惯：

git add .
git commit -m "backup"

这样即使出现误修改，也可以快速回退。

---

五、使用方式

如果是 FastAPI、Spring Boot 等毕业设计项目，可以采用下面这套流程：

需求分析
    ↓
Plan Mode
    ↓
数据库设计
    ↓
接口设计
    ↓
代码生成
    ↓
Review检查
    ↓
测试验证
    ↓
生成文档

适合：

• 医疗预约系统
• 智能健身平台
• 电商系统
• 在线学习平台
• 企业管理系统

同时也方便后续编写：

• 开发日志
• 项目说明书
• 数据库设计文档
• 毕业论文

---

六、常用提示词模板

通用开发模板

严格遵循项目分层架构。

要求：

1. 添加日志记录
2. 添加异常处理
3. 添加参数校验
4. 兼容现有数据库结构
5. 遵循项目代码规范

完成后自行检查边界情况和潜在Bug。

---

Bug修复模板

修复当前代码Bug。

要求：

1. 保留原有业务逻辑
2. 增加事务回滚
3. 增加容错处理
4. 增加异常处理

修复完成后进行自检，并输出详细改动说明。

---

总结

Claude Code 最有价值的地方并不是自动生成代码，而是在开发过程中提供：

• 项目理解
• 架构分析
• 代码审查
• Bug定位
• 开发提效

对于后端项目而言，一个简单但有效的原则是：

先规划，再实现；先审查，再提交。

这往往比直接让 AI 从头写到尾更加稳定，也更符合真实的软件开发流程。