Claude Code 最全使用指南:CLAUDE.md、rules、skills、memory 一次讲清(含架构图+完整模板)
最近 AI Coding 很火,但很多人第一次用 Claude Code 都会有个错觉:
"AI 都这么聪明了,还需要我写规则?"结果实际用起来发现:
- 写代码像刚入职的实习生\
- 修 bug 像准备重写整个项目\
- 找代码像在迷宫里转圈
原因很简单:
AI 不理解你的项目。Claude Code 提供了一套 项目规则系统:
- CLAUDE.md
- rules
- skills
- memory
配置好之后,Claude 不再只是一个聊天 AI,而是:
一个真正理解你项目的 AI 同事。
目录
- Claude Code 是什么\
- 为什么 Claude Code 需要规则系统\
- CLAUDE.md 是什么\
- rules 是什么\
- skills 是什么\
- memory 是什么\
- Claude Code 架构图\
- 推荐项目结构\
- rules 示例模板\
- skills 完整模板\
- 实际使用建议\
- 常见误区\
- 总结
一、Claude Code 是什么?
Claude Code 是 Anthropic 推出的 AI 编程 CLI 工具。
简单说,它可以:
- 阅读整个代码仓库
- 修改代码
- 新建功能
- 分析项目结构
- 自动修 bug
- 执行命令
启动方式:
bash
claude
例如你可以直接说:
帮我分析这个项目结构
或者:
帮我新增一个接口
Claude 会自动阅读代码,然后生成修改。
二、为什么 Claude Code 需要规则系统?
AI 默认并不知道:
- 项目技术栈
- 编码规范
- 模块职责
- 历史设计
所以 Claude Code 提供了一套规则体系:
CLAUDE.md
rules/
skills/
memory
它们的作用:
文件 作用
CLAUDE.md 项目说明
rules 编码规范
skills 自动化流程
memory AI 自动记忆
三、CLAUDE.md 是什么?
一句话:
CLAUDE.md = AI 的项目说明书
它告诉 Claude:
- 项目是什么
- 技术栈是什么
- 项目结构是什么
- 如何运行项目
示例:
markdown
# 项目说明
这是一个 Web 服务项目。
技术栈:
- Node.js
- Express
- PostgreSQL
- Redis
Claude 会用这些信息理解项目。
四、rules 是什么?
rules 是 编码规范库。
它规定:
- Controller 写法
- Service 规范
- ORM 使用规则
- 日志规范
示例:
.claude/rules/controller.md
内容:
markdown
Controller 编写规范
1 Controller 保持轻量
2 不写复杂业务逻辑
3 业务逻辑放在 Service
4 返回统一格式
Claude 写代码时就会遵守这些规则。
五、skills 是什么?
skills 可以理解为:
Claude 的技能包。
例如:
create-api
debug-service
analyze-codebase
如果你说:
帮我创建一个接口
Claude 可以自动执行:
1 创建 Controller
2 创建 Service
3 创建 Repository
4 创建测试
六、memory 是什么?
memory 是 Claude 自动学习的项目记忆。
例如你告诉 Claude:
日志必须使用 logger,不允许 console.log
Claude 可能会记录:
项目规则:禁止使用 console.log
memory 通常存储在:
~/.claude/projects/项目名/memory
特点:
特点 说明
自动生成 Claude 自动记录
长期知识 项目经验
项目隔离 每个仓库不同
七、Claude Code 架构图
Claude Code 的整体结构其实很简单:
开发者
│
▼
Claude Code CLI
│
├── CLAUDE.md (项目说明)
├── rules (编码规范)
├── skills (自动化技能)
└── memory (AI记忆)
│
▼
代码仓库
流程:
1 开发者提出需求
2 Claude 读取规则
3 Claude 分析代码仓库
4 Claude 生成代码修改
八、推荐项目结构
一个成熟项目建议这样组织:
project
│
├─ CLAUDE.md
│
└─ .claude
│
├─ rules
│ ├─ controller.md
│ ├─ service.md
│ └─ database.md
│
└─ skills
├─ create-api
└─ debug-service
职责:
- CLAUDE.md → 项目说明
- rules → 编码规范
- skills → 自动流程
九、rules 示例模板
.claude/rules/controller.md
示例:
markdown
# Controller 规范
1 Controller 只负责接收请求
2 不写复杂业务逻辑
3 所有业务逻辑放在 Service
4 返回统一 JSON 结构
十、skills 完整模板
.claude/skills/create-api/SKILL.md
示例:
markdown
---
name: create-api
description: 创建新的 REST API 接口
---
步骤:
1 创建 Controller
2 创建 Service
3 创建 Repository
4 添加路由
5 添加测试
十一、实际使用建议
推荐流程:
1 先写 CLAUDE.md 2 再写 rules 3 再创建 skills
这样 Claude 就能理解项目。
十二、常见误区
很多人会把所有规则写在:
CLAUDE.md
结果:
- 文件巨大
- AI理解困难
正确方式:
CLAUDE.md → 项目说明
rules → 编码规范
skills → 自动流程
memory → AI经验
十三、总结
Claude Code 的规则体系可以理解为:
文件 作用
CLAUDE.md 项目说明
rules 编码规范
skills 工作流程
memory 自动记忆
关系:
项目说明
↓
编码规范
↓
自动流程
↓
经验知识
当你配置好这些之后:
Claude 就不再只是聊天 AI。
而是:
真正理解项目的 AI 开发同事。
如果这篇文章对你有帮助,欢迎点赞 👍
后面我还会分享:
- Claude Code 实战配置
- AI Coding 工作流
- AI 自动生成接口