Claude Code Rules 配置实战：规范管理与 Token 优化

注意：规则会自动合并，冲突时高优先级覆盖低优先级。如果不确定，优先在项目目录下配置。

进阶：多语言与子文件夹管理

当项目涉及多种语言时，在 rules 下创建子文件夹（如 python, java, go）是最佳实践。Claude Code 会递归扫描这些目录。

1. 目录结构示例

project-root/.claude/rules/
├── common/           # 通用规则（所有语言）
│   ├── security.md
│   └── doc-style.md
├── python/           # Python 专属
│   ├── coding-style.md
│   └── testing.md
└── java/             # Java 专属
    ├── coding-style.md
    └── spring.md

2. 继承与扩展

如果不同语言的规则有共性（例如都遵循某种安全标准），可以在子文件夹中引用父级规则。例如在 Python 规则文件中添加：

This file extends common/coding-style.md with Python specific content.

这样既能复用通用逻辑，又能保持语言特异性。

全局 vs 项目级：Token 消耗真相

很多开发者纠结是把所有语言规则放全局还是只放项目级。结论很明确：通用规则放全局，定制规则放项目。

为什么不会浪费 Token？

很多人担心全局加载了 Java 规则会影响 Python 项目。其实不用担心，因为规则是否进入上下文取决于 paths 元数据的匹配结果，而非文件是否存在。

• 即使全局放了 java/ 和 go/ 规则，当你处理 .py 文件时，只有 paths 匹配 **.py 的规则会被加载。
• 未匹配的文件完全不会进入上下文，不消耗 Token。
• 真正消耗 Token 的是那些没有配置 paths（默认匹配所有文件）的规则。

实操建议

1. 全局目录 (~/.claude/rules/)：存放各语言的行业通用规范（如 PEP8, GoFmt），每个文件务必配置精准的 paths。
2. 项目目录 (.claude/rules/)：仅存放该项目特有的定制化规则（如指定依赖版本、特殊日志格式），用于覆盖全局规则。

// .claude/settings.json
{
  "permissions": {
    "default": "deny",
    "allow": ["read(**)", "edit(**)", "bash(npm run *)", "bash(git *)"],
    "deny": ["bash(rm -rf *)", "bash(sudo *)", "read(.env*)"]
  }
}

验证与常见问题

配置完成后，可以通过以下方式确认生效情况：

1. 查看列表：在交互界面输入 /rules 命令，列出当前加载的所有规则。
2. 实际测试：让 AI 生成对应语言的代码，检查是否符合预期规范。
3. 排查问题：
   • 规则不生效？检查文件路径是否为 .claude/rules/，扩展名是否为 .md。
   • 规则冲突？检查是否有重复定义，或调整优先级。
   • AI 忽略规则？尝试简化规则表述，使用'必须/禁止'等强指令词汇。

通过合理的配置，你可以让 Claude Code 成为团队统一的开发助手，既保证代码质量，又有效控制成本。