# cluade code 源码逆向工程解读分析

## 项目概述

Claude Code Best (CCB) 是一个对 Anthropic 官方 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 工具进行反编译/逆向还原的开源项目。该项目旨在复现 Claude Code 的大部分功能及工程化能力，但技术实现相当完整。

![Claude Code 架构图](https://developer.qcloudimg.com/http-save/yehe-1293908/5585d5d055c7e44e5bdfcc932f48b42e.jpg)

## 技术定位

Claude Code 被定义为一个 **Terminal-native Agentic Coding System**（终端原生智能编码系统），具有三个关键特性：

1. **Terminal-native**: 原生 CLI 应用，不是 IDE 插件、Web 界面或 API wrapper
2. **Agentic**: 具备 AI 自主决策工具调用链，不是简单的"一问一答"聊天模式
3. **Coding system**: 面向软件工程全流程，不是通用问答工具

## 核心架构

Claude Code 采用五层架构设计：

```
┌─────────────────────────────────────────────────────────┐
│ 1. 入口层 (cli.tsx → main.tsx)                          │
│    feature() = false, MACRO 注入, 启动 Commander.js CLI  │
├─────────────────────────────────────────────────────────┤
│ 2. 交互层 (REPL.tsx — React/Ink)                        │
│    PromptInput 捕获用户输入 → UserMessage 加入会话       │
├─────────────────────────────────────────────────────────┤
│ 3. 编排层 (QueryEngine.ts)                               │
│    管理 turn 生命周期、token 预算、compaction 触发       │
├─────────────────────────────────────────────────────────┤
│ 4. 核心循环 (query.ts — Agentic Loop)                    │
│    组装上下文 → 调 API → 收流式响应 → 解析工具调用      │
│    → 权限检查 → 执行工具 → 结果回传 → 再次调 API → 循环 │
├─────────────────────────────────────────────────────────┤
│ 5. 工具执行 (BashTool.call / FileEditTool.call / ...)    │
│    实际执行: 读文件、运行命令、搜索代码...               │
├─────────────────────────────────────────────────────────┤
│ 6. 通信层 (claude.ts → Anthropic API)                    │
│    流式 HTTP, 支持 Bedrock/Vertex/Azure 多 provider      │
└─────────────────────────────────────────────────────────┘
```

## 功能实现状态

### 核心系统（已完全实现）
- REPL 交互界面（Ink 终端渲染）
- 多平台 API 通信（Anthropic Direct、AWS Bedrock、Google Vertex、Azure Foundry）
- 流式对话与工具调用循环
- 会话引擎（QueryEngine.ts）
- 上下文构建（git status / CLAUDE.md / memory）
- 权限系统（plan/auto/manual 模式）
- Hook 系统（pre/post tool use）
- 会话恢复 (/resume)
- Doctor 诊断 (/doctor)
- 自动压缩 (compaction)

### 工具系统

#### 始终可用的工具（✅）
- **文件操作**: FileReadTool、FileEditTool、FileWriteTool、NotebookEditTool
- **命令执行**: BashTool（带沙箱和权限检查）
- **网络工具**: WebFetchTool、WebSearchTool
- **代理工具**: AgentTool（支持子代理派生）
- **交互工具**: AskUserQuestionTool、SendMessageTool
- **任务管理**: TodoWriteTool、TaskOutputTool、TaskStopTool

#### 条件启用的工具（⚠️）
- GlobTool、GrepTool（默认启用）
- TaskCreate/Get/Update/ListTool（需开启 Todo V2）
- Enter/ExitWorktreeTool（需开启 Worktree 模式）
- TeamCreate/DeleteTool（需开启 Agent Swarms）
- PowerShellTool（仅 Windows）
- LSPTool（需设置环境变量）

#### 关闭的功能（❌）
项目通过 polyfill 使所有 Feature Flags 返回 `false`，因此以下功能被关闭：
- SleepTool、Cron 工具（AGENT_TRIGGERS 相关）
- WebBrowserTool、MonitorTool
- Voice 相关功能（VOICE_MODE）
- 远程控制功能（BRIDGE_MODE、DAEMON）
- Anthropic 内部专用功能（ANT-ONLY）

## 安全机制

Claude Code 实现了多层次的安全保障：

1. **权限模型**: Allow/Ask/Deny 三级权限体系
2. **沙箱机制**: 权限之外的第二道防线
3. **计划模式**: Plan Mode "先看后做"的安全机制
4. **Hook 系统**: 执行前后的拦截协议

## 项目结构

```
claude-code/
├── src/
│   ├── entrypoints/
│   │   ├── cli.tsx          # 入口文件（含 MACRO/feature polyfill）
│   │   └── sdk/             # SDK 子模块 stub
│   ├── main.tsx             # 主 CLI 逻辑（Commander 定义）
│   └── types/
│       ├── global.d.ts      # 全局变量/宏声明
│       └── internal-modules.d.ts  # 内部 npm 包类型声明
├── packages/                # Monorepo workspace 包
│   ├── color-diff-napi/     # 完整实现（终端 color diff）
│   ├── modifiers-napi/      # stub（macOS 修饰键检测）
│   └── @ant/               # Anthropic 内部包 stub
├── scripts/                 # 自动化 stub 生成脚本
├── dist/                    # 构建输出
└── package.json             # Bun workspaces monorepo 配置
```

## 快速开始

### 环境要求
- Bun >= 1.3.11（必须最新版本）
- Node.js >= 18（部分依赖需要）
- 有效的 Anthropic API Key（或 Bedrock / Vertex 凭据）

### 安装与运行
```bash
# 安装依赖
bun install

# 开发模式（看到版本号 888 说明正确）
bun run dev

# 直接运行
bun run src/entrypoints/cli.tsx

# 管道模式
echo "say hello" | bun run src/entrypoints/cli.tsx -p

# 构建
bun run build
```

## 版本路线图

- **V1**: 完成跑通及基本的类型检查通过
- **V2**: 完整实现工程化配套设施
- **V3**: 实现多层级解耦（UI 包、Agent 包等可独立优化）
- **V4**: 完成大量测试文件，提高稳定性

## 总结

Claude Code Best 项目成功逆向还原了 Anthropic 官方 Claude Code CLI 工具的核心功能，实现了完整的终端原生智能编码系统。它不仅能够理解代码、修改文件、执行命令，还具备完善的安全机制和权限控制系统。虽然部分高级功能（如语音、远程控制、Web 浏览器等）因 Feature Flags 被关闭而不可用，但已实现的功能足以支持日常开发工作流。

该项目展示了 AI 编程助手如何在终端环境中实现真正的自主代理（Agentic）能力，而非简单的问答交互，为开发者提供了一个强大的本地化 AI 编码工具。

Claude Code Best (CCB) 是一个对 Anthropic 官方 Claude Code CLI 工具进行反编译/逆向还原的开源项目。该项目旨在复现 Claude Code 的大部分功能及工程化能力，但技术实现相当完整。

cluade code 源码逆向工程解读分析

高级工程师

人工智能

开发工具

后端

ClaudeCodeBest(CCB)开源项目逆向还原Anthropic官方ClaudeCode CLI工具，实现终端原生智能编码系统。采用五层架构设计，支持流式对话、工具调用循环、权限控制等核心功能，包含文件操作、命令执行等20+工具。项目通过安全机制保障执行安全，为开发者提供强大的本地化AI编码助手。

软件工程

Windows

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

cluade code 源码逆向工程解读分析-腾讯云开发者社区-腾讯云

cluade code 源码逆向工程解读分析

cluade code 源码逆向工程解读分析

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