25 分钟内训 · 12 个核心判断

Claude Code Best Practices 速读:
Cal 的技术判断

Code w/ Claude 大会 · Cal Rueb (Anthropic Applied AI)
原视频 · 完整笔记 →

🧑‍💻 Cal Rueb
Anthropic Applied AI
Claude Code 核心贡献者
prompt + 评测体系负责人
🏗️ 架构与心智模型
1
架构
"Claude Code 是一个非常 pure agent——一些指令、几个有力的工具,让模型在一个循环里跑直到它觉得做完。"
设计哲学是 simple thing that works。没有 RAG、没有索引、没有 embedding——Claude 像新员工一样用 glob / grep / find 做 agentic search 探索代码。没有索引 = 没有漂移,cd 进去就能跑。
2
架构
"Claude Code is like that coworker that does everything on the terminal. 等于 Tony 一直在你电脑里。"
Cal 做 junior 时遇到 bug 就跑去导师 Tony 桌前——他甩到终端一通 bash + Vim 搞定。"我想学但从来没学会。有了 Claude Code 就不用学了。"这个心智模型是理解一切功能的起点。
3
架构
"请求直连模型 API,没有中间服务器。支持 Anthropic / Bedrock / Vertex 三条通路。"
安全设计让 Claude Code 能在大公司过合规。多云部署是原生支持——不是插件,不是适配器。这也是为什么企业客户大规模采用的前提条件。
⚙️ 环境配置
4
配置
"Claude Code 是 agent,它没有记忆。CLAUDE.md 就是跨会话、跨团队共享状态的主要手段。"
启动时 cwd 有 CLAUDE.md 就直接塞进 prompt。放置位置:项目 cwd(团队共享)、~/CLAUDE.md(个人偏好)、用 @path 引用其他位置。写什么:怎么跑测试、项目布局、style guide、内部工具。
5
配置
"Shift+Tab 进 auto-accept 模式——你按下后 Claude 就只管跑。/settings 里给信任的命令开白名单。"
默认模型:Read 放行、Write/Bash 弹确认。看到第 100 遍 npm run test 提示就该加白名单了。Permission 调到位 = 进入 flow state 的前提。
🔄 日常工作流
6
工作流
"先让 Claude 搜一圈、告诉我它怎么 fix——别动文件。我看 plan 没问题,再让它 implement。"
最容易犯的错:张口就说"修这个 bug"。正确姿势:先 agentic search + plan → 你 review → 再实现。Claude 会自动建 TODO 列表,盯着它,发现歪路按 ESC 改方向。
7
工作流
"按 enter 一路看 Claude 跑很爽。但 TDD + 小步 commit 才是让你敢于放开手的护栏。"
Smart vibe coding 护栏组合:让 Claude 先写测试再实现 → 每改一小点跑测试 → 跑 type check 和 linting → 频繁 commit。走偏就 reset 到上一个 good state。任务风险决定你在"全手动"到"headless"光谱上站哪里。
8
工作流
"直接 paste 一张 mock.png,说'帮我建成这样'——Claude 是多模态的,它能看。"
截图当 context:前端 mock → paste 给 Claude 实现;已实现截图 vs 设计稿 → 让 Claude 根据视觉差异 debug。任何"需要看着图说话"的任务都可以直接喂图。
🚀 进阶技巧
9
进阶
"我自己同时操作 2 个 Claude,Anthropic 有人跑 4 个。用不同实例承担不同角色:写代码、做 review、跑测试。"
Tmux / 多 tab / git worktree 都行。没有原生 multi-agent——当前最佳实践是 ticket.md:Agent A 写 spec → 文件持久化 → Agent B 读 spec 接着做。"也许我们之后会做成原生 feature。"
10
进阶
"ESC 一次停当前工具调用。ESC 两次跳回对话历史——让你从旧节点重新分支。"
隐藏键位,知道的人不多。知道何时按 ESC、何时让 Claude 继续摸索,是用好 Claude Code 的关键判断力——这件事本身没法教,得用出来。
11
进阶
"Claude Code is both an MCP client & server! 纠结 CLI 还是 MCP?选 CLI。MCP 留给 CLI 搞不定的。"
双向能力:可以把 Claude Code 自己当 MCP server 暴露给别的 agent 用。但实操中 CLI 文档好、Claude 用得更顺。MCP 是 CLI 的补充而非替代。
✨ Claude 4 新特性
12
新特性
"过去的模型只在 tool call 之前 thinking。Claude 4 在 tool call 之间也会 think——这是关键改进。"
触发方法:prompt 加 "think hard"(也支持 think harder / ultrathink)。视觉信号:淡灰色文字 = Claude 的"内心独白"。Cal 强调做任务、debug 时随手扔个 think hard,效果差距很大。Claude 4 的 instruction following 也强了很多——升级后是重新审视 CLAUDE.md 的好时机。

Pure Agent,Simple Thing That Works。
不做 RAG、不做 indexing、不做原生 multi-agent。
给模型最少的脚手架,
让它自己长出能力。