不是靠写更好的提示词来扩展 AI 编码工作流。是靠围绕 Agent 构建系统。
大多数人打开 Claude Code，输入请求，拿到代码，继续前进。
高级团队完全不同：创建持久化项目规则、添加安全 Hooks、构建可复用 Agent、分离团队配置和个人配置、自动执行格式化、测试和权限控制——把 Claude 变成真正的工程队友。
这就是 .claude 文件夹变得极其强大的原因。
1. 最大的错误：把所有东西塞进一个 Prompt
大多数开发者反复解释相同的事情："用 TypeScript"、"不要暴露错误"、"遵循我们的 API 结构"、"先跑测试"。
这是浪费的上下文。
顶级配置把所有这些移入持久化项目记忆。你的仓库对 AI 来说变成自文档化的。
# Project: Acme API
## Architecture
- Express REST API
- PostgreSQL via Prisma
- Handlers in src/handlers/
## Conventions
- Use zod validation
- Return { data, error }
- Never expose stack traces
现在 Claude 在你输入 Prompt 之前就已经理解了：你的技术栈、架构、约定、测试流程、格式化规则、安全边界。
这改变了一切。
2. 两个 .claude 文件夹 = 团队大脑 + 个人大脑
这是 Claude Code 中最聪明的设计决策之一。
项目 .claude/
与整个团队共享，进 Git。用于：规则、Hooks、Agents、共享工作流、安全策略。
全局 ~/.claude/
你的个人 AI 环境，不进 Git。用于：个人 Agents、偏好、本地覆盖、Session 记忆。
这种分离非常强大，因为团队获得一致性的同时不失去个人定制能力。
3. 模块化规则胜过巨型 Prompt
大多数团队创建一个巨型 CLAUDE.md。糟糕主意。超过 300 行后，没人维护。
更好的设置：
.claude/rules/
├── code-style.md
├── testing.md
├── api-conventions.md
└── security.md
然后只在需要的地方应用规则：
paths:
- "src/api/**/*.ts"
- "src/handlers/**/*.ts"
---
# API Design Rules
- Return { data, error }
- Use zod validation
- Never leak internal errors
保持指令：更小、模块化、可维护、上下文高效。
你的 AI 变得显著更可靠。
4. Hooks 把 Claude 从"聪明"变成"安全"
Hooks 让你可以在 Claude 行动前后拦截工具执行。
这意味着你可以：阻止危险命令、自动格式化编辑过的文件、强制执行测试、拒绝不安全操作。
示例：
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "./.claude/hooks/bash-firewall.sh"
}
]
}
]
}
}
现在每个 shell 命令都先经过你的防火墙。这是企业级控制。
5. 最被低估的功能：专用 Agent
大多数人用一个巨型通用 AI Agent。糟糕的扩展策略。
Claude 让你创建专注的子 Agent，工具受限、上下文隔离。
示例：
name: code-reviewer
model: sonnet
tools: Read, Grep, Glob
---
You are a senior code reviewer focused on:
- bugs
- edge cases
- maintainability
这极其强大，因为：主上下文保持干净、任务变得确定性、Agent 深度专业化、权限保持受限。
你完全停止上下文污染。
6. 权限比提示词更重要
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Read",
"Edit"
],
"deny": [
"Bash(rm -rf *)",
"Read(./.env)"
]
}
}
这至关重要。
因为最终 AI Agent 不会因为智力问题失败。会因为权限问题失败。
在 AI 自动化中幸存的团队将是构建强大运营边界的团队，而不是有最花哨提示词的团队。
结论
大多数开发者还在"与 AI 聊天"。
下一波开发者将编排 AI。
真正的解锁不是："我如何更好地提示？"
而是："我如何设计一个环境，让 AI 始终表现正确？"
这就是 Claude Code 悄悄实现的东西。