README.md

claude-code-best-practice

从氛围编程 (Vibe Coding) 到代理工程 (Agentic Engineering) —— 熟能生巧，Claude 臻于完美

= 代理 (Agents) · = 命令 (Commands) · = 技能 (Skills)

Boris Cherny on X (tweet 1 · tweet 2 · tweet 3)

🧠 核心概念 (CONCEPTS)

功能	位置	描述
子代理 (Subagents)	`.claude/agents/.md`	在全新隔离上下文中的自主执行者 —— 自定义工具、权限、模型、记忆和持久身份
命令 (Commands)	`.claude/commands/.md`	注入现有上下文的知识 —— 简单的用户调用提示模板，用于工作流编排
技能 (Skills)	`.claude/skills//SKILL.md`	注入现有上下文的知识 —— 可配置、可预加载、可自动发现，支持上下文分叉和渐进式披露 · 官方技能 (Official Skills)
工作流 (Workflows)	`.claude/commands/weather-orchestrator.md`
钩子 (Hooks)	`.claude/hooks/`	用户定义的处理器（脚本、HTTP、提示、代理），在特定事件时运行于代理循环之外 · 指南 (Guide)
MCP 服务器	`.claude/settings.json`, `.mcp.json`	模型上下文协议 (Model Context Protocol) 连接外部工具、数据库和 API
插件 (Plugins)	可分发包	技能、子代理、钩子、MCP 服务器和 LSP 服务器的捆绑包 · 市场 (Marketplaces) · 创建市场
设置 (Settings)	`.claude/settings.json`	分层配置系统 · 权限 (Permissions) · 模型配置 · 输出样式 · 沙盒 · 快捷键 · 快速模式
状态栏 (Status Line)	`.claude/settings.json`	可自定义的状态栏，显示上下文使用、模型、成本和会话信息
记忆 (Memory)	`CLAUDE.md`, `.claude/rules/`, `/.claude/rules/`, `/.claude/projects//memory/`	通过 CLAUDE.md 文件和 `@path` 导入实现持久化上下文 · 自动记忆 · 规则 (Rules)
检查点 (Checkpointing)	自动（基于 git）	自动跟踪文件编辑，支持回退（`Esc Esc` 或 `/rewind`）和定向总结
CLI 启动标志	`claude [flags]`	命令行标志、子命令和环境变量，用于启动 Claude Code · 交互模式 · 环境变量
AI 术语		代理工程 (Agentic Engineering) · 上下文工程 (Context Engineering) · 氛围编程 (Vibe Coding)
最佳实践		官方最佳实践 · 提示工程 · 扩展 Claude Code

🔥 热门功能 (Hot)

