尧图网页设计 
5000行手写一个Claude Codeclaude-code-from-scratch项目全景解读15章Coding Agent教程路线图【免费下载链接】claude-code-from-scratchBuild your own Claude Code from scratch. Claude Code 开源了 50 万行代码读不动用 ~5000 行 TypeScript / Python 从零复现核心架构11 章分步教程带你理解 coding agent 精髓项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-from-scratchClaude Code 的源码有 50 万行读不动claude-code-from-scratch 是一个从零复现 Claude Code 核心架构的开源学习项目用约 5000 行 TypeScript / Python 代码配合 15 章分步教程带你亲手写出一个 Coding Agent——Agent 循环、13 个工具、权限系统、记忆召回、多 Agent、MCP 集成全部覆盖。本文带你走一遍这张教程路线图看看它怎么把几十万行拆成几千行。 项目是什么用一台卡丁车理解汽车先说清楚这个项目不是 demo而是一份分步教程真实的 Claude Code 把核心循环包在 50 万行 TypeScript 里——66 个工具、React/Ink 终端界面、MCP 协议、OAuth、多代理系统。直接翻这些代码很容易淹死在边界情况里读完还是说不清那个循环长什么样。claude-code-from-scratch 反过来做把那个循环单独拎出来用最小代码重造一遍一块一块搭。起点是十几行只会聊天的循环每一章补一块能力每一块都能单独跑起来。就像用一台卡丁车理解汽车——引擎、方向盘、刹车都在空调音响先不装但每一颗关键的螺丝都拧得清清楚楚。关键数字说明~5000 行Python 版代码量TypeScript 版 ~5500 行互为镜像15 章从「只会聊天」一路造到「自主干活」13 个工具文件读写编辑、Shell、搜索、WebFetch、技能、子 Agent、Plan Mode0 个 API Key每章代码用本地 mock 模型就能跑改一行立刻知道对不对MIT 协议学习项目与 Anthropic 无关联仅参照公开可观察行为核心一句话传统程序里下一步做什么由程序员用if/else写死Coding Agent 反了过来——下一步由模型决定代码只负责把循环转起来、把工具递过去。这一个反转就是 coding agent 和普通聊天机器人的全部区别。 15 章教程路线图三个 Phase 逐级点亮能力完整章节列表见 docs/00-introduction.md。教程分三个阶段Phase 1构建一个可用的 Coding Agent第 1–7 章章节这一章之后agent 能……对应源码1. Agent Loop调用工具、把结果喂回自己不再只是聊天src/agent.ts2. 工具系统读写文件、跑 Shell、搜代码真正动手改项目src/tools.ts3. System Prompt知道自己在什么系统、什么目录、什么 Git 状态下干活src/prompt.ts4. CLI 与会话有交互命令行对话能存盘、--resume接着聊src/cli.ts5. 流式输出一边生成一边显示还能接 OpenAI 兼容模型src/agent.ts6. 权限与安全危险操作先问一句deny 规则拦得住越界src/tools.ts7. 上下文管理对话太长自动 4 层压缩跑几十轮不撑爆窗口src/agent.tsPhase 2进阶能力第 8–12 章章节这一章之后agent 能……对应源码8. 记忆系统跨会话记住偏好和项目事实用得上时自己捞出来src/memory.ts9. 技能系统常用操作打包成可复用技能/commit随用随调src/skills.ts10. Plan Mode先只读地拿出方案批准了再动手src/agent.ts11. 多 Agent任务太大就 fork 一个子 Agent 去啃啃完带回结果src/subagent.ts12. MCP 集成接上外部工具服务器工具集能往外扩src/mcp.tsPhase 3验收与自主运行第 13–15 章章节这一章之后agent 能……对应源码13. 架构对比和真实 Claude Code 逐项对照看清最小实现差在哪全局14. 功能测试22 个手动场景 自动化集成测试逐项验收test/15. 自治与续跑/goal追目标、/loop定时重投、Auto Mode 分类器逐动作裁决src/autonomy.ts️ 核心架构全景一个主循环 12 个模块搭到最后各部件是这样接的用户输入 → CLI 交给 Agent Loop → 模型决定调哪个工具 → 代码执行完把结果喂回去 → 循环到模型说「做完了」。agent.ts是整台发动机的引擎约 2169 行组装消息、调 API、编排工具、压缩上下文、控制预算全在这儿其余 11 个文件各管一摊规模都不大模块行数管什么agent.ts~2169Agent 主循环流式执行、4 层压缩、预算、Plan Mode、自治三件套tools.ts~88413 个工具 权限门禁 mtime 防护 延迟加载autonomy.ts~464/goal评估器、/loop调度、Auto Mode 分类器cli.ts~416CLI 入口、参数解析、REPL 交互memory.ts~3924 类型记忆 语义召回 异步预取其余 7 个模块41–277mcp.ts、prompt.ts、ui.ts、subagent.ts、skills.ts、session.ts、frontmatter.tsPython 版是同一套结构的完整镜像放在 python/mini_claude/ 包里文件一一对应agent.py、tools.py……学哪门语言都能跟。⚡ 最大亮点每一章的代码都能跑且不用 API Key读代码最怕读不懂又跑不起来。这个项目的解法很巧妙——steps/ 目录下为每个代码章节都留了一份能单独运行的最小实现快照node steps/run.mjs --list # 列出所有能跑的章节 node steps/run.mjs 7 # 跑第 7 章对话变长后自动把旧消息压成摘要 node steps/run.mjs 7 --diff # 只看这一章比上一章多写的那几行 node steps/run.mjs 7 --py # 换成 Python 版输出是本地 mock 模型真跑出来的不联网、不用 key想拿自己的 prompt 连真实模型加个--live就行。而且每章的代码、文档里的代码块、跑出来的输出全部从 steps/canonical/ 同一份源码生成——不会出现文档说的和代码对不上。 快速开始五分钟跑起一个迷你 Claude Codegit clone https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch cd claude-code-from-scratch npm install npm run build export ANTHROPIC_API_KEYsk-ant-xxx # 也支持 OpenAI 兼容格式 npm start # 交互式 REPL 模式Python 版则是在 python/ 目录执行pip install -e .后运行mini-claude-py。启动后可以试一句read src/agent.ts and explain the main loop看它自己读文件、自己讲。命令行还有丰富的开关--yolo跳过确认、--plan只分析不修改、--auto分类器自动裁决权限、--max-cost 0.50 --max-turns 20预算控制——每个开关背后都对应教程里的一章。⚖️ 和真正的 Claude Code 差在哪对比表见 docs/13-whats-next.md 与 README.md。简化版维度Claude Codemini-claude代码量50 万 行~5500 行TS/ ~5000 行Python工具数量66 内置工具13 个工具权限系统7 层 AST 分析5 种模式 声明式规则 正则检测多 AgentSub-Agent Coordinator SwarmSub-Agent fork-return项目刻意没实现 Hooks 钩子系统、Coordinator/Swarm 模式和 LSP 集成——第 13 章解释了每一项为什么不做它们更多是 prompt engineering 或协议工程问题对理解 agent 原理帮助不大。读完 15 章你手里拿的不只是几千行代码而是一张能直接对照生产级实现的架构地图。 加入社区一起从零造轮子项目由 Windy3f3f3f3f 等人贡献MIT 协议配套 QQ 交流群「AI Agent 工坊」群号 1090526244适合边学边交流。如果你正被Coding Agent 到底怎么工作这个问题困扰这张 15 章的路线图可能是目前成本最低的一条路每章几百行跑起来只需要一条命令。【免费下载链接】claude-code-from-scratchBuild your own Claude Code from scratch. Claude Code 开源了 50 万行代码读不动用 ~5000 行 TypeScript / Python 从零复现核心架构11 章分步教程带你理解 coding agent 精髓项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5000行手写一个Claude Code：claude-code-from-scratch项目全景解读（15章Coding Agent教程路线图）
5000行手写一个Claude Codeclaude-code-from-scratch项目全景解读15章Coding Agent教程路线图【免费下载链接】claude-code-from-scratchBuild your own Claude Code from scratch. Claude Code 开源了 50 万行代码读不动用 ~5000 行 TypeScript / Python 从零复现核心架构11 章分步教程带你理解 coding agent 精髓项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-from-scratchClaude Code 的源码有 50 万行读不动claude-code-from-scratch 是一个从零复现 Claude Code 核心架构的开源学习项目用约 5000 行 TypeScript / Python 代码配合 15 章分步教程带你亲手写出一个 Coding Agent——Agent 循环、13 个工具、权限系统、记忆召回、多 Agent、MCP 集成全部覆盖。本文带你走一遍这张教程路线图看看它怎么把几十万行拆成几千行。 项目是什么用一台卡丁车理解汽车先说清楚这个项目不是 demo而是一份分步教程真实的 Claude Code 把核心循环包在 50 万行 TypeScript 里——66 个工具、React/Ink 终端界面、MCP 协议、OAuth、多代理系统。直接翻这些代码很容易淹死在边界情况里读完还是说不清那个循环长什么样。claude-code-from-scratch 反过来做把那个循环单独拎出来用最小代码重造一遍一块一块搭。起点是十几行只会聊天的循环每一章补一块能力每一块都能单独跑起来。就像用一台卡丁车理解汽车——引擎、方向盘、刹车都在空调音响先不装但每一颗关键的螺丝都拧得清清楚楚。关键数字说明~5000 行Python 版代码量TypeScript 版 ~5500 行互为镜像15 章从「只会聊天」一路造到「自主干活」13 个工具文件读写编辑、Shell、搜索、WebFetch、技能、子 Agent、Plan Mode0 个 API Key每章代码用本地 mock 模型就能跑改一行立刻知道对不对MIT 协议学习项目与 Anthropic 无关联仅参照公开可观察行为核心一句话传统程序里下一步做什么由程序员用if/else写死Coding Agent 反了过来——下一步由模型决定代码只负责把循环转起来、把工具递过去。这一个反转就是 coding agent 和普通聊天机器人的全部区别。 15 章教程路线图三个 Phase 逐级点亮能力完整章节列表见 docs/00-introduction.md。教程分三个阶段Phase 1构建一个可用的 Coding Agent第 1–7 章章节这一章之后agent 能……对应源码1. Agent Loop调用工具、把结果喂回自己不再只是聊天src/agent.ts2. 工具系统读写文件、跑 Shell、搜代码真正动手改项目src/tools.ts3. System Prompt知道自己在什么系统、什么目录、什么 Git 状态下干活src/prompt.ts4. CLI 与会话有交互命令行对话能存盘、--resume接着聊src/cli.ts5. 流式输出一边生成一边显示还能接 OpenAI 兼容模型src/agent.ts6. 权限与安全危险操作先问一句deny 规则拦得住越界src/tools.ts7. 上下文管理对话太长自动 4 层压缩跑几十轮不撑爆窗口src/agent.tsPhase 2进阶能力第 8–12 章章节这一章之后agent 能……对应源码8. 记忆系统跨会话记住偏好和项目事实用得上时自己捞出来src/memory.ts9. 技能系统常用操作打包成可复用技能/commit随用随调src/skills.ts10. Plan Mode先只读地拿出方案批准了再动手src/agent.ts11. 多 Agent任务太大就 fork 一个子 Agent 去啃啃完带回结果src/subagent.ts12. MCP 集成接上外部工具服务器工具集能往外扩src/mcp.tsPhase 3验收与自主运行第 13–15 章章节这一章之后agent 能……对应源码13. 架构对比和真实 Claude Code 逐项对照看清最小实现差在哪全局14. 功能测试22 个手动场景 自动化集成测试逐项验收test/15. 自治与续跑/goal追目标、/loop定时重投、Auto Mode 分类器逐动作裁决src/autonomy.ts️ 核心架构全景一个主循环 12 个模块搭到最后各部件是这样接的用户输入 → CLI 交给 Agent Loop → 模型决定调哪个工具 → 代码执行完把结果喂回去 → 循环到模型说「做完了」。agent.ts是整台发动机的引擎约 2169 行组装消息、调 API、编排工具、压缩上下文、控制预算全在这儿其余 11 个文件各管一摊规模都不大模块行数管什么agent.ts~2169Agent 主循环流式执行、4 层压缩、预算、Plan Mode、自治三件套tools.ts~88413 个工具 权限门禁 mtime 防护 延迟加载autonomy.ts~464/goal评估器、/loop调度、Auto Mode 分类器cli.ts~416CLI 入口、参数解析、REPL 交互memory.ts~3924 类型记忆 语义召回 异步预取其余 7 个模块41–277mcp.ts、prompt.ts、ui.ts、subagent.ts、skills.ts、session.ts、frontmatter.tsPython 版是同一套结构的完整镜像放在 python/mini_claude/ 包里文件一一对应agent.py、tools.py……学哪门语言都能跟。⚡ 最大亮点每一章的代码都能跑且不用 API Key读代码最怕读不懂又跑不起来。这个项目的解法很巧妙——steps/ 目录下为每个代码章节都留了一份能单独运行的最小实现快照node steps/run.mjs --list # 列出所有能跑的章节 node steps/run.mjs 7 # 跑第 7 章对话变长后自动把旧消息压成摘要 node steps/run.mjs 7 --diff # 只看这一章比上一章多写的那几行 node steps/run.mjs 7 --py # 换成 Python 版输出是本地 mock 模型真跑出来的不联网、不用 key想拿自己的 prompt 连真实模型加个--live就行。而且每章的代码、文档里的代码块、跑出来的输出全部从 steps/canonical/ 同一份源码生成——不会出现文档说的和代码对不上。 快速开始五分钟跑起一个迷你 Claude Codegit clone https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch cd claude-code-from-scratch npm install npm run build export ANTHROPIC_API_KEYsk-ant-xxx # 也支持 OpenAI 兼容格式 npm start # 交互式 REPL 模式Python 版则是在 python/ 目录执行pip install -e .后运行mini-claude-py。启动后可以试一句read src/agent.ts and explain the main loop看它自己读文件、自己讲。命令行还有丰富的开关--yolo跳过确认、--plan只分析不修改、--auto分类器自动裁决权限、--max-cost 0.50 --max-turns 20预算控制——每个开关背后都对应教程里的一章。⚖️ 和真正的 Claude Code 差在哪对比表见 docs/13-whats-next.md 与 README.md。简化版维度Claude Codemini-claude代码量50 万 行~5500 行TS/ ~5000 行Python工具数量66 内置工具13 个工具权限系统7 层 AST 分析5 种模式 声明式规则 正则检测多 AgentSub-Agent Coordinator SwarmSub-Agent fork-return项目刻意没实现 Hooks 钩子系统、Coordinator/Swarm 模式和 LSP 集成——第 13 章解释了每一项为什么不做它们更多是 prompt engineering 或协议工程问题对理解 agent 原理帮助不大。读完 15 章你手里拿的不只是几千行代码而是一张能直接对照生产级实现的架构地图。 加入社区一起从零造轮子项目由 Windy3f3f3f3f 等人贡献MIT 协议配套 QQ 交流群「AI Agent 工坊」群号 1090526244适合边学边交流。如果你正被Coding Agent 到底怎么工作这个问题困扰这张 15 章的路线图可能是目前成本最低的一条路每章几百行跑起来只需要一条命令。【免费下载链接】claude-code-from-scratchBuild your own Claude Code from scratch. Claude Code 开源了 50 万行代码读不动用 ~5000 行 TypeScript / Python 从零复现核心架构11 章分步教程带你理解 coding agent 精髓项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考