米游社自动签到：3分钟搞定stoken配置的完整指南
2026/5/29 2:19:01
作为Java开发者，要让Claude Code真正高效产出生产级代码，关键在于用工程化配置约束AI，而不是依赖它的"自觉"。以下是经过验证的核心配置方案：
一、核心配置文件：CLAUDE.md（根目录必配）
这是Claude每次会话自动读取的上下文文件，需要在项目根目录创建CLAUDE.md，写入强制规范。规范的核心原则是：让Claude成为你团队的一名"资深工程师"，而非自由发挥的实习生。
建议配置内容包括以下方面：
| 配置类别 | 核心约束 |
|---|---|
| 技术栈声明 | JDK 17+、Spring Boot、MyBatis-Plus、Maven |
| 代码极简原则 | 禁止冗余变量、多层if嵌套、过度防御式判空；必须复用项目已有工具类 |
| 数据库性能 | 严禁N+1查询、select *；批量操作必须用batch接口；模糊查询优先右模糊 |
| 事务规范 | 查询方法禁止@Transactional；写操作事务范围最小化；杜绝大事务 |
| 资源安全 | IO流/连接必须自动关闭（try-with-resources）；禁止手动创建线程，统一使用线程池 |
| 工程红线 | 禁止私自新增/修改Maven依赖；禁止新建顶层包；禁止删除原有代码 |
实际经验：有团队将CLAUDE.md与SonarQube规则对齐后，AI生成的代码首次通过率提升约60%。
二、分层规则配置：.claude/rules/*.md
对于大型项目，单一CLAUDE.md会过于臃肿。Claude Code支持递归扫描规则目录，可按模块拆分规范：
bash
.claude/ ├── rules/ │ ├── backend/ │ │ ├── java-spring.md # Spring Boot规范 │ │ └── database.md # SQL规范 │ └── frontend/ # 如Vue规范（按需）
配置优先级（从高到低）：
企业级策略：
/Library/Application Support/ClaudeCode/CLAUDE.md项目规则集：
.claude/rules/*.md项目记忆：
./CLAUDE.md用户全局：
~/.claude/CLAUDE.md
三、Java专用技能包：Developer Kit
推荐安装开源的Developer Kit，它提供了50+ Java专用技能和20+专业Agent：
bash
git clone https://github.com/giuseppe-trisciuoglio/developer-kit.git cd developer-kit-claude-code make install-claude # 交互式安装，按需选择Spring Boot、JUnit等技能
常用命令速查：
| 命令 | 功能 | 使用场景 |
|---|---|---|
/devkit.java.generate-crud | 从领域模型生成完整CRUD | 快速搭建REST API |
/devkit.java.write-unit-tests | 生成JUnit5单元测试 | Service层测试覆盖 |
/devkit.java.code-review | 代码审查（架构+性能+安全） | MR前自检 |
/devkit.java.security-review | OWASP安全审计 | 安全合规检查 |
四、自动化质量门禁：Hooks + MCP
1. PostToolUse Hook
在~/.claude/settings.json配置，每次修改Java文件后自动提示：
json
{ "hooks": { "PostToolUse": [{ "matcher": "Edit|Write|MultiEdit", "hooks": [{ "type": "command", "command": "filepath=\"$CLAUDE_FILE_PATH\"; if [[ \"$filepath\" == *.java ]]; then echo '⚠️ 建议执行 /devkit.java.code-review'; fi" }] }] } }2. SonarQube MCP集成（可选但推荐）
配置MCP Server让Claude能自动调用SonarQube扫描并修复问题：
bash
# 项目根目录创建 sonar-project.properties sonar.projectKey=YOUR_PROJECT_KEY sonar.sources=src/main/java sonar.exclusions=**/test/**,**/resources/**
然后在AGENTS.md中强制规则：
生成代码后必须运行
sonar-scanner，质量问题必须立即修复，质量门通过后才能提交。
五、工作流优化：会话管理与显式调用
| 原则 | 做法 | 理由 |
|---|---|---|
| 单会话单一职责 | 一个会话只开发一个模块，完成后/clear重置 | 防止上下文污染导致规范遗忘 |
| 显式调用审查 | 开发完成后执行/devkit.java.code-review | Claude的自动触发不稳定，手动调用更可靠 |
| Git分支隔离 | 大改动前先git stash+ 新建分支 | 防止AI误删代码，便于diff对比 |
六、效率提升额外配置
| 配置项 | 路径/命令 | 作用 |
|---|---|---|
| 全局共用 | ~/.claude/CLAUDE.md | 放个人通用规范（如日志格式偏好），避免每个项目重复配置 |
| IDE集成 | IntelliJ IDEA插件 + 项目根目录执行claude | 获得Diff视图、自动上下文共享（当前选中代码、Lint错误） |
| LSP支持 | IDE自动提供 | 让Claude理解代码符号（跳转定义、查找引用），而非文本匹配 |
七、避坑清单：绝对禁止的事
根据实际落地经验，以下情况必须杜绝：
❌ 让AI私自修改
pom.xml依赖版本❌ 不指定任何规范就让AI写代码（默认会生成JDK8过时写法）
❌ 一个会话里混合开发多个不相关模块
❌ 直接在生产分支让AI重构代码
最后建议：先从CLAUDE.md强制规范 + Developer Kit技能包起步，运行1-2个迭代后根据团队的"痛点"（如N+1问题频发、事务边界错误）逐步补充Hooks和MCP。记住一个原则：配置即能力，花1小时写好规则，后续每名开发者、每个项目都能持续受益。