Claude Code 从零复刻教程 - 完整大纲

Claude Code 从零复刻教程 - 完整大纲本教程面向有 JavaScript 基础的开发者通过 12 篇系列文章从零构建一个类似 Claude Code 的 AI 编程助手 CLI 工具。目录教程简介技术栈系列大纲每篇教程结构学习路径教程简介什么是 Claude CodeClaude Code 是 Anthropic 官方推出的命令行工具可以让开发者通过终端与 Claude AI 进行自然语言交互辅助完成编程任务。它具有以下核心能力能力说明CLI 交互在终端中通过自然语言与 AI 对话工具调用AI 可以读写文件、执行命令、搜索代码多智能体多个 AI Agent 协同工作长期记忆跨会话记住项目上下文教程目标完成本系列教程后你将理解 AI CLI 工具的核心架构掌握 TypeScript Node.js 构建 CLI 的最佳实践实现一个功能完整的 AI 编程助手为参与开源或开发自己的 AI 工具奠定基础受众要求要求说明JavaScript 基础熟悉 ES6 语法命令行基础会使用终端TypeScript教程中会讲解但有 JS 基础可快速上手API Key需要准备 Anthropic API Key免费注册技术栈类别技术版本说明语言TypeScript5.x类型安全、易于调试运行时Node.js20ESM TS 原生支持包管理npm10生态成熟AI 能力Anthropic SDK最新Claude API 封装CLI 框架Commander.js12.x参数解析输出美化picocolors1.x彩色终端输出存储文件系统-轻量无需 DB测试Vitest2.x快速轻量系列大纲阶段一CLI 核心框架第 1 篇项目初始化与 CLI 骨架核心内容项目目录结构设计TypeScript 配置tsconfig.jsonCommander.js 入门入口文件架构打印彩色输出交付物最小可运行的 CLI 工具my-claude# 完成后可运行my-claude--help# 输出帮助信息文件结构my-claude/ ├── src/ │ ├── main.ts # 入口 │ └── index.ts # 导出 ├── package.json ├── tsconfig.json └── README.md第 2 篇REPL 循环实现核心内容标准输入输出readline 模块消息队列设计用户输入处理退出机制彩色提示符交付物可交互的命令行界面my-claude# 显示彩色提示符# 等待用户输入# 循环处理...# 输入 /exit 退出关键代码模式constrlreadline.createInterface({input:process.stdin,output:process.stdout,prompt:chalk.blue(claude )});rl.prompt();rl.on(line,async(input){awaitprocessInput(input.trim());rl.prompt();});第 3 篇参数解析与配置管理核心内容命令行参数解析–api-key, --model 等环境变量配置settings.json 配置文件API Key 安全管理配置优先级交付物完整的配置系统my-claude --api-key sk-ant-xxx--modelclaude-sonnet# 或通过环境变量ANTHROPIC_API_KEYsk-ant-xxx my-claude# 或通过配置文件配置文件结构// ~/.my-claude/settings.json{apiKey:sk-ant-xxx,model:claude-sonnet-4-20250514,maxTokens:8192}阶段二对话系统第 4 篇Anthropic API 集成核心内容Anthropic SDK 安装与配置API 调用流程消息格式流式响应错误处理重试机制交付物能对话的 CLImy-claude# claud 解释什么是闭包# [AI 回复...]核心代码importAnthropicfromanthropic-ai/sdk;constclientnewAnthropic({apiKey});constmessageawaitclient.messages.create({model:claude-sonnet-4-20250514,max_tokens:1024,messages:[{role:user,content:Hello!}]});第 5 篇七层 System Prompt 架构核心内容七层设计理念身份定义层系统约束层任务规范层安全准则层工具使用层沟通规范层静态/动态分层优化交付物模块化的 Prompt 系统Prompt 结构图┌─────────────────────────────────────────┐ │ Layer 7: 动态上下文记忆/MCP/语言 │ ← 每次请求重建 ├─────────────────────────────────────────┤ │ Layer 6: 沟通规范 │ ├─────────────────────────────────────────┤ │ Layer 5: 工具使用指导 │ ├─────────────────────────────────────────┤ │ Layer 4: 安全准则 │ ├─────────────────────────────────────────┤ │ Layer 3: 任务规范 │ ├─────────────────────────────────────────┤ │ Layer 2: 系统约束 │ ├─────────────────────────────────────────┤ │ Layer 1: 身份定义 │ ← 全局缓存 └─────────────────────────────────────────┘第 6 篇对话上下文管理核心内容消息历史管理Token 计数上下文窗口限制消息截断策略对话状态持久化上下文压缩交付物完整对话体验interfaceConversationContext{messages:Message[];totalTokens:number;maxTokens:number;}functionmanageContext(ctx:ConversationContext,newMsg:Message):void{ctx.messages.push(newMsg);ctx.totalTokenscountTokens(newMsg);while(ctx.totalTokensctx.maxTokens){ctx.messages.shift();ctx.totalTokensrecalculate(ctx.messages);}}阶段三工具系统第 7 篇工具注册与调用机制核心内容工具接口定义注册表模式动态工具注册Tool Use 规范工具参数验证调用结果处理交付物工具执行框架工具接口interfaceTool{name:string;description:string;input_schema:JSONSchema;execute:(params:unknown)PromiseToolResult;}classToolRegistry{privatetools:Mapstring,Tool;register(tool:Tool):void;get(name:string):Tool|undefined;list():Tool[];}第 8 篇基础工具实现核心内容ReadFileTool读取文件内容WriteFileTool写入文件GlobTool模式匹配文件BashTool执行 shell 命令工具权限控制执行超时处理交付物实际可用的文件操作工具四个核心工具工具命令说明ReadRead: filePath读取文件WriteWrite: filePath, content写入文件GlobGlob: pattern搜索文件BashBash: command执行命令阶段四Agent Teams第 9 篇多智能体协作框架核心内容Agent 概念与生命周期TeamCreateTool 实现SendMessageTool 实现任务分发机制进程内 vs 进程外 Agent状态同步交付物多 Agent 基础设施架构图用户 │ ▼ ┌─────────┐ │ TeamLead │ ← 主 Agent └────┬────┘ │ 分配任务 ┌─────┼─────┐ ▼ ▼ ▼ ┌─────┐ ┌─────┐ ┌─────┐ │ Ag1 │ │ Ag2 │ │ Ag3 │ ← 队友 Agent └─────┘ └─────┘ └─────┘第 10 篇内置 Agent 实现核心内容ExploreAgent代码探索专家PlanAgent架构规划专家VerificationAgent质量验证专家Agent 提示词设计Agent 间通信结果汇总交付物专业化的 Agent 角色Agent 类型Agent角色特点Explore搜索专家只读、并行、高效Plan规划专家结构化输出、深度分析Verification验证专家对抗测试、质量把控阶段五记忆系统第 11 篇长期记忆存储核心内容四种记忆类型user/feedback/project/reference记忆文件格式YAML frontmatter存储路径设计记忆索引MEMORY.md记忆提取机制安全存储交付物记忆持久化系统记忆类型类型作用域内容user私有用户偏好、角色、职责feedback私有/团队反馈规则、已知问题project私有/团队项目约定、决策历史reference团队共享文档、API 参考存储结构~/.my-claude/ └── projects/ └── 项目路径/ └── memory/ ├── MEMORY.md # 索引入口 ├── user_role.md ├── feedback.md ├── project_arch.md └── reference_api.md第 12 篇Auto Dream 自动整合核心内容Fork Agent 模式后台记忆整合整合触发条件四阶段整合流程Orient/Gather/Consolidate/Prune定时任务调度整合锁机制交付物智能记忆管理整合流程1. Orient: 了解当前记忆状态 2. Gather: 收集新会话数据 3. Consolidate: 合并新旧记忆 4. Prune: 清理过期内容学习路径推荐顺序第1周CLI 基础 ├── 第 1 篇项目初始化 ├── 第 2 篇REPL 循环 └── 第 3 篇配置管理 第2周对话核心 ├── 第 4 篇API 集成 ├── 第 5 篇Prompt 架构 └── 第 6 篇上下文管理 第3周工具系统 ├── 第 7 篇工具框架 └── 第 8 篇基础工具 第4周高级功能 ├── 第 9 篇Agent Teams └── 第10篇内置 Agent 第5周记忆系统 ├── 第11篇记忆存储 └── 第12篇自动整合快速路径如果你只想快速体验核心功能第 1 篇项目初始化第 4 篇API 集成第 7 篇工具框架第 8 篇基础工具完成这 4 篇后你就拥有了一个最小可用的 AI 编程助手附录A. Claude Code 源码参考本教程部分设计参考 Claude Code 源码模块源码位置教程对应CLI 入口src/main.tsx第 1-3 篇对话系统src/src/buddy/第 4-6 篇工具系统src/src/tools/第 7-8 篇Agent Teamssrc/src/tasks/第 9-10 篇记忆系统src/src/memdir/第 11-12 篇B. 术语表术语解释REPLRead-Eval-Print Loop交互式解释器Tool UseAI 调用外部工具的能力System Prompt系统提示词定义 AI 行为Token文本处理单位API 计费依据Fork Agent从当前会话分离的独立 AgentC. 相关资源Anthropic API 文档TypeScript 官方文档Commander.js 文档Claude Code 源码