Appearance
Claude Code最强使用指南！GitHub 13万星，看完少走半年弯路
用了一年代码，才发现自己一直在用"新手模式"。
仓库：shanraisshan/claude-code-best-practice（130K Star，曾登GitHub Trending日榜第一）
一、五大核心原语
Claude Code真正的能力建立在五大原语之上，核心编排模式是：
Command编排 → Agent执行 → Skill注入知识
| 原语 | 定位 | 特点 |
|---|---|---|
| Subagents | 独立上下文执行者 | 主对话只看结论，中间过程隔离 |
| Commands | 手动触发的固定模板 | 高频重复操作用/command |
| Skills | 自动发现的知识模块 | description做语义匹配自动触发 |
| Hooks | 确定性代码 | PreToolUse拦截、PostToolUse格式化 |
| Memory | 团队共享知识 | CLAUDE.md + .claude/rules/签入Git |
二、CLAUDE.md 魔鬼细节
| 规则 | 说明 |
|---|---|
| 200行以内 | 60行效果最好，超200行遵守率断崖下跌 |
| 条件标签 | 条件包裹的规则遵守率明显提升 |
| 确定性行为放settings | 锁死的行为放settings.json，模型会忘但配置不会 |
正确示例：
条件：永远先运行测试套件，测试不过不创建PR。三、上下文管理是分水岭
关键数据：1M上下文窗口，上下文腐烂点300-400K tokens，"降智区"约40%上下文利用率。
| 策略 | 做法 |
|---|---|
| Rewind优于Correct | 出错不要在同一上下文修正，两下Esc回退重来 |
| 新任务=新会话 | 独立任务用新上下文窗口 |
| 子代理是终极武器 | 只需要结论的任务派子代理，中间过程隔离 |
建议控制上下文在40%以内，激进控制在30%以内。
四、Boris Cherny 13条铁律（精选）
- 一切任务用Opus+Thinking — per-token更慢但端到端更快，因为不需要频繁纠正
- 同时跑5个Claude — 终端标签编号，任务分发到不同标签并行
- 让Claude用你所有工具 — 接Slack/BigQuery/Sentry MCP
- 给Claude验证自己工作的方法 — 最终质量提升2-3倍
- 团队共享一份CLAUDE.md — 签入Git，像维护代码一样维护
五、Thariq 9条技能设计原则（精选）
| 原则 | 说明 |
|---|---|
| 技能是文件夹不是文件 | references/scripts/examples子目录渐进式披露 |
| 建立Gotchas章节 | 每次犯错加一条，信号最强的部分 |
| Description是触发器 | 回答"什么场景该触发"，不是给人类看 |
| 给目标约束不给步骤 | 告诉它达成什么效果，让它自己规划路径 |
六、小PR数据
- 141个PR/天
- 中位数118行代码
- 总计45,000行/天
- 始终squash merge，一个功能一个commit
七、三大工作流流派
| 流派 | 代表作 | 特点 | 适合 |
|---|---|---|---|
| 重装派 | Superpowers（231K⭐） | TDD优先，14个skill覆盖SDLC | 团队协作、工程质量 |
| 全能派 | Everything Claude Code（217K⭐） | 38命令/75代理/156技能 | 个人开发者、多平台 |
| 轻量派 | Get Shit Done（64K⭐） | 每次全新上下文，XML计划 | 快速原型、个人项目 |
核心循环都收敛到：Research → Plan → Execute → Review → Ship
最后
当课程读，不要当配置拷。按需取用，不全盘接收。
每次选3-5条当前最痛的场景试验，用起来了再学下一批。
关键词：Claude Code, 最佳实践, 上下文管理, Subagents, Skills
