Skip to content

Icarus603/claude-code

Repository files navigation

Claude Code Best

繁體中文 | 简体中文

Release CI Last Commit Stars Platforms Bun TypeScript

Models Claude Subscription Anthropic API Anthropic Compatible OpenAI Compatible ChatGPT Codex Gemini

Terminal coding agent. Single binary ccb. Talks to Anthropic (OAuth or API key), Anthropic-compatible endpoints, ChatGPT Codex (OAuth), OpenAI-compatible endpoints (Ollama, DeepSeek, vLLM, …), and Gemini through one agent loop. macOS, Linux, Windows.

Solo-maintained public derivative of Claude Code; baseline reconstructed from the v2.1.88 sourcemap (2026-03-31). See ATTRIBUTION.md. Not affiliated with Anthropic.


Install

macOS / Linux (also Git Bash / WSL):

curl -fsSL https://raw.githubusercontent.com/Icarus603/claude-code/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/Icarus603/claude-code/main/install.ps1 | iex

No Node, no Bun, no package manager required. Auto-updates on every startup.


Quick Start

Open a terminal — on macOS press ⌘ Space, type Terminal, hit Enter. On Linux press Ctrl Alt T. On Windows open PowerShell from the Start menu.

Then run:

ccb

That drops you into an interactive REPL. Type any task in plain English and press Enter:

> refactor the auth module to use async/await
> explain what this codebase does
> write tests for src/utils/parser.ts

One-shot mode (no REPL, prints and exits):

ccb -p "what does package.json do?"

Continue the last conversation:

ccb --continue

Inside the REPL:

Key Action
Enter Send message
Shift+Enter New line
Escape Cancel current response
/help Show all slash commands
Ctrl+C Exit

Windows ARM64 is not supported. Use x64 under emulation, or WSL.


Learn ccb in 10 minutes — /powerup

New here? Inside the REPL, type:

/powerup

Ten short interactive lessons walk you through what makes ccb worth using — @ file mentions, permission modes, /rewind and Esc-Esc to undo, background sessions, CLAUDE.md, MCP, skills + hooks, /fork for parallel branches, model dialing, and multi-provider switching. Open one, try it, mark it done. The home banner tracks progress until you've finished all ten.


Contributing

Requires Bun ≥ 1.3.

git clone https://github.com/Icarus603/claude-code.git
cd claude-code
bun install
bun run dev        # hot-reload REPL
bun test
bun run doctor:arch
  • doctor:arch and bun test must pass. No --no-verify.
  • Commit messages explain why.
  • No npm publishing — binary-only by design.
  • PRs are reviewed by one maintainer at human pace. No SLA.
  • Open an Issue before non-trivial PRs.

Uninstall

# macOS / Linux
rm -rf ~/.local/share/ccb ~/.local/bin/ccb

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\ccb"

Issues · Official Claude Code