cclauncher

CCL - Claude Code Launcher

Built with Synthetic.new API

A lightweight Go launcher for Claude Code that enables switching between LLM providers without complex configuration. Providers expose an Anthropic-compatible Messages API, so Claude Code works natively with each one.

Installation

go install github.com/dotcommander/cclauncher/cmd/ccl@latest

Or build from source:

git clone https://github.com/dotcommander/cclauncher
cd cclauncher
just install

Ensure ~/go/bin is in your PATH.

Usage

ccl                    # Default provider (Synthetic/Kimi-K2.5)
ccl -p deepseek        # DeepSeek-V3.2 via Synthetic.new
ccl -p kimi2           # Kimi-K2.5 via Synthetic.new
ccl -p minimax         # MiniMax-M2 via Synthetic.new
ccl -p qwen            # Qwen3-VL-235B via Synthetic.new
ccl -p qwen3-coder     # Qwen3-Coder-480B via Synthetic.new
ccl -p claude          # Anthropic Claude (OAuth)
ccl -p claude2         # Anthropic Claude (second account)
ccl -p zai             # Z.ai (GLM-4.7)
ccl -p llamabarn       # LlamaBarn (local)
ccl version            # Show version information
ccl update             # Update to latest version

All arguments after the provider flag are passed through to claude.

Providers

Configuration

API keys can be set via environment variables:

export SYNTHETIC_API_KEY="..."      # Synthetic.new providers
export ZAI_API_KEY="..."            # Z.ai
export LLAMABARN_API_KEY="..."      # LlamaBarn
export CLAUDE2_OAUTH_TOKEN="..."    # Claude second account

Or use per-provider overrides with the CCL_<PROVIDER>_API_KEY format:

export CCL_SYNTHETIC_API_KEY="..."  # Override for -p synthetic, deepseek, etc.
export CCL_ZAI_API_KEY="..."        # Override for -p zai

Priority order:

1. CCL_<PROVIDER>_API_KEY environment variable (highest)
2. Config file authToken field (with ${VAR} interpolation)
3. Default value from built-in provider template

Optional config file at ~/.config/cclauncher/config.yaml with ${VAR:-default} interpolation. See examples/config.yaml.example.

CCL validates authentication before launching and will error if the selected provider requires but lacks credentials.

Architecture

CCL sets the appropriate ANTHROPIC_* environment variables for the chosen provider, then launches the claude CLI. All providers use the Anthropic Messages API format natively, so no proxy or API translation is needed.

Development

just build    # Build ./ccl
just install  # Build + symlink to ~/go/bin/ccl
just test     # Run tests
just lint     # golangci-lint
just fmt      # gofmt
just dev      # go run (no build)
just clean    # Remove artifacts

License

MIT