# claude-code-agent-learning

**Repository Path**: zengraoli/claude-code-agent-learning

## Basic Information

- **Project Name**: claude-code-agent-learning
- **Description**: 在claude-code泄露源代码基础上学习agent
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-01
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code v2.1.88 完整可运行源码
> 从官方npm包的source map 1:1完美还原，包含52万行TypeScript代码，100%功能完整，是工业级Agent产品的完整实现

## 🎉 项目状态
✅ **已完成：**
1. ✅ 完整源码还原，所有核心模块100%无缺失
2. ✅ 一键构建脚本，直接运行即可编译出可执行文件
3. ✅ 已添加完整学习指南（[LEARNING_GUIDE.md](./LEARNING_GUIDE.md)），包含从入门到高级的学习路线、核心模块解析、可直接复用的设计亮点
4. ✅ `dist/`目录已经有预编译好的可执行文件，可以直接运行
5. ⚠️ 正在适配glm-5 API接口：当前默认对接Anthropic官方API，已经配置好glm-5的地址和密钥，正在适配OpenAI兼容的调用格式

---

## 🚀 快速开始
### 环境要求
- Node.js >= 20
- Bun >= 1.1

### 构建方法
```bash
# 生产构建（压缩版，体积更小）
node scripts/build-cli.mjs

# 开发构建（无压缩，构建速度更快）
node scripts/build-cli.mjs --no-minify
```

构建完成后会在`dist/`目录生成可执行文件：
```bash
# 运行交互模式（类似ChatGPT的终端对话）
node dist/cli.js

# 非交互模式（直接执行任务，执行完成后退出）
node dist/cli.js -p "你的任务描述"
```

---

## 📚 学习资源
### 👉 [完整学习指南](./LEARNING_GUIDE.md)
包含：
- 整体架构分层介绍
- 从入门到高级的学习路线（按天规划）
- 6大核心模块深度解析（Agent系统/任务调度/MCP工具链等）
- 可以直接抄的设计亮点（工业级最佳实践）
- 二次开发指南（基于这个项目改造成自己的Agent）

### 核心模块学习顺序推荐：
1. **入门（1-3天）**：先看`src/tools/` 工具系统 → 理解Agent怎么调用工具、怎么处理工具返回结果
2. **进阶（1周）**：研究`src/agents/` Agent系统 → 学习Agent的定义、创建、运行、管理全流程
3. **核心（1-2周）**：精读`src/coordinator/` 任务调度器 → 掌握复杂任务的调度、多轮对话管理、错误重试逻辑
4. **高级（2周以上）**：学习`src/services/mcp/` MCP工具链 → 这是全行业最先进的工具扩展协议实现，直接抄到自己的项目里就能获得无限工具扩展能力
5. **扩展（可选）**：看`src/utils/swarm/` 多Agent协作 → 学习多Agent团队协作的架构设计、消息路由、权限隔离

---

## 📦 仓库内容说明
```
├── scripts/build-cli.mjs    # 一键构建脚本，无需复杂配置
├── source/cli.js.map        # 原始source map文件（包含4756个模块的完整映射）
├── source/src/              # 完整源码目录，52万行TypeScript代码
├── source/native-addons/    # 预编译的原生扩展（截图/键盘输入等功能）
├── dist/                    # 编译后的可执行文件目录
├── LEARNING_GUIDE.md        # 完整学习指南，保姆级学习路线
├── README.md                # 英文版说明
└── README_zh.md             # 中文版说明（本文档）
```

---

## 🎯 项目核心价值
这是目前全网唯一完整可运行的Claude Code源码，学习价值极高，比任何开源Demo都要成熟3-5年：
- ✅ 经过千万级用户验证的成熟Agent架构，踩过所有你能想到的坑
- ✅ 全行业最先进的MCP（Model Context Protocol）工具链完整实现
- ✅ 生产级别的权限控制、安全校验、危险操作拦截、错误处理
- ✅ 支持多端运行（CLI/IDE插件/浏览器/移动端）
- ✅ 所有代码100%可阅读、可学习、可直接二次开发

---

## 🔧 glm-5 适配说明（进行中）
配置自定义API参数示例：
- API Base URL：`https://你的API地址/v1`
- 模型名称：`你的模型名称`
- API Key：`sk-xxxxxxxxxxxxxxx（替换为你的实际密钥）`

正在适配OpenAI兼容的调用格式，适配完成后会第一时间更新到仓库。

---

## 💡 使用示例（待API适配完成后）
```bash
# 生成Python版本的快速排序代码
node dist/cli.js -p "写一个Python快速排序算法，带详细中文注释和测试用例" --model glm-5
```

有任何问题或者需要解析特定模块的逻辑，随时提issue~