辈伊温行CLAUDE.md目前不光在Claude Code中被自动加载，OpenCode和Cursor也会自动加载项目的这个文件。它不和SKILLS、SUBAGENTS一样按需加载，它会一直存在于上下文中，所以要尽量小的占用上下文，要做到只放重要信息和你的特殊要求。一般情况下使用/init 生成的是完全无法达到要求的。

经过一段时间的实践，项目中CLAUDE.md可以写下面的几项内容

很多模型默认生成MySQL语法的语句，你项目如果使用Postgresql你就可以在这里说明。

ClaudeCode或者OpenCode使用国内模型的时候也会返回英文，为了不每次都调整可以将"回复使用中文"添加到这里。

你可以在这个文件加入强制它执行规划的提示，如“每次实现新功能的时候，先规划一下然后反思一下规划，有不明白的要向我提问，直到我明确提出执行计划你才能开始编写代码”

有时候它会运行这个项目来看代码是否正确，但有时候你并不想让Claude这么做，你可以告诉它只编译不运行。

你添加一个接口的时候，让Claude按照你的目录的规划来实现各自的代码，而不是自己创建新的目录和文件来实现逻辑

如果给模型的提示词不好使，就在CLAUDE.md中加上MUST FOLLOW多写一遍。

CLAUDE.md 控制在模型上下文Token数的1%之内，尽量少占用上下文。因为模型可能在达到上下文限制之前就已经开始腐化。

当某个SKILLS或者SUBAGENT总是不触发的时候，你可以在CLAUDE.md里面再写一下触发的提示

一些你不希望它做的事情，比如git psuh 和git commit 命令,

其它，待补充...

如下是一个CLAUDE.md的示例

复制代码

### MUST FOLLOW:输出内容的时候一定要使用中文

### MUST FOLLOW: 项目的数据库使用的是PostgreSQL，编写SQL要使用Postgresql的语法，不要使用MySQL的语法

### 做计划的时候要优先考虑业界最佳实践，输出计划前也要再反思一下，参考本项目的整体逻辑不遗漏细节，同时又不要过度设计。

### 测试编译是否成功的时候，编译后不要生成文件

### 项目目录结构

```

gin-project/

├── main.go # 程序入口

├── config/

│ └── config.go # 配置管理

├── controller/ # 控制器 (MVC中的C)

│ ├── user.go

│ └── auth.go

├── service/ # 业务逻辑层

│ ├── user.go

│ └── auth.go

├── model/ # 数据模型 + 数据库操作

│ ├── user.go

│ └── db.go

├── router/ # 路由注册

│ └── router.go

├── middleware/ # 中间件

│ ├── auth.go

│ └── cors.go

├── utils/ # 工具函数

│ └── response.go

└── go.mod

```

### 接口调用链路

当你实现一个接口时，参考文本检测接口 `POST /v1/text/check` 调用链路来实现，完整的调用链路如下：

```

HTTP Request

↓

router/router.go # 路由注册、分组、中间件挂载

↓

middleware/*.go # JWT认证、CORS、日志记录（可选）

↓

controller/*.go # 参数校验、JSON绑定、调用Service

↓

service/*.go # 业务逻辑、事务管理、规则校验

↓

model/*.go # 数据模型、ORM操作、SQL执行

↓

Database # MySQL/PostgreSQL等持久化存储

```