把教学实现的协议与结构误认为 Claude Code 官方源码或架构
风险描述
learn-claude-code 仓库虽然以 Claude Code 命名，但作者明确声明这是社区教学实现，不模仿 Claude Code 的界面、协议或内部源码。仓库中的 JSONL 邮箱、子 Agent 协调、上下文压缩策略等都是教学版的简化实现。读者若把这些当作 Claude Code 的官方架构或 API 协议，会形成错误认知并向外传播。
典型误读
- 把仓库的 JSONL 邮箱当作 Claude Code 官方的多 Agent 通信协议。
- 把仓库中的工具调用 schema 误认为 Anthropic API 的官方扩展。
- 把 Skills、MCP、Hooks、Plan Mode 等机制的简化版教学当作 Claude Code 的官方行为。
- 把教学代码的运行表现反推为 Claude Code 的性能或稳定性。
可能带来的后果
- 在生产系统中按教学版协议设计通信层，导致与官方工具不兼容。
- 把仓库的简化决策当成"Claude Code 的最佳实践"对外分享。
- 在团队内部基于错误认知制定 Agent 平台架构方向。
如何避免
- 区分"教学实现"与"官方源码"：仓库结构是教学示意，Anthropic 官方资料应以官方文档为准。
- 遇到需要"复刻 Claude Code 行为"的需求时，回到 Claude Code 的官方介绍与官方仓库。
- 在引用仓库观点时同时引用 渐进式 Agent Harness 工程化（最小循环 → 工具 → 上下文 → 计划 → 子 Agent → Skills → MCP → 团队 → worktree），明确"这是渐进式工程化方法"而非 Claude Code 架构。
相关页面
- 教学仓库：learn-claude-code（从最小循环到完整 Harness 的中文教学仓库）
- 教程摘要：Learn Claude Code——从最小循环到完整 Harness（shareAI-lab 教学仓库教程摘要）
- 教学对象工具：Claude Code
- 配套风险：教学版 Agent 代码与生产系统缺失的治理能力差距