Claude Code 最佳实践配置方案

cc.md

Claude Code 配置与工作流完全指南

一、核心概念

1. Skills（技能）与 Commands（命令）

• 用途：预设工作流的快捷方式，可链式调用（如 /refactor-clean、/tdd、/e2e）
• 存储位置：
  • Skills：~/.claude/skills/ — 更广泛的工作流定义
  • Commands：~/.claude/commands/ — 快速执行的提示词

2. Hooks（钩子）

基于事件触发的自动化，绑定到工具调用和生命周期事件：

钩子类型	触发时机
PreToolUse	工具执行前（验证、提醒）
PostToolUse	工具执行后（格式化、反馈）
UserPromptSubmit	发送消息时
Stop	Claude 完成响应时
PreCompact	上下文压缩前

技巧：使用 hookify 插件通过对话创建钩子，无需手写 JSON。

3. Subagents（子代理）

主 Claude 可委托任务给有限作用域的子代理，可在后台/前台运行，释放主代理上下文。

~/.claude/agents/
  planner.md           # 功能规划
  architect.md         # 系统设计
  tdd-guide.md         # 测试驱动开发
  code-reviewer.md     # 代码审查
  security-reviewer.md # 安全分析

4. Rules（规则）与 Memory（记忆）

.rules 文件夹存放 Claude 始终遵循的最佳实践：

~/.claude/rules/
  security.md      # 禁止硬编码密钥
  coding-style.md  # 不可变性、文件组织
  testing.md       # TDD、80%覆盖率
  git-workflow.md  # 提交格式、PR流程

5. MCPs（模型上下文协议）

连接 Claude 到外部服务（数据库、部署平台等），允许直接操作而非复制粘贴。

⚠️ 关键警告：

• 200k 上下文窗口可能因工具过多降至 70k
• 建议：配置 20-30 个 MCP，但仅启用 <10 个 / <80 个工具

6. Plugins（插件）

打包工具便于安装，可包含 skill + MCP 或 hooks/tools 组合。

LSP 插件特别有用 — 提供实时类型检查和智能补全。

---

二、实用技巧

快捷键

按键	功能
Ctrl+U	删除整行
!	快速 bash 命令
@	搜索文件
/	斜杠命令
Shift+Enter	多行输入
Tab	切换思考显示
Esc Esc	中断 Claude

并行工作流

• /fork — 分叉对话并行处理不重叠任务
• Git Worktrees — 多个独立检出避免冲突
• tmux — 长时运行命令的会话管理

常用命令

• /rewind — 回退到之前状态
• /checkpoints — 文件级撤销点
• /compact — 手动触发上下文压缩
• mgrep — 比 ripgrep 更强的搜索（支持本地+网络）

---

三、编辑器配置

Zed（推荐）

• Rust 编写，轻量快速
• Agent Panel 实时追踪文件变更
• CMD+Shift+R 快速访问自定义命令
• 支持 Vim 模式

VSCode / Cursor

• 终端格式或扩展集成均可
• 使用 \ide 启用 LSP 功能

通用建议：

1. 分屏 — 终端 + 编辑器
2. 启用自动保存
3. 确认文件观察器已启用

---

四、示例配置

插件（同时仅启用 4-5 个）

typescript-lsp, pyright-lsp, hookify, mgrep, context7
commit-commands, pr-review-toolkit, security-guidance

钩子示例

时机	匹配器	动作
PreToolUse	npm/pnpm/yarn	tmux 提醒
PreToolUse	git push	打开编辑器审查
PostToolUse	编辑 .ts/.tsx	prettier --write
PostToolUse	编辑 .ts/.tsx	tsc --noEmit
Stop	*	检查 console.log

---

五、核心要点

1. 不要过度复杂化 — 配置是微调，不是架构设计
2. 上下文窗口珍贵 — 禁用未使用的 MCP 和插件
3. 并行执行 — fork 对话、git worktrees
4. 自动化重复工作 — 钩子处理格式化、lint、提醒
5. 限定子代理作用域 — 工具越少，执行越专注

---

六、参考链接

• 插件参考
• 钩子文档
• 子代理
• MCP 概览