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

前言

Claude Code 是 Anthropic 推出的 AI 编码助手，专为开发者打造，相比通用 AI，它对 Java、SpringBoot 等企业级开发场景的适配性更强，能精准生成可运行的代码、排查业务逻辑 bug、优化接口性能，大幅提升开发效率。本文从安装部署、提示词技巧、SpringBoot 项目实战三个核心维度，手把手教你玩转 Claude Code，最终实现'AI 辅助完成完整 SpringBoot 项目开发并落地本地'。

一、Claude Code 安装部署（3 种主流方式）

Claude Code 支持网页版、桌面客户端、IDE 插件三种使用形式，开发者优先推荐 IDE 插件（无缝融入本地开发流程）。

1. 环境前置要求

• 本地开发环境：JDK 8+/Maven 3.6+/IntelliJ IDEA 2022+（或 Eclipse）
• 网络：需访问 Anthropic 官网（国内用户可通过合规网络环境）
• 账号：注册 Anthropic 账号（需邮箱验证，支持个人 / 企业账号）

2. 方式 1：网页版（零安装，快速尝鲜）

1. 访问 Claude 官方网址：https://www.anthropic.com/claude
2. 登录账号后，在左侧菜单栏选择「Claude Code」（新版已整合编码模块）；
3. 右侧切换「Code Mode」（编码模式），即可开始编写提示词生成代码。

3. 方式 2：桌面客户端（跨平台，无浏览器限制）

1. 下载地址：https://www.anthropic.com/claude/downloads
2. 选择对应系统（Windows/macOS/Linux），下载后双击安装；
3. 安装完成后登录账号，进入「Code」模块即可使用。

4. 方式 3：IDEA 插件（推荐，本地开发无缝衔接）

步骤 1：安装插件

1. 打开 IntelliJ IDEA，进入「File → Settings → Plugins」；
2. 搜索「Claude Code」（或「Anthropic Claude」），点击「Install」安装；
3. 安装完成后重启 IDEA，在右侧边栏会出现 Claude Code 面板。

步骤 2：配置 API Key

1. 登录 Anthropic 官网，进入「Settings → API Keys」，创建并复制 API Key；
2. 回到 IDEA，在 Claude Code 面板中粘贴 API Key，点击「Save」；
3. 测试连接：输入「Hello World in Java」，若能生成代码则配置成功。

注意：API Key 需妥善保管，不要泄露；免费账号有额度限制（每月约 10 万 tokens），企业账号可付费扩容。

二、Claude Code 提示词编写核心技巧（针对 Java/SpringBoot）

Claude Code 的效果完全依赖提示词质量，针对 Java 开发，需遵循「精准需求 + 技术约束 + 输出格式」的原则，以下是核心技巧和示例：

1. 提示词编写三要素

要素	说明
精准需求	明确功能（如'用户登录接口'）、入参出参、业务规则（如'密码加密用 BCrypt'）
技术约束	指定框架版本（如 SpringBoot 2.7.x）、数据库（MySQL 8.0）、编码规范（阿里 Java 规范）
输出格式	要求'完整可运行代码 + 注释 + 测试用例'，避免碎片化代码

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% 重复编码时间。

六、常见问题与解决

问题	解决方案
API Key 验证失败	检查 Key 是否过期，确认账号有 Claude Code 使用权限，网络环境是否合规
生成的代码无法运行	提示词中明确框架版本、依赖版本，要求 Claude 输出 pom.xml 完整依赖
本地项目导入后依赖报错	刷新 Maven 依赖（IDEA 中点击「Reload All Maven Projects」），检查仓库配置
生成的代码不符合编码规范	提示词中加入'遵循阿里 Java 开发手册'，指定代码风格（如驼峰命名、注释规范）

七、总结

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

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

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