功能	位置	描述
增强功能 (Power-ups)	`/powerup`	通过动画演示教授 Claude Code 功能的交互式课程 (v2.1.90)
超级计划 (Ultraplan)	`/ultraplan`	在云端起草计划，支持浏览器内审阅、内联评论和灵活执行 —— 远程执行或传回终端
Claude Code Web	`claude.ai/code`	在云端基础设施上运行任务 —— 长时间运行任务、PR 自动修复、并行会话，无需本地设置 · 定时任务
代理 SDK (Agent SDK)	`npm` / `pip` 包	使用 Claude Code 作为库构建生产级 AI 代理 —— Python 和 TypeScript SDK，内置工具、钩子、子代理和 MCP · 快速开始 · 示例
无闪烁模式 (No Flicker Mode)	`CLAUDE_CODE_NO_FLICKER=1`	无闪烁的备用屏幕渲染，支持鼠标、稳定内存和应用内滚动 —— 选择性加入的研究预览版
计算机使用 (Computer Use)	`computer-use` MCP 服务器	让 Claude 控制你的屏幕 —— 在 macOS 上打开应用、点击、输入和截图 · 桌面版
自动模式 (Auto Mode)	`claude --enable-auto-mode`	后台安全分类器替代手动权限提示 —— Claude 自主决定什么是安全的，同时阻止提示注入和风险升级 · 使用 `claude --enable-auto-mode`（或 `--permission-mode auto`）启动，或在会话中按 `Shift+Tab` 切换到该模式 · 博客
频道 (Channels)	`--channels`, 基于插件	将 Telegram、Discord 或 Webhook 的事件推送到运行中的会话 —— Claude 在你离开时也能响应 · 参考
Slack	Slack 中的 `@Claude`	在团队聊天中提及 @Claude 并分配编码任务 —— 路由到 Claude Code Web 会话进行错误修复、代码审查和并行任务执行
代码审查 (Code Review)	GitHub App（托管）	多代理 PR 分析，捕获错误、安全漏洞和回归 · 博客
GitHub Actions	`.github/workflows/`	在 CI/CD 管道中自动化 PR 审查、问题分类和代码生成 · GitLab CI/CD
Chrome	`--chrome`, 扩展	通过 Chrome 中的 Claude 实现浏览器自动化 —— 测试 Web 应用、使用控制台调试、自动化表单、从页面提取数据
定时任务 (Scheduled Tasks)	`/loop`, `/schedule`, cron 工具	`/loop` 在本地按计划运行提示（最长 3 天） · `/schedule` 在 Anthropic 云端基础设施上按计划运行提示 —— 即使你的机器关闭也能工作 · 公告
语音听写 (Voice Dictation)	`/voice`	按键即说语音输入，支持 20 种语言，可重新绑定激活键
简化与批处理 (Simplify & Batch)	`/simplify`, `/batch`	内置技能用于代码质量和批量操作 —— 简化重构以提高重用性和效率，批处理跨文件运行命令
代理团队 (Agent Teams)	内置（环境变量）	多个代理在同一代码库上并行工作，共享任务协调
远程控制 (Remote Control)	`/remote-control`, `/rc`	从任何设备继续本地会话 —— 手机、平板或浏览器 · 无头模式
Git Worktrees	内置	隔离的 git 分支用于并行开发 —— 每个代理都有自己的工作副本
Ralph Wiggum Loop	插件	长时间运行任务的自主开发循环 —— 迭代直至完成

查看 编排工作流 (orchestration-workflow) 了解 命令 (Command) → 代理 (Agent) → 技能 (Skill) 模式的实现细节。

claude
/weather-orchestrator

⚙️ 开发工作流 (DEVELOPMENT WORKFLOWS)

所有主要工作流都遵循相同的架构模式：研究 (Research) → 计划 (Plan) → 执行 (Execute) → 审查 (Review) → 发布 (Ship)

名称	★	独特之处	计划
Everything Claude Code	148k		planner	47	82	182
Superpowers	143k		writing-plans	5	3	14
Spec Kit	87k		speckit.plan	0	9+	0
gstack	68k		autoplan	0	0	37
Get Shit Done	50k		gsd-planner	24	68	0
BMAD-METHOD	44k		bmad-create-prd	0	0	39
OpenSpec	39k		opsx:propose	0	11	0
oh-my-claudecode	27k		ralplan	19	0	37
Compound Engineering	14k		ce-plan	51	4	43
HumanLayer	10k		create_plan	6	27	0

其他工作流

• 跨模型工作流（Claude Code + Codex）
• RPI
• Ralph Wiggum Loop
• Andrej Karpathy（OpenAI 创始成员）工作流
• Peter Steinberger（OpenClaw 创建者）工作流
• Boris Cherny（Claude Code 创建者）工作流 — 13 个技巧 · 10 个技巧 · 12 个技巧 · 2 个技巧 · 15 个技巧

💡 技巧与窍门 (TIPS AND TRICKS) (69)

🚫👶 = 无需保姆式监管 (do not babysit)

提示技巧 · 计划 · CLAUDE.md · 代理 · 命令 · 技能 · 钩子 · 工作流 · 高级 · Git / PR · 调试 · 工具 · 日常

