Claude Code 中文社区技巧精选
本文整理自 GitHub 中文社区的优秀开源项目，感谢所有贡献者的分享。
🏆 黄金法则
讨论方案的时间能省下十倍的返工时间
这是中文社区总结的最重要经验：
- 讨论方案 1-2 小时，写代码 10-20 分钟
- 方案没想清楚就动手，返工时间可能是几小时甚至几天
- 先讨论，后编码
📋 技术方案讨论法
第一步：明确告知不要写代码
text
我想实现用户认证功能，先讨论技术方案，不要写代码。第二步：全面提问
问清楚这些问题：
- 整体架构是什么？
- 需要哪些模块？
- 数据流如何？
- 技术选型是什么？
- 可能有哪些坑？
第三步：深入理解每个决策
追问具体原因：
- 为什么用 Redis 而非 Memcached？
- 中间件执行顺序为何这样安排？
- WebSocket 和轮询的区别？
- 数据结构为何这样设计？
核心要点
充分理解技术方案，实施遇到问题时才能给出有效判断。
🔄 多方案对比法
要求 Claude 给出三种方案：
| 方案 | 特点 | 适用场景 |
|---|---|---|
| 方案一 | 最简单快速能上线 | 时间紧迫、MVP |
| 方案二 | 性能最优 | 高并发、大数据量 |
| 方案三 | 最灵活可扩展 | 长期项目、需求多变 |
示例提问：
text
这个场景的行业最佳实践是什么？
业界通常如何解决这类问题？
大厂是怎么做的？
请给出三种方案并分析优缺点。📁 文档系统管理
建立 .agent 文档系统
项目根目录/
├── .agent/
│ ├── tasks/ # 任务记录
│ ├── system/ # 系统配置
│ └── sops/ # 标准操作流程
└── docs/
├── architecture.md # 架构设计
├── decisions.md # 技术决策
└── api-design.md # API 设计效果数据
| 指标 | 改进前 | 改进后 |
|---|---|---|
| 新功能实现速度 | 基准 | 提升 3 倍 |
| 错误重复率 | 基准 | 降低 90% |
保存技术方案
text
把我们讨论的方案整理成文档，保存到 @docs 目录重要
Claude Code 无法跨 session 保持上下文。docs 是跨 session 的上下文，没有文档就没有记忆！
⚡ 上下文管理技巧
关键命令
| 命令 | 作用 |
|---|---|
/context | 诊断上下文使用情况 |
/compact | 压缩对话历史 |
/clear | 清除当前会话 |
使用子代理外包研究工作
让子代理处理：
- 代码搜索
- 文档查找
- 依赖分析
效果数据
| 指标 | 改进前 | 改进后 |
|---|---|---|
| 响应时间 | 8-12 秒 | 3-5 秒 |
| 准确率 | 70% | 95% |
🔁 BMAD 敏捷开发方法
Break down - Multi-role - Agile - Develop
工作流程
- 拆分：将项目拆分为一周的小目标（Sprint）
- 角色：让 AI 扮演不同角色
- 架构师：设计系统结构
- 开发者：实现功能代码
- 测试员：编写和执行测试
- 上下文：每个任务保持完整上下文
- 迭代：编码 → 测试 → 改进
效果数据
| 指标 | 改进 |
|---|---|
| AI 错误率 | 降低 80% |
| 开发时间 | 节省 60% |
🎯 思考模式关键词
Claude Code 支持不同深度的思考模式：
| 关键词 | 思考深度 | 适用场景 |
|---|---|---|
think | 基础 | 简单问题 |
think hard | 深入 | 中等复杂度 |
think harder | 更深入 | 复杂问题 |
ultrathink | 最深度 | 架构设计、疑难问题 |
使用示例：
text
ultrathink 这个分布式系统的一致性问题应该如何解决？📊 可视化技巧
使用 Mermaid 画图，一图胜千言：
text
用 Mermaid 画出系统架构图，展示各模块间的调用关系常用图表类型
- 架构图：展示模块间调用关系
- 数据流图：展示数据流转过程
- 时序图：展示前端、后端、数据库交互
- ER 图：展示数据库表关系
✅ 测试驱动开发
测试覆盖层次
┌─────────────────────────────────┐
│ 接口测试 (API) │
├─────────────────────────────────┤
│ 集成测试 (模块协作) │
├─────────────────────────────────┤
│ 单元测试 (独立函数) │
└─────────────────────────────────┘自动化配置
text
创建测试脚本，集成到 CI/CD
配置 GitHub Actions，测试失败禁止合并🛠️ 120+ 斜杠命令精选
中文社区整理的高频命令：
核心思维命令
/think-ultra- 深度思考/reflection- 反思总结/eureka- 灵感激发
开发流程命令
/spec- 需求规格/design- 设计方案/task- 任务分解/execute- 执行实现
GitHub 集成
/review-pr- PR 审查/fix-issue- 修复问题/gh-commit- 提交代码
📝 案例对比
购物车功能
❌ 常规做法： 边做边改，需求不断变化，代码越来越混乱
✅ 推荐做法：
text
我要实现购物车功能，需要支持：
- 多规格商品（颜色、尺寸）
- 服务端存储（登录用户）
- 本地存储（游客）
- 优惠券计算
- 库存实时检查
先讨论技术方案，不要写代码。API 性能优化
❌ 常规做法： 盲目优化，方向不对
✅ 推荐做法：
text
这个 API 响应慢，请：
1. 分析可能的原因
2. 列出优化方案
3. 评估每个方案的收益和成本
4. 给出优先级建议📚 学习路径建议
初学者（1-2小时）
- 学习基础命令
- 掌握文档系统
- 练习技术方案讨论
进阶用户（3-5小时）
- 多代理协作
- 自定义斜杠命令
- 工作流优化
专家用户（5+小时）
- 复杂工作流设计
- 企业级配置
- 工具集成开发
🔗 社区资源
感谢以下开源项目的贡献：
- ClaudeCode_Skill_CN - Vibe Coding 技巧
- ClaudeCodeTips - 系统化学习知识库
- claude-code-learning - 高级技巧教程
- cc-best-practice - 最佳实践集合
最后更新：2025年12月 | 来源：GitHub 中文社区