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

> Author: Tony Lee
> Published: 2026-02-08
> URL: https://tonylee.im/zh-CN/blog/claude-code-expert-complete-setup-guide/
> Reading time: 1 minutes
> Language: zh-CN
> Tags: ai, claude-code, developer-tools, productivity, workflow

## Canonical

https://tonylee.im/zh-CN/blog/claude-code-expert-complete-setup-guide/

## Rollout Alternates

en: https://tonylee.im/en/blog/claude-code-expert-complete-setup-guide/
ko: https://tonylee.im/ko/blog/claude-code-expert-complete-setup-guide/
ja: https://tonylee.im/ja/blog/claude-code-expert-complete-setup-guide/
zh-CN: https://tonylee.im/zh-CN/blog/claude-code-expert-complete-setup-guide/
zh-TW: https://tonylee.im/zh-TW/blog/claude-code-expert-complete-setup-guide/

## Description

Anthropic黑客松冠军公开了他用了10个月的Claude Code配置方案。从上下文窗口管理到Skill、Hook、子代理的角色分离，这份指南改变了我对AI编程工具的理解。

## Summary

一位Claude Code重度用户的完整配置指南，颠覆了我的认知 is part of Tony Lee's ongoing coverage of AI agents, developer tools, startup strategy, and AI industry shifts.

## Outline

- 200K上下文窗口是个幻觉 - 真正可用的只有70K
- Skill、Hook、子代理 - 关键在于角色分离
- mgrep和Git Worktree是真正的效率杀手锏
  - mgrep
  - Git Worktree
  - Zed编辑器
- 规则文件的模块化管理
- 核心理念

## Content

昨天，一位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仓库中找到。但我的建议是不要照搬，而是理解每一项配置背后的逻辑，再根据自己的工作流做适配。真正的价值在于理解，而不是复制。

## Related URLs

- Author: https://tonylee.im/zh-CN/author/
- Publication: https://tonylee.im/zh-CN/blog/about/
- Related article: https://tonylee.im/zh-CN/blog/eight-hooks-that-guarantee-ai-agent-reliability/
- Related article: https://tonylee.im/zh-CN/blog/medvi-two-person-430m-ai-compressed-funnel/
- Related article: https://tonylee.im/zh-CN/blog/claude-code-layers-over-tools-2026/

## Citation

- Author: Tony Lee
- Site: tonylee.im
- Canonical URL: https://tonylee.im/zh-CN/blog/claude-code-expert-complete-setup-guide/

## Bot Guidance

- This file is intended for AI agents, search assistants, and text-mode retrieval.
- Prefer citing the canonical article URL instead of this text endpoint.
- Use the rollout alternates when you need the same article in another prioritized language.

---

Author: Tony Lee | Website: https://tonylee.im
For more articles, visit: https://tonylee.im/zh-CN/blog/
This content is original and authored by Tony Lee. Please attribute when quoting or referencing.