Provider Overview

CCS supports 11 providers across 3 authentication methods. This guide helps you choose the right provider for your needs.

Provider Categories

OAuth Providers

9 Providers - Zero API keys, browser login onlyPerfect 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

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, Kiro, Codex, Antigravity	GHCP, Qwen, iFlow
Token Refresh	Automatic (proactive)	Automatic (on-demand)
Best For	Local development, desktop	CI/CD, remote servers

Example: OAuth Flow

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

Example: Device Code Flow

ccs ghcp --device-code
# → URL displayed → Copy to browser → Enter code → Token cached

All Providers Comparison

OAuth Providers (8 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 →

Amazon CodeWhisperer - AWS integration

Feature	Details
Models	Amazon CodeWhisperer (AWS)
Free Tier	✅ Yes (Builder ID)
Auth Method	Browser OAuth (AWS SSO) + IDE import
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) - Dual auth modes

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

# Browser OAuth (default)
ccs ghcp "your query"

# Device Code (headless-friendly)
ccs ghcp --device-code

# Check quota
ccs ghcp --quota

Full Documentation →

OpenAI Codex - ChatGPT Plus access

Feature	Details
Models	GPT-5.1-codex-max
Free Tier	❌ No (ChatGPT Plus required)
Auth Method	Browser OAuth (OpenAI)
Multi-Account	✅ Yes (email-based)
Model Picker	❌ No (single model)
Best For	ChatGPT Plus subscribers, OpenAI ecosystem

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

Full Documentation →

Antigravity (AGY) - Premium multi-model

Feature	Details
Models	Claude Opus 4.5 Thinking, Claude Sonnet 4.5, 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	Browser 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 →

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	✅
GHCP	❌	✅	❌	✅	✅ Auto	✅ Device Code
Codex	❌	✅	❌	❌	✅ Auto	✅
Antigravity	❌	✅	✅	❌	✅ Auto	✅
Claude	❌	✅	❌	❌	✅ Auto	✅
Qwen	❌	✅	❌	❌	✅ Auto	✅
iFlow	❌	✅	❌	❌	✅ Auto	✅
MiniMax	❌	✅	❌	❌	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	Browser OAuth	Filename	✅ IDE	Normal (no incognito)
GHCP	Browser/Device	GitHub username	❌	Incognito default
Codex	Browser OAuth	Email	❌	Incognito default
Antigravity	Browser OAuth	Email	❌	Incognito default
Claude	Browser OAuth	Email	❌	Incognito default
Qwen	Browser OAuth	Email	❌	Incognito default
iFlow	Browser OAuth	Email	❌	Incognito default
MiniMax	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.5 Thinking
Claude Sonnet 4.5
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 SSO support
IDE token import
Free Builder ID

ChatGPT Plus User

→ Codex

Leverage existing subscription
GPT-5.1-codex-max
OpenAI ecosystem

By Authentication Preference

Prefer Browser OAuth?

Gemini, Kiro, GHCP, Codex, Antigravity, Qwen, iFlow

Prefer Device Code?

GHCP (with --device-code flag)

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 - ChatGPT Plus
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

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 SSO integration
✅ Free tier (Builder ID)

GHCP Unique Features

✅ Dual auth modes (OAuth + Device Code)
✅ Quota display (--quota)
✅ Device code for headless servers
✅ GitHub integration

Antigravity Unique Features

✅ Multi-model access (Claude + Gemini)
✅ Claude Opus 4.5 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

ChatGPT Plus, GPT-5.1-codex-max

Antigravity Provider

Claude Opus 4.5, 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

Claude Accounts

Multiple subscriptions, concurrent sessions

API Profiles

Custom endpoints, self-hosted models

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 - Device code flow (--device-code)
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 (8 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

ChatGPT Plus User

​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

Claude Accounts

API Profiles

​FAQ

Provider Overview

Provider Categories

Quick Decision Guide

Authentication Methods Comparison

Browser OAuth vs Device Code

All Providers Comparison

OAuth Providers (8 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