适用于 Spring Boot 应用的 Claude 代码模板

该模板为 Spring Boot 应用提供了一个结构化的起点，专为 Claude AI 的代码补全功能进行了优化。它包含了必要的配置和最佳实践，旨在简化开发流程并提升开发效率。

此模板的设计理念是：您只需克隆本仓库，即可借助 Claude Code 快速生成所需的应用程序。

.
├── .claude
│   ├── agents
│   │   ├── code-reviewer.md
│   │   ├── devops-engineer.md
│   │   ├── docker-expert.md
│   │   ├── java-architect.md
│   │   ├── kubernetes-specialist.md
│   │   ├── security-engineer.md
│   │   ├── spring-boot-engineer.md
│   │   └── test-automator.md
│   ├── settings.local.json
│   └── skills
│       ├── README.md
│       ├── api-contract-review
│       │   └── SKILL.md
│       ├── clean-code
│       │   └── SKILL.md
│       ├── design-patterns
│       │   └── SKILL.md
│       ├── java-architect
│       │   ├── SKILL.md
│       │   └── references
│       │       ├── jpa-optimization.md
│       │       ├── reactive-webflux.md
│       │       ├── spring-boot-setup.md
│       │       ├── spring-security.md
│       │       └── testing-patterns.md
│       ├── java-code-review
│       │   └── SKILL.md
│       ├── jpa-patterns
│       │   └── SKILL.md
│       ├── logging-patterns
│       │   └── SKILL.md
│       ├── spring-boot-engineer
│       │   ├── SKILL.md
│       │   └── references
│       │       ├── cloud.md
│       │       ├── data.md
│       │       ├── security.md
│       │       ├── testing.md
│       │       └── web.md
│       └── spring-boot-patterns
│           └── SKILL.md
├── CLAUDE.md
├── README.md
└── pom.xml

有关该模板的详细说明和介绍，请参阅我的文章《适用于 Spring Boot 的 Claude 代码模板》：Claude Code Template for Spring Boot。

claude-ai-spring-boot 快速上手指南

本指南旨在帮助中国开发者快速利用 claude-ai-spring-boot 模板，结合 Claude AI 的代码生成能力，高效启动 Spring Boot 项目开发。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• JDK：Java Development Kit 17 或更高版本（推荐 JDK 21）
• 构建工具：Maven 3.8+（项目内置 pom.xml，也可使用 IDE 自带 Maven）
• AI 工具：已安装并配置好 Claude Code (CLI) 或支持该模板的 Claude AI 集成环境
• Git：用于克隆仓库

国内加速建议：

• JDK 下载：推荐使用 华为开源镜像站 或 阿里巴巴开源镜像站 获取 JDK。
• Maven 配置：建议在 ~/.m2/settings.xml 中配置阿里云 Maven 镜像，以加速依赖下载：

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>Aliyun Maven</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

安装步骤

1. 克隆模板仓库 使用 Git 将模板克隆到本地目录：

   git clone https://github.com/piotrminkowski/claude-ai-spring-boot.git my-spring-app
   cd my-spring-app
   

2. 清理远程仓库关联（可选） 如果您打算将其作为新项目的起点，建议移除原始的 Git 远程关联：

   git remote remove origin
   git init
   

3. 验证项目结构 确保 .claude 目录、CLAUDE.md 和 pom.xml 文件存在。这些文件包含了针对 Spring Boot 优化的 Agent 定义（如 java-architect, spring-boot-engineer）和技能库（Skills），是 Claude AI 理解上下文的关键。

基本使用

本模板的核心在于通过自然语言指令驱动 Claude AI 生成代码。

1. 启动 Claude Code 在项目根目录下运行：

   claude
   

   (注：具体启动命令取决于您的 Claude Code 安装方式，也可能是 npx @anthropic-ai/claude-code)

2. 发送初始化指令 进入交互界面后，直接输入您的需求。由于模板已预置了 CLAUDE.md 和各类 Agent 技能，您可以直接描述业务场景。

   示例指令：

   请作为一名 Spring Boot 专家，基于当前模板创建一个用户管理模块。
   要求：
   1. 使用 Spring Data JPA 连接 H2 数据库。
   2. 包含 User 实体、Repository、Service 和 REST Controller。
   3. 实现标准的 CRUD 接口。
   4. 遵循 clean-code 技能中的规范，并自动生成单元测试。
   

3. 运行与验证 待 AI 生成代码后，使用 Maven 构建并运行项目：

   ./mvnw spring-boot:run
   

   或者如果您配置了本地 Maven：

   mvn spring-boot:run
   

   应用启动后，即可访问生成的 API 端点（例如 http://localhost:8080/api/users）。