shanraisshan/claude-code-best-practice

# claude-code-best-practice practice makes claude perfect  [](best-practice/) *点击此徽章查看最新最佳实践*
[](implementation/) *点击此徽章查看本仓库中的实现*
[](orchestration-workflow/orchestration-workflow.md) *点击此徽章查看 Command → Agent → Skill 编排工作流*

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

## 核心概念 | 功能 | 位置 | 描述 | |---------|----------|-------------| | [**Commands**](https://code.claude.com/docs/en/slash-commands) | `.claude/commands/.md` | [](best-practice/claude-commands.md) [](implementation/claude-commands-implementation.md) 注入到现有上下文中的知识 — 用于工作流编排的简单用户调用提示模板 | | [**Sub-Agents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/.md` | [](best-practice/claude-subagents.md) [](implementation/claude-subagents-implementation.md) 在全新隔离上下文中运行的自主执行者 — 拥有自定义工具、权限、模型、记忆和持久身份 | | [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills//SKILL.md` | [](best-practice/claude-skills.md) [](implementation/claude-skills-implementation.md) 注入到现有上下文中的知识 — 可配置、可预加载、可自动发现，支持上下文分叉和渐进式披露 · [官方 Skills](https://github.com/anthropics/skills/tree/main/skills) | | [**Workflows**](https://code.claude.com/docs/en/common-workflows) | [`.claude/commands/weather-orchestrator.md`](.claude/commands/weather-orchestrator.md) | [](orchestration-workflow/orchestration-workflow.md) | | [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [](https://github.com/shanraisshan/claude-code-voice-hooks) [](https://github.com/shanraisshan/claude-code-voice-hooks) 在特定事件时于智能体循环之外运行的确定性脚本 | | [**MCP Servers**](https://code.claude.com/docs/en/mcp) | `.claude/settings.json`, `.mcp.json` | [](best-practice/claude-mcp.md) [](.mcp.json) 连接外部工具、数据库和 API 的 Model Context Protocol 连接 | | [**Plugins**](https://code.claude.com/docs/en/plugins) | 可分发包 | Skills、Subagents、Hooks 和 MCP Servers 的捆绑包 · [市场](https://code.claude.com/docs/en/discover-plugins) | | [**Settings**](https://code.claude.com/docs/en/settings) | `.claude/settings.json` | [](best-practice/claude-settings.md) [](.claude/settings.json) 分层配置系统 · [权限](https://code.claude.com/docs/en/permissions) · [模型配置](https://code.claude.com/docs/en/model-config) · [输出样式](https://code.claude.com/docs/en/output-styles) · [沙箱](https://code.claude.com/docs/en/sandboxing) · [快捷键](https://code.claude.com/docs/en/keybindings) · [快速模式](https://code.claude.com/docs/en/fast-mode) | | [**Status Line**](https://code.claude.com/docs/en/statusline) | `.claude/settings.json` | [](https://github.com/shanraisshan/claude-code-status-line) [](.claude/settings.json) 显示上下文使用量、模型、成本和会话信息的可自定义状态栏 | | [**Memory**](https://code.claude.com/docs/en/memory) | `CLAUDE.md`, `.claude/rules/`, `~/.claude/rules/`, `~/.claude/projects//memory/` | [](best-practice/claude-memory.md) [](CLAUDE.md) 通过 CLAUDE.md 文件和 `@path` 导入实现持久化上下文 · [自动记忆](https://code.claude.com/docs/en/memory) · [规则](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) | | [**Checkpointing**](https://code.claude.com/docs/en/checkpointing) | 自动（基于 git） | 自动跟踪文件编辑，支持回退（`Esc Esc` 或 `/rewind`）和针对性摘要 | | [**CLI Startup Flags**](https://code.claude.com/docs/en/cli-reference) | `claude [flags]` | [](best-practice/claude-cli-startup-flags.md) 用于启动 Claude Code 的命令行标志、子命令和环境变量 · [交互模式](https://code.claude.com/docs/en/interactive-mode) | | **AI 术语** | | [](https://github.com/shanraisshan/claude-code-codex-cursor-gemini/blob/main/reports/ai-terms.md) Agentic Engineering · Context Engineering · Vibe Coding | | [**最佳实践**](https://code.claude.com/docs/en/best-practices) | | 官方最佳实践 · [提示工程](https://github.com/anthropics/prompt-eng-interactive-tutorial) · [扩展 Claude Code](https://code.claude.com/docs/en/features-overview) | ### 🔥 热门 | 功能 | 位置 | 描述 | |---------|----------|-------------| | [**/btw**](https://x.com/trq212/status/2031506296697131352) | `/btw` | [](https://x.com/trq212/status/2031506296697131352) Claude 工作时的侧链对话 | | [**Code Review**](https://code.claude.com/docs/en/code-review)  | GitHub App（托管） | [](https://x.com/claudeai/status/2031088171262554195) 多智能体 PR 分析，可发现 bug、安全漏洞和回归问题 · [博客](https://claude.com/blog/code-review) | | [**Scheduled Tasks**](https://code.claude.com/docs/en/scheduled-tasks) | `/loop`, cron 工具 | [](https://x.com/bcherny/status/2030193932404150413) [](implementation/claude-scheduled-tasks-implementation.md) 按循环计划运行提示（最长 3 天），设置一次性提醒，轮询部署和构建 | | [**Voice Mode**](https://x.com/trq212/status/2028628570692890800)  | `/voice` | [](https://x.com/trq212/status/2028628570692890800) 语音转提示 — /voice 激活 | | [**Simplify & Batch**](https://x.com/bcherny/status/2027534984534544489) | `/simplify`, `/batch` | [](https://x.com/bcherny/status/2027534984534544489) 用于代码质量和批量操作的内置 Skills — simplify 重构以提升复用性和效率，batch 跨文件运行命令 | | [**Agent Teams**](https://code.claude.com/docs/en/agent-teams)  | 内置（环境变量） | [](https://x.com/bcherny/status/2019472394696683904) [](implementation/claude-agent-teams-implementation.md) 多个智能体在同一代码库中并行工作，具有共享任务协调 | | [**Remote Control**](https://code.claude.com/docs/en/remote-control) | `/remote-control`, `/rc` | 从任意设备（手机、平板或浏览器）继续本地会话 · [无头模式](https://code.claude.com/docs/en/headless) | | [**Git Worktrees**](https://code.claude.com/docs/en/common-workflows) | 内置 | [](https://x.com/bcherny/status/2025007393290272904) 用于并行开发的隔离 git 分支 — 每个智能体获得自己的工作副本 | | [**Ralph Wiggum Loop**](https://github.com/anthropics/claude-code/tree/main/plugins/ralph-wiggum) | 插件 | [](https://github.com/ghuntley/how-to-ralph-wiggum) [](https://github.com/shanraisshan/novel-llm-26) 用于长时间运行任务的自主开发循环 — 持续迭代直至完成 | ## 查看 [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) 了解 **Command → Agent → Skill** 模式的实现详情。

 ``` claude /weather-orchestrator ``` | 组件 | 角色 | 示例 | |-----------|------|---------| | **Command** | 入口点，用户交互 | [`/weather-orchestrator`](.claude/commands/weather-orchestrator.md) | | **Agent** | 使用预加载的 Skill 获取数据（agent skill） | [`weather-agent`](.claude/agents/weather-agent.md) 搭配 [`weather-fetcher`](.claude/skills/weather-fetcher/SKILL.md) | | **Skill** | 独立创建输出（skill） | [`weather-svg-creator`](.claude/skills/weather-svg-creator/SKILL.md) | ## 开发工作流 ### 🔥 热门 - [跨模型（Claude Code + Codex）工作流](development-workflows/cross-model-workflow/cross-model-workflow.md) [](development-workflows/cross-model-workflow/cross-model-workflow.md) - [RPI](development-workflows/rpi/rpi-workflow.md) [](development-workflows/rpi/rpi-workflow.md) - [Ralph Wiggum Loop](https://www.youtube.com/watch?v=eAtvoGlpeRU) [](https://github.com/shanraisshan/novel-llm-26) ### 其他 - [Github Speckit](https://github.com/github/spec-kit) · ★ 74k - [obra/superpowers](https://github.com/obra/superpowers) · ★ 72k - [OpenSpec OPSX](https://github.com/Fission-AI/OpenSpec/blob/main/docs/opsx.md) · ★ 28k - [get-shit-done (GSD)](https://github.com/gsd-build/get-shit-done) · ★ 25k - [Brian Casel (Creator of Agent OS) - 2026 Workflow](https://github.com/buildermethods/agent-os) · ★ 4k - [2026 年已显得过度](https://www.youtube.com/watch?v=0hdFJA-ho3c) - [Human Layer RPI - Research Plan Implement](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents/blob/main/ace-fca.md) · ★ 1.5k - [Andrej Karpathy (Founding Member, OpenAI) Workflow](https://x.com/karpathy/status/2015883857489522876) - [Boris Cherny (Creator of Claude Code) - Feb 2026 Workflow](https://x.com/bcherny/status/2017742741636321619) - [Peter Steinberger (Creator of OpenClaw) Workflow](https://youtu.be/8lF7HmQ_RgY?t=2582) ## 技巧与窍门  ■ **规划 (2)** - 始终以 [计划模式](https://code.claude.com/docs/en/common-workflows) 开始。让 Claude 采访你；[向用户提问](https://code.claude.com/docs/en/cli-reference) - 始终制定分阶段把关计划，每个阶段包含多个测试（单元测试、自动化测试、集成测试）。使用 [跨模型](development-workflows/cross-model-workflow/cross-model-workflow.md) 审查你的计划 ■ **工作流 (12)** - [CLAUDE.md](https://code.claude.com/docs/en/memory) 每个文件应控制在 [200 行](https://code.claude.com/docs/en/memory#write-effective-instructions) 以内。[humanlayer 中为 60 行](https://www.humanlayer.dev/blog/writing-a-good-claude-md)（[仍无法 100% 保证](https://www.reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/)）。 - 对于 monorepo 使用 [多个 CLAUDE.md](best-practice/claude-memory.md) — 祖先 + 后代加载 - 使用 [.claude/rules/](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules)拆分大型指令 - 使用 [commands](https://code.claude.com/docs/en/slash-commands) 而非 [sub-agents](https://code.claude.com/docs/en/sub-agents) 来构建你的工作流 - 使用针对特定功能的 [sub-agents](https://code.claude.com/docs/en/sub-agents)（额外上下文）搭配 [skills](https://code.claude.com/docs/en/skills)（渐进式披露），而不是通用的 qa、backend engineer。 - [memory.md](https://code.claude.com/docs/en/memory)、constitution.md 不保证任何效果 - 避免智能体进入愚蠢区，在最多 50% 时手动执行 [/compact](https://code.claude.com/docs/en/interactive-mode)。如果中途切换到新任务，使用 [/clear](https://code.claude.com/docs/en/cli-reference) 重置上下文 - 对于较小任务，原生 cc 比任何工作流都更好 - 对于 monorepo 使用 [子文件夹中的 skills](reports/claude-skills-for-larger-mono-repos.md) - 使用 [/model](https://code.claude.com/docs/en/model-config) 选择模型和推理，[/context](https://code.claude.com/docs/en/interactive-mode) 查看上下文使用量，[/usage](https://code.claude.com/docs/en/costs) 检查计划限制，[/extra-usage](https://code.claude.com/docs/en/interactive-mode) 配置溢出计费，[/config](https://code.claude.com/docs/en/settings) 配置设置 - 在 [/config](https://code.claude.com/docs/en/settings) 中始终将 [思考模式](https://code.claude.com/docs/en/model-config) 设为 true（查看推理过程）并将 [输出样式](https://code.claude.com/docs/en/output-styles) 设为 Explanatory（查看带有 ★ Insight 框的详细输出），以更好理解 Claude 的决策 - 在提示中使用 ultrathink 关键词进行 [高投入推理](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) - [/rename](https://code.claude.com/docs/en/cli-reference) 重要的会话（例如 [TODO - refactor task]）并在稍后 [/resume](https://code.claude.com/docs/en/cli-reference) 它们 - 当 Claude 偏离轨道时，使用 [Esc Esc 或 /rewind](https://code.claude.com/docs/en/checkpointing) 撤销，而不是尝试在同一上下文中修复 - 频繁提交 — 尝试每小时至少提交一次，任务完成后立即提交。 ■ **高级工作流 (6)** - 大量使用 ASCII 图表来理解你的架构 - 使用 [tmux 搭配 agent teams](https://code.claude.com/docs/en/agent-teams) 和 [git worktrees](https://x.com/bcherny/status/2025007393290272904) 进行并行开发 - 使用 [/loop](https://code.claude.com/docs/en/scheduled-tasks) 进行循环监控 — 轮询部署、照看 PR、检查构建（最长运行 3 天） - 使用 [Ralph Wiggum 插件](https://github.com/shanraisshan/novel-llm-26) 处理长时间运行的自主任务 - 使用带通配符语法的 [/permissions](https://code.claude.com/docs/en/permissions)（Bash(npm run *), Edit(/docs/**)）而不是 dangerously-skip-permissions - 使用 [/sandbox](https://code.claude.com/docs/en/sandboxing) 通过文件和网络隔离减少权限提示 ■ **调试 (5)** - 养成截图的习惯，每当遇到任何问题时与 Claude 分享 - 使用 mcp（[Claude in Chrome](https://code.claude.com/docs/en/chrome)、[Playwright](https://github.com/microsoft/playwright-mcp)、[Chrome DevTools](https://developer.chrome.com/blog/chrome-devtools-mcp)）让 Claude 自行查看 Chrome 控制台日志 - 始终要求 Claude 将（你想查看日志的）终端作为后台任务运行，以便更好地调试 - [/doctor](https://code.claude.com/docs/en/cli-reference) 诊断安装、身份验证和配置问题 - 紧凑过程中的错误可以通过使用 [/model](https://code.claude.com/docs/en/model-config) 选择 1M token 模型，然后运行 [/compact](https://code.claude.com/docs/en/interactive-mode) 来解决 - 使用 [跨模型](development-workflows/cross-model-workflow/cross-model-workflow.md) 进行 QA — 例如使用 [Codex](https://github.com/shanraisshan/codex-cli-best-practice) 进行计划和实现审查 ■ **实用工具 (5)** - 使用 [iTerm](https://iterm2.com/)/[Ghostty](https://ghostty.org/)（[Boris 推文](https://x.com/bcherny/status/2017742753971769626)）/[tmux](https://github.com/tmux/tmux) 终端而非 IDE（[VS Code](https://code.visualstudio.com/)/[Cursor](https://www.cursor.com/)） - 使用 [Wispr Flow](https://wisprflow.ai) 进行语音提示（10 倍生产力） - 使用 [claude-code-voice-hooks](https://github.com/shanraisshan/claude-code-voice-hooks) 获取 Claude 反馈 - 使用 [状态栏](https://github.com/shanraisshan/claude-code-status-line) 进行上下文感知和快速紧凑 - 探索 [settings.json](best-practice/claude-settings.md) 功能，如 [Plans Directory](best-practice/claude-settings.md#plans-directory)、[Spinner Verbs](best-practice/claude-settings.md#display--ux) 以获得个性化体验 ■ **日常 (3)** - 每天使用 [update](https://code.claude.com/docs/en/setup) 更新 Claude Code，并以阅读 [changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) 开始你的一天 - 在 Reddit 上关注 [r/ClaudeAI](https://www.reddit.com/r/ClaudeAI/)、[r/ClaudeCode](https://www.reddit.com/r/ClaudeCode/) - 在 X 上关注 [Boris](https://x.com/bcherny)、[Thariq](https://x.com/trq212)、[Cat](https://x.com/_catwu)、[Lydia](https://x.com/lydiahallie)、[Noah](https://x.com/noahzweben)、[Claude](https://x.com/claudeai)、[Alex Albert](https://x.com/alexalbert__)  - 始终使用计划模式，给 Claude 验证的方法，使用 /code-review (Boris) | 27/Dec/25 ● [推文](https://x.com/bcherny/status/2004711722926616680) - 要求 Claude 使用 AskUserQuestion 工具采访你 (Thariq) | 28/Dec/25 ● [推文](https://x.com/trq212/status/2005315275026260309) - [我如何使用 Claude Code — 来自我极其原生设置的 13 个技巧 (Boris) | 03/Jan/26](tips/claude-boris-13-tips-03-jan-26.md) ● [推文](https://x.com/bcherny/status/2007179832300581177) - Claude Code 团队自己的 10 个使用技巧 (Boris) | 01/Feb/26 ● [推文](https://x.com/bcherny/status/2017742741636321619) - [12 种人们自定义 Claude 的方式 (Boris) | 12/Feb/26](tips/claude-boris-12-tips-12-feb-26.md) ● [推文](https://x.com/bcherny/status/2021699851499798911) - Git Worktrees — Boris 使用的 5 种方式 | 21 Feb 2026 ● [推文](https://x.com/bcherny/status/2025007393290272904) - 像智能体一样看世界 — 构建 Claude Code 的经验教训 (Thariq) | 28 Feb 2026 ● [推文](https://x.com/trq212/status/2027463795355095314) - AskUserQuestion + ASCII Markdowns (Thariq) | 28 Feb 2026 ● [推文](https://x.com/trq212/status/2027543858289250472) - /loop — 安排最长 3 天的循环任务 (Boris) | 07 Mar 2026 ● [推文](https://x.com/bcherny/status/2030193932404150413) - Code Review — 为什么全新的上下文窗口能发现原始智能体遗漏的 bug (Boris) | 10 Mar 2026 ● [推文](https://x.com/bcherny/status/2031151689219321886) - /btw — Claude 工作时的侧链对话 (Thariq) | 10 Mar 2026 ● [推文](https://x.com/trq212/status/2031506296697131352) ## ☠️ 初创公司 / 商业 | Claude | 替代 | |-|-| |[**Code Review**](https://code.claude.com/docs/en/code-review)|[Greptile](https://greptile.com)、[CodeRabbit](https://coderabbit.ai)、[Devin Review](https://devin.ai)、[OpenDiff](https://opendiff.com)、[Cursor BugBot](https://bugbot.dev)| |[**Voice Mode**](https://x.com/trq212/status/2028628570692890800)|[Wispr Flow](https://wisprflow.ai)、[SuperWhisper](https://superwhisper.com/)| |[**Remote Control**](https://code.claude.com/docs/en/remote-control)|[OpenClaw](https://openclaw.ai/) |**Cowork**|[OpenAI Operator](https://openai.com/operator)、[AgentShadow](https://agentshadow.ai) |[**Tasks**](https://x.com/trq212/status/2014480496013803643)|[Beads](https://github.com/steveyegge/beads) |[**Plan Mode**](https://code.claude.com/docs/en/common-workflows)|[Agent OS](https://github.com/buildermethods/agent-os)| |[**Skills / Plugins**](https://code.claude.com/docs/en/plugins)|YC AI 套壳初创公司（[reddit](https://reddit.com/r/ClaudeAI/comments/1r6bh4d/claude_code_skills_are_basically_yc_ai_startup/)）|  *如果你有答案，请通过 shanraisshan@gmail.com 告诉我* **记忆与指令 (4)** 1. 你到底应该在 CLAUDE.md 里放什么 — 又该把什么排除在外？ 2. 如果你已经有 CLAUDE.md，是否真的需要单独的 constitution.md 或 rules.md？ 3. 你应该多久更新一次 CLAUDE.md，又怎么知道它什么时候过时了？ 4. 为什么 Claude 仍然会忽略 CLAUDE.md 中的指令 — 即使它们用全大写写了 MUST？([reddit](https://reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/)) **智能体、Skills 与工作流 (6)** 1. 什么时候应该使用 command vs agent vs skill — 什么时候原生 Claude Code 反而更好？ 2. 随着模型改进，你应该多久更新一次 agents、commands 和 workflows？ 3. 给 subagent 一个详细的人设是否能提高质量？一个用于研究/QA subagent 的"完美人设/提示"应该是什么样的？ 4. 你应该依赖 Claude Code 内置的计划模式 — 还是构建自己的计划 command/agent 来强制执行团队的工作流？ 5. 如果你有个人 skill（例如，符合你编码风格的 /implement），如何在不产生冲突的情况下整合社区 skills（例如 /simplify）— 当它们不一致时谁优先？ 6. 我们到了吗？能否将现有代码库转换为规格，删除代码，然后让 AI 仅从这些规格中重新生成完全相同的代码？ **规格与文档 (3)** 1. 你仓库中的每个功能是否都应该有一个 markdown 格式的规格文件？ 2. 你需要多久更新一次规格，以便在实现新功能时它们不会过时？ 3. 在实现新功能时，你如何处理对其他功能规格的连锁影响？ ## 报告 | 报告 | 描述 | |--------|-------------| | [Agent SDK vs CLI System Prompts](reports/claude-agent-sdk-vs-cli-system-prompts.md) | 为什么 Claude CLI 和 Agent SDK 输出可能不同 — 系统提示架构和确定性 | | [Browser Automation MCP Comparison](reports/claude-in-chrome-v-chrome-devtools-mcp.md) | Playwright、Chrome DevTools 和 Claude in Chrome 用于自动化测试的比较 | | [Global vs Project Settings](reports/claude-global-vs-project-settings.md) | 哪些功能仅限全局（`~/.claude/`）vs 双范围，包括 Tasks 和 Agent Teams | | [Skills Discovery in Monorepos](reports/claude-skills-for-larger-mono-repos.md) | Skills 在大型 monorepo 项目中如何被发现和加载 | | [Agent Memory Frontmatter](reports/claude-agent-memory.md) | Subagents 的持久记忆范围（`user`、`project`、`local`）— 使智能体能够跨会话学习 | | [Advanced Tool Use Patterns](reports/claude-advanced-tool-use.md) | 程序化工具调用 (PTC)、工具搜索和工具使用示例 | | [Usage, Rate Limits & Extra Usage](reports/claude-usage-and-rate-limits.md) | 使用命令（`/usage`、`/extra-usage`、`/cost`）、速率限制和按需付费溢出计费 | | [LLM Day-to-Day Degradation](reports/llm-day-to-day-degradation.md) | 为什么 LLM 性能每天会有波动 — 基础设施 bug、MoE 路由差异和心理学因素 | | [Agents vs Commands vs Skills](reports/claude-agent-command-skill.md) | 何时使用每种扩展机制 — 比较表、解析顺序和示例演练 | [](https://claude.com/contact-sales/claude-for-oss) [](https://claude.com/community/ambassadors)

标签：AI 编程, Anthropic, CIS基准, Claude Code, DLL 劫持, LLM, MITM代理, Slash Commands, SOC Prime, Sub-Agents, Unmanaged PE, 人工智能, 代码助手, 后端开发, 大语言模型, 子代理, 工作流编排, 开发工具, 效率提升, 斜杠命令, 最佳实践, 用户模式Hook绕过, 知识管理, 网络调试, 自动化, 软件开发, 防御加固