Provider Overview

CCS supports 9 OAuth providers plus Claude accounts and API profiles (including Alibaba Coding Plan, OpenRouter, Novita, GLM, MiniMax, and more) across 3 authentication methods. This guide helps you choose the right provider for your needs.

Provider Categories

OAuth Providers

9 OAuth Providers - Zero API keys, browser or device-code loginPerfect for beginners and quick setup

Claude Accounts

Multiple Subscriptions - Isolated Claude instancesWork/personal separation, concurrent sessions

API Profiles

Direct API Access - Bring your own keysCustom endpoints, self-hosted models

Quick Decision Guide

Choose your path:

New to CCS? Start with OAuth

Recommended: Gemini (free tier available)

ccs gemini "your first query"
# Browser opens → Sign in → Start coding

No API keys needed
Free tier available (Gemini 2.5 Pro)
Auto token refresh
Multi-account support

Have Claude Pro/Team? Use Claude Accounts

Best for: Multiple Claude subscriptions

ccs auth create work
ccs auth create personal
# Use both simultaneously in different terminals

Work/personal isolation
Concurrent sessions
Team collaboration
Existing subscription leverage

Need Custom Endpoints? Use API Profiles

Best for: Self-hosted models, custom APIs

ccs config
# Add API profile with custom endpoint + API key

Full control over endpoints
Self-hosted model support
Custom headers/authentication
Built-in presets such as OpenRouter, Novita, and Alibaba

Authentication Methods Comparison

Browser OAuth vs Device Code

Feature	Browser OAuth	Device Code
Setup	Browser opens automatically	Manual URL copy
Speed	Instant (3-5 seconds)	Manual (10-20 seconds)
Headless Servers	Requires `--headless` flag	Native support
Providers	Gemini, Codex, Antigravity, iFlow, Claude	GHCP, Qwen, Kimi, Kiro (default)
Token Refresh	Automatic (proactive)	Automatic (on-demand)
Best For	Local development, desktop	CI/CD, remote servers

Kiro also supports optional browser auth-code flows via --kiro-aws-authcode and --kiro-google-login, but the default flow is AWS device code. Example: OAuth Flow

ccs gemini "task"
# → Browser opens → Google login → Token cached → Session starts

Example: Device Code Flow

ccs ghcp "task"
# → Device code displayed → Copy URL/code → Token cached

All Providers Comparison

OAuth Providers (9 Total)

Google Gemini - Best for beginners

Feature	Details
Models	Gemini 3 Pro (High/Preview), Gemini 2.5 Pro, Gemini 3 Flash
Free Tier	✅ Yes (Gemini 2.5 Pro)
Auth Method	Browser OAuth (Google SSO)
Multi-Account	✅ Yes (email-based)
Model Picker	✅ Interactive `--config`
Quota Display	✅ Auto project rotation
Token Refresh	✅ Proactive (5 min before expiry)
Best For	Beginners, free tier users, fast responses

ccs gemini "your query"
ccs gemini --config           # Change model
ccs gemini --auth --add       # Add account

Full Documentation →

Kiro (AWS) - AWS device code by default, optional browser auth flows

Feature	Details
Models	Amazon CodeWhisperer (AWS)
Free Tier	✅ Yes (Builder ID)
Auth Method	AWS device code by default, plus optional auth-code/Google flows
Multi-Account	✅ Yes (filename-based)
Model Picker	❌ No (single model)
Token Import	✅ From Kiro IDE
Browser Mode	Normal (default), incognito disabled on Linux
Best For	AWS users, Kiro IDE users

ccs kiro "your query"
ccs kiro --import             # Import from Kiro IDE
ccs kiro --no-incognito       # Normal browser (Linux fix)

Full Documentation →

GitHub Copilot (GHCP) - Device-code OAuth via CLIProxy

Feature	Details
Models	GitHub Copilot models
Free Tier	❌ No (requires subscription)
Auth Method	Device code OAuth
Multi-Account	✅ Yes (GitHub username)
Device Code	✅ Built-in default flow
Quota Display	✅ Yes (`--quota`)
Best For	CI/CD, headless servers, GitHub users

# Start GHCP and complete the device-code prompt
ccs ghcp "your query"

# Check quota
ccs ghcp --quota

Full Documentation →

OpenAI Codex - OpenAI coding models via OAuth

