10个月深度使用后，我的Claude Code完整配置指南

从二月实验版开始，我就是Claude Code的重度用户，并用它在Anthropic x Forum Ventures黑客松中拿下冠军。十个月日常使用后，分享我摸索出的完整配置体系。

+ Skills与Commands：让重复工作一键完成

Skills本质上是限定作用域的规则，可以理解为特定工作流的提示词简写。长时间用Opus 4.5写代码后想清理死代码？直接运行/refactor-clean。需要测试？/tdd、/e2e、/test-coverage，这些命令还能在单个提示词中链式调用。

两者略有重叠但存储位置不同：Skills放在~/.claude/skills，是更宽泛的工作流定义；Commands放在~/.claude/commands，是快速可执行的提示词。

+ Hooks：基于触发器的自动化

与Skills不同，Hooks被限定在工具调用和生命周期事件上。主要类型包括：PreToolUse（工具执行前的验证提醒）、PostToolUse（执行后的格式化反馈）、UserPromptSubmit（发送消息时）、Stop（Claude响应完成时）等。

比如我设置了一个Hook：在执行npm、pnpm等长时间命令前，如果不在tmux会话中就提醒考虑使用tmux保持会话持久性。另一个实用技巧是用hookify插件对话式创建Hooks，省去手写JSON的麻烦。

+ Subagents：任务委派的艺术

Subagents是主编排器可以委派任务的子进程，拥有受限的作用域，可在前台或后台运行，为主Agent释放上下文。它们与Skills配合默契——一个能执行部分Skills的Subagent可以自主完成被委派的任务。

我的Subagents配置包括：planner负责功能规划、architect负责系统设计、tdd-guide负责测试驱动开发、security-reviewer负责漏洞分析等。关键是为每个Subagent配置允许的工具、MCP和权限。

+ MCP：连接外部世界的桥梁

MCP将Claude直接连接到外部服务，本质是API的提示词驱动包装器。比如Supabase MCP让Claude能直接拉取特定数据、执行SQL查询，无需复制粘贴。

但这里有个关键点：上下文窗口管理。200k的上下文窗口，如果启用太多工具可能实际只剩70k，性能会显著下降。我的原则是：配置20-30个MCP，但保持启用数量在10个以下、活跃工具在80个以内。

+ 插件与LSP

插件将工具打包以便安装，省去繁琐的手动设置。LSP插件特别有用——如果你经常在编辑器外运行Claude Code，语言服务器协议能提供实时类型检查和智能补全，无需打开IDE。

+ 实用技巧集锦

键盘快捷键方面：Ctrl+U删除整行、!作为快速bash命令前缀、@搜索文件、Tab切换思考显示、Esc Esc中断Claude或恢复代码。

并行工作流方面：/fork可分叉对话处理非重叠任务；Git Worktrees让多个Claude实例无冲突并行工作。

另外强烈推荐用mgrep替代grep，它比ripgrep有显著提升，支持本地和网络搜索。

+ 编辑器选择

虽然不是必需，但好的编辑器能显著提升效率。我用Zed——一个基于Rust的轻量级编辑器，打开即时、大代码库也不卡顿。它的Agent Panel能实时追踪Claude的文件修改，CMD+Shift+R命令面板可快速访问所有自定义命令。

VS Code和Cursor同样可行，可选终端模式或扩展集成模式。

+ 核心要点

不要过度复杂化，把配置当作微调而非架构设计。上下文窗口是稀缺资源，禁用不用的MCP和插件。善用并行执行，自动化重复工作，为Subagents设置明确边界。

这套体系的精髓在于：在保持强大能力的同时，精准控制资源消耗。

x.com/affaanmustafa/status/1934706098579292549