■ 提示技巧 (Prompting) (3)

技巧	来源
挑战 Claude —— "仔细审查这些改动，在我通过你的测试之前不要创建 PR。" 或 "向我证明这能工作"，让 Claude 对比 main 分支和你的分支 🚫👶
在得到一个平庸的修复后 —— "基于你现在知道的一切，废弃这个方案，实现一个优雅的解决方案" 🚫👶
Claude 自己能修复大多数错误 —— 粘贴错误信息，说 "修复"，不要微观管理怎么做 🚫👶

■ 计划/规范 (Planning/Specs) (6)

技巧	来源
总是从 计划模式 (plan mode) 开始
从最小规范或提示开始，让 Claude 使用 AskUserQuestion 工具采访你，然后新建会话来执行规范
总是制定分阶段门控计划，每个阶段包含多个测试（单元测试、自动化测试、集成测试）
启动第二个 Claude 作为高级工程师审查你的计划，或使用 跨模型审查
在交接工作前编写详细的规范并减少歧义 —— 你越具体，输出就越好
原型 > PRD —— 构建 20-30 个版本而不是写规范，构建成本低所以多尝试

■ CLAUDE.md (7)

技巧	来源
CLAUDE.md 每个文件应控制在 200 行以内。humanlayer 使用 60 行（但仍不能保证 100% 有效）
在 CLAUDE.md 规则中使用 `` 标签 包裹领域特定规则，防止 Claude 在文件变长时忽略它们
为 monorepos 使用 多个 CLAUDE.md —— 祖先 + 后代加载
使用 .claude/rules/ 拆分大型指令
memory.md、constitution.md 不能保证任何事
任何开发者都应该能够启动 Claude，说 "运行测试"，并且第一次就能成功 —— 如果不能，你的 CLAUDE.md 缺少基本的设置/构建/测试命令
保持代码库整洁并完成迁移 —— 部分迁移的框架会混淆模型，可能选择错误的模式
使用 settings.json 进行工具强制的行为（署名、权限、模型）—— 不要把 "NEVER add Co-Authored-By" 放在 CLAUDE.md 中，而要用 `attribution.commit: ""` 这是确定性的

代理 (Agents) (4)

技巧	来源
为特定功能创建带有 技能（渐进式披露）的 子代理 (sub-agents)，而不是通用的 QA、后端工程师
说 "使用子代理" 来投入更多算力解决问题 —— 将任务卸载以保持主上下文清洁和专注 🚫👶
带 tmux 的代理团队 和 git worktrees 用于并行开发
使用 测试时计算 (test time compute) —— 分离的上下文窗口能产生更好的结果；一个代理可能引入错误，另一个（相同模型）能发现它们

命令 (Commands) (3)

技巧	来源
对工作流使用 命令 (commands) 而不是 子代理
为你每天重复多次的每个"内循环"工作流使用 斜杠命令 —— 节省重复提示，命令存放在 `.claude/commands/` 并提交到 git
如果你每天做某事超过一次，把它变成一个 技能 或 命令 —— 构建 `/techdebt`、上下文转储或分析命令

技能 (Skills) (9)

技巧	来源
使用 `context: fork` 在隔离的子代理上下文中运行技能 —— 主上下文只看到最终结果，而不是中间工具调用。agent 字段允许你设置子代理类型
为 monorepos 使用 子文件夹中的技能
技能是文件夹，不是文件 —— 使用 references/、scripts/、examples/ 子目录进行 渐进式披露
在每个技能中构建 "陷阱 (Gotchas)" 部分 —— 最高信号内容，随着时间添加 Claude 的失败点
技能描述字段是触发器，不是摘要 —— 为模型编写（"我应该在什么时候触发？"）
不要在技能中陈述显而易见的事 —— 专注于推动 Claude 偏离默认行为的内容 🚫👶
不要在技能中过度约束 Claude —— 给出目标和约束，而不是规定性的分步指令 🚫👶
在技能中包含脚本和库，让 Claude 组合而不是重建样板代码
在 SKILL.md 中嵌入 `` !`command` `` 以将动态 shell 输出注入提示 —— Claude 在调用时运行它，模型只看到结果

