用途
Claude Code Best(CCB)是 Anthropic Claude Code CLI 的生产级、可调试分支实现,本质上是一个运行在终端中的 AI 编程代理界面。它让 Claude 或兼容模型在本地终端运行,并拥有完整的文件系统访问能力,用于辅助编码与工程任务。
主要能力
- 在终端中运行 Claude(或兼容模型),拥有完整文件系统访问权限。
- 通过 Pipe IPC 和局域网发现实现多实例协调。
- 通过 ACP 协议与 Zed、Cursor 及其他 IDE 集成。
- 提供企业级监控集成(Langfuse、Sentry、GrowthBook)。
- 提供 Web 搜索、语音输入、计算机/浏览器控制。
- 兼容任意 Anthropic 兼容 API 提供商(OpenAI、Gemini 等)。
安装方式
从 NPM 安装(推荐)
npm i -g claude-code-best
# 使用 Node.js 启动 CCB
ccb
# 使用 Bun 运行时启动 CCB
ccb-bun
# 更新到最新版本
ccb update
从源码安装
前置要求:安装 Bun >= 1.3.11
curl -fsSL https://bun.sh/install | bash
exec $SHELL # 重载 shell
# 验证安装
bun --version
bun upgrade # 如需要则更新
克隆并运行:
git clone https://github.com/claude-code-best/claude-code.git
cd claude-code
bun install
# 开发模式(版本 888)
bun run dev
# 生产构建
bun run build
# 运行构建版本
node dist/cli.js
# 或
bun dist/cli.js
配置
登录 API 提供商
首次运行时,在 REPL 中输入 /login:
ccb
# 在 REPL 中:
/login
选择提供商类型:
- Anthropic Compatible(任意 Claude 兼容 API)
- OpenAI Compatible(OpenAI 或兼容服务)
- Gemini Compatible(Google Gemini API)
必填字段包括 Base URL、API Key、Haiku Model、Sonnet Model、Opus Model。使用 Tab/Shift+Tab 导航,Enter 确认。
环境变量
# 通过 FEATURE_<NAME>=1 启用功能
FEATURE_BUDDY=1 ccb
# 远程控制
CLAUDE_BRIDGE_BASE_URL=https://remote-control.claude-code-best.win/ \
CLAUDE_BRIDGE_OAUTH_TOKEN=$YOUR_TOKEN \
ccb --remote-control
# Langfuse 监控
LANGFUSE_PUBLIC_KEY=$YOUR_KEY \
LANGFUSE_SECRET_KEY=$YOUR_SECRET \
LANGFUSE_HOST=https://cloud.langfuse.com \
ccb
# 省流模式(减少 API 调用)
ccb # 然后在 REPL 中输入 /poor
主要命令
在 REPL 中:
/login # 配置 API 提供商
/pipes # 显示活动 pipe 连接
/poor # 切换省流模式(降低成本)
/dream # 整理记忆文件
/voice doubao # 启用语音输入
/teach-me <topic> # 交互式学习 CCB 架构
CLI 标志:
ccb --remote-control # 以远程控制启动
ccb --channels plugin:name@marketplace # 启用频道(外部通知)
bun run dev:inspect # 带检查器的调试模式
使用模式
CCB 主要是 CLI 工具,内部使用工具执行、Pipe IPC 多实例协调、记忆管理等模式。远程控制可通过自托管 Docker 部署。设置 BING_SEARCH_API_KEY 或 BRAVE_SEARCH_API_KEY 后可启用 Web 搜索。设置 LANGFUSE 相关环境变量后,每次代理循环都会在 Langfuse 面板中被追踪。启用 FEATURE_COMPUTER_USE=1 后可进行屏幕控制(截图、点击菜单、输入文字)。Chrome 自动化需先安装 chrome-use MCP server。
开发模式
项目结构中 src/ 包含 cli.ts 入口、tools/ 内置工具、ipc/ 多实例 Pipe IPC、memory/ 记忆提取与检索、providers/ API 适配器、ui/ React Ink 终端组件、features/ 功能开关实现。可添加自定义工具(基于 zod 定义 schema 并在 src/tools/index.ts 注册)。VS Code 中可通过 bun run dev:inspect 配合 F5 附加到 Bun 进行调试。
常见问题
涵盖安装失败(清除旧版本、指定版本、改用 npm)、安装后找不到 Bun(重载 shell)、功能不生效(检查功能开关)、API 连接问题(在 /login 重新填写凭证)、构建错误(升级 Bun、清理重装)、远程控制无法连接(检查环境变量)等。
高级配置
- 多实例 Pipe IPC:多个终端运行 ccb,在 REPL 中用 /pipes 查看连接实例,Shift+↓ 广播消息。
- 局域网跨机发现:各机器设置 FEATURE_LAN_DISCOVERY=1,实例自动发现并连接。
- 频道(外部通知):通过 --channels 安装频道插件(如 Slack),配置 webhook 后外部事件可推送消息进入会话。
- 自定义记忆优化:REPL 中 /dream 手动触发整理,或设置 FEATURE_AUTO_DREAM=1。
资源
- 主页:https://ccb.agent-aura.top/
- 文档:https://ccb.agent-aura.top/docs/
- GitHub:https://github.com/claude-code-best/claude-code
- Discord:https://discord.gg/uApuzJWGKX
- 功能文档:仓库中 docs/features/
限制
资料中未提供定价、收费模式、性能指标及具体的平台支持范围,这些信息暂未提供。