深度使用 Claude Code 74 天,消耗 14 亿 Tokens,我锤炼出了这套工程化配置
74 天,14 亿 Tokens,1700+ 次对话。
这不是炫耀——这是踩坑的成本。
Claude Code 很强,但裸用的 Claude Code 和工程化配置后的 Claude Code,是两个完全不同的工具。就像同一匹马,有没有缰绳,结果不是"差一点",是"能用和不能用的区别"。
我把这 74 天里踩过的坑、验证过的配置、反复打磨的流程,拆成了 16 篇实战指南,从单兵作战到军团编排,一步步把 Claude Code 从"聊天工具"变成"工程化武器"。
这套专栏解决什么问题
一句话:让 AI 编码从"能用但不敢用"变成"过了关卡放心用"。
你可能已经遇到过这些场景:
- 每次新会话,AI 从零开始,上次踩的坑这次又踩
- AI 生成的代码能跑,但安全、规范、质量全靠人肉检查
- 规则写了 Prompt 里,AI 有时候遵守有时候忘
- 项目大了,AI 不知道上下文该读什么、忽略什么
- 想让多个 Agent 协作,但不知道怎么编排
这些问题的根因都一样:你缺的不是更好的 Prompt,是一套 Harness。
Harness 是包裹在 AI 模型外面的一切——规则、工具、约束、反馈、安全边界。Prompt 下次会忘,Harness 永远生效。
这套专栏,就是手把手教你搭建 Harness。
专栏导航
专栏按"从配置到编排"的逻辑组织,分四个阶段:
🏗️ 第一阶段:认知与基础(-0 ~ -2)
先搞清楚为什么要做工程化,再掌握基础操作。
-
-0 有 Harness 和没 Harness,AI 编码工具差距有多大 — 同一个模型、同一个任务,没有 Harness 是"能用但不敢用",有 Harness 是"放心合入"。从 Mitchell Hashimoto 的 Agent 公式出发,理解 Harness 思维的核心:不是靠 AI 记住,而是靠系统强制。
-
-1 基础指令速查表 — 会话管理、CLI 参数、快捷键,一表打尽。日常高频操作速查,建议收藏备用。
-
-2 全方位介绍目录配置 —
.claude/目录结构该怎么组织?每个目录放什么、不放什么?目录配置是工程化的地基,地基不稳后面全白搭。
🧠 第二阶段:记忆与约束(-3 ~ -4)
让 AI "长记性",把规则从软约束变成硬约束。
-
-3 记忆系统完全指南:CLAUDE.md 从入门到实战 — CLAUDE.md 是 Claude Code 的"项目说明书",怎么写、写多少、拆不拆,直接影响 AI 每次启动的上下文质量。
-
-3.5 全方位介绍 settings.json — 权限、Hooks、环境变量、MCP 插件……系统层配置的完整解读。settings.json 决定了 AI 能做什么、不能做什么。
-
-3.6 @mentions 实战指南:给 AI 精准投喂上下文的 4 种姿势 — 上下文不是越多越好,是越精准越好。4 种 @mentions 方式,让 AI 只看该看的,不浪费一个 Token。
-
-3.7 Hooks 实战指南:让 AI 编程助手学会"自律" — PostToolUse 跑 Lint、Stop Hook 跑测试、PreToolUse 拦截危险操作——Hooks 是 Harness 的反馈回路,让 AI 写完代码自己检查、当场修。
-
-3.8 /loop 让定时任务回归人话 — 不用写脚本,一句话设定定时任务。
/loop 5m /run比 crontab 更直观,比守护进程更轻量。 -
-4 权限系统完全指南:从原理到实战配置 —
rm -rf直接 deny,文件编辑自动 allow——权限系统是安全底线,让你敢让 AI 动你的代码库。
🔧 第三阶段:能力扩展(-5 ~ -9)
接入工具、定义指令、拆分角色、封装技能、模块化规则。
-
-5 MCP 实战指南:从协议原理到 5 大服务配置 — 让 Claude Code 连上外部世界:数据库、浏览器、搜索引擎、文件系统、Git。5 个实战场景,从原理到配置一步到位。
-
-6 Commands 实战:从零搭建你的 AI 编码快捷指令体系 — 把高频操作封装成
/review、/deploy这样的快捷指令,团队统一入口,新人零门槛上手。 -
-7 子代理实战指南:从内置 Agent 到自定义专业团队 — 前端 Agent、后端 Agent、安全审计 Agent……一个 Claude Code 实例里跑多个专业角色,各司其职。
-
-8 Skills 实战指南:让 AI 精准执行你的工程规范 — Skill 是可复用的能力模块,带
when_to_use自动匹配,带#include按需注入上下文。写一次,到处复用。 -
-9 Rules 实战指南:让 AI 编程助手「长记性」的模块化配置方案 — rules/ 启动时全量注入,Skills 按需匹配加载——两种规范组织方式的分工逻辑和最佳实践。
⚡ 第四阶段:编排与安全(-10 ~ -15)
多 Agent 协作、自动化流水线、安全边界、加载机制。
-
-10 自动化编排:Skills 和 Workflows 到底选哪个? — 不是所有任务都适合 Workflow。Skills 适合单步精确执行,Workflows 适合多步有序流程。选错了,不是多写几行配置的问题,是整个编排跑不通。
-
-11 编排实战:Workflow 与 Orchestrator Agent 怎么选、怎么写 — 确定性流水线 vs 灵活调度器,两种编排模式的适用场景和配置方法。
-
-12 并发编排实战:让多个 Agent 同时跑起来 — 子代理串行等太久?并发编排让多个 Agent 同时开工,任务拆分和结果聚合的实战方案。
-
-13 不只会聊天:Headless 模式 + Agent SDK,让它自己干活 — Claude Code 不只在终端里用。Headless 模式接入 CI/CD,Agent SDK 嵌入你的产品,让 AI 编码变成自动化 Pipeline 的一环。
-
-14 不失控指南:本地 Git + 检查点 + 沙箱,三块拼图补齐安全边界 — AI 改坏了代码怎么办?Git 版本控制 + 自动检查点 + OS 级沙箱,三重保险让你敢让 AI 大胆改。
-
-15 加载机制:从启动到执行的完整拆解 — 你写的配置到底有没有生效?settings.json → CLAUDE.md → rules/ → Auto Memory,完整加载顺序和优先级。理解这一篇,前面的配置你才知道为什么这么放。
怎么读这套专栏
如果你是新手,从 -0 开始按顺序读。先理解 Harness 思维,再一步步搭配置。
如果你已经在用 Claude Code,按需跳读。遇到哪个配置不清楚,直接翻对应章节。每篇独立闭环,不依赖前后文。
如果你是团队负责人,重点关注 -0(理解价值)、-3(记忆系统)、-4(权限系统)、-6(Commands)、-7(子代理)、-14(安全边界)。这些是团队规模化落地的核心配置。
下一个专栏预告
这套专栏讲的是"怎么配置 Claude Code"——把工具调到最优。
但配置再好,如果需求拆解不到位,AI 也只能瞎忙。
下一个专栏,我将专注真实项目中的通用拆解原理:
人工拆解 → SDD 拆解(OpenSec、Spec-Kit)
从"凭感觉拆任务"到"用结构化方法拆需求"——让 AI 编码从"能干活"升级到"干对活"。
敬请关注。
专栏:Claude Code 工程化实战:从单兵到军团(保姆级教程) 作者:颜进强 同一个模型,同一台电脑——有 Harness,才是工程化。