Expert in using Claude Code Best (CCB) - a production-grade, debuggable fork of Anthropic's Claude Code CLI with enterprise features
triggers
["how do I use Claude Code Best","set up CCB with custom API provider","configure claude code best features","debug claude code best project","use pipe IPC in CCB","enable langfuse monitoring in claude code","set up remote control for claude code","use web search in claude code best"]
Claude Code Best (CCB) is a reverse-engineered, production-ready implementation of Anthropic's Claude Code CLI. It's written in TypeScript, runs on Bun or Node.js, and provides enterprise-grade features including multi-instance orchestration, ACP protocol support, Langfuse monitoring, remote control, web search, voice mode, and computer/browser automation.
What It Does
CCB is an AI coding agent terminal interface that:
Runs Claude (or compatible models) in your terminal with full file system access
Supports multi-instance coordination via Pipe IPC and LAN discovery
Integrates with Zed, Cursor, and other IDEs via ACP protocol
Offers web search, voice input, computer/browser control
Works with any Anthropic-compatible API provider (OpenAI, Gemini, etc.)
Installation
From NPM (Recommended)
npm i -g claude-code-best
# Start CCB with Node.js
ccb
# Start CCB with Bun runtime
ccb-bun
# Update to latest version
ccb update
From Source
Prerequisites:
# Install Bun >= 1.3.11
curl -fsSL https://bun.sh/install | bash
exec$SHELL# Reload shell# Verify installation
bun --version
bun upgrade # Update if needed
Clone and run:
git clone https://github.com/claude-code-best/claude-code.git
cd claude-code
bun install
# Development mode (version 888)
bun run dev
# Build for production
bun run build
# Run built version
node dist/cli.js
# or
bun dist/cli.js
Configuration
Login to API Provider
On first run, enter /login in the REPL:
ccb
# In REPL:
/login
Choose provider type:
Anthropic Compatible - any Claude-compatible API
OpenAI Compatible - OpenAI or compatible services
Gemini Compatible - Google Gemini API
Required fields:
Field
Description
Example
Base URL
API endpoint
https://api.anthropic.com
API Key
Auth token
$ANTHROPIC_API_KEY
Haiku Model
Fast model
claude-haiku-4-5-20251001
Sonnet Model
Balanced model
claude-sonnet-4-6
Opus Model
Premium model
claude-opus-4-6
Use Tab/Shift+Tab to navigate, Enter to confirm.
Environment Variables
# Enable features via FEATURE_<NAME>=1
FEATURE_BUDDY=1 ccb
# Remote control
CLAUDE_BRIDGE_BASE_URL=https://remote-control.claude-code-best.win/ \
CLAUDE_BRIDGE_OAUTH_TOKEN=$YOUR_TOKEN \
ccb --remote-control
# Langfuse monitoring
LANGFUSE_PUBLIC_KEY=$YOUR_KEY \
LANGFUSE_SECRET_KEY=$YOUR_SECRET \
LANGFUSE_HOST=https://cloud.langfuse.com \
ccb
# Poor mode (reduce API calls)
ccb # then type /poor in REPL
Key Commands
In REPL
/login # Configure API provider
/pipes # Show active pipe connections
/poor # Toggle poor mode (reduce costs)
/dream # Organize memory files
/voice doubao # Enable voice input
/teach-me <topic> # Interactive learning about CCB architecture# Examples:
/teach-me Claude Code architecture
/teach-me React Ink terminal rendering --level beginner
/teach-me Tool system --resume
CLI Flags
# Start with remote control
ccb --remote-control
# Enable channels (external notifications)
ccb --channels plugin:name@marketplace
# Debug mode with inspector
bun run dev:inspect
# Then attach VS Code debugger (F5 → "Attach to Bun (TUI debug)")
// Enabled automatically when API keys are setexportBING_SEARCH_API_KEY=$YOUR_BING_KEY
# or
exportBRAVE_SEARCH_API_KEY=$YOUR_BRAVE_KEY
ccb
# In session, ask: "search for latest TypeScript features"
Langfuse Monitoring
# Configure via env varsexport LANGFUSE_PUBLIC_KEY=pk-lf-xxx
export LANGFUSE_SECRET_KEY=sk-lf-xxx
export LANGFUSE_HOST=https://cloud.langfuse.com
ccb
# Every agent loop will be tracked in Langfuse dashboard
Computer Use (Screen Control)
// Requires computer-use feature enabledFEATURE_COMPUTER_USE=1 ccb
// In session:// "take a screenshot of my screen"// "click on the file menu"// "type 'hello world' in the editor"
Chrome Automation
# Install chrome-use MCP server first
npx @modelcontextprotocol/create-server chrome-use
# Configure in CCB
ccb
# In REPL: configure MCP server path# Usage in session:# "open chrome and navigate to github.com"# "fill out the login form with my credentials"# "scrape the table data from this page"
// .vscode/launch.json (already configured){"configurations":[{"name":"Attach to Bun (TUI debug)","type":"bun","request":"attach","url":"ws://localhost:8888"}]}
Steps:
Terminal: bun run dev:inspect
Set breakpoints in src/
VS Code: F5 → Select "Attach to Bun (TUI debug)"
Common Issues
Installation Fails
# Clear old versions
npm rm -g claude-code-best
# Install specific version
npm i -g claude-code-best@5.0.0
# If Bun install has issues, use npm
npm i -g claude-code-best
Bun Not Found After Install
# macOS/Linux - reload shellexec$SHELL# Or manually sourcesource ~/.zshrc # or ~/.bashrc# Windows - reopen PowerShell
Feature Not Working
# Check feature flags are set
FEATURE_NAME=1 ccb
# Example for all features:
FEATURE_BUDDY=1 \
FEATURE_FORK_SUBAGENT=1 \
FEATURE_WEB_SEARCH=1 \
ccb
API Connection Issues
# Verify credentials in REPL
/login
# Re-enter Base URL and API Key# Test with simple request# In session: "what's 2+2"
Build Errors
# Update Bun to latest
bun upgrade
# Clean installrm -rf node_modules bun.lockb
bun install
# Rebuild
bun run build
Remote Control Not Connecting
# Verify env vars are exportedecho$CLAUDE_BRIDGE_BASE_URLecho$CLAUDE_BRIDGE_OAUTH_TOKEN# Test with official hosted version
CLAUDE_BRIDGE_BASE_URL=https://remote-control.claude-code-best.win/ \
CLAUDE_BRIDGE_OAUTH_TOKEN=test-my-key \
ccb --remote-control
Advanced Configuration
Multi-Instance Pipe IPC
# Terminal 1 (main instance)
ccb
# Terminal 2 (sub instance, auto-discovers main)
ccb
# In main REPL:
/pipes # Shows connected instances# Shift+↓ to broadcast message to all pipes
LAN Cross-Machine Discovery
# Machine A
FEATURE_LAN_DISCOVERY=1 ccb
# Machine B (same network)
FEATURE_LAN_DISCOVERY=1 ccb
# Instances automatically discover and connect
Channels (External Notifications)
# Install channel plugin (e.g., Slack)
ccb --channels plugin:slack@marketplace
# Configure webhook in REPL# Now external events can push messages into session
Custom Memory Optimization
# In REPL, manually trigger memory organization
/dream
# Or configure auto-dream
FEATURE_AUTO_DREAM=1 ccb