Claude Code V1

Anthropic 官方 Claude Code CLI 工具的源码反编译/逆向还原项目。目标是将 Claude Code 大部分功能及工程化能力复现。

V1 会完成跑通及基本的类型检查通过; V2 会完整实现工程化配套设施; V3 会实现多层级解耦, 很多比如 UI 包, Agent 包都可以独立优化; V4 会完成大量的测试文件, 以提高稳定性

我不知道这个项目还会存在多久, fork 不好使, git clone 或者下载 .zip 包才稳健;

这个项目更新很快, 后台有 Opus 持续优化, 所以你可以提 issues, 但是 PR 暂时不会接受;

如果你想要私人咨询服务, 那么可以发送邮件到 claude-code-best@proton.me, 备注咨询与联系方式即可; 由于后续工作非常多, 可能会忽略邮件, 半天没回复, 可以多发;

快速开始

环境要求

一定要最新版本的 bun 啊, 不然一堆奇奇怪怪的 BUG!!! bun upgrade!!!

Bun >= 1.3.11
Node.js >= 18（部分依赖需要）
有效的 Anthropic API Key（或 Bedrock / Vertex 凭据）

安装

bun install

运行

# 开发模式, 看到版本号 888 说明就是对了
bun run dev

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

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

# 构建
bun run build

构建产物输出到 dist/cli.js（~25.75 MB，5326 模块）。

能力清单

✅ = 已实现 ⚠️ = 部分实现 / 条件启用 ❌ = stub / 移除 / feature flag 关闭

核心系统

能力	状态	说明
REPL 交互界面（Ink 终端渲染）	✅	主屏幕 5000+ 行，完整交互
API 通信 — Anthropic Direct	✅	支持 API Key + OAuth
API 通信 — AWS Bedrock	✅	支持凭据刷新、Bearer Token
API 通信 — Google Vertex	✅	支持 GCP 凭据刷新
API 通信 — Azure Foundry	✅	支持 API Key + Azure AD
流式对话与工具调用循环 (`query.ts`)	✅	1700+ 行，含自动压缩、token 追踪
会话引擎 (`QueryEngine.ts`)	✅	1300+ 行，管理对话状态与归因
上下文构建（git status / CLAUDE.md / memory）	✅	`context.ts` 完整实现
权限系统（plan/auto/manual 模式）	✅	6300+ 行，含 YOLO 分类器、路径验证、规则匹配
Hook 系统（pre/post tool use）	✅	支持 settings.json 配置
会话恢复 (`/resume`)	✅	独立 ResumeConversation 屏幕
Doctor 诊断 (`/doctor`)	✅	版本、API、插件、沙箱检查
自动压缩 (compaction)	✅	auto-compact / micro-compact / API compact

工具 — 始终可用

工具	状态	说明
BashTool	✅	Shell 执行，沙箱，权限检查
FileReadTool	✅	文件 / PDF / 图片 / Notebook 读取
FileEditTool	✅	字符串替换式编辑 + diff 追踪
FileWriteTool	✅	文件创建 / 覆写 + diff 生成
NotebookEditTool	✅	Jupyter Notebook 单元格编辑
AgentTool	✅	子代理派生（fork / async / background / remote）
WebFetchTool	✅	URL 抓取 → Markdown → AI 摘要
WebSearchTool	✅	网页搜索 + 域名过滤
AskUserQuestionTool	✅	多问题交互提示 + 预览
SendMessageTool	✅	消息发送（peers / teammates / mailbox）
SkillTool	✅	斜杠命令 / Skill 调用
EnterPlanModeTool	✅	进入计划模式
ExitPlanModeTool (V2)	✅	退出计划模式
TodoWriteTool	✅	Todo 列表 v1
BriefTool	✅	简短消息 + 附件发送
TaskOutputTool	✅	后台任务输出读取
TaskStopTool	✅	后台任务停止
ListMcpResourcesTool	✅	MCP 资源列表
ReadMcpResourceTool	✅	MCP 资源读取
SyntheticOutputTool	✅	非交互会话结构化输出