■ 钩子 (Hooks) (5)

技巧	来源
在技能中使用 按需钩子 —— /careful 阻止破坏性命令，/freeze 阻止目录外的编辑
使用 PreToolUse 钩子 测量技能使用情况 以发现流行或触发不足的技能
使用 PostToolUse 钩子 自动格式化代码 —— Claude 生成格式良好的代码，钩子处理最后 10% 以避免 CI 失败
通过钩子将 权限请求 路由到 Opus —— 让它扫描攻击并自动批准安全的请求 🚫👶
使用 Stop 钩子 在回合结束时提示 Claude 继续工作或验证其工作

■ 工作流 (Workflows) (7)

技巧	来源
避免代理盲区，在达到 50% 时手动执行 /compact。使用 /clear 在会话中切换到新任务时重置上下文
对于较小任务，原版 CC 比任何工作流都好
使用 /model 选择模型和推理，/context 查看上下文使用，/usage 检查计划限制，/extra-usage 配置超额计费，/config 配置设置 —— 计划模式用 Opus，编码用 Sonnet，两者兼得
始终在 /config 中使用思考模式 true（查看推理）和 输出样式 解释性（查看带 ★ Insight 框的详细输出）以更好地理解 Claude 的决策
在提示中使用 ultrathink 关键词进行 高努力推理
/rename 重要会话（例如 [TODO - 重构任务]）并稍后 /resume —— 同时运行多个 Claude 时为每个实例添加标签
当 Claude 偏离轨道时使用 Esc Esc 或 /rewind 撤销，而不是尝试在同一上下文中修复

■ 高级工作流 (Workflows Advanced) (6)