Feature	Details
Models	GPT-5 Codex, GPT-5 Codex Mini, GPT-5.2 Codex, GPT-5.3 Codex, GPT-5.4
Free Tier	✅ Cross-plan-safe models available; paid plans unlock paid-only model IDs
Auth Method	Browser OAuth (OpenAI)
Multi-Account	✅ Yes (email-based)
Model Picker	✅ Interactive `--config`
Best For	OpenAI users who want Codex via OAuth

ccs codex "your query"
ccs codex --auth --add        # Add account

Full Documentation →

Kimi (Moonshot) - Device-code OAuth via CLIProxy

Feature	Details
Models	Kimi K2.5, Kimi K2 Thinking, Kimi K2
Auth Method	Device code OAuth
Multi-Account	✅ Yes (email-based)
Model Picker	✅ Interactive `--config`
Token Refresh	✅ Auto via CLIProxy
Best For	Moonshot users who want Kimi without an API key

ccs kimi "your query"
ccs kimi --accounts
ccs kimi --use work

Full Documentation →

Antigravity (AGY) - Premium multi-model

Feature	Details
Models	Claude Opus 4.6 Thinking (default), Claude Opus 4.6, Claude Sonnet 4.6 Thinking, Claude Sonnet 4.6, Gemini 3 Pro
Free Tier	❌ No (subscription required)
Auth Method	Browser OAuth
Multi-Account	✅ Yes (email-based)
Model Picker	✅ Interactive `--config`
Best For	Premium users, multi-model access

ccs agy "your query"
ccs agy --config              # Choose model

Full Documentation →

Claude (Anthropic) - Direct Anthropic OAuth

Feature	Details
Models	Claude models via Anthropic
Free Tier	❌ No (requires subscription)
Auth Method	Browser OAuth (Anthropic SSO)
Multi-Account	✅ Yes (email-based)
Model Picker	❌ No
Token Refresh	✅ Auto
Best For	Anthropic subscribers, direct Claude access

ccs claude "your query"
ccs claude --auth --add       # Add account

Full Documentation →

Qwen3 Coder - Specialized coding model

Feature	Details
Models	Qwen3 Coder
Free Tier	❌ No (subscription required)
Auth Method	Device code OAuth
Multi-Account	✅ Yes (email-based)
Model Picker	❌ No (single model)
Best For	Specialized coding tasks

ccs qwen "your query"

Full Documentation →

iFlow - Various models

Feature	Details
Models	Multiple models available
Free Tier	❌ No (subscription required)
Auth Method	Browser OAuth
Multi-Account	✅ Yes (email-based)
Model Picker	Check provider for details
Best For	iFlow subscribers

ccs iflow "your query"

Full Documentation →

MiniMax - Long-context specialist

Feature	Details
Models	MiniMax with 1M token context
Free Tier	❌ No (API key required)
Auth Method	API Key (via API Profiles)
Multi-Account	✅ Yes (profile-based)
Model Picker	❌ No (single model)
Context Window	1M tokens (largest available)
Best For	Large codebase analysis, document processing

# Quick setup with preset
ccs api create mm --preset mm

# Use profile
ccs mm "analyze large document"

Full Documentation →

Alibaba Coding Plan - Qwen3 Coder via API key

Feature	Details
Models	qwen3-coder-plus (default), qwen3-coder-flash
Free Tier	❌ No (API key required)
Auth Method	API Key (`sk-sp-...`)
Multi-Account	✅ Yes (profile-based)
Context Window	1M tokens
Best For	Cost-effective coding tasks, Alibaba Cloud users

# Quick setup with preset
ccs api create --preset alibaba-coding-plan

# Use default profile name
ccs albb "implement this feature"

Full Documentation →

Novita AI - Anthropic-compatible hosted endpoint

Feature	Details
Models	Default preset uses `deepseek/deepseek-v3.2`; other Novita-supported Anthropic-compatible models can be configured manually
Free Tier	❌ No (API key required)
Auth Method	API Key
Multi-Account	✅ Yes (profile-based)
Model Picker	✅ Via API Profile editor
Best For	Fast hosted setup when you want a built-in Anthropic-compatible preset

ccs api create --preset novita
ccs novita "summarize this incident"

Full Documentation →

Claude Accounts

Run multiple Claude subscriptions simultaneously with isolated sessions:

Feature	Details
Setup	`ccs auth create <profile>`
Multi-Account	✅ Unlimited profiles
Concurrent Sessions	✅ Each profile runs independently
Session Isolation	✅ Complete (credentials, history, state)
Subscription	Requires existing Claude Pro/Team
Best For	Work/personal separation, team collaboration

Example:

# Create profiles
ccs auth create work
ccs auth create personal

