Claude Code 教程：从安装部署到 SpringBoot 项目实战

2. 经典提示词模板（直接复用）

【需求】开发一个 SpringBoot 用户管理模块【技术约束】1. 框架：SpringBoot 2.7.10、MyBatis-Plus 3.5.3.1 2. 数据库：MySQL 8.0，表名 t_user，字段：id(BIGINT,主键)、username(VARCHAR)、password(VARCHAR)、create_time(DATETIME) 3. 功能：实现用户新增、查询（单条 + 列表）、修改、删除接口 4. 规范：遵循阿里 Java 开发手册，密码用 BCrypt 加密，接口返回统一 JSON 格式【输出要求】1. 完整代码：包含实体类、Mapper、Service、Controller、配置文件 2. 注释：关键方法添加详细注释 3. 测试：提供 Postman 测试用例（请求 URL+ 参数）

3. 避坑指南

• 避免模糊需求：不要只写'做一个用户接口'，需明确入参、出参、异常处理；
• 限定版本：SpringBoot 不同版本配置差异大，必须指定具体版本；
• 分步提问：复杂项目拆分为'实体类→Mapper→Service→Controller'分步生成，避免一次性生成过多代码导致混乱。

三、实战 1：用 Claude Code 生成完整 SpringBoot 项目并保存本地

本节通过 Claude Code 生成一个'用户管理系统'SpringBoot 项目，全程无需手动写核心代码，最终保存到本地并可直接运行。

步骤 1：编写精准提示词

在 Claude Code（IDEA 插件 / 网页版）中输入以下提示词：

【目标】生成可直接运行的 SpringBoot 2.7.10 用户管理项目【技术栈】- 核心框架：SpringBoot 2.7.10、Spring MVC、MyBatis-Plus 3.5.3.1 - 数据库：MySQL 8.0，自动生成建表语句 - 工具：Lombok、Knife4j（接口文档）、BCrypt（密码加密）【功能】1. 基础功能：用户新增、根据 ID 查询、用户列表查询、修改用户信息、删除用户 2. 全局配置：统一返回结果、全局异常处理、跨域配置【输出要求】1. 按标准 Maven 项目结构输出所有代码文件（src/main/java + src/main/resources）2. 包含 pom.xml、application.yml、建表 SQL 3. 每个文件完整代码，标注文件路径（如 com.example.user.entity.User）4. 提供项目运行步骤和测试说明

步骤 2：获取 Claude Code 生成的代码

Claude Code 会按 Maven 结构输出所有代码，示例片段如下：

<!-- pom.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.10</version>
        <relativePath/>
    </parent>
    <groupId>com.example</groupId>
    <artifactId>user-manage</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>user-manage</name>
    <description>SpringBoot 用户管理项目</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <!-- SpringBoot 核心 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- MyBatis-Plus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.3.1</version>
        </dependency>
        <!-- MySQL 驱动 -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!-- Lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <!-- Knife4j 接口文档 -->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>3.0.3</version>
        </dependency>
        <!-- 测试 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

// com.example.user.entity.User
package com.example.user.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.time.LocalDateTime;

/**
 * 用户实体类
 * @TableName t_user
 */
@Data
@TableName("t_user")
public class User {
    /**
     * 主键 ID
     */
    @TableId(type = IdType.AUTO)
    private Long id;
    /**
     * 用户名
     */
    private String username;
    /**
     * 密码（BCrypt 加密）
     */
    private String password;
    /**
     * 创建时间
     */
    private LocalDateTime createTime;
}