技巧	来源
大量使用 ASCII 图表来理解你的架构
使用 /loop 进行本地定期监控（最长 3 天） · 使用 /schedule 进行云端定期任务，即使你的机器关闭也能运行
使用 Ralph Wiggum 插件 进行长时间运行的自主任务
/permissions 使用通配符语法（Bash(npm run *), Edit(/docs/**)）而不是 dangerously-skip-permissions
/sandbox 通过文件和网络隔离减少权限提示 —— 内部减少 84%
投入时间完善 产品验证 技能（注册流程驱动器、结账验证器）—— 值得花一周时间完善

■ Git / PR (5)

技巧	来源
保持 PR 小而专注 —— p50 为 118 行（一天内 141 个 PR，45K 行变更），每个 PR 一个功能，更容易审查和回退
总是 压缩合并 (squash merge) PR —— 干净的线性历史，每个功能一个提交，便于 git revert 和 git bisect
经常提交 —— 尽量每小时至少提交一次，任务完成就提交
在同事的 PR 上标记 @claude 以自动生成重复审查反馈的 lint 规则 —— 将自己从代码审查中自动化出来 🚫👶
使用 /code-review 进行多代理 PR 分析 —— 在合并前捕获错误、安全漏洞和回归

■ 调试 (Debugging) (7)

技巧	来源
遇到任何问题时养成截图并与 Claude 分享的习惯
使用 mcp（Chrome 中的 Claude、Playwright、Chrome DevTools）让 Claude 自己查看 Chrome 控制台日志
总是让 Claude 将终端（你想看日志的）作为后台任务运行以便更好地调试
/doctor 诊断安装、认证和配置问题
压缩期间的错误可以通过使用 /model 选择 1M token 模型，然后运行 /compact 来解决
使用 跨模型 进行 QA —— 例如 Codex 用于计划和实施审查
代理搜索（glob + grep）击败 RAG —— Claude Code 尝试过并放弃了向量数据库，因为代码会漂移出同步且权限复杂

■ 工具 (Utilities) (5)

技巧	来源
使用 iTerm/Ghostty/tmux 终端而不是 IDE（VS Code/Cursor）
/voice 或 Wispr Flow 用于语音提示（10 倍生产力）
claude-code-hooks 用于 Claude 反馈
状态栏 用于上下文感知和快速压缩
探索 settings.json 功能如 计划目录、加载动词 以获得个性化体验

■ 日常 (Daily) (2)

技巧	来源
每天 更新 Claude Code
通过阅读 更新日志 开始你的一天

文章 / 推文	来源
Claude Code 中 15 个隐藏和未充分利用的功能（Boris）| 2026年3月30日	Tweet
压缩合并与 PR 大小分布（Boris）| 2026年3月25日	Tweet
构建 Claude Code 的经验教训：我们如何使用技能（Thariq）| 2026年3月17日	Article
代码审查与测试时计算（Boris）| 2026年3月10日	Tweet
/loop —— 安排最长 3 天的定期任务（Boris）| 2026年3月7日	Tweet
AskUserQuestion + ASCII Markdowns（Thariq）| 2026年2月28日	Tweet
像代理一样思考 —— 构建 Claude Code 的经验教训（Thariq）| 2026年2月28日	Article
Git Worktrees —— Boris 使用的 5 种方式 | 2026年2月21日	Tweet
构建 Claude Code 的经验教训：提示缓存就是一切（Thariq）| 2026年2月20日	Article
人们自定义 Claude 的 12 种方式（Boris）| 2026年2月12日	Tweet
团队使用 Claude Code 的 10 个技巧（Boris）| 2026年2月1日	Tweet
我如何使用 Claude Code —— 来自我惊人地朴素设置的 13 个技巧（Boris）| 2026年1月3日	Tweet
使用 AskUserQuestion 工具让 Claude 采访你（Thariq）| 2025年12月28日	Tweet
总是使用计划模式，给 Claude 验证方法，使用 /code-review（Boris）| 2025年12月27日	Tweet

🎬 视频 / 播客 (VIDEOS / PODCASTS)

视频 / 播客	来源	YouTube
我们对研究-计划-实施的所有误解（Dex）| 2026年3月24日 | MLOps Community		YouTube
与 Boris Cherny 一起构建 Claude Code（Boris）| 2026年3月4日 | The Pragmatic Engineer		YouTube
Claude Code 负责人：编码解决后会发生什么（Boris）| 2026年2月19日 | Lenny's Podcast		YouTube
与 Claude Code 创建者 Boris Cherny 一起深入 Claude Code（Boris）| 2026年2月17日 | Y Combinator		YouTube
Boris Cherny（Claude Code 创建者）谈什么推动了他的职业生涯（Boris）| 2025年12月15日 | Ryan Peterman		YouTube
来自构建它的工程师的 Claude Code 秘密（Cat）| 2025年10月29日 | Every		YouTube

🔔 订阅 (SUBSCRIBE)

来源	名称	徽章
	r/ClaudeAI, r/ClaudeCode, r/Anthropic
	Claude, Anthropic, Boris, Thariq, Cat, Lydia, Noah, Anthony, Alex, Kenneth
	Jesse Kriss (Superpowers), Affaan Mustafa (ECC), Garry Tan (gstack), Dex Horthy (HumanLayer), Kieran Klaassen (Compound Eng), Tabish Gilani (OpenSpec), Brian McAdams (BMAD), Lex Christopherson (GSD), Dani Avila (CC Templates), Dan Shipper (Every), Andrej Karpathy (AutoResearch), Peter Steinberger (OpenClaw), Sigrid Jin (claw-code), Yeachan Heo (oh-my-claudecode)
	Anthropic
	Lenny's Podcast, Y Combinator, The Pragmatic Engineer, Ryan Peterman, Every, MLOps Community

☠️ 创业公司 / 业务 (STARTUPS / BUSINESSES)

Claude	替代方案
代码审查 (Code Review)	Greptile, CodeRabbit, Devin Review, OpenDiff, Cursor BugBot
语音听写 (Voice Dictation)	Wispr Flow, SuperWhisper
远程控制 (Remote Control)	OpenClaw
Chrome 中的 Claude	Playwright MCP, Chrome DevTools MCP
计算机使用 (Computer Use)	OpenAI CUA
协作 (Cowork)	ChatGPT Agent, Perplexity Computer, Manus
任务 (Tasks)	Beads
计划模式 (Plan Mode)	Agent OS
技能 / 插件 (Skills / Plugins)	YC AI 包装器创业公司 (reddit)

如果你有答案，请发送邮件至 shanraisshan@gmail.com

记忆与指令 (Memory & Instructions) (4)

1. 你应该在 CLAUDE.md 中放入什么内容 —— 以及应该省略什么？
2. 如果你已经有了 CLAUDE.md，是否还需要单独的 constitution.md 或 rules.md？
3. 你应该多久更新一次 CLAUDE.md，你如何知道它何时已经过时？
4. 为什么 Claude 仍然忽略 CLAUDE.md 指令 —— 即使它们用大写的 MUST 标明？(reddit)

代理、技能与工作流 (Agents, Skills & Workflows) (6)

1. 你应该何时使用命令 vs 代理 vs 技能 —— 以及什么时候原版 Claude Code 更好？
2. 随着模型改进，你应该多久更新一次代理、命令和工作流？
3. 给子代理详细的角色设定能否提高质量？研究/QA 子代理的"完美角色设定/提示"是什么样的？
4. 你应该依赖 Claude Code 内置的计划模式 —— 还是构建自己的计划命令/代理来强制执行团队的工作流？
5. 如果你有一个个人技能（例如带有你编码风格的 /implement），如何在不冲突的情况下整合社区技能（例如 /simplify）—— 当它们有分歧时谁获胜？
6. 我们到了吗？能否将现有代码库转换为规范，删除代码，然后让 AI 仅从这些规范重新生成完全相同的代码？

规范与文档 (Specs & Documentation) (3)

1. 你的仓库中的每个功能都应该有一个作为 Markdown 文件的规范吗？
2. 你需要多久更新一次规范，以便在实施新功能时它们不会过时？
3. 实施新功能时，你如何处理对其他功能规范的连锁影响？

报告 (REPORTS)

1. 像课程一样阅读这个仓库，在学习使用命令、代理、技能和钩子之前先了解它们是什么。
2. 克隆这个仓库并试用示例，尝试 /weather-orchestrator，听钩子声音，运行代理团队，这样你就能看到事物实际如何工作。
3. 进入你自己的项目，让 Claude 建议你应该添加这个仓库中的哪些最佳实践，将这个仓库作为参考，让它知道什么是可能的。

✨2026年3月 GitHub 趋势榜✨

其他仓库 (Other Repos)

claude-code-hooks · codex-cli-best-practice · codex-cli-hooks

开发方式 (Developed by)

#	工作流	描述
1	/workflows:development-workflows	通过并行研究所有 10 个工作流仓库来更新开发工作流表和跨工作流分析报告
2	/workflows:best-practice:workflow-concepts	使用最新的 Claude Code 功能和概念更新 README 概念部分
3	/workflows:best-practice:workflow-claude-settings	跟踪 Claude Code 设置报告变更并找出需要更新的内容
4	/workflows:best-practice:workflow-claude-subagents	跟踪 Claude Code 子代理报告变更并找出需要更新的内容
5	/workflows:best-practice:workflow-claude-commands	跟踪 Claude Code 命令报告变更并找出需要更新的内容
6	/workflows:best-practice:workflow-claude-skills	跟踪 Claude Code 技能报告变更并找出需要更新的内容

Star 历史 (Star History)