工具 — 条件启用

工具	状态	启用条件
GlobTool	✅	未嵌入 bfs/ugrep 时启用（默认启用）
GrepTool	✅	同上
TaskCreateTool	⚠️	`isTodoV2Enabled()` 为 true 时
TaskGetTool	⚠️	同上
TaskUpdateTool	⚠️	同上
TaskListTool	⚠️	同上
EnterWorktreeTool	⚠️	`isWorktreeModeEnabled()`
ExitWorktreeTool	⚠️	同上
TeamCreateTool	⚠️	`isAgentSwarmsEnabled()`
TeamDeleteTool	⚠️	同上
ToolSearchTool	⚠️	`isToolSearchEnabledOptimistic()`
PowerShellTool	⚠️	Windows 平台检测
LSPTool	⚠️	`ENABLE_LSP_TOOL` 环境变量
ConfigTool	❌	`USER_TYPE === 'ant'`（永远为 false）

工具 — Feature Flag 关闭（全部不可用）

工具	Feature Flag
SleepTool	`PROACTIVE` / `KAIROS`
CronCreate/Delete/ListTool	`AGENT_TRIGGERS`
RemoteTriggerTool	`AGENT_TRIGGERS_REMOTE`
MonitorTool	`MONITOR_TOOL`
SendUserFileTool	`KAIROS`
OverflowTestTool	`OVERFLOW_TEST_TOOL`
TerminalCaptureTool	`TERMINAL_PANEL`
WebBrowserTool	`WEB_BROWSER_TOOL`
SnipTool	`HISTORY_SNIP`
WorkflowTool	`WORKFLOW_SCRIPTS`
PushNotificationTool	`KAIROS`
SubscribePRTool	`KAIROS_GITHUB_WEBHOOKS`
ListPeersTool	`UDS_INBOX`
CtxInspectTool	`CONTEXT_COLLAPSE`

工具 — Stub / 不可用

工具	说明
TungstenTool	ANT-ONLY stub
REPLTool	ANT-ONLY，`isEnabled: () => false`
SuggestBackgroundPRTool	ANT-ONLY，`isEnabled: () => false`
VerifyPlanExecutionTool	需 `CLAUDE_CODE_VERIFY_PLAN=true` 环境变量，且为 stub
ReviewArtifactTool	stub，未注册到 tools.ts
DiscoverSkillsTool	stub，未注册到 tools.ts

斜杠命令 — 可用

命令	状态	说明
`/add-dir`	✅	添加目录
`/advisor`	✅	Advisor 配置
`/agents`	✅	代理列表/管理
`/branch`	✅	分支管理
`/btw`	✅	快速备注
`/chrome`	✅	Chrome 集成
`/clear`	✅	清屏
`/color`	✅	Agent 颜色
`/compact`	✅	压缩对话
`/config` (`/settings`)	✅	配置管理
`/context`	✅	上下文信息
`/copy`	✅	复制最后消息
`/cost`	✅	会话费用
`/desktop`	✅	Claude Desktop 集成
`/diff`	✅	显示 diff
`/doctor`	✅	健康检查
`/effort`	✅	设置 effort 等级
`/exit`	✅	退出
`/export`	✅	导出对话
`/extra-usage`	✅	额外用量信息
`/fast`	✅	切换 fast 模式
`/feedback`	✅	反馈
`/files`	✅	已跟踪文件
`/heapdump`	✅	Heap dump（调试）
`/help`	✅	帮助
`/hooks`	✅	Hook 管理
`/ide`	✅	IDE 连接
`/init`	✅	初始化项目
`/install-github-app`	✅	安装 GitHub App
`/install-slack-app`	✅	安装 Slack App
`/keybindings`	✅	快捷键管理
`/login` / `/logout`	✅	登录 / 登出
`/mcp`	✅	MCP 服务管理
`/memory`	✅	Memory / CLAUDE.md 管理
`/mobile`	✅	移动端 QR 码
`/model`	✅	模型选择
`/output-style`	✅	输出风格
`/passes`	✅	推荐码
`/permissions`	✅	权限管理
`/plan`	✅	计划模式
`/plugin`	✅	插件管理
`/pr-comments`	✅	PR 评论
`/privacy-settings`	✅	隐私设置
`/rate-limit-options`	✅	限速选项
`/release-notes`	✅	更新日志
`/reload-plugins`	✅	重载插件
`/remote-env`	✅	远程环境配置
`/rename`	✅	重命名会话
`/resume`	✅	恢复会话
`/review`	✅	代码审查（本地）
`/ultrareview`	✅	云端审查
`/rewind`	✅	回退对话
`/sandbox-toggle`	✅	切换沙箱
`/security-review`	✅	安全审查
`/session`	✅	会话信息
`/skills`	✅	Skill 管理
`/stats`	✅	会话统计
`/status`	✅	状态信息
`/statusline`	✅	状态栏 UI
`/stickers`	✅	贴纸
`/tasks`	✅	任务管理
`/theme`	✅	终端主题
`/think-back`	✅	年度回顾
`/upgrade`	✅	升级 CLI
`/usage`	✅	用量信息
`/insights`	✅	使用分析报告
`/vim`	✅	Vim 模式

