creating-claude-rules

创建 Claude 规则

概述

.claude/rules/ 中的规则是模块化指令，可通过 glob 模式限定到特定文件。它们会自动加载，优先级与 CLAUDE.md 相同。

适用场景

• 在 .claude/rules/ 中创建新规则
• 修复使用错误 frontmatter（globs 而非 paths）的规则
• 将 Cursor 规则迁移为 Claude 格式
• 整理项目专属约定

快速参考

字段	Claude	Cursor
路径模式	paths	globs
始终应用	省略 paths	alwaysApply: true
描述	未记录	description

Frontmatter

路径限定规则

---
paths:
  - 'src/api/**/*.ts'
  - 'tests/**/*.test.ts'
---

或使用单个模式：

---
paths: src/**/*.{ts,tsx}
---

全局规则

完全省略 frontmatter — 适用于所有文件：

# TypeScript Conventions

Use .js extensions in imports.

常见错误

# ❌ WRONG - globs is Cursor format
---
globs:
  - '**/*.ts'
---
# ✅ CORRECT - Claude uses paths
---
paths:
  - '**/*.ts'
---

# ❌ WRONG - alwaysApply is Cursor-only
---
alwaysApply: true
---
# ✅ CORRECT - just omit paths for global rules
# (no frontmatter needed)

# ❌ WRONG - unquoted patterns
---
paths:
  - **/*.ts
---

# ✅ CORRECT - quote glob patterns
---
paths:
  - "**/*.ts"
---

目录结构

.claude/rules/
├── testing.md          # Path-scoped or global
├── typescript.md
└── frontend/           # Subdirectories supported
    └── react.md

系统会递归查找文件。使用子目录进行整理。

Glob 模式

模式	匹配项
**/*.ts	任意位置的所有 .ts 文件
src/**/*	src/ 下的所有内容
*.md	仅根目录中的 Markdown 文件
**/*.{ts,tsx}	.ts 和 .tsx 文件
{src,lib}/**/*.ts	src/ 或 lib/ 中的 .ts 文件

参考

https://code.claude.com/docs/en/memory#modular-rules-with-claude/rules/