一位Claude Code重度用户的完整配置指南，颠覆了我的认知

昨天，一位Anthropic黑客松获奖者公开分享了他的Claude Code配置指南。我当天就把每一条都照着做了一遍，整整花了一天时间，效果立竿见影。

这份指南来自affaan（@affaanmustafa），他已经连续使用Claude Code十个月了。看完他的配置，我的第一反应是：“我这段时间到底在干嘛？”

指南以GitHub仓库的形式发布，核心思路非常清晰：不是越多越好，而是刚好够用。

200K上下文窗口是个幻觉 - 真正可用的只有70K

Claude Code的200K上下文窗口是理论上限。MCP服务器和插件加载太多的话，实际可用上下文会缩水到70K左右。

affaan的做法是：

1. 配置了14个MCP服务器，但每个项目只激活5到6个。
2. 同时启用的工具保持在80个以内。

他实际接入了GitHub、Supabase、Vercel、Railway、Cloudflare全家桶、ClickHouse等总共14个服务器，但通过disabledMcpServers把不用的全部显式禁用。我照着这个思路调整之后，响应质量有了明显的提升。

Skill、Hook、子代理 - 关键在于角色分离

这三个概念刚接触时很容易混淆，但搞清楚它们的区别至关重要。

• Skill：存放在~/.claude/skills目录下。一条命令（比如/refactor-clean）就能跑完整个工作流。
• Hook：事件驱动的自动化机制。编辑.ts文件后自动用Prettier格式化、发现console.log时自动告警等等。hookify插件甚至可以通过对话直接生成Hook。
• 子代理：存放在~/.claude/agents目录下。每个代理有专属角色 - planner负责规划、architect负责架构、tdd-guide负责测试驱动开发、security-reviewer负责安全审查 - 各司其职，接受委派任务。

affaan在三个执行节点 - PreToolUse、PostToolUse和Stop - 都部署了Hook，自动完成格式化、类型检查和安全审计。这套模式也得到了Boris Cherny的认可。

mgrep和Git Worktree是真正的效率杀手锏

指南中最具实战价值的几个技巧：

mgrep

比ripgrep更精准，还内置了网络搜索。一条命令/mgrep 'function handleSubmit'就能同时搜索本地文件和网络资源。

Git Worktree

同时开发多个功能时，创建独立的检出目录，在每个目录中分别运行Claude Code。也可以用/fork来分叉对话。目前社区对于Worktree和仓库克隆哪个更好还有争论 - 两种方式各有取舍，具体选哪个取决于你的工作流。

Zed编辑器

Rust构建，天生轻量。Agent Panel可以实时追踪Claude的文件修改，CMD+Shift+R一键执行自定义命令。

规则文件的模块化管理

按关注点拆分~/.claude/rules目录：

• security.md - 禁止硬编码密钥
• coding-style.md - 不可变性、文件结构规范
• testing.md - TDD工作流、80%最低覆盖率
• git-workflow.md - 提交信息格式
• performance.md - 模型选择策略

把类似”禁止提交console.log”这样的规则写在这里，再配合Stop Hook在提交前自动审计。当自动化替你把关的时候，低级错误自然就消失了。

核心理念

affaan把他的方法论浓缩成了五条原则：

• 把配置当作微调，而不是架构设计。 小而精准的调整远胜大刀阔斧的重构。
• 上下文窗口寸土寸金。 不在用的东西，立刻禁用。
• 善用并行执行。 用/fork和Worktree让多个代理同时工作。
• 把重复劳动自动化。 Hook消灭那些拖慢你节奏的手动步骤。
• 限制子代理的职责范围。 每个代理只做一件明确的事。

过度配置适得其反。只保留真正在用的工具才是真正的生产力。对大多数人来说，做减法是最难的，而这份指南恰好是一个有力的提醒。

补充一点个人经验：在浏览器自动化方面，我发现Vercel的agent-browser比原文提到的Playwright等工具稳定得多。无论是速度还是可处理的任务范围，都不在一个量级上。

完整配置可以在affaan的GitHub仓库中找到。但我的建议是不要照搬，而是理解每一项配置背后的逻辑，再根据自己的工作流做适配。真正的价值在于理解，而不是复制。