build-claude-code

一个渐进式学习项目,用TypeScript从零构建AI编程代理。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:build-claude-code。
它的用途是:一个渐进式学习项目,用TypeScript从零构建AI编程代理。
完整的 Skill 内容见:https://321skill.com/skills/build-claude-code/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我实现一个能调用Bash命令的基础Agent循环”,它会引导你查看`s01`的代码,并运行`pnpm s01`来观察一个最简单的Agent如何与模型交互并执行命令。接着,你可以按照学习路线,逐步为这个Agent添加工具系统、任务规划等高级能力。

介绍

这个项目旨在解决开发者希望深入理解AI Agent核心机制,但苦于缺乏系统性、渐进式实践路径的问题。它不是一个开箱即用的黑盒工具,而是一份详细的构建指南,通过从基础循环到复杂协作的18个阶段(s01-s18),手把手教你用TypeScript实现一个类似Claude Code的AI编程代理。

使用方式非常清晰:克隆项目后,按照学习路线图,从s01开始逐步运行每个阶段的代码示例。每个阶段都有对应的学习笔记和可执行的入口脚本(如pnpm s01),让你在动手实践中理解Agent循环、工具调用、任务规划、上下文压缩等核心概念。

它非常适合希望在Node.js/TypeScript生态中深入理解AI Agent工程化实践的开发者,特别是全栈开发、智能体开发者和对AI应用底层原理感兴趣的学习者。通过跟随项目,你能获得构建复杂AI应用套件(Harness)的扎实能力。

建议在学习时,不要急于跳级,务必按照顺序完成每个session,并仔细阅读配套的学习笔记(learn/目录)。同时,确保你已具备基本的TypeScript和Node.js知识,并准备好可用的Anthropic API密钥以运行示例。

核心特点

与大多数直接提供封装好Agent的库不同,本项目核心是“教学”而非“成品”,它用TypeScript完整拆解并实现了Claude Code风格Agent的每一个构建步骤,提供了从零到一的渐进式、可运行的代码学习路径。

注意事项

本项目不适合希望直接获得一个开箱即用、功能完备的AI编程Agent产品的用户,它更侧重于教学和底层原理实践。

常见问题

需要什么前置知识才能学习这个项目?

需要具备基本的TypeScript和Node.js开发经验,以及对AI Agent基础概念(如提示词、工具调用)的初步了解。

这个项目和原版learn-claude-code有什么区别?

原版(Python)侧重于原理讲解,而本项目使用TypeScript重写了Agent核心逻辑,更适合Node.js生态的开发者进行实践学习。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/build-claude-code/raw/index.md 读取 build-claude-code 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。