# 引子 · 不是聊天框，是编排台 · Claude Code · 终端里的编排台 **作者** Aklman · **章节** 01 / 11 · **首发** 2026.07 · **语言** 中文为主, 中英双语 **原文** https://library.aklman.com/books/claude-code/01-intro **全书 markdown** https://library.aklman.com/books/claude-code/llms.md **下一章** https://library.aklman.com/books/claude-code/02-loop/llms.md > 本章来自 Aklman · Library, 完整免费阅读。允许 AI 摘读、引用、问答; 转载请保留作者署名与原文链接 (CC BY-NC-ND 4.0, https://library.aklman.com/license)。 --- > 你为 Claude Code 付了 Max，却把它当成一个会改文件的聊天框：问一句、看它写、粘走。官方给它的定位也还是「编码工具」。但计划模式、CLAUDE.md、Skills、subagents、MCP、hooks 拼在一起，它的边界不是「能写什么代码」，而是「一台电脑上的活，有多少能由你派出去、再由你验收」。这一章讲清楚这本书的立场：Claude Code 最小的样子是编辑器，最大的样子是你一个人指挥一支 agent 队的编排台 —— 以及为什么停在聊天框那层，等于把付费买到的后一半白扔。 你大概是这样用 Claude Code 的:开一个终端,敲一句要求,看它改文件,扫两眼 diff,合并。偶尔它自己跑了个测试,你觉得挺神。一天下来,它对你来说是一个会动文件的聊天框 —— 比网页版多省下的,只是复制粘贴。 这没错,但这是它最小的一层。你的 Pro 或 Max 订阅本来就含它,额度和网页版共用一个池子[^1] —— 也就是说,你从没为「聊天框」单独付费,你付的钱里装着一台大得多的机器。这本书的立场一句话说完:Claude Code 最小的样子是一个会改文件的编辑器,最大的样子,是你一个人指挥并验收一支 agent 队的**编排台**。停在聊天框那层,等于把后一半白扔。 ### I · 名字里的「Code」,已经装不下它 官方文档给它的一句话定位是「agentic coding tool」:读你的代码库、改文件、跑命令;入口有终端、IDE、桌面应用和浏览器四个,连的是同一台引擎。[^2]这个定位没有错 —— 只是太谦虚。往同一页文档底下翻:用 MCP 接 Google Drive、Jira、Slack;用 Routines 把活挂到日程上定时跑;用 Channels 把 Telegram、Discord 的消息接成任务;开 agent teams 让几个 agent 并行分工;用 `claude -p` 把它嵌进脚本和 CI。[^2]这些能力没有一个长得像「编码工具」—— 它们长得像一张派活的台子。 这本书不列全部功能。它按「一台编排台需要什么」挑出核心的六件,每件一章:[^3] | 部件 | 它替你做什么 | 哪章 | |---|---|---| | 计划模式 | 动手前先交方案,你批准了它才改 | 第 2 章 | | CLAUDE.md | 项目的长期记忆,每次开工自动加载 | 第 3 章 | | Skills | 把重复的流程收编成资产,用到才加载 | 第 4 章 | | Subagents | 独立上下文的分身,干完只交回结论 | 第 5 章 | | MCP | 把 issue、工单、数据库接进上下文 | 第 6 章 | | Hooks | 固定时机自动执行的规矩,不靠模型自觉 | 第 7 章 | 单看,每一件都不新奇 —— 别的工具也有记忆、也有插件。拼在一起才变质:计划模式让你从「看它写每一行」退到「审方案、验结果」[^4];CLAUDE.md 和 Skills 让你不用每次重新交代;subagents 让活离开你的上下文,headless 让活离开你的终端(第 8 章);hooks 把「希望它记得」换成「到点必然发生」[^3]。每一件都在回答同一个问题:**怎么让你少盯一点,而不失控。** --- ### II · 边界重画:能派多少,验得动多少 > Claude Code 最省的不是敲代码的时间,而是你从「自己动手」切到「派活 + 验收」的整个工作方式。 > — 本书的第一条判断 所以量它的尺子得换。旧尺子问「它能写什么代码」—— 按这把尺子,它和一打同类挤在同一条跑道上。新尺子问「一台电脑上的活,有多少能由你派出去、再由你验收」—— 按这把尺子,写代码只是它顺手的一类活:排查一个线上报错、迁移两千个文件、盯着 CI 修失败、把一夜的日志读成三行结论,都在射程里。 注意新尺子的后半句。派活是容易的一半;难的一半是确认它真做对了。官方最佳实践排在最前面的一条,不是「写更好的 prompt」,而是给它一个**它能自己跑的检查** —— 测试、构建、一张能对比的截图 —— 因为能自动验的活,你才敢真放手。[^5]这本书把「验收」单独设为第 9 章,也是全书的书眼:别的教程教你怎么派活,这本书还要你带着凭据收活。 > 立场照旧说在前面:我是付费用它的人,不是它的产品经理。官网自己能写的话,这里不写。Claude Code 以周为单位在变 —— 书里每个事实都标了核对日期,过期请以官方文档为准。它也不是所有活的最优解:哪些活该留给 Cursor、Codex 或 Warp,第 10 章照实摆。 --- ### III · 先量一次你的活 往下读之前,先给自己的活拍一张底片: - **翻两周,挑 5 件你亲手做完的活**: 不限写代码:排查过的一个报错、迁移过的一批文件、清洗过的一份数据、写过的一份发布说明 —— 挑 5 件当时从头到尾自己动手的。 - **给每件写一条「它能自己跑的检查」**: 想象把这件活派出去:你能不能写出一条测试、一条命令、一个可对比的产出,来判断它做没做对?写得出、写不出、拿不准,各自标上。 - **数「写得出」的有几件**: 那几件是你现在就能派出去的活;「拿不准」的部分,是这本书接下来九章要补的。读完回来重标一遍 —— 这张表就是你的前后对照。 > 写代码是它最小的样子, > 指挥一支 agent 队才是最大的 ## 引用与参考 01 · Claude 帮助中心 · Use Claude Code with your Pro or Max plan —— Pro 与 Max 订阅均直接包含 Claude Code:一份订阅同时覆盖 Claude 应用(网页 / 桌面 / 移动)与终端里的 Claude Code,两边用量共享同一个额度池。截至 2026-07-17。 (Claude Help · Claude Code on Pro/Max) 02 · Claude Code Docs · Overview —— 官方一句话定位:「agentic coding tool」,读你的代码库、改文件、跑命令;入口有终端、IDE、桌面应用与浏览器,连着同一台引擎(CLAUDE.md、设置、MCP 跨入口通用)。同一页列出的能力还有:MCP 接 Google Drive / Jira / Slack、Routines 定时任务、Channels 接 Telegram / Discord 等消息渠道、agent teams 多 agent 协作、headless(claude -p)与 Agent SDK。截至 2026-07-17。 (Claude Code Docs · Overview) 03 · Claude Code Docs · Extend Claude Code —— 扩展机制总览:CLAUDE.md 是每次会话都加载的持久上下文;Skills 是按需加载的知识与流程;subagents 在隔离上下文里干活、只交回摘要;MCP 接外部服务;hooks 在生命周期事件上必然触发。并明确划线:写在 CLAUDE.md 或 skill 里的指令「是请求,不是保证」—— 必须每次都发生的规矩,要写成 hook。截至 2026-07-17。 (Claude Code Docs · Extend Claude Code) 04 · Claude Code Docs · Permission modes —— 计划模式:让 Claude 调研、提方案,但不动手改你的源码 —— 它会读文件、跑只读的探索命令、写出一份计划;在你批准计划之前,编辑一律被挡。Shift+Tab 或 /plan 进入。截至 2026-07-17。 (Claude Code Docs · Permission modes) 05 · Claude Code Docs · Best practices —— 验证一节的第一条:给 Claude 一个它能自己跑的检查 —— 测试、构建、一张能对比的截图;没有检查,「看起来做完了」就是唯一信号,你就是人肉验证回路。并要它交证据(测试输出、跑过的命令与返回)而不是宣称成功。截至 2026-07-17。 (Claude Code Docs · Best practices) --- *引子 · 不是聊天框，是编排台 · Claude Code · 终端里的编排台 · Aklman 著 · CC BY-NC-ND 4.0 · https://library.aklman.com/books/claude-code/01-intro*