# Use simultaneously
ccs work "implement feature"      # Terminal 1
ccs personal "side project"        # Terminal 2 (concurrent)

Full Documentation →

API Profiles

Direct API access with custom endpoints and keys:

Feature	Details
Setup	`ccs config` → Add API profile
Custom Endpoints	✅ Full control
Self-Hosted Models	✅ Supported
API Key Management	Manual (you provide keys)
Model Configuration	Provider-dependent
Best For	Custom APIs, self-hosted models, advanced users

Example:

# Configure via dashboard
ccs config

# Add profile:
# - Name: myapi
# - Endpoint: https://api.example.com/v1/chat
# - API Key: sk-...
# - Model: custom-model-name

# Use profile
ccs myapi "your query"

Full Documentation →

Feature Matrix

All Providers Feature Comparison

Provider	Free Tier	Multi-Account	Model Picker	Quota Display	Token Refresh	Headless Mode
Gemini	✅	✅	✅	✅	✅ Proactive	✅
Kiro	✅	✅	❌	❌	✅ Auto	✅
Kimi	Varies	✅	✅	❌	✅ Auto	✅ Device Code
GHCP	❌	✅	❌	✅	✅ Auto	✅ Device Code
Codex	✅ Limited	✅	✅	✅	✅ Auto	✅
Antigravity	❌	✅	✅	✅	✅ Auto	✅
Claude	❌	✅	✅	❌	✅ Auto	✅
Qwen	❌	✅	❌	❌	✅ Auto	✅
iFlow	❌	✅	❌	❌	✅ Auto	✅
MiniMax	❌	✅	❌	❌	Manual	✅
Alibaba Coding Plan	❌	✅	❌	❌	Manual	✅
Novita AI	❌	✅	✅	❌	Manual	✅
Claude Accounts	❌	✅	❌	❌	N/A	N/A
API Profiles	Varies	✅	Varies	❌	Manual	✅

Authentication Features

Provider	Auth Method	Account ID	Token Import	Browser Control
Gemini	Browser OAuth	Email	❌	Incognito default
Kiro	Device code + optional browser auth	Filename	✅ IDE	Normal (no incognito)
Kimi	Device Code	Email	❌	N/A
GHCP	Device Code	GitHub username	❌	N/A
Codex	Browser OAuth	Email	❌	Incognito default
Antigravity	Browser OAuth	Email	❌	Incognito default
Claude	Browser OAuth	Email	❌	Incognito default
Qwen	Device Code	Email	❌	Incognito default
iFlow	Browser OAuth	Email	❌	Incognito default
MiniMax	API Key	Profile name	❌	N/A
Alibaba Coding Plan	API Key	Profile name	❌	N/A
Novita AI	API Key	Profile name	❌	N/A
Claude Accounts	OAuth (Claude)	Profile name	❌	N/A
API Profiles	API Key	Profile name	❌	N/A

Provider Selection Guide

By Use Case

Beginner (First Time)

→ Gemini (free tier)

No API keys needed
Free tier available
Easy setup (browser only)
Good documentation

Work/Personal Separation

→ Claude Accounts

Isolated sessions
Concurrent use
Separate subscriptions
Professional workflow

CI/CD Pipeline

→ GHCP (device code)

Headless-friendly
No browser needed
Scriptable auth
Quota management

Free Tier Only

→ Gemini or Kiro

Gemini: 2.5 Pro (Google free)
Kiro: CodeWhisperer (AWS Builder ID)

Premium Models

→ Antigravity

Claude Opus 4.6 Thinking
Claude Sonnet 4.6
Gemini 3 Pro
Interactive model picker

Long-Context Tasks

→ MiniMax

1M token context window
Large codebase analysis
Document processing
API key authentication

Self-Hosted Models

→ API Profiles

Custom endpoints
Local LLMs
Full control
Privacy-focused

AWS Ecosystem

→ Kiro

CodeWhisperer integration
AWS Builder ID device code by default
IDE token import
Free Builder ID

OpenAI Workflow

→ Codex

Cross-plan-safe GPT-5 Codex defaults
GPT-5.3 Codex / GPT-5.2 Codex when available
OpenAI ecosystem

Alibaba Cloud / Cost-Efficient Coding

→ Alibaba Coding Plan

Qwen3 Coder Plus/Flash
1M token context
$1.00/$ 5.00 per M tokens
ccs api create --preset alibaba

By Authentication Preference

Prefer Browser OAuth?

Gemini, Codex, Antigravity, iFlow, Claude, plus optional Kiro auth-code / Google flows

