CCBUD

Coding CLI Buddy

Point Claude Code at any Anthropic-compatible provider — one click, all local.

Installation · Quick Start · How it works

English · 简体中文

CCBUD (cc coding CLI + bud buddy) is a cross-platform desktop app that runs a tiny local gateway between Claude Code and any Anthropic-compatible provider — Kimi, DeepSeek, GLM, MiMo and more. Add your providers once, switch with a single click, and let CCBUD wire up Claude Code for you. You never touch an environment variable.

• One-click Connect — CCBUD writes ~/.claude/settings.json for you, and restores it exactly when you disconnect.
• Switch in a click — keep many providers side by side; tap a card to switch instantly.
• Automatic model mapping — Claude's default model names are routed to the active provider's models for you.
• Stays on your machine — the gateway binds to 127.0.0.1; nothing leaves your computer.

📥 Installation

Download (recommended)

Grab the latest build for your platform from the Releases page:

macOS Gatekeeper: if the first launch is blocked, right-click the app → Open, or run
xattr -dr com.apple.quarantine /Applications/ccbud.app.

Homebrew (macOS)

brew install --cask ccbud/tap/ccbud   # first install
brew upgrade --cask ccbud             # later upgrades

Staying up to date

CCBUD checks for new releases on launch (and daily) and surfaces them under Settings → About & Updates. App updates are delivered through the Tauri updater when available; Homebrew users can also run brew upgrade --cask ccbud.

Build from source

git clone https://github.com/ccbud/ccbud.git
cd ccbud
npm install
npm start                 # run the Tauri app in development

# package a distributable for your OS:
npm run dist:mac          # or: dist:win · dist:linux

🚀 Quick Start

1 · Add a provider
Open CCBUD, click +, pick a preset (GLM · DeepSeek · MiMo · Kimi …) or enter a custom base URL, and paste your API key.

2 · Connect
Hit the big Connect button. CCBUD points Claude Code at the local gateway by writing env.ANTHROPIC_BASE_URL and env.ANTHROPIC_AUTH_TOKEN into ~/.claude/settings.json — backing up whatever was there before.

3 · Use Claude Code
Start a new Claude Code session and you're on your chosen provider. Switch anytime by clicking another card; hit Disconnect to restore your original settings, untouched. Keep CCBUD running while you work — closing the window tucks it into the menu bar / tray.

🔧 How it works

Claude Code ──(ANTHROPIC_BASE_URL = 127.0.0.1:port)──▶ CCBUD gateway ──▶ active provider
                                                          │
                                          · swaps in the upstream's real token
                                          · routes / maps model names
                                          · rewrites the model name in the response
                                            back to the name the client asked for

CCBUD never edits your providers' own configs — it just runs a forwarding server on your machine. When you use a model alias, the gateway rewrites the model field in the response (including the streaming message_start) back to the alias, so Claude Code always sees the name it requested. If you don't set ANTHROPIC_MODEL, Claude's default claude-* model names are mapped to the active provider's main model (with haiku → its small model).

📸 A look inside

Switch providers and map models in a click	Watch every request flow through, live
Usage at a glance — even from the menu bar	Redact sensitive data before it ever leaves

📄 License

Released under the GPL-3.0 license.