The Code Atelier vol. 01 2026 春 · 第一辑
一份给所有人的实战手册

在终端里,与一位
会写代码的
同事,
共事。

这是一份关于 Claude CodeCodex 的双线教程——从安装、基础命令、提示词写作,到上下文管理、调试 workflow、MCP 扩展、Git 工作流、成本控制与避坑。由面及点,由浅入深,可读、可点、可输入。

⌘K
章节
09
交互演示
08
阅读时长
~ 75 min
最近修订
2026 / 05 / 09
§ 01

选一条线,开始你的旅程。

两条路线并行展开。
同样的任务,不同的脾气。

§ 02

九个章节,按你想要的顺序读。

§ 03 · 章 02

命令行:第一次握手。

大多数图形界面都把"我能做什么"摆在你眼前。命令行不一样:你必须 问它 你能做什么。这听起来令人沮丧,其实是它的解放——一旦你学会 /help,整个工具的版图就会缓缓展开在你面前。

下面这个交互式终端不连接真实模型,但它会按 Claude Code 与 Codex CLI 的真实输出格式回应你的命令。先试试 /help

~/projects/web-app — claude-code v2.4.0

关键指令速查

把这些当成 IDE 里的快捷键——头三天不用全记住,但第四天它们会让你飞起来。

§ 03 · 章 03

写好一句话,胜过写一千行。

"帮我修一下登录"——这是大多数 prompt 的样子。它没有错,只是太单薄。模型会去猜你想要什么,然后给你一个"也许还行"的答案。把信息密度往上推一档,结果会立刻不同。

含糊的请求
帮我修一下登录页面的 bug
缺少:症状、复现步骤、相关文件、期望结果。模型会做出过多假设。
命中度 1/5
具体而克制
登录页(src/auth/Login.tsx)在 Safari 上点"登录"无响应,Chrome 正常。Network 显示请求未发出。先定位原因,给出一个最小修复,不要重构。完成后跑 npm test 确认 auth.spec.ts 通过。
命中:文件路径、症状、对照、约束(不重构)、验收标准(测试通过)。
命中度 5/5

一个好提示词是给 AI 同事的"工单",不是搜索框查询。它至少要回答四件事:在哪里(文件、范围)、是什么(症状或目标)、不要做什么(约束)、怎么算完成(验收)。