README.md

Claude Code Best V5 (CCB)

Which Claude do you like? The open source one is the best.

牢 A (Anthropic) 官方 Claude Code CLI 工具的源码反编译/逆向还原项目。目标是将 Claude Code 大部分功能及工程化能力复现 (问就是老佛爷已经付过钱了)。虽然很难绷, 但是它叫做 CCB(踩踩背)...

文档在这里, 支持投稿 PR | 留影文档在这里 | Discord 群组

特性	说明	文档
Claude 群控技术	Pipe IPC 多实例协作：同机 main/sub 自动编排 + LAN 跨机器零配置发现与通讯，/pipes 选择面板 + Shift+↓ 交互 + 消息广播路由	Pipe IPC / LAN
Remote Control 私有部署	Docker 自托管 RCS + Web UI	文档
/dream 记忆整理	自动整理和优化记忆文件	文档
Web Search	内置网页搜索工具	文档
自定义模型供应商	OpenAI/Anthropic/Gemini/Grok 兼容	文档
Voice Mode	Push-to-Talk 语音输入	文档
Computer Use	屏幕截图、键鼠控制	文档
Chrome Use	浏览器自动化、表单填写、数据抓取	自托管 原生版
Sentry	企业级错误追踪	文档
GrowthBook	企业级特性开关	文档
Langfuse 监控	LLM 调用/工具执行/多 Agent 全链路追踪	文档
Poor Mode	穷鬼模式，关闭记忆提取和键入建议	/poor 可以开关

• 🔮 [ ] V6 — 大规模重构石山代码，全面模块分包（全新分支，main 封存为历史版本）

• 🚀 想要启动项目

• 🐛 想要调试项目

• 📖 想要学习项目

⚡ 快速开始(安装版)

不用克隆仓库, 从 NPM 下载后, 直接使用

bun  i -g claude-code-best
bun pm -g trust claude-code-best
ccb # 以 nodejs 打开 claude code
ccb-bun # 以 bun 形态打开
CLAUDE_BRIDGE_BASE_URL=https://remote-control.claude-code-best.win/ CLAUDE_BRIDGE_OAUTH_TOKEN=test-my-key ccb --remote-control # 我们有自部署的远程控制

⚡ 快速开始(源码版)

⚙️ 环境要求

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

• 📦 Bun >= 1.3.11
• ⚙️ 常规的配置 CC 的方式, 各大提供商都有自己的配置方式

📥 安装

bun install

▶️ 运行

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

# 构建
bun run build

构建采用 code splitting 多文件打包（build.ts），产物输出到 dist/ 目录（入口 dist/cli.js + 约 450 个 chunk 文件）。

构建出的版本 bun 和 node 都可以启动, 你 publish 到私有源可以直接启动

如果遇到 bug 请直接提一个 issues, 我们优先解决

👤 新人配置 /login

首次运行后，在 REPL 中输入 /login 命令进入登录配置界面，选择 Anthropic Compatible 即可对接第三方 API 兼容服务（无需 Anthropic 官方账号）。 选择 OpenAI 和 Gemini 对应的栏目都是支持相应协议的

需要填写的字段：

📌 字段	📝 说明	💡 示例
Base URL	API 服务地址	https://api.example.com/v1
API Key	认证密钥	sk-xxx
Haiku Model	快速模型 ID	claude-haiku-4-5-20251001
Sonnet Model	均衡模型 ID	claude-sonnet-4-6
Opus Model	高性能模型 ID	claude-opus-4-6

• ⌨️ Tab / Shift+Tab 切换字段，Enter 确认并跳到下一个，最后一个字段按 Enter 保存

ℹ️ 支持所有 Anthropic API 兼容服务（如 OpenRouter、AWS Bedrock 代理等），只要接口兼容 Messages API 即可。

Feature Flags

所有功能开关通过 FEATURE_<FLAG_NAME>=1 环境变量启用，例如：

FEATURE_BUDDY=1 FEATURE_FORK_SUBAGENT=1 bun run dev

各 Feature 的详细说明见 docs/features/ 目录，欢迎投稿补充。

VS Code 调试

TUI (REPL) 模式需要真实终端，无法直接通过 VS Code launch 启动调试。使用 attach 模式：

步骤

1. 终端启动 inspect 服务：

   bun run dev:inspect

   会输出类似 ws://localhost:8888/xxxxxxxx 的地址。

2. VS Code 附着调试器：

   • 在 src/ 文件中打断点
   • F5 → 选择 "Attach to Bun (TUI debug)"

Teach Me 学习项目

我们新加了一个 teach-me skills, 通过问答式引导帮你理解这个项目的任何模块。(调整 sigma skill 而来)

# 在 REPL 中直接输入
/teach-me Claude Code 架构
/teach-me React Ink 终端渲染 --level beginner
/teach-me Tool 系统 --resume

它能做什么

• 诊断水平 — 自动评估你对相关概念的掌握程度，跳过已知的、聚焦薄弱的
• 构建学习路径 — 将主题拆解为 5-15 个原子概念，按依赖排序逐步推进
• 苏格拉底式提问 — 用选项引导思考，而非直接给答案
• 错误概念追踪 — 发现并纠正深层误解
• 断点续学 — --resume 从上次进度继续

学习记录

学习进度保存在 .claude/skills/teach-me/ 目录下，支持跨主题学习者档案。

相关文档及网站

• 在线文档（Mintlify）: ccb.agent-aura.top — 文档源码位于 docs/ 目录，欢迎投稿 PR
• DeepWiki: https://deepwiki.com/claude-code-best/claude-code

Contributors

Star History

许可证

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