Claude Code 最全使用指南:CLAUDE.md、rules、skills、memory 一次讲清

Claude Code 最全使用指南:CLAUDE.md、rules、skills、memory 一次讲清(含架构图+完整模板)

最近 AI Coding 很火,但很多人第一次用 Claude Code 都会有个错觉:
"AI 都这么聪明了,还需要我写规则?"

结果实际用起来发现:

  • 写代码像刚入职的实习生\
  • 修 bug 像准备重写整个项目\
  • 找代码像在迷宫里转圈

原因很简单:
AI 不理解你的项目。

Claude Code 提供了一套 项目规则系统:

配置好之后,Claude 不再只是一个聊天 AI,而是:

一个真正理解你项目的 AI 同事。


目录

  1. Claude Code 是什么\
  2. 为什么 Claude Code 需要规则系统\
  3. CLAUDE.md 是什么\
  4. rules 是什么\
  5. skills 是什么\
  6. memory 是什么\
  7. Claude Code 架构图\
  8. 推荐项目结构\
  9. rules 示例模板\
  10. skills 完整模板\
  11. 实际使用建议\
  12. 常见误区\
  13. 总结

一、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 自动生成接口
相关推荐
乌恩大侠44 分钟前
从 5G 通信到厘米级感知:基于 NVIDIA Aerial、SRS 与 UL-TDOA 构建 6G 无线定位实验平台
人工智能·5g·电信大模型
云和数据.ChenGuang8 小时前
Python 重写(Override)深度解析:从 MRO 到 super() 的完整机制
java·开发语言·人工智能·python·langchain·1024程序员节
西西木科技丨Shopify开发机构8 小时前
CalDigit TS4案例:AI产品图的Shopify整站接入与验收
人工智能·shopify·独立站
又过二十8 小时前
用 Electron 做的 AI 视频切片工作台:VClip 的技术选型与踩坑实录
ai·electron·aigc·funasr·视频切片
2601_965448879 小时前
AI视频制作:做系列节气民俗视频音色不统一,AI 音色克隆省事的方法
人工智能·机器学习·音视频
美狐美颜SDK开放平台9 小时前
视频美颜SDK试用DEMO阶段应该测试什么?直播APP接入实操指南
开发语言·人工智能·深度学习·音视频·美颜sdk·直播美颜sdk·第三方美颜sdk
HRaitest9 小时前
秋招技术岗招聘提效:三类 AI 招聘方案的技术底层与选型逻辑
大数据·人工智能·求职招聘·ai-native
天远数科9 小时前
零信任架构实战:基于天远企业股权变更构建自动化商业银行对公授信存续期股权异动与资产抽逃预警网关
运维·人工智能·架构·自动化
车软学堂9 小时前
从测试转开发,到底要补什么
网络·人工智能·python·功能测试·单片机·车载系统·自动化
海盗123410 小时前
AI 新闻日报 10-28:Atria Dawn 完整版开源、Cursor Agent SDK 转正、Genie 4 实时世界模型
人工智能·机器人·开源·人工智能aigc