今天这段api-design.md看起来很短,只有一个paths范围和三条 API 约定,但它实际解决的是 Claude Code 使用中一个很关键的问题,规则到底应该一直塞进上下文,还是等它真的碰到相关代码时再加载。在 Claude Code 项目里,.claude/rules/可以把项目指令拆成多个 Markdown 文件。官方文档也明确提到,规则可以按文件路径限定,只在 Claude 正在处理匹配文件时进入上下文,这样可以减少噪音,也能节省上下文空间。规则文件放在项目的.claude/rules/目录下,文件名可以像testing.md、api-design.md这样按主题命名,所有 Markdown 文件会被递归发现。api-design.md的价值就在这里。它不是一个普通的说明文档,而是一份面向 Claude Code 的后端 API 工作规则。它告诉 Claude,当正在读写src/api/下面的 TypeScript 文件时,才需要把 API 设计规范加载进来。官方文档给出的路径规则示例也正是src/api/**/*.ts,并说明这种paths字段基于 glob 模式,只在 Claude 处理匹配文件时生效。说到这个机制,最容易踩的坑是把所有规则都写进CLAUDE.md。CLAUDE.md适合放项目长期通用背景,比如项目技术栈、常用命令、架构边界、编码风格等。可
api-design.md,给 Claude Code 的后端 API 规则装一个自动触发器
今天这段api-design.md看起来很短,只有一个paths范围和三条 API 约定,但它实际解决的是 Claude Code 使用中一个很关键的问题,规则到底应该一直塞进上下文,还是等它真的碰到相关代码时再加载。在 Claude Code 项目里,.claude/rules/可以把项目指令拆成多个 Markdown 文件。官方文档也明确提到,规则可以按文件路径限定,只在 Claude 正在处理匹配文件时进入上下文,这样可以减少噪音,也能节省上下文空间。规则文件放在项目的.claude/rules/目录下,文件名可以像testing.md、api-design.md这样按主题命名,所有 Markdown 文件会被递归发现。api-design.md的价值就在这里。它不是一个普通的说明文档,而是一份面向 Claude Code 的后端 API 工作规则。它告诉 Claude,当正在读写src/api/下面的 TypeScript 文件时,才需要把 API 设计规范加载进来。官方文档给出的路径规则示例也正是src/api/**/*.ts,并说明这种paths字段基于 glob 模式,只在 Claude 处理匹配文件时生效。说到这个机制,最容易踩的坑是把所有规则都写进CLAUDE.md。CLAUDE.md适合放项目长期通用背景,比如项目技术栈、常用命令、架构边界、编码风格等。可