用途
该技能专注于探索、理解并扩展 Claude Code 的反编译源码归档及其 Python 重实现(claw-code)。它是一个研究型仓库,用于学习、扩展或重新实现 Anthropic 的 CLI 编码代理。
仓库结构
仓库名为 collection-claude-code-source-code,包含三部分:
- claude-code-source-code/:Claude Code v2.1.88 的反编译 TypeScript 源码(约 163,318 行、1,884 个文件),其 src/ 下包含 main.tsx(CLI 入口与 REPL 引导)、query.ts(核心代理循环,785KB)、QueryEngine.ts(SDK/无头生命周期引擎)、Tool.ts(工具接口与 buildTool 工厂)、commands.ts(斜杠命令定义)、tools/(40+ 工具实现)、commands/(约 87 个斜杠命令处理器)、components/(React/Ink 终端 UI)、services/(业务逻辑层)、coordinator/(多智能体协调)、memdir/(长期记忆管理)、plugins/(插件系统)。
- claw-code/:Python 净室重写(66 个文件)。
- docs/:英文与中文双语分析文档。
安装与设置
git clone https://github.com/chauncygu/collection-claude-code-source-code.git
cd collection-claude-code-source-code
# 浏览 TypeScript 源码
cd claude-code-source-code
npm install # 如需 package.json 依赖用于工具链
# 使用 Python 重写
cd ../claw-code
pip install -r requirements.txt
主要能力与代码结构
核心架构:代理循环
核心执行模型位于 src/query.ts,资料给出简化的代理循环模式:从各部分组装系统提示词、运行带自动压缩的流式工具执行器、将流式消息 yield 回消费者、并行执行工具调用、接近 token 限制时自动压缩上下文、无更多工具调用时退出。
入口点模式(main.tsx)
CLI 引导模式导入 ink 的 render 与 App 组件;解析参数后,若为无头模式则通过 QueryEngine 运行引擎,否则以 React/Ink 渲染交互式 REPL。
工具系统
Tool 接口包含 name、description、inputSchema(ZodSchema)与 execute 方法;buildTool 工厂模式用于定义工具。资料列出的关键内置工具包括 FileReadTool、FileEditTool、FileWriteTool、GlobTool、GrepTool、BashTool、WebFetchTool、WebSearchTool、AgentTool、TodoWriteTool。工具注册在 src/tools.ts 的 getTools 中按配置启用 Web 工具或代理工具。
斜杠命令
命令定义模式包括 name、description、aliases 与 execute;在 commands.ts 的 SLASH_COMMANDS 中注册,共约 87 个。资料列出常见命令:/commit、/commit-push-pr、/review、/resume、/memory、/config、/skills、/permissions、/mcp、/vim。
权限系统
三种权限模式:default(执行敏感工具前询问用户)、bypass(自动允许所有工具,用于无头/CI)、strict(自动拒绝所有未白名单工具)。权限规则结构包含 tool、pattern(可选 glob)、mode;运行时 checkPermission 返回 allow、deny 或 ask。
上下文管理与自动压缩
自动压缩策略包括 reactive(接近 token 限制时压缩)、micro(压缩小型增量块)、trimmed(先裁剪最旧轮次)。autoCompact 在 token 数超过 CONTEXT_COLLAPSE_THRESHOLD 时总结历史并保留最后 KEEP_LAST_N_MESSAGES 条消息;estimateTokens 按内容长度除以 4 估算。
记忆系统(src/memdir/)
Claude Code 实现了 7 层记忆架构:working(当前会话上下文窗口)、episodic(压缩的过往会话摘要)、semantic(抽取的事实与偏好)、procedural(学到的工作流与模式)、external(文件、文档、代码库)、meta(关于记忆的记忆/索引)、dream(后台整合过程)。记忆条目以结构化 markdown 存储在 ~/.claude/memory/。
多智能体协调(src/coordinator/)
通过 AgentTool 生成子代理;AgentCoordinator 支持 runParallel 与 runSequential 两种并行/顺序执行模式。
QueryEngine(无头/SDK 模式)
QueryEngine 接受 apiKey、model、permissionMode、tools 等配置,支持单次 query 与流式 queryStream。
Python 重写 claw-code
claw-code 以 Python 镜像 TypeScript 架构,提供 ClawAgent、FileReadTool、BashTool、GrepTool 等;支持同步运行与异步流式;自定义工具继承 BaseTool 并用 pydantic 定义输入 schema。
MCP 集成
MCPTool 可连接 MCP 服务器,声明 resources、tools、prompts 能力,并自动发现工具为标准 Tool[]。
React/Ink 终端 UI
组件模式使用 ink 的 Box、Text、useInput;示例展示 AgentOutput 组件与 useAgentState 自定义 hook 处理流式消息。
使用方式
配置
配置结构(src/setup.ts)包括 model(默认 'claude-opus-4-5')、permissionMode(默认 'default')、maxTokens(默认 8192)、enableWebTools、enableVoice、enableVim、mcpServers、memoryDir(默认 ~/.claude/memory)、apiKey(来自 ANTHROPIC_API_KEY)。配置存储于 ~/.claude/config.json,可通过 /config 斜杠命令或直接编辑修改。环境变量包括 ANTHROPIC_API_KEY(必需)、CLAUDE_MODEL、CLAUDE_PERMISSION_MODE、CLAUDE_MCP_SERVER_URL、CLAUDE_MEMORY_DIR。
常见模式
- 添加新工具:创建 src/tools/MyNewTool.ts 并在 src/tools.ts 注册。
- 添加斜杠命令:创建 src/commands/myCommand.ts 并在 src/commands.ts 注册。
- 阅读分析文档:查看 docs/en/architecture-overview.md 与 docs/claude-code-deep-dive-xelatex.pdf。
适用场景
适合研究 Claude Code CLI 编码代理架构、学习其代理循环、工具系统、权限、上下文压缩、记忆、多智能体与 MCP 集成实现,或基于 claw-code 进行 Python 重实现与扩展。
限制与说明
资料说明该 TypeScript 源码为反编译产物,部分类型可能需要 stub,编译时需检查 stubs/ 目录并补充缺失模块 stub。Python claw-code 出现导入错误时可用 pip install -e . 以可编辑模式安装。查找具体模块可用 grep 追踪概念,例如搜索 autoCompact 或 StreamingToolExecutor。代理循环的 token/上下文问题可调整 query.ts 中的 CONTEXT_COLLAPSE_THRESHOLD 与 KEEP_LAST_N_MESSAGES 常量。查找斜杠命令处理位置可 grep "name: 'commit'"。关于该技能的收费、价格、平台支持范围与效果等事实,资料暂未提供。
category:coding(编程与开发)。