Claude Code Best V5 (CCB)

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

牢 A (Anthropic) 官方 Claude Code 完整复原的工程化项目。虽然很难绷, 但是它叫做 CCB(踩踩背)... 而且, 我们实现了企业版或者需要登陆 Claude 账号才能使用的特性, 并在此基础上扩展了更多好玩的特性。

Peri Code：Claude Code 兼容的 Rust Agent，多年大模型经验匠心制作，国内大模型（DeepSeek/GLM）精调，CPU/内存极致优化，在开发版/树莓派上也能跑 CC 一样的体验。

文档在这里 | 留影文档在这里 | Discord 群组，群主在线答疑

• 🚀 想要启动项目
• 🐛 想要调试项目
• 📖 想要学习项目

⚡ 快速开始(安装版)

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

npm i -g claude-code-best

# bun 安装比较多问题, 推荐 npm 装
# bun  i -g claude-code-best
# bun pm -g trust claude-code-best @claude-code-best/mcp-chrome-bridge

ccb # 以 nodejs 打开 claude code
ccb-bun # 以 bun 形态打开
ccb update # 更新到最新版本
CLAUDE_BRIDGE_BASE_URL=https://remote-control.claude-code-best.win/ CLAUDE_BRIDGE_OAUTH_TOKEN=test-my-key ccb --remote-control # 我们有自部署的远程控制

安装/更新失败？ 先 npm rm -g claude-code-best 清理旧版本，再 npm i -g claude-code-best@latest。仍失败则指定版本号：npm i -g claude-code-best@<版本号>

⚡ 快速开始(源码版)

⚙️ 环境要求

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

• 📦 Bun >= 1.3.11

安装 Bun：

# Linux 和 macOS
curl -fsSL https://bun.sh/install | bash

# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

安装后的操作：

1. 让当前终端识别 bun 命令

   安装脚本会把 ~/.bun/bin 写入对应的 shell 配置文件。macOS 默认 zsh 环境通常会看到：

   copy

   Added "~/.bun/bin" to $PATH in "~/.zshrc"
   

   可以按安装脚本提示重启当前 shell：

   copy

   exec /bin/zsh
   

   如果你使用 bash，重新加载 bash 配置：

   copy

   source ~/.bashrc
   

   Windows PowerShell 用户关闭并重新打开 PowerShell 即可。

2. 验证 Bun 是否可用

   copy

   bun --help
   bun --version
   

3. 如果已经安装过 Bun，更新到最新版本

   copy

   bun upgrade
   

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

📍 命令执行位置

• 安装或检查 Bun 的命令可以在任意目录执行： curl -fsSL https://bun.sh/install | bash、bun --help、bun --version、bun upgrade
• 安装本项目依赖、启动开发模式、构建项目时，必须先进入本仓库根目录，也就是包含 package.json 的目录。

📥 安装

cd /path/to/claude-code
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 对应的栏目都是支持相应协议的

需要填写的字段：

• ⌨️ 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 服务：

   copy

   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

致谢

• doubaoime-asr — 豆包 ASR 语音识别 SDK，为 Voice Mode 提供无需 Anthropic OAuth 的语音输入方案

许可证

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