Prefer Device Code?

GHCP, Qwen, Kimi, Kiro (default)

Prefer API Keys?

API Profiles

Prefer No External Auth?

Claude Accounts (uses Claude CLI’s built-in OAuth)

By Cost Model

Free Tier Available:

Gemini - Gemini 2.5 Pro (free Google account)
Kiro - CodeWhisperer (AWS Builder ID)

Requires Subscription:

Gemini 3 Pro - Paid Google account
GHCP - GitHub Copilot subscription
Codex paid-only models - Paid Codex plan required for gpt-5.2-codex, gpt-5.3-codex, or gpt-5.4
Antigravity - Subscription
Claude - Anthropic subscription
Qwen - Subscription
iFlow - Subscription

Use Existing Subscription:

Claude Accounts - Claude Pro/Team

Bring Your Own:

API Profiles - You manage costs
Alibaba Coding Plan - Qwen3 Coder (from $0.30/M input)
Novita AI - Anthropic-compatible preset with hosted routing
OpenRouter - 300+ models, pay per use

Multi-Account Management

All OAuth providers support multiple accounts:

Email-Based (Most Providers)
Username-Based (GHCP)
Filename-Based (Kiro)
Profile-Based (Claude)

Gemini, Codex, Antigravity, Qwen, iFlow

# Add account
ccs gemini --auth --add

# List accounts
ccs gemini --accounts

# Output:
# * john (john@gmail.com) - default
#   work (alice@company.com)

# Switch account
ccs gemini --use work

# Rename account
ccs gemini --nickname personal

Account ID: Email prefix (john@gmail.com → john)

GitHub Copilot

# Add account
ccs ghcp --auth --add

# List accounts
ccs ghcp --accounts

# Output:
# * kaitranntt (GitHub) - default
#   company-bot (GitHub)

# Switch account
ccs ghcp --use company-bot

Account ID: GitHub username

Kiro (AWS CodeWhisperer)

# Add account
ccs kiro --auth --add

# List accounts
ccs kiro --accounts

# Output:
# * github-ABC123 (default)
#   github-XYZ789

# Switch account
ccs kiro --use github-XYZ789

Account ID: Extracted from token filename

Claude Accounts

# Create profiles
ccs auth create work
ccs auth create personal

# List profiles
ccs auth list

# Use profiles
ccs work "task"
ccs personal "task"

# Set default
ccs auth default work

Account ID: Profile name (custom)

Storage Locations

All providers store data in ~/.ccs/:

~/.ccs/
├── cliproxy/
│   ├── auth/                           # OAuth tokens
│   │   ├── gemini-john@gmail.com.json
│   │   ├── kiro-github-ABC123.json
│   │   ├── ghcp-kaitranntt.json
│   │   └── ...
│   ├── accounts.json                   # Account registry (all OAuth providers)
│   └── config.yaml                     # CLIProxy configuration
├── instances/                           # Claude account profiles
│   ├── work/
│   └── personal/
├── gemini.settings.json                 # Provider-specific settings
├── agy.settings.json
└── config.yaml                          # Global CCS config

Common Commands (All Providers)

Authentication

# Initial auth (browser opens)
ccs <provider> --auth

# Add new account (preserves existing)
ccs <provider> --auth --add

# Logout (clear tokens)
ccs <provider> --logout

# Headless mode (manual URL)
ccs <provider> --headless

Account Management

# List all accounts
ccs <provider> --accounts

# Switch default account
ccs <provider> --use <nickname>

# Rename current account
ccs <provider> --nickname <new-name>

Execution

# Execute query (interactive session)
ccs <provider> "your prompt"

# One-shot mode
ccs <provider> "quick question" --one-shot

Configuration

# Provider-specific config (if available)
ccs <provider> --config

# Global dashboard
ccs config

Provider-Specific Features

Gemini Unique Features

✅ Proactive token refresh (5 min before expiry)
✅ Auto project rotation on quota exceeded
✅ Interactive model picker (4 models)
✅ Free tier (Gemini 2.5 Pro)

Kiro Unique Features

✅ Token import from Kiro IDE (--import)
✅ Browser mode control (--no-incognito)
✅ AWS Builder ID device code by default
✅ Free tier (Builder ID)

GHCP Unique Features

✅ Built-in device-code OAuth flow
✅ Quota display (--quota)
✅ Device code for headless servers
✅ GitHub integration

Antigravity Unique Features

