curl -fsSL \
https://raw.githubusercontent.com/claudianus/clco-helper/main/scripts/install.sh | sh
clco
Claude Code local routing dashboard
clco-helper
The local dashboard that lets Claude Code use any AI model. Pick a provider, choose a model route, and launch — all from the terminal.
Fast start
Install and run
Install then run clco to pick your provider, choose a model route, and launch Claude Code in one flow.
bun install -g clco-helper
clco
powershell -NoProfile -ExecutionPolicy Bypass `
-Command "irm .../install.ps1 | iex"
clco
bunx --bun clco-helper
npx clco-helper
What it does
One proxy for every Claude Code route
Passthrough Proxy
Anthropic-compatible providers keep Claude Code request/response format intact. Zero translation overhead — streaming, tool use, system prompts, and thinking blocks pass through natively. Works with Anthropic API clones.
OpenAI Translator
Translates between Anthropic Messages API and OpenAI Chat Completions API in real time for 15+ providers. Converts tool definitions, streaming chunks, thinking tokens, and usage counts bidirectionally.
Route Mesh
Intelligent traffic spreader that monitors rate limits, timeouts, and concurrency across multiple models and providers. Auto-shifts traffic when providers throttle — your session stays alive under pressure.
Tier Mapping
Map Claude Code's Opus, Sonnet, Haiku tiers to any provider and model combination. Each tier independently configurable with per-provider API keys, rate limits, and retry policies.
Live Dashboard
Real-time TUI dashboard: active routes, tier mappings, token usage, latency, error rates, and provider health. Inspect headers, retries, and cost per session — color-coded for instant clarity.
Web Search MCP
Add a free, zero-config web search MCP server to Claude Code from the MCP screen. DuckDuckGo, Brave Search, and SearXNG backends — search, fetch, and cite sources via MCP protocol.
Multi-account Vault
Securely store multiple API keys per provider with per-account quota tracking and automatic rotation on rate limit. Encrypted at rest on your machine.
Claude Settings Manager
View, edit, backup, and restore Claude Code settings from the TUI. Auto-backup before changes, one-click restore — no manual JSON editing.
Deep Research Packs
Pre-configured MCP server packs for arXiv, PubMed, Semantic Scholar, and web crawling — install from the MCP screen with auto-detection of Python/uvx/node.
mattpocock/skills
One-click install the mattpocock/skills collection to boost Claude Code capabilities. From TOOLS → Install Skills in the TUI — zero config, fully automatic.
plug & play tools
MCP Server Packs — one toggle, full capability
Pre-configured MCP servers that auto-detect your environment. No config files, no manual setup — just toggle on from the TUI.
bunx clco-deep-research-mcp
4-in-1 bundle
API key required
GitHub token
API key required
Chromium auto-install
local SQLite
zero-config
quick answers
Frequently asked questions
Does clco-helper modify Claude Code?
No. clco-helper does not patch, modify, or wrap Claude Code binaries. It uses documented settings and a local proxy daemon.
Which AI providers are supported?
30+ providers across three integration modes: Anthropic-compatible, OpenAI-compatible, and native adapters (Codex OAuth, Gemini, Vertex, Bedrock).
Can I use multiple AI accounts?
Yes. Store multiple API keys per provider with usage tracking and automatic rotation on rate limit. Keys are encrypted at rest.
Does it work with Claude Code updates?
Yes. clco-helper has a built-in Claude Code update checker and self-updater in the RUN menu. Checks npm with one-hour cache.
Is there telemetry or data collection?
None. clco-helper runs entirely on your machine. No analytics, no telemetry, no usage data sent anywhere. Outbound connections only go to your configured AI providers.
Windows / Linux / macOS?
All three. macOS/Linux via curl or npm/bun. Windows via PowerShell install script or npm. WSL, Git Bash, and native PowerShell all supported.
Supported paths
30+ providers, three integration modes
Full provider list
Featured providers
Local first
Claude Code unchanged, routes under your control
clco-helper does not patch Claude Code binaries. It uses documented ~/.claude/settings.json settings and a local daemon to manage provider/model routes. Writes backups before any change and can restore from the menu.
Claude Code → clco:8080 → Codex / GPT-5.5
request.complete · 0 errors · statusLine synced