开源学习项目

通过逆向工程
深入理解 Claude Code

基于公开API和类型定义,完整重现Claude Code CLI v2.1.4的核心功能。 25+内置工具、会话管理、MCP协议支持,是学习AI编程助手架构的绝佳资源。

25+ 内置工具
TypeScript 技术栈
MIT 开源协议
claude-code-open
$ npm run dev

Claude Code Open v2.1.4
 已加载 25 个工具
 会话管理已启动
 MCP 服务器已连接

> 分析这个代码库的架构

核心功能特性

完整复现Claude Code的核心能力,深入理解每个模块的设计思想

🛠️

25+ 内置工具

Bash、Read、Write、Edit、Glob、Grep、WebFetch、WebSearch、Task等完整工具集

💾

会话管理

完整的会话持久化,支持30天自动过期,可恢复历史对话

🔌

MCP 协议支持

Model Context Protocol完整实现,可扩展外部工具服务

🎨

React + Ink UI

现代化终端UI框架,流畅的交互体验

🔍

智能代码分析

Tree-sitter WASM多语言解析,精准代码理解

流式响应

实时流式输出,大幅提升交互响应速度

三层架构设计

清晰的分层架构,易于理解和扩展

1

入口层 Entry Layer

src/cli.ts - CLI参数解析
src/index.ts - 主导出文件
2

核心引擎 Core Engine

client.ts - API封装与重试
session.ts - 会话状态管理
loop.ts - 对话循环编排
3

工具系统 Tool System

BaseTool - 工具基类
ToolRegistry - 动态工具管理
25+ 内置工具实现

快速开始

只需几个简单步骤,即可运行本地开发环境

1

克隆仓库

git clone https://github.com/kill136/claude-code.git
2

安装依赖

cd claude-code && npm install
3

配置 API Key

export ANTHROPIC_API_KEY=your-api-key
4

启动开发模式

npm run dev

准备好深入学习了吗?

加入社区,一起探索AI编程助手的核心架构