CLAUDE.md配置调教Claude Code：18条技巧让AI变靠谱队友 ​

让AI编程助手从"临时工"变成"老员工"，关键不在于它有多聪明，而在于你如何配置它。CLAUDE.md就是这份员工手册。

CLAUDE.md是什么？ ​

CLAUDE.md是一个纯文本的Markdown文件，你可以在里面写下任何你希望Claude记住的规则、偏好和约定。每次Claude启动时都会自动读取这个文件，就像给它灌输了一套"工作守则"。

不用学任何新语法，会写字就能配置。

三级配置体系 ​

Claude Code支持三级配置，按优先级从低到高：

三级配置如何协作？ ​

优先级：Local > Project > User（更具体的配置优先）

关键规则：

• 规则自动叠加，冲突时更具体的配置覆盖更通用的
• 数组类配置（如权限列表）会合并，而非替换

示例：

• User规定"代码风格用4空格缩进"
• Project规定"这个项目用2空格缩进"
• 最终效果：当前项目用2空格缩进

设置方法 ​

User级（全局配置）：

# Mac/Linux
mkdir -p ~/.claude && nano ~/.claude/CLAUDE.md

# Windows
# 在 %USERPROFILE%\.claude\ 目录下创建

Project级：

直接在项目根目录创建 CLAUDE.md 或 .claude/CLAUDE.md 文件，会随代码提交到Git，团队成员共享。

一、上下文控制：防止AI"注意力涣散" ​

技巧1：用@显式引用文件 ​

每次提需求时，用 @filename.py 或 @src/classes/ 直接指定文件范围。

注意：@符号必须在输入指令之前，否则不生效。

技巧2：先方案后动手 ​

在CLAUDE.md里写明：写任何代码前，必须先描述完整方案并等待人工批准。需求模糊时，主动提问而不是瞎猜。

The Approval Rule: Before writing, modifying, or deleting any code, you MUST present a detailed implementation plan.

Content of the Plan:
1. Objective: What problem are we solving?
2. Proposed Changes: List specific files and the logic to be updated.
3. Potential Risks: Mention any breaking changes or edge cases.

The Wait Command: After presenting the plan, stop and wait for my explicit confirmation (e.g., "y", "go", or "proceed"). Strictly no coding until approved.

技巧3：超过3个文件就拆分 ​

如果一个任务需要改动超过3个文件，先停下来，把它拆成更小的子任务。大任务容易让AI"上下文爆炸"，产生幻觉。

Task Execution Protocol:
Threshold: Before modifying more than 3 files or implementing a complex feature, MUST run /decompose first.
Workflow: List the plan -> Wait for user y to confirm -> Execute sub-tasks one by one.
Strict Rule: No coding until the plan is approved.

技巧4：创建/decompose命令 ​

在CLAUDE.md里定义一个 /decompose 命令，让AI自动把大计划拆成可逐一执行的任务清单。

/decompose: Before executing any complex task, analyze the requirements and break them down into a Markdown checklist. Each task must:
- Be atomic (affecting < 3 files)
- Include a brief description of the implementation logic
- Be ordered by dependency
- Wait for my approval before starting the first item

技巧7：用.claudeignore做硬隔离 ​

类似.gitignore，把敏感文件、无关文件排除在AI的视野之外：

• 保护API密钥、密码等敏感数据
• 屏蔽 node_modules、编译产物等大型目录
• 限制核心配置文件的修改权限

软隔离vs硬隔离：

硬隔离的问题是：屏蔽了图片，哪天想让它批量转格式，会报错找不到文件。软隔离更灵活：平时不碰，需要时用@显式引用即可。

二、持久记忆：让AI"像老员工一样工作" ​

技巧5：写清楚项目规范 ​

把技术栈、文件夹结构、编码规范、要避免的反模式全部写进CLAUDE.md。AI每次启动都会读取，相当于给它做了"入职培训"。

技巧12：错了先问，别急着改 ​

配置一条规则：当我说"错了"时，先提问澄清问题所在，而不是直接重写。这能避免AI在错误方向上越走越远。

技巧16：每次纠错都更新规则 ​

每次你纠正AI的错误，就让它在CLAUDE.md里新增一条规则。这样同样的错误永远不会犯第二次——AI真的能"长记性"。

三、测试驱动：把TDD思维植入AI ​

技巧8：先写测试再修Bug ​

遇到Bug时，要求AI先写一个能复现问题的测试用例，再修复代码直到测试通过。这能确保修复是真正有效的。

技巧9：主动预判问题 ​

让AI写完代码后，主动列出可能出问题的场景，并建议相应的测试用例。把质量意识内化到AI的工作流程里。

After completing any code change:
1. List 3-5 potential edge cases or failure scenarios
2. For each scenario, suggest a test case that would catch it
3. Ask if I want you to implement any of these tests

四、工作流自动化：把AI变成"团队" ​

技巧6：用/memory保存个人偏好 ​

跨项目持久的偏好（比如你喜欢的代码风格、常用的工具链）用 /memory 命令保存，避免每次都重复说明。

技巧10、11：创建专用命令 ​

技巧17：把成功的Prompt转为命令 ​

任何用得顺手的Prompt，都值得转成slash命令或Skill。复用才是效率的来源。

技巧18：用Sub-Agent隔离大任务 ​

重复性高、上下文占用大的任务，创建专用Sub-Agent来处理。这样不会污染主上下文，AI能保持"头脑清醒"。

Sub-Agent Pattern:
For tasks that: (1) are repetitive, (2) have large context, or (3) need isolated environment
Create a dedicated Sub-Agent with: /agent create <name> --task <description>

Examples:
- /agent create test-runner --task "Run all tests and report failures"
- /agent create doc-writer --task "Update documentation for changed code"

五、安全迭代：平衡速度与风险 ​

技巧13：/rewind回滚变更 ​

改错了？用 /rewind 命令回滚，然后给出更精准的反馈重试。

技巧14：Git worktrees并行开发 ​

利用Git worktrees，可以在不同目录并行运行多个Agent会话，任务之间互不干扰。

# 创建worktree
git worktree add ../project-feature feature-branch

# 在另一个终端启动Claude
cd ../project-feature && claude

技巧15：一次性环境快速迭代 ​

在可恢复的一次性环境里，用 claude --dangerously-skip-permissions 跳过权限确认，快速迭代原型。

总结：核心思想就一句话 ​

这18条技巧的核心思想其实就一句话：把AI当成新员工来管理。

你不会指望一个新人第一天就知道所有规矩，但你会给他一份员工手册，告诉他什么能做、什么不能做、遇到问题先问谁。

CLAUDE.md就是这份手册。写得越清楚，AI就越像个"靠谱队友"。