✅ Multi-model access (Claude + Gemini)
✅ Claude Opus 4.6 Thinking (latest flagship)
✅ Claude Sonnet 4.6 Thinking
✅ Interactive model picker

Claude Accounts Unique Features

✅ Concurrent sessions (different profiles)
✅ Complete session isolation
✅ Unlimited profiles
✅ Work/personal separation

Next Steps

Gemini Provider

Free tier, proactive refresh, 4 models

Kiro Provider

AWS CodeWhisperer, IDE import, free tier

GHCP Provider

Dual auth, device code, quota display

Codex Provider

GPT-5 Codex defaults, paid-plan models, plan-aware fallbacks

Antigravity Provider

Claude Opus 4.6 Thinking, multi-model picker

Claude Provider

Direct Anthropic OAuth access

Qwen Provider

Specialized coding model

iFlow Provider

Various models available

MiniMax Provider

1M context window, long-context tasks

Novita Provider

Anthropic-compatible preset, default deepseek/deepseek-v3.2

Claude Accounts

Multiple subscriptions, concurrent sessions

API Profiles

Custom endpoints, self-hosted models

Alibaba Coding Plan

Qwen3 Coder, 1M context, cost-effective

FAQ

Can I use multiple providers simultaneously?

Yes! Each provider runs isolated sessions:

# Terminal 1
ccs gemini "task A"

# Terminal 2
ccs codex "task B"

# No conflicts

Which provider is best for beginners?

Gemini - Free tier available, easy setup, no API keys needed:

ccs gemini "your first query"
# Browser opens → Google login → Start coding

Can I switch between accounts without re-authenticating?

Yes! All OAuth providers support multi-account with instant switching:

ccs gemini --use work      # Switch to work account
ccs gemini --use personal  # Switch to personal
# No re-auth needed

Which providers work without a browser (CI/CD)?

GHCP - Built-in device-code flow
All OAuth Providers - Headless mode (--headless, copy URL manually)
API Profiles - No browser needed (API keys only)

Can I use the same account across multiple machines?

Yes for OAuth providers - tokens sync automatically if you:

Copy ~/.ccs/cliproxy/auth/ to new machine
Re-authenticate on new machine (tokens specific to each machine)

Better: Re-auth on each machine for security.

Which providers support concurrent sessions?

Different providers: Always concurrent (isolated)
Same provider, different accounts: Concurrent (if supported by backend)
Claude Accounts: Concurrent (different profiles)
Same provider, same account: Not recommended (session conflicts)

Getting Started

Providers

Features

Tutorials

​Provider Overview

​Provider Categories

OAuth Providers

Claude Accounts

API Profiles

​Quick Decision Guide

​Authentication Methods Comparison

​Browser OAuth vs Device Code

​All Providers Comparison

​OAuth Providers (9 Total)

​Claude Accounts

​API Profiles

​Feature Matrix

​All Providers Feature Comparison

​Authentication Features

​Provider Selection Guide

​By Use Case

Beginner (First Time)

Work/Personal Separation

CI/CD Pipeline

Free Tier Only

Premium Models

Long-Context Tasks

Self-Hosted Models

AWS Ecosystem

OpenAI Workflow

Alibaba Cloud / Cost-Efficient Coding

​By Authentication Preference

​By Cost Model

​Multi-Account Management

​Storage Locations

​Common Commands (All Providers)

​Authentication

​Account Management

​Execution

​Configuration

​Provider-Specific Features

​Gemini Unique Features

​Kiro Unique Features

​GHCP Unique Features

​Antigravity Unique Features

​Claude Accounts Unique Features

​Next Steps

Gemini Provider

Kiro Provider

GHCP Provider

Codex Provider

Antigravity Provider

Claude Provider

Qwen Provider

iFlow Provider

MiniMax Provider

Novita Provider

Claude Accounts

API Profiles

Alibaba Coding Plan

​FAQ

Provider Overview

Provider Categories

Quick Decision Guide

Authentication Methods Comparison

Browser OAuth vs Device Code

All Providers Comparison

OAuth Providers (9 Total)

Claude Accounts

API Profiles

Feature Matrix

All Providers Feature Comparison

Authentication Features

Provider Selection Guide

By Use Case

By Authentication Preference

By Cost Model

Multi-Account Management

Storage Locations

Common Commands (All Providers)

Authentication

Account Management

Execution

Configuration

Provider-Specific Features

Gemini Unique Features

Kiro Unique Features

GHCP Unique Features

Antigravity Unique Features

Claude Accounts Unique Features

Next Steps

FAQ