斜杠命令 — Feature Flag 关闭

命令	Feature Flag
`/voice`	`VOICE_MODE`
`/proactive`	`PROACTIVE` / `KAIROS`
`/brief`	`KAIROS` / `KAIROS_BRIEF`
`/assistant`	`KAIROS`
`/bridge`	`BRIDGE_MODE`
`/remote-control-server`	`DAEMON` + `BRIDGE_MODE`
`/force-snip`	`HISTORY_SNIP`
`/workflows`	`WORKFLOW_SCRIPTS`
`/web-setup`	`CCR_REMOTE_SETUP`
`/subscribe-pr`	`KAIROS_GITHUB_WEBHOOKS`
`/ultraplan`	`ULTRAPLAN`
`/torch`	`TORCH`
`/peers`	`UDS_INBOX`
`/fork`	`FORK_SUBAGENT`
`/buddy`	`BUDDY`

斜杠命令 — ANT-ONLY（不可用）

/tag /backfill-sessions /break-cache /bughunter /commit /commit-push-pr /ctx_viz /good-claude /issue /init-verifiers /mock-limits /bridge-kick /version /reset-limits /onboarding /share /summary /teleport /ant-trace /perf-issue /env /oauth-refresh /debug-tool-call /agents-platform /autofix-pr

CLI 子命令

子命令	状态	说明
`claude`（默认）	✅	主 REPL / 交互 / print 模式
`claude mcp serve/add/remove/list/get/...`	✅	MCP 服务管理（7 个子命令）
`claude auth login/status/logout`	✅	认证管理
`claude plugin validate/list/install/...`	✅	插件管理（7 个子命令）
`claude setup-token`	✅	长效 Token 配置
`claude agents`	✅	代理列表
`claude doctor`	✅	健康检查
`claude update` / `upgrade`	✅	自动更新
`claude install [target]`	✅	Native 安装
`claude server`	❌	`DIRECT_CONNECT` flag
`claude ssh <host>`	❌	`SSH_REMOTE` flag
`claude open <cc-url>`	❌	`DIRECT_CONNECT` flag
`claude auto-mode`	❌	`TRANSCRIPT_CLASSIFIER` flag
`claude remote-control`	❌	`BRIDGE_MODE` + `DAEMON` flag
`claude assistant`	❌	`KAIROS` flag
`claude up/rollback/log/error/export/task/completion`	❌	ANT-ONLY

服务层