# application.yml
spring:
  # 数据库配置
  datasource:
    url: jdbc:mysql://localhost:3306/user_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
  # MyBatis-Plus 配置
  mybatis-plus:
    mapper-locations: classpath:mapper/*.xml
    type-aliases-package: com.example.user.entity
    configuration:
      # 开启驼峰命名转换
      map-underscore-to-camel-case: true
      # 显示 SQL 日志
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  # 服务器配置
  server:
    port: 8080

步骤 3：本地创建并导入项目

1. 打开 IDEA，点击「File → New → Project from Existing Sources」；
2. 选择本地新建的「user-manage」文件夹（按 Claude 输出的目录结构手动创建）；
3. 依次创建包结构：com.example.user.entity、com.example.user.mapper、com.example.user.service、com.example.user.controller；
4. 将 Claude 生成的代码按文件路径粘贴到对应目录；
5. 创建 user_db 数据库，执行 Claude 生成的建表 SQL：

CREATE TABLE `t_user` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键 ID',
  `username` varchar(50) NOT NULL COMMENT '用户名',
  `password` varchar(100) NOT NULL COMMENT '密码（BCrypt 加密）',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

步骤 4：运行项目

1. 修改 application.yml 中的数据库账号 / 密码为本地配置；
2. 启动 UserManageApplication 主类；
3. 访问 http://localhost:8080/doc.html（Knife4j 接口文档），测试接口是否可用。

四、实战 2：本地 SpringBoot 项目中使用 Claude Code（进阶示例）

本地项目搭建完成后，可通过 Claude Code 实现「功能扩展」「Bug 排查」「代码优化」，以下是 3 个高频场景示例：

场景 1：扩展功能 —— 添加用户登录接口

在 IDEA 的 Claude Code 面板中输入提示词：

【上下文】我已有的 SpringBoot 用户管理项目中，实体类 User 包含 id、username、password、create_time 字段，使用 MyBatis-Plus【需求】添加用户登录接口【要求】1. 接口路径：/user/login 2. 请求方式：POST 3. 请求参数：username（String）、password（String）4. 业务逻辑：- 校验用户名和密码是否为空 - 根据 username 查询用户，不存在则返回'用户不存在' - 用 BCrypt 匹配密码，错误则返回'密码错误' - 登录成功返回用户信息（隐藏 password）+ token（模拟生成）5. 输出：完整的 Controller 代码+Service 代码 + 统一返回结果类

Claude Code 会生成如下代码（直接复制到本地项目）：

// 统一返回结果类：com.example.user.common.Result
package com.example.user.common;
import lombok.Data;

/**
 * 统一返回结果
 */
@Data
public class Result<T> {
    /**
     * 状态码：200 成功，500 失败
     */
    private Integer code;
    /**
     * 提示信息
     */
    private String msg;
    /**
     * 数据
     */
    private T data;

    // 成功返回
    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.setCode(200);
        result.setMsg("操作成功");
        result.setData(data);
        return result;
    }

    // 失败返回
    public static <T> Result<T> error(String msg) {
        Result<T> result = new Result<>();
        result.setCode(500);
        result.setMsg(msg);
        result.setData(null);
        return result;
    }
}

// Service 扩展：com.example.user.service.UserService
package com.example.user.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.user.common.Result;
import com.example.user.entity.User;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

public interface UserService extends IService<User> {
    /**
     * 用户登录
     * @param username 用户名
     * @param password 密码
     * @return 登录结果
     */
    Result<User> login(String username, String password);
}

// Service 实现类：com.example.user.service.impl.UserServiceImpl
package com.example.user.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.user.common.Result;
import com.example.user.entity.User;
import com.example.user.mapper.UserMapper;
import com.example.user.service.UserService;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    private final BCryptPasswordEncoder passwordEncoder = new BCryptPasswordEncoder();

    @Override
    public Result<User> login(String username, String password) {
        // 1. 校验参数
        if (username == null || username.isEmpty() || password == null || password.isEmpty()) {
            return Result.error("用户名或密码不能为空");
        }
        // 2. 查询用户
        LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(User::getUsername, username);
        User user = this.getOne(queryWrapper);
        if (user == null) {
            return Result.error("用户不存在");
        }
        // 3. 验证密码
        if (!passwordEncoder.matches(password, user.getPassword())) {
            return Result.error("密码错误");
        }
        // 4. 隐藏密码，模拟生成 token
        user.setPassword(null);
        // 实际项目中用 JWT 生成 token，此处简化
        return Result.success(user);
    }
}

