CLIProxy API Integration
CCS uses CLIProxyAPI to provide OAuth authentication for third-party AI providers. The CLIProxy page offers comprehensive provider management and model configuration.
Overview
Supported Providers
| Provider | Status | Description |
|---|
| Google Gemini | OAuth | Access Gemini models via Google OAuth |
| Codex | OAuth | Code generation models |
| Antigravity | OAuth | Multi-account routing with 14+ accounts |
| Qwen Code | OAuth | Alibaba’s code models |
| iFlow | OAuth | Alternative AI routing |
| Claude | OAuth | Anthropic Claude with quota tracking |
| GitHub Copilot (ghcp) | OAuth (Device Code) | Copilot with premium quota tracking |
Quota-Supported Providers
The following providers support quota display via ccs cliproxy quota:
agy · codex · gemini · claude · ghcp
CLIProxy Service Status
The sidebar displays real-time service status:
- Status: Up/Down indicator with colored dot
- Port: Local proxy port (default: 8317)
- Sessions: Active connection count
- Uptime: Service running duration
- Version: Current CLIProxy version
Provider Configuration
Model Mapping
Configure which models handle each tier:
| Tier | Description | Use Case |
|---|
| Default Model | Used when no tier specified | General requests |
| Opus (Most capable) | Complex reasoning | Difficult problems |
| Sonnet (Balanced) | Speed + capability | Most tasks |
| Haiku (Fast) | Quick responses | Simple queries |
Presets
One-click presets for common configurations:
- Claude Opus 4.5 Thinking: Map all tiers to Opus thinking model
- Claude Sonnet 4.5 Thinking: Map to Sonnet thinking model
- Custom: Create your own mapping
Account Management
For multi-account providers like Antigravity:
- View connected accounts with last-used timestamps
- Set default account with star indicator
- Add/remove accounts via three-dot menu
Target Controls
Each provider and variant supports a target field to route execution to alternative CLIs:
| Target | CLI | Description |
|---|
claude | Claude Code | Default target |
droid | Factory Droid | Alternative agent runtime |
# Create variant with target
ccs cliproxy create my-droid --provider gemini --target droid
# Edit existing variant target
ccs cliproxy edit my-droid --target droid
cliproxy:
variants:
my-droid:
provider: gemini
target: droid # Routes to Factory Droid CLI
Raw Configuration
The right panel shows live JSON configuration:
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:8317/api/provider/agy",
"ANTHROPIC_AUTH_TOKEN": "",
"ANTHROPIC_DEFAULT_MODEL": "gemini-claude-opus-4-5-thinking",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-claude-opus-4-5-thinking",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-claude-opus-4-5-thinking",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3-flash-preview"
}
}
- Valid JSON indicator confirms syntax
- Global env vars injected at runtime
Backend Variants
CCS supports two CLIProxy backends with different provider capabilities:
| Backend | Description | Additional Providers |
|---|
| Original | CLIProxyAPI | Gemini, Codex, Antigravity, Qwen, iFlow |
| Plus (default) | CLIProxyAPIPlus | All above + Kiro, GitHub Copilot |
Provider Compatibility
| Provider | Original | Plus | Notes |
|---|
| gemini, codex, agy | ✓ | ✓ | Works on both backends |
| qwen, iflow | ✓ | ✓ | Works on both backends |
| kiro | ✗ | ✓ | Requires Plus backend |
| ghcp | ✗ | ✓ | Requires Plus backend |
Configuration
Default: Backend defaults to plus for maximum provider support.
config.yaml:
cliproxy:
backend: plus # original | plus (default: plus)
ccs gemini --backend=original # Force original backend
ccs kiro --backend=plus # Required for kiro/ghcp
Backend-specific binaries are stored separately in ~/.ccs/bin/original/ and ~/.ccs/bin/plus/ to prevent conflicts.
Quick Setup
# Start CLIProxy
ccs config
# Navigate to CLiProxy → Quick Setup
CLIProxyAPI is an open-source project. See GitHub for implementation details. 
