拓冰网站定制 
5分钟从零跑通第一个Coding Agentclaude-code-from-scratch快速上手完整指南免API key演示【免费下载链接】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想搞懂Coding Agent编程智能体到底是怎么自己读文件、改代码、跑测试的又不想啃 Claude Code 那五十多万行源码claude-code-from-scratch用一个约 5000 行的 TypeScript / Python 极简实现把 Coding Agent 的核心架构Agent Loop、工具系统、上下文压缩、记忆、多 Agent、MCP 集成一步步复现出来。最棒的是每一章都能一条命令跑起来而且完全免 API key本地 mock 模型驱动、不联网输出确定可复现。本指南带你 5 分钟克隆项目、装好依赖、跑通第一个能真正动手干活的 Coding Agent。适合谁看刚接触 AI Agent / LLM 应用的新手、想用几百行代码看懂 Coding Agent 原理的开发者、想找一个能边跑边读的学习项目的同学。一、这个项目到底做什么一句话用最小代码把会自己干活的编程 Agent从循环搭建起来。传统聊天机器人只能给建议——它给一段代码但跑不了测试、看不到报错、没法根据结果再改一版。Coding Agent 迈过了这道坎靠一个循环不断「调模型 → 执行工具 → 把结果喂回去 → 继续」直到任务完成。claude-code-from-scratch 正是把这个核心拎出来用一块一块、可单独运行的方式重建起点是十几行只会聊天的循环每加一章就补一块能力最后长成一个能读写文件、跑 Shell、自动压缩上下文、带记忆和子 Agent 的完整 Agent。它不是一个玩具 demo而是一份分步教程13 章主线 2 章测试/自治TypeScript 与 Python 双语言互为镜像每章都对着真实 Claude Code 讲清最小实现 vs 生产级的差异。二、环境准备1 分钟两种方式任选其一即可依赖少到一眼能看完。版本需要说明TypeScript 版Node.js 18、npm与 Claude Code 同语言推荐Python 版Python 3.11、pip更简洁易读功能一致先确认一下版本node -v # TypeScript 版需要 Node 18 python3 --version # Python 版需要 3.11三、克隆项目并安装依赖git clone https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch.git cd claude-code-from-scratch npm install # TypeScript 版安装依赖首次约 1 分钟 想用 Python 版安装完依赖后进入 python/ 目录执行pip install -e .即可。四、5 分钟跑通免 API key 的演示 这是全文最重要的部分——不用注册、不用填 key直接看真实代码跑起来。项目里每一章都配了一份能单独跑的最小实现由本地 mock 模型回放一个脚本化场景输出稳定、可复现。命令都在 steps/ 目录下入口是 steps/run.mjs。第 1 步看看有哪些能跑的章节node steps/run.mjs --list第 2 步跑一个章节演示无需 keynode steps/run.mjs 7 # 第 7 章对话变长了它把旧消息压成摘要你会看到它真的在工作终端会打印▶ step 7 demo (no API key — local mock model)这样的提示。第 3 步看这一章比上一章多了哪几行代码node steps/run.mjs 7 --diff第 4 步换成 Python 版node steps/run.mjs 7 --py常用参数作用--list列出所有可运行的章节--diff对比本章相对上一章新增的代码--py运行 Python 版本--live连接真实模型需要配置 API key原理演示用的是单一真源生成出的自包含快照——文档里贴的代码块、跑出来的输出全来自同一份源码不会出现文档说的和代码对不上的情况。五、配置 API Key连接真实模型可选看完演示想让它真的帮你干活只需配置一个后端。支持两种格式通过环境变量自动识别也支持自定义 base url方式一Anthropic 格式推荐export ANTHROPIC_API_KEYsk-ant-xxx # 可选使用代理/中转 export ANTHROPIC_BASE_URLhttps://your-relay.com方式二OpenAI 兼容格式export OPENAI_API_KEYsk-xxx export OPENAI_BASE_URLhttps://api.openai.com/v1默认模型为claude-opus-4-6可随时切换export MINI_CLAUDE_MODELclaude-sonnet-4-6 # 环境变量方式 npm start -- --model gpt-4o # 命令行方式优先级更高配置好后任意章节都可以接上自己的 prompt 连真模型试node steps/run.mjs 2 --live -- create hello.txt with the text hi六、启动 mini-claude 交互终端TypeScript 版npm start # 交互式 REPL 模式推荐 npm start -- --resume # 恢复上次会话继续对话 npm start -- --plan # Plan 模式只分析不修改Python 版mini-claude-py # 交互式 REPL避免与 TS 版命令冲突 mini-claude-py --resume # 恢复上次会话 python -m mini_claude # 或用模块方式运行启动后进入命令行交互Mini Claude Code — A minimal coding agent Commands: /clear /cost /compact /memory /skills /plan 常用命令行开关对应的实现在后面章节逐个拆解开关作用--yolo跳过安全确认危险命令自动执行--planPlan 模式只读分析不修改文件--accept-edits自动批准文件编辑--dont-askCI 模式需确认的操作自动拒绝--max-cost 0.50 --max-turns 20费用 轮次双重预算限制REPL 内命令命令功能/clear清空对话历史/cost显示累计 token 用量与费用估算/compact手动触发对话压缩/memory列出所有已保存的记忆/skills列出可用技能试一句read src/agent.ts and explain the main loop看它自己读文件、自己讲给你听。七、核心能力一览跑起来后你会发现这个最小实现其实五脏俱全Agent 循环自动调工具 → 处理结果 → 持续迭代直到任务完成13 个工具读写编辑文件带 mtime 防护、搜索、Shell、WebFetch、技能、子 Agent、Plan Mode4 层上下文压缩对话再长也不撑爆窗口30KB 的大结果自动落盘权限系统5 种模式 声明式规则 16 个危险命令正则拦截记忆系统4 类型记忆 语义召回 异步预取多 Agent子 Agent fork-return任务太大就分出去啃MCP 集成JSON-RPC over stdio 连接外部工具服务器错误恢复限流/过载时指数退避 随机抖动重试CtrlC 优雅中断八、去哪读代码项目结构代码精简到每个文件各管一摊TS 版约 5500 行Python 版约 5000 行互为镜像模块路径管什么Agent 主循环src/agent.ts消息构造、API 调用、工具编排、流式、压缩、预算工具系统src/tools.ts13 工具 mtime 防护 延迟加载自治三件套src/autonomy.ts/goal评估器、/loop、Auto Mode 分类器CLI 入口src/cli.ts参数解析、REPL 交互记忆系统src/memory.ts4 类型 语义召回 异步预取每章可运行实现steps/单一真源 → 生成可跑快照Python 镜像python/mini_claude/与 TS 版功能一致想深挖原理从这份导读入手docs/00-introduction.md。九、继续学习13 章路线图 每一章 一个新能力跟着动手写几千行代码从零理解 Coding Agent 的工作原理阶段章节这一章之后 Agent 能……Phase 11. Agent Loop调用工具、把结果喂回自己不再只是聊天Phase 12. 工具系统读写文件、跑 Shell、搜代码——真正动手Phase 13. System Prompt知道自己在什么系统、目录、Git 状态下干活Phase 14. CLI 与会话有交互式命令行对话可存盘、--resume续聊Phase 15. 流式输出边生成边显示支持 OpenAI 兼容后端Phase 16. 权限与安全危险操作先问一句deny 规则拦得住越界Phase 17. 上下文管理对话太长自动压缩跑几十轮不撑爆窗口Phase 28. 记忆系统跨会话记住偏好与项目事实Phase 29. 技能系统常用操作打包成技能随用随调Phase 210. Plan Mode先只读出方案批准了再动手Phase 211. 多 Agent任务太大就 fork 子 Agent 去啃Phase 212. MCP 集成接外部工具服务器工具集向外扩展收尾13. 架构对比逐项对照真实 Claude Code看清差异在哪十、常见问题FAQ❓ 没有 API key 能跑吗能。node steps/run.mjs N默认走本地 mock 模型不联网、免 key专门用来看它真的转起来。❓ 支持哪些模型Anthropic 格式与 OpenAI 兼容格式两种后端默认claude-opus-4-6可通过MINI_CLAUDE_MODEL或--model随意切换含 gpt-4o 等。❓ TypeScript 和 Python 版怎么选想贴近 Claude Code 同语言就选 TS 版npm start偏好简洁易读就选 Python 版mini-claude-py两者功能完全一致。❓ 演示和真实运行有什么区别演示默认是回放脚本化场景、输出确定加--live就换成你的 prompt 连真模型实时跑。十一、加入社区交流 学习路上遇到问题、想交流 Agent 设计思路扫下方二维码加入AI Agent 工坊交流群群号1090526244小结claude-code-from-scratch给你一条读得动、跑得起来的路径理解 Coding Agentgit clonenpm install装好依赖node steps/run.mjs 7免 API key 跑通演示想真干活就配个 keynpm start进入交互终端跟着 13 章教程 从零把 Agent 一块块搭起来。5000 行代码一个循环起步一路长到能自己干活——这就是 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-scratch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5分钟从零跑通第一个Coding Agent：claude-code-from-scratch快速上手完整指南（免API key演示）
5分钟从零跑通第一个Coding Agentclaude-code-from-scratch快速上手完整指南免API key演示【免费下载链接】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想搞懂Coding Agent编程智能体到底是怎么自己读文件、改代码、跑测试的又不想啃 Claude Code 那五十多万行源码claude-code-from-scratch用一个约 5000 行的 TypeScript / Python 极简实现把 Coding Agent 的核心架构Agent Loop、工具系统、上下文压缩、记忆、多 Agent、MCP 集成一步步复现出来。最棒的是每一章都能一条命令跑起来而且完全免 API key本地 mock 模型驱动、不联网输出确定可复现。本指南带你 5 分钟克隆项目、装好依赖、跑通第一个能真正动手干活的 Coding Agent。适合谁看刚接触 AI Agent / LLM 应用的新手、想用几百行代码看懂 Coding Agent 原理的开发者、想找一个能边跑边读的学习项目的同学。一、这个项目到底做什么一句话用最小代码把会自己干活的编程 Agent从循环搭建起来。传统聊天机器人只能给建议——它给一段代码但跑不了测试、看不到报错、没法根据结果再改一版。Coding Agent 迈过了这道坎靠一个循环不断「调模型 → 执行工具 → 把结果喂回去 → 继续」直到任务完成。claude-code-from-scratch 正是把这个核心拎出来用一块一块、可单独运行的方式重建起点是十几行只会聊天的循环每加一章就补一块能力最后长成一个能读写文件、跑 Shell、自动压缩上下文、带记忆和子 Agent 的完整 Agent。它不是一个玩具 demo而是一份分步教程13 章主线 2 章测试/自治TypeScript 与 Python 双语言互为镜像每章都对着真实 Claude Code 讲清最小实现 vs 生产级的差异。二、环境准备1 分钟两种方式任选其一即可依赖少到一眼能看完。版本需要说明TypeScript 版Node.js 18、npm与 Claude Code 同语言推荐Python 版Python 3.11、pip更简洁易读功能一致先确认一下版本node -v # TypeScript 版需要 Node 18 python3 --version # Python 版需要 3.11三、克隆项目并安装依赖git clone https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch.git cd claude-code-from-scratch npm install # TypeScript 版安装依赖首次约 1 分钟 想用 Python 版安装完依赖后进入 python/ 目录执行pip install -e .即可。四、5 分钟跑通免 API key 的演示 这是全文最重要的部分——不用注册、不用填 key直接看真实代码跑起来。项目里每一章都配了一份能单独跑的最小实现由本地 mock 模型回放一个脚本化场景输出稳定、可复现。命令都在 steps/ 目录下入口是 steps/run.mjs。第 1 步看看有哪些能跑的章节node steps/run.mjs --list第 2 步跑一个章节演示无需 keynode steps/run.mjs 7 # 第 7 章对话变长了它把旧消息压成摘要你会看到它真的在工作终端会打印▶ step 7 demo (no API key — local mock model)这样的提示。第 3 步看这一章比上一章多了哪几行代码node steps/run.mjs 7 --diff第 4 步换成 Python 版node steps/run.mjs 7 --py常用参数作用--list列出所有可运行的章节--diff对比本章相对上一章新增的代码--py运行 Python 版本--live连接真实模型需要配置 API key原理演示用的是单一真源生成出的自包含快照——文档里贴的代码块、跑出来的输出全来自同一份源码不会出现文档说的和代码对不上的情况。五、配置 API Key连接真实模型可选看完演示想让它真的帮你干活只需配置一个后端。支持两种格式通过环境变量自动识别也支持自定义 base url方式一Anthropic 格式推荐export ANTHROPIC_API_KEYsk-ant-xxx # 可选使用代理/中转 export ANTHROPIC_BASE_URLhttps://your-relay.com方式二OpenAI 兼容格式export OPENAI_API_KEYsk-xxx export OPENAI_BASE_URLhttps://api.openai.com/v1默认模型为claude-opus-4-6可随时切换export MINI_CLAUDE_MODELclaude-sonnet-4-6 # 环境变量方式 npm start -- --model gpt-4o # 命令行方式优先级更高配置好后任意章节都可以接上自己的 prompt 连真模型试node steps/run.mjs 2 --live -- create hello.txt with the text hi六、启动 mini-claude 交互终端TypeScript 版npm start # 交互式 REPL 模式推荐 npm start -- --resume # 恢复上次会话继续对话 npm start -- --plan # Plan 模式只分析不修改Python 版mini-claude-py # 交互式 REPL避免与 TS 版命令冲突 mini-claude-py --resume # 恢复上次会话 python -m mini_claude # 或用模块方式运行启动后进入命令行交互Mini Claude Code — A minimal coding agent Commands: /clear /cost /compact /memory /skills /plan 常用命令行开关对应的实现在后面章节逐个拆解开关作用--yolo跳过安全确认危险命令自动执行--planPlan 模式只读分析不修改文件--accept-edits自动批准文件编辑--dont-askCI 模式需确认的操作自动拒绝--max-cost 0.50 --max-turns 20费用 轮次双重预算限制REPL 内命令命令功能/clear清空对话历史/cost显示累计 token 用量与费用估算/compact手动触发对话压缩/memory列出所有已保存的记忆/skills列出可用技能试一句read src/agent.ts and explain the main loop看它自己读文件、自己讲给你听。七、核心能力一览跑起来后你会发现这个最小实现其实五脏俱全Agent 循环自动调工具 → 处理结果 → 持续迭代直到任务完成13 个工具读写编辑文件带 mtime 防护、搜索、Shell、WebFetch、技能、子 Agent、Plan Mode4 层上下文压缩对话再长也不撑爆窗口30KB 的大结果自动落盘权限系统5 种模式 声明式规则 16 个危险命令正则拦截记忆系统4 类型记忆 语义召回 异步预取多 Agent子 Agent fork-return任务太大就分出去啃MCP 集成JSON-RPC over stdio 连接外部工具服务器错误恢复限流/过载时指数退避 随机抖动重试CtrlC 优雅中断八、去哪读代码项目结构代码精简到每个文件各管一摊TS 版约 5500 行Python 版约 5000 行互为镜像模块路径管什么Agent 主循环src/agent.ts消息构造、API 调用、工具编排、流式、压缩、预算工具系统src/tools.ts13 工具 mtime 防护 延迟加载自治三件套src/autonomy.ts/goal评估器、/loop、Auto Mode 分类器CLI 入口src/cli.ts参数解析、REPL 交互记忆系统src/memory.ts4 类型 语义召回 异步预取每章可运行实现steps/单一真源 → 生成可跑快照Python 镜像python/mini_claude/与 TS 版功能一致想深挖原理从这份导读入手docs/00-introduction.md。九、继续学习13 章路线图 每一章 一个新能力跟着动手写几千行代码从零理解 Coding Agent 的工作原理阶段章节这一章之后 Agent 能……Phase 11. Agent Loop调用工具、把结果喂回自己不再只是聊天Phase 12. 工具系统读写文件、跑 Shell、搜代码——真正动手Phase 13. System Prompt知道自己在什么系统、目录、Git 状态下干活Phase 14. CLI 与会话有交互式命令行对话可存盘、--resume续聊Phase 15. 流式输出边生成边显示支持 OpenAI 兼容后端Phase 16. 权限与安全危险操作先问一句deny 规则拦得住越界Phase 17. 上下文管理对话太长自动压缩跑几十轮不撑爆窗口Phase 28. 记忆系统跨会话记住偏好与项目事实Phase 29. 技能系统常用操作打包成技能随用随调Phase 210. Plan Mode先只读出方案批准了再动手Phase 211. 多 Agent任务太大就 fork 子 Agent 去啃Phase 212. MCP 集成接外部工具服务器工具集向外扩展收尾13. 架构对比逐项对照真实 Claude Code看清差异在哪十、常见问题FAQ❓ 没有 API key 能跑吗能。node steps/run.mjs N默认走本地 mock 模型不联网、免 key专门用来看它真的转起来。❓ 支持哪些模型Anthropic 格式与 OpenAI 兼容格式两种后端默认claude-opus-4-6可通过MINI_CLAUDE_MODEL或--model随意切换含 gpt-4o 等。❓ TypeScript 和 Python 版怎么选想贴近 Claude Code 同语言就选 TS 版npm start偏好简洁易读就选 Python 版mini-claude-py两者功能完全一致。❓ 演示和真实运行有什么区别演示默认是回放脚本化场景、输出确定加--live就换成你的 prompt 连真模型实时跑。十一、加入社区交流 学习路上遇到问题、想交流 Agent 设计思路扫下方二维码加入AI Agent 工坊交流群群号1090526244小结claude-code-from-scratch给你一条读得动、跑得起来的路径理解 Coding Agentgit clonenpm install装好依赖node steps/run.mjs 7免 API key 跑通演示想真干活就配个 keynpm start进入交互终端跟着 13 章教程 从零把 Agent 一块块搭起来。5000 行代码一个循环起步一路长到能自己干活——这就是 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-scratch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考