// Controller 扩展：com.example.user.controller.UserController
package com.example.user.controller;
import com.example.user.common.Result;
import com.example.user.entity.User;
import com.example.user.service.UserService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;

@RestController
@RequestMapping("/user")
@Api(tags = "用户管理接口")
public class UserController {
    @Resource
    private UserService userService;

    @ApiOperation("用户登录")
    @PostMapping("/login")
    public Result<User> login(@RequestParam String username, @RequestParam String password) {
        return userService.login(username, password);
    }
}

场景 2：Bug 排查 —— 修复接口返回异常

若本地运行时出现'登录接口返回 500'，将报错日志复制到 Claude Code，输入提示词：

【问题】SpringBoot 用户登录接口返回 500，报错日志如下：java.lang.IllegalStateException: No bean of type 'org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder' available【需求】1. 分析报错原因 2. 提供修复方案和完整代码 3. 说明避免此类问题的注意事项

Claude Code 会快速定位问题（缺少 BCryptPasswordEncoder 配置类），并生成修复代码：

// 配置类：com.example.user.config.SecurityConfig
package com.example.user.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

/**
 * 安全配置类，注入 BCrypt 密码编码器
 */
@Configuration
public class SecurityConfig {
    @Bean
    public BCryptPasswordEncoder bCryptPasswordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

场景 3：代码优化 —— 提升查询接口性能

针对用户列表查询接口，输入提示词让 Claude Code 优化性能：

【上下文】我的 SpringBoot 项目中有用户列表查询接口，代码如下：@GetMapping("/list") public Result<List<User>> list() { List<User> list = userService.list(); return Result.success(list); }【问题】数据量 10 万时接口响应慢【需求】1. 添加分页功能 2. 优化查询性能（索引、分页插件）3. 输出完整优化后的代码

Claude Code 会生成带分页的优化代码，并给出索引优化建议：

// 添加 MyBatis-Plus 分页插件配置
package com.example.user.config;
import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MyBatisPlusConfig {
    /**
     * 分页插件
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

// 优化后的 Controller
@ApiOperation("用户列表分页查询")
@GetMapping("/list")
public Result<IPage<User>> list(
    @RequestParam(defaultValue = "1") Integer pageNum,
    @RequestParam(defaultValue = "10") Integer pageSize) {
    IPage<User> page = new Page<>(pageNum, pageSize);
    IPage<User> userPage = userService.page(page);
    return Result.success(userPage);
}

// 索引优化建议
/* 在 t_user 表的 username 字段添加索引，提升查询效率：
CREATE INDEX idx_t_user_username ON t_user(username);
*/

五、Claude Code 高级使用技巧

1. 结合本地代码上下文

在 IDEA 插件中，选中本地已有代码（如 User 实体类），点击「Send to Claude」，再输入需求，Claude 会基于现有代码生成适配的功能，避免重复开发。

2. 自定义提示词模板

将常用的 SpringBoot 开发提示词保存为模板（如'生成 RESTful 接口 + Swagger 注释'），每次调用只需修改核心需求，提升效率。

3. 批量生成代码

针对多表 CRUD 场景，输入'生成 t_order、t_goods 两张表的完整 CRUD 接口（SpringBoot+MyBatis-Plus）'，Claude 可批量生成，节省 80% 重复编码时间。

六、常见问题与解决

七、总结

Claude Code 不是'替代开发者'，而是'提升开发效率的利器'—— 它能帮我们省去重复 CRUD 编码、快速排查 Bug、优化性能，让开发者聚焦核心业务逻辑。本文从安装部署到 SpringBoot 项目实战，覆盖了 Claude Code 在 Java 开发中的核心使用场景，掌握这些技巧后，你可以：

1. 10 分钟生成可运行的 SpringBoot 基础项目；
2. 30 分钟完成一个业务模块的开发；
3. 快速定位并修复项目中的常见 Bug。

建议从简单需求开始尝试，逐步掌握提示词技巧，最终实现'AI 辅助 + 人工把控'的高效开发模式。