claude-code-best

Skill by ara.so — Claude Code Skills collection.

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
Provides enterprise monitoring (Langfuse, Sentry, GrowthBook)
Offers web search, voice input, computer/browser control
Works with any Anthropic-compatible API provider (OpenAI, Gemini, etc.)

Installation

From NPM (Recommended)

bash

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:

bash

# 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:

bash

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:

bash

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

bash

# 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

bash

/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

bash

# 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)")

Usage Patterns

Basic Usage

typescript

// CCB is primarily a CLI tool, but internally uses these patterns:

// 1. Tool execution (from src/tools/)
import { executeShellCommand } from './tools/bash';

const result = await executeShellCommand({
  command: 'ls -la',
  workingDir: process.cwd()
});

// 2. Multi-instance coordination (Pipe IPC)
import { PipeManager } from './ipc/pipe-manager';

const pipeManager = new PipeManager();
await pipeManager.broadcast({
  type: 'message',
  content: 'Task complete'
});

// 3. Memory management
import { MemoryService } from './memory/service';

const memory = new MemoryService();
await memory.extract({
  sessionId: 'current',
  content: 'User prefers TypeScript over JavaScript'
});

Remote Control Setup

bash

# Self-hosted Docker setup
docker run -d \
  -p 3000:3000 \
  -e OAUTH_SECRET=$YOUR_SECRET \
  claude-code-remote-control

# Client connection
CLAUDE_BRIDGE_BASE_URL=http://localhost:3000 \
CLAUDE_BRIDGE_OAUTH_TOKEN=$YOUR_TOKEN \
ccb --remote-control

Web Search Integration

typescript

// Enabled automatically when API keys are set
export BING_SEARCH_API_KEY=$YOUR_BING_KEY
# or
export BRAVE_SEARCH_API_KEY=$YOUR_BRAVE_KEY

ccb
# In session, ask: "search for latest TypeScript features"

Langfuse Monitoring

bash

# Configure via env vars
export 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)

typescript

// Requires computer-use feature enabled
FEATURE_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

bash

# 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"

Development Patterns

Project Structure

claude-code/
├── src/
│   ├── cli.ts              # Entry point
│   ├── tools/              # Built-in tools (bash, read_file, etc.)
│   ├── ipc/                # Pipe IPC for multi-instance
│   ├── memory/             # Memory extraction & retrieval
│   ├── providers/          # API provider adapters
│   ├── ui/                 # React Ink terminal components
│   └── features/           # Feature flag implementations
├── dist/                   # Build output (450+ chunks)
├── build.ts                # Bun build script
└── package.json

Adding a Custom Tool

typescript

// src/tools/my-custom-tool.ts
import { z } from 'zod';

export const MyCustomToolSchema = z.object({
  input: z.string().describe('Tool input parameter')
});

export async function executeMyCustomTool(
  params: z.infer<typeof MyCustomToolSchema>
): Promise<string> {
  // Your tool logic
  return `Processed: ${params.input}`;
}

// Register in src/tools/index.ts
export const tools = [
  {
    name: 'my_custom_tool',
    description: 'Does something useful',
    input_schema: MyCustomToolSchema,
    execute: executeMyCustomTool
  },
  // ... other tools
];

Debugging in VS Code

json

// .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

bash

# 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

bash

# macOS/Linux - reload shell
exec $SHELL

# Or manually source
source ~/.zshrc  # or ~/.bashrc

# Windows - reopen PowerShell

Feature Not Working

bash

# 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

bash

# Verify credentials in REPL
/login
# Re-enter Base URL and API Key

# Test with simple request
# In session: "what's 2+2"

Build Errors

bash

# Update Bun to latest
bun upgrade

# Clean install
rm -rf node_modules bun.lockb
bun install

# Rebuild
bun run build

Remote Control Not Connecting

bash

# Verify env vars are exported
echo $CLAUDE_BRIDGE_BASE_URL
echo $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

bash

# 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

bash

# Machine A
FEATURE_LAN_DISCOVERY=1 ccb

# Machine B (same network)
FEATURE_LAN_DISCOVERY=1 ccb

# Instances automatically discover and connect

Channels (External Notifications)

bash

# 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

bash

# In REPL, manually trigger memory organization
/dream

# Or configure auto-dream
FEATURE_AUTO_DREAM=1 ccb

Resources

Homepage: https://ccb.agent-aura.top/
Documentation: https://ccb.agent-aura.top/docs/
GitHub: https://github.com/claude-code-best/claude-code
Discord: https://discord.gg/uApuzJWGKX
Feature Docs: See
```
docs/features/
```
in repository

Example Session

bash

$ ccb
Claude Code Best v5.0.0

You: I need to analyze all TypeScript files in src/ and create a dependency graph

claude-code-best

NPX Install

Tags

SKILL.md Content

claude-code-best

What It Does

Installation

From NPM (Recommended)

From Source

Configuration

Login to API Provider

Environment Variables

Key Commands

In REPL

CLI Flags

Usage Patterns

Basic Usage

Remote Control Setup

Web Search Integration

Langfuse Monitoring

Computer Use (Screen Control)

Chrome Automation

Development Patterns

Project Structure

Adding a Custom Tool

Debugging in VS Code

Common Issues

Installation Fails

Bun Not Found After Install

Feature Not Working

API Connection Issues

Build Errors

Remote Control Not Connecting

Advanced Configuration

Multi-Instance Pipe IPC

LAN Cross-Machine Discovery

Channels (External Notifications)

Custom Memory Optimization

Resources

Example Session