服务	状态	说明
API 客户端 (`services/api/`)	✅	3400+ 行，4 个 provider
MCP (`services/mcp/`)	✅	24 个文件，12000+ 行
OAuth (`services/oauth/`)	✅	完整 OAuth 流程
插件 (`services/plugins/`)	✅	基础设施完整，无内置插件
LSP (`services/lsp/`)	⚠️	实现存在，默认关闭
压缩 (`services/compact/`)	✅	auto / micro / API 压缩
Hook 系统 (`services/tools/toolHooks.ts`)	✅	pre/post tool use hooks
会话记忆 (`services/SessionMemory/`)	✅	会话记忆管理
记忆提取 (`services/extractMemories/`)	✅	自动记忆提取
Skill 搜索 (`services/skillSearch/`)	✅	本地/远程 skill 搜索
策略限制 (`services/policyLimits/`)	✅	策略限制执行
分析 / GrowthBook / Sentry	⚠️	框架存在，实际 sink 为空
Voice (`services/voice.ts`)	❌	`VOICE_MODE` flag 关闭

内部包 (`packages/`)

包	状态	说明
`color-diff-napi`	✅	997 行完整 TypeScript 实现（语法高亮 diff）
`audio-capture-napi`	❌	stub，`isNativeAudioAvailable()` 返回 false
`image-processor-napi`	❌	stub，`getNativeModule()` 返回 null
`modifiers-napi`	❌	stub，`isModifierPressed()` 返回 false
`url-handler-napi`	❌	stub，`waitForUrlEvent()` 返回 null
`@ant/claude-for-chrome-mcp`	❌	stub，`createServer()` 返回 null
`@ant/computer-use-mcp`	❌	stub，`buildTools()` 返回 []
`@ant/computer-use-input`	❌	stub，仅类型声明
`@ant/computer-use-swift`	❌	stub，仅类型声明

Feature Flags（30 个，全部返回 `false`）

ABLATION_BASELINE AGENT_MEMORY_SNAPSHOT BG_SESSIONS BRIDGE_MODE BUDDY CCR_MIRROR CCR_REMOTE_SETUP CHICAGO_MCP COORDINATOR_MODE DAEMON DIRECT_CONNECT EXPERIMENTAL_SKILL_SEARCH FORK_SUBAGENT HARD_FAIL HISTORY_SNIP KAIROS KAIROS_BRIEF KAIROS_CHANNELS KAIROS_GITHUB_WEBHOOKS LODESTONE MCP_SKILLS PROACTIVE SSH_REMOTE TORCH TRANSCRIPT_CLASSIFIER UDS_INBOX ULTRAPLAN UPLOAD_USER_SETTINGS VOICE_MODE WEB_BROWSER_TOOL WORKFLOW_SCRIPTS

项目结构

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 修饰键检测）
│   ├── audio-capture-napi/  # stub
│   ├── image-processor-napi/# stub
│   ├── url-handler-napi/    # stub
│   └── @ant/               # Anthropic 内部包 stub
│       ├── claude-for-chrome-mcp/
│       ├── computer-use-mcp/
│       ├── computer-use-input/
│       └── computer-use-swift/
├── scripts/                 # 自动化 stub 生成脚本
├── dist/                    # 构建输出
└── package.json             # Bun workspaces monorepo 配置

技术说明

运行时 Polyfill

入口文件 src/entrypoints/cli.tsx 顶部注入了必要的 polyfill：

feature() — 所有 feature flag 返回 false，跳过未实现分支
globalThis.MACRO — 模拟构建时宏注入（VERSION 等）

Monorepo

项目采用 Bun workspaces 管理内部包。原先手工放在 node_modules/ 下的 stub 已统一迁入 packages/，通过 workspace:* 解析。

Feature Flags 详解

原版 Claude Code 通过 bun:bundle 的 feature() 在构建时注入 feature flag，由 GrowthBook 等 A/B 实验平台控制灰度发布。本项目中 feature() 被 polyfill 为始终返回 false，因此以下 30 个 flag 全部关闭。

自主 Agent

Flag	用途
`KAIROS`	Assistant 模式 — 长期运行的自主 Agent（含 brief、push 通知、文件发送）
`KAIROS_BRIEF`	Kairos Brief — 向用户发送简报摘要
`KAIROS_CHANNELS`	Kairos 频道 — 多频道通信
`KAIROS_GITHUB_WEBHOOKS`	GitHub Webhook 订阅 — PR 事件实时推送给 Agent
`PROACTIVE`	主动模式 — Agent 主动执行任务，含 SleepTool 定时唤醒
`COORDINATOR_MODE`	协调器模式 — 多 Agent 编排调度
`BUDDY`	Buddy 配对编程功能
`FORK_SUBAGENT`	Fork 子代理 — 从当前会话分叉出独立子代理

远程 / 分布式

Flag	用途
`BRIDGE_MODE`	远程控制桥接 — 允许外部客户端远程操控 Claude Code
`DAEMON`	守护进程 — 后台常驻服务，支持 worker 和 supervisor
`BG_SESSIONS`	后台会话 — `ps`/`logs`/`attach`/`kill`/`--bg` 等后台进程管理
`SSH_REMOTE`	SSH 远程 — `claude ssh <host>` 连接远程主机
`DIRECT_CONNECT`	直连模式 — `cc://` URL 协议、server 命令、`open` 命令
`CCR_REMOTE_SETUP`	网页端远程配置 — 通过浏览器配置 Claude Code
`CCR_MIRROR`	Claude Code Runtime 镜像 — 会话状态同步/复制

通信

Flag	用途
`UDS_INBOX`	Unix Domain Socket 收件箱 — Agent 间本地通信（`/peers`）

增强工具

Flag	用途
`CHICAGO_MCP`	Computer Use MCP — 计算机操作（屏幕截图、鼠标键盘控制）
`WEB_BROWSER_TOOL`	网页浏览器工具 — 在终端内嵌浏览器交互
`VOICE_MODE`	语音模式 — 语音输入输出，麦克风 push-to-talk
`WORKFLOW_SCRIPTS`	工作流脚本 — 用户自定义自动化工作流
`MCP_SKILLS`	基于 MCP 的 Skill 加载机制

对话管理

Flag	用途
`HISTORY_SNIP`	历史裁剪 — 手动裁剪对话历史中的片段（`/force-snip`）
`ULTRAPLAN`	超级计划 — 远程 Agent 协作的大规模规划功能
`AGENT_MEMORY_SNAPSHOT`	Agent 运行时的记忆快照功能

基础设施 / 实验

Flag	用途
`ABLATION_BASELINE`	科学实验 — 基线消融测试，用于 A/B 实验对照组
`HARD_FAIL`	硬失败模式 — 遇错直接中断而非降级
`TRANSCRIPT_CLASSIFIER`	对话分类器 — `auto-mode` 命令，自动分析和分类对话记录
`UPLOAD_USER_SETTINGS`	设置同步上传 — 将本地配置同步到云端
`LODESTONE`	深度链接协议处理器 — 从外部应用跳转到 Claude Code 指定位置
`EXPERIMENTAL_SKILL_SEARCH`	实验性 Skill 搜索索引
`TORCH`	Torch 功能（具体用途未知，可能是某种高亮/追踪机制）

许可证

本项目仅供学习研究用途。Claude Code 的所有权利归 Anthropic 所有。

Name		Name	Last commit message	Last commit date
Latest commit History 20 Commits
packages		packages
scripts		scripts
src		src
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
README.md		README.md
RECORD.md		RECORD.md
TODO.md		TODO.md
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

Claude Code V1

快速开始

环境要求

安装

运行

能力清单

核心系统

工具 — 始终可用

工具 — 条件启用

工具 — Feature Flag 关闭（全部不可用）

工具 — Stub / 不可用

斜杠命令 — 可用

斜杠命令 — Feature Flag 关闭

斜杠命令 — ANT-ONLY（不可用）

CLI 子命令

服务层

内部包 (packages/)

Feature Flags（30 个，全部返回 false）

项目结构

技术说明

运行时 Polyfill

Monorepo

Feature Flags 详解

自主 Agent

远程 / 分布式

通信

增强工具

对话管理

基础设施 / 实验

许可证

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

内部包 (`packages/`)

Feature Flags（30 个，全部返回 `false`）

Packages