// 38 章深度课程 · 架构师视角

Claude Code
Harness

从源码分析到自己动手实现 AI Agent Harness。TypeScript 源码解析 + Python 简化实现,双技术栈实战。

查看课程大纲 →
38
章节
6
模块
TS+PY
双技术栈
2
学习路径
这门课适合谁?

找到与你相似的学员

不同背景的学员,都能从这门课中获得价值

查看 README.md
了解完整用户画像
3 个典型学员
不同背景都能获益
学习路径
清晰的进阶路线
查看完整用户画像
Module 1: Harness 核心概念
理解 Claude Code 的架构设计,从宏观视角建立 Harness 的完整心智模型。
Ch01
什么是 Agent Harness
Harness vs LLM、Model 推理 vs Harness 执行、Claude Code 架构全景图
Ch02
QueryEngine 核心设计
TypeScript 源码分析:QueryEngine 类、状态管理、消息流转
Ch03
工具系统架构
Tool Protocol、ToolRegistry、工具注册与调用机制
Ch04
上下文管理
ContextManager、Token 预算、上下文压缩策略
Ch05
权限与安全
Permission System、Sandbox、危险操作拦截
Module 2: 核心组件深入
深入 Skills、Hooks、MCP、Memory 等核心组件的实现原理。
Ch06
Skills 系统原理
SKILL.md 格式、Frontmatter 解析、技能加载与调用
Ch07
Skills 实战
编写自定义 Skill、调试技巧、最佳实践
Ch08
Hooks 机制
事件驱动架构、Hook 生命周期、settings.json 配置
Ch09
MCP 协议详解
Model Context Protocol 规范、Server/Client 架构、消息格式
Ch10
MCP Server 开发
从零实现一个 MCP Server(TypeScript)、工具注册、资源暴露
Ch11
Memory 系统
持久化记忆架构、MEMORY.md 索引、记忆检索与更新
Ch12
CLAUDE.md 指令系统
指令层级、动态注入、项目感知
Module 3: 多代理系统
Sub-Agent、并行编排、Plan-Work-Review 循环、Worktree 隔离。
Ch13
Sub-Agent 架构
Agent 工具、隔离执行、结果聚合
Ch14
并行任务编排
任务分解、并发控制、依赖管理
Ch15
Plan→Work→Review 循环
规划模式、执行模式、代码审查代理
Ch16
Worktree 隔离
Git Worktree 集成、分支管理、清理策略
Ch17
任务系统
TaskCreate/TaskUpdate/TaskList、状态机、进度追踪
Module 4: Python 实现简化版 Harness
用 Python 从零实现一个简化但功能完整的 Harness,巩固前三个模块的理论知识。
Ch18
架构设计
简化版 Harness 架构、核心类型定义、模块划分
Ch19
QueryEngine 实现
Python 实现:状态管理、消息循环、工具调度
Ch20
工具系统实现
ToolRegistry、工具装饰器、参数验证
Ch21
Skills 加载器
YAML Frontmatter 解析、技能索引、动态加载
Ch22
Hooks 执行器
事件监听、subprocess 调用、异步 Hook 支持
Ch23
MCP Client 实现
JSON-RPC 通信、工具发现、资源读取
Ch24
Memory 管理器
文件索引、相关性检索、自动更新
Ch25
集成测试
完整 Harness 运行、与 Claude API 集成、端到端测试
Module 5: 高级特性
上下文压缩、流式输出、错误恢复、性能优化、安全加固、可观测性、插件系统。
Ch26
上下文压缩策略
滑动窗口、摘要生成、Prompt Caching 优化
Ch27
流式输出处理
SSE 解析、增量渲染、工具调用流式处理
Ch28
错误恢复机制
重试策略、状态回滚、错误反馈循环
Ch29
性能优化
Token 使用优化、并发控制、缓存策略
Ch30
安全加固
命令注入防护、路径遍历检测、敏感信息过滤
Ch31
可观测性
日志系统、Trace 追踪、性能指标收集
Ch32
插件系统设计
插件架构、热加载、版本管理
Module 6: 生产实战
企业级 Skills 开发、自定义 MCP 生态、CI/CD 集成、多租户架构。
Ch33
企业级 Skills 开发
复杂 Skill 设计模式、团队协作、版本控制
Ch34
自定义 MCP 生态
数据库 MCP、API MCP、内部工具集成
Ch35
CI/CD 集成
GitHub Actions 中使用 Claude Code、自动化测试、PR 审查
Ch36
多租户架构
隔离策略、配置管理、资源限制
Ch37
Harness 扩展案例
实战:为 Claude Code 添加新工具类型
Ch38
未来展望
Agent 编排趋势、Harness 演进方向、开源生态
技术栈
TypeScript 5.0+ Python 3.11+ Node.js 22+ Anthropic SDK Pydantic aiohttp Rich JSON-RPC MCP Protocol Git Worktree pytest
← 熵减智算