Claude Code

Claude Code
最佳实践

熟能生巧，让 Claude 更完美

● 最佳实践 ● 已实现 ● 编排工作流
查看原始仓库

核心概念

⌘

命令 Commands

.claude/commands/<name>.md

工作流的入口提示 — 使用 /command-name 调用

最佳实践已实现
🤖

子代理 Sub-Agents

.claude/agents/<name>.md

拥有独立名称、颜色、工具、权限和模型的自定义代理

最佳实践已实现
⚡

技能 Skills

.claude/skills/<name>/SKILL.md

可复用的知识、工作流和斜杠命令 — 按需加载或使用 /skill-name 调用

最佳实践已实现
🪝

钩子 Hooks

.claude/hooks/

在特定事件上于代理循环外运行的确定性脚本

最佳实践已实现
🔌

MCP 服务器

.claude/settings.json · .mcp.json

通过模型上下文协议连接外部工具、数据库和 API

最佳实践已实现
📦

插件 Plugins

可分发包

技能、子代理、钩子和 MCP 服务器的捆绑包，可分发至市场

最佳实践已实现
⚙️

设置 Settings

.claude/settings.json

层级配置 · 权限 · 模型配置 · 输出样式 · 沙箱 · 快捷键

最佳实践已实现
🧠

记忆 Memory

CLAUDE.md · .claude/rules/

通过 CLAUDE.md 和 @path 导入实现持久化上下文

最佳实践已实现
💾

检查点 Checkpointing

自动（基于 git）

自动追踪文件编辑，支持回退 Esc Esc 或 /rewind

最佳实践已实现

🔥 热门功能

HOT

代理团队

多个代理并行工作
共享任务协调

 HOT

语音模式

语音提示
/voice 激活

 HOT

远程控制

从任何设备
继续本地会话

 HOT

Git Worktrees

隔离分支
独立工作副本

编排工作流

Command → Agent → Skill 模式的实现。 查看完整文档 →

Command Skill Agent 架构流程
$ claude
> /weather-orchestrator
⌘

命令 Command

入口点 · 用户交互

/weather-orchestrator
🤖

代理 Agent

预加载技能获取数据

weather-agent
⚡

技能 Skill

独立创建输出

weather-svg-creator

开发工作流

跨模型 Claude Code + Codex 已实现 RPI 工作流 已实现 Boris 2026年2月工作流 Ralph 插件与沙箱 已实现 Human Layer RPI - 研究规划实现 Github Speckit GSD - 搞定它 Superpower

技巧与窍门

工作流

  • CLAUDE.md 每个文件应控制在 200 行以内
  • 在单体仓库中使用多个 CLAUDE.md — 祖先 + 后代加载
  • 使用 .claude/rules/ 拆分大型指令
  • 使用命令来定义工作流，而非子代理
  • 创建功能特定的子代理搭配技能（渐进式披露），而非通用 QA、后端工程师
  • 避免代理呆滞区，在上下文使用到 50% 时手动执行 /compact
  • 始终以计划模式开始
  • 对于较小的任务，原生 Claude Code 比任何工作流都更好
  • 在提示词中使用 ultrathink 关键词以获得高强度推理
  • 使用 /model 选择模型，/context 查看上下文用量，/usage 设置限额

每日

每小时

  • 频繁提交，任务完成后立即提交

工具推荐

调试

  • 使用 /doctor 进行诊断
  • 让 Claude 将终端作为后台任务运行以便查看日志
  • 使用 MCP（Claude in Chrome、Playwright、Chrome DevTools）自动查看控制台日志
  • 提供问题截图
  • 使用不同模型进行 QA — 如 Codex 审查计划

💡 Boris Cherny + 团队分享

让 Claude 使用 AskUserQuestion 工具采访你（Thariq） Boris 设置 — 5 个技巧 Claude Code 团队自己的 10 个技巧 人们自定义 Claude 的 12 种方式 Git Worktrees — Boris 的 5 种使用方式 像代理一样思考 — 构建 Claude Code 的经验（Thariq）

☠️ 初创公司 / 商业

语音模式

Voice Mode

替代 →

Wispr Flow · SuperWhisper

远程控制

Remote Control

替代 →

OpenClaw

协作

Cowork

替代 →

Operator · AgentShadow

任务

Tasks

替代 →

Beads

计划模式

Plan Mode

替代 →

Agent OS

技能 / 插件

Skills & Plugins

替代 →

YC AI 套壳

💰 价值十亿美元的问题

记忆与指令

  1. CLAUDE.md 里到底应该放什么 — 什么不该放？
  2. 如果已有 CLAUDE.md，还需要单独的 constitution.md 或 rules.md 吗？
  3. 应该多久更新一次 CLAUDE.md，如何判断它已经过时？
  4. 为什么 Claude 仍会忽略指令 — 即使全大写写着 MUST？

代理、技能与工作流

  1. 什么时候用命令 vs 代理 vs 技能 — 什么时候原生 Claude Code 就够了？
  2. 随着模型改进，应该多久更新一次代理、命令和工作流？
  3. 给子代理详细人设能提升质量吗？"完美的"研究/QA 子代理提示词长什么样？

规格文档与文档

  1. 仓库中每个功能都应该有一个 markdown 格式的规格文档吗？
  2. 需要多久更新规格文档，以防实现新功能后变得过时？
  3. 实现新功能时，如何处理对其他功能规格文档的连锁影响？

报告

Agent SDK vs CLI 系统提示词

Claude CLI 和 Agent SDK 输出可能不同的原因 — 系统提示词架构和确定性

浏览器自动化 MCP 对比

Playwright、Chrome DevTools 和 Claude in Chrome 的自动化测试对比

全局 vs 项目设置

哪些功能仅限全局 vs 双作用域，包括任务和代理团队

单体仓库中的技能发现

大型单体仓库项目中技能的发现和加载方式

代理记忆前置元数据

子代理的持久记忆作用域 — 让代理跨会话学习

高级工具使用模式

程序化工具调用（PTC）、工具搜索和工具使用示例

用量、速率限制与额外用量

用量命令、速率限制和按用量付费溢出计费