> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ccs.kaitran.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Provider Overview

> Compare CCS providers: CLIProxy OAuth providers, Claude accounts, and API profiles

# Provider Overview

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

## Provider Categories

<CardGroup cols={3}>
  <Card title="OAuth Providers" icon="key">
    **OAuth Providers** - Zero API keys, browser callback, device-code, or browser-polling login

    Perfect for beginners and quick setup
  </Card>

  <Card title="Claude Accounts" icon="users">
    **Multiple Subscriptions** - Isolated Claude instances

    Work/personal separation, concurrent sessions
  </Card>

  <Card title="API Profiles" icon="code">
    **Direct API Access** - Bring your own keys

    Custom endpoints, self-hosted models
  </Card>
</CardGroup>

## Quick Decision Guide

**Choose your path:**

<Steps>
  <Step title="New to CCS? Start with OAuth">
    **Recommended:** Codex for browser OAuth, or Kiro if you want a free Builder ID path

    ```bash theme={null}
    ccs codex "your first query"
    # Browser opens → Sign in → Start coding
    ```

    * No API keys needed
    * Good baseline for your first session
    * Auto token refresh on supported providers
    * Multi-account support
  </Step>

  <Step title="Have Claude Pro/Team? Use Claude Accounts">
    **Best for:** Multiple Claude subscriptions

    ```bash theme={null}
    ccs auth create work
    ccs auth create personal
    # Use both simultaneously in different terminals
    ```

    * Work/personal isolation
    * Concurrent sessions
    * Team collaboration
    * Existing subscription leverage
  </Step>

  <Step title="Need Custom Endpoints? Use API Profiles">
    **Best for:** Self-hosted models, custom APIs

    ```bash theme={null}
    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
  </Step>
</Steps>

## Authentication Methods Comparison

### Browser Callback vs Device Code vs Browser Polling

| Feature              | Browser Callback                                     | Device Code                                                      | Browser Polling                                      |
| -------------------- | ---------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------- |
| **Setup**            | Browser opens and returns through a local callback   | Manual URL/code or device login                                  | Browser opens and CCS polls upstream auth completion |
| **Headless Servers** | Usually pair with `--headless` or `--paste-callback` | Native support                                                   | Limited; best on desktop/browser-capable machines    |
| **Providers**        | Gemini, Codex, Antigravity, iFlow, Claude, GitLab    | Kimi, Kiro (default), Kilo, Qoder, deprecated GHCP compatibility | Cursor, CodeBuddy                                    |
| **Best For**         | Local development, desktop                           | CI/CD, remote servers                                            | Provider-specific browser-driven flows               |

Kiro also supports optional auth-code and IDC flows via `--kiro-auth-method`.
GitLab Duo also supports PAT login via `--gitlab-token-login`.

**Example: Browser Callback Flow**

```bash theme={null}
ccs codex "task"
# → Browser opens → Provider login → Token cached → Session starts
```

**Example: Device Code Flow**

```bash theme={null}
ccs ghcp "task"
# → Device code displayed → Copy URL/code → Token cached
```

**Example: Browser Polling Flow**

```bash theme={null}
ccs cursor --auth
# → Browser opens → Upstream auth completes → CCS detects the session
```

## All Providers Comparison

### Providers At A Glance

<Tabs>
  <Tab title="Gemini">
    **Google Gemini** - Google OAuth route

    | 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** | ✅ Automatic (CLIProxy-managed)                              |
    | **Best For**      | Beginners, free tier users, fast responses                  |

    For command examples and setup flow, open the dedicated Gemini provider page.

    [Full Documentation →](/providers/oauth/gemini)
  </Tab>

  <Tab title="Kiro">
    **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                                        |

    ```bash theme={null}
    ccs kiro "your query"
    ccs kiro --import             # Import from Kiro IDE
    ccs kiro --no-incognito       # Normal browser (Linux fix)
    ```

    [Full Documentation →](/providers/oauth/kiro)
  </Tab>

  <Tab title="GitHub Copilot">
    **GitHub Copilot (GHCP)** - Deprecated device-code OAuth compatibility via CLIProxy

    <Warning>
      GitHub Copilot is kept for existing setups only. GitHub usage-based Copilot
      billing begins June 1, 2026; prefer Codex or another active provider for
      new work.
    </Warning>

    | 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**      | Existing Copilot setups that still need compatibility |

    ```bash theme={null}
    # Start GHCP and complete the device-code prompt
    ccs ghcp "your query"

    # Check quota
    ccs ghcp --quota
    ```

    [Full Documentation →](/providers/oauth/ghcp)
  </Tab>

  <Tab title="Codex">
    **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                                     |

    ```bash theme={null}
    ccs codex "your query"
    ccs codex --auth --add        # Add account
    ```

    [Full Documentation →](/providers/oauth/codex)
  </Tab>

  <Tab title="Kimi">
    **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 |

    ```bash theme={null}
    ccs kimi "your query"
    ccs kimi --accounts
    ccs kimi --use work
    ```

    [Full Documentation →](/providers/oauth/kimi)
  </Tab>

  <Tab title="Antigravity">
    **Antigravity (AGY)** - Subscription multi-model route

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

    For command examples and setup flow, open the dedicated Antigravity provider page.

    [Full Documentation →](/providers/oauth/agy)
  </Tab>

  <Tab title="Claude">
    **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**  | ✅ Interactive `--config`                    |
    | **Token Refresh** | ✅ Auto                                      |
    | **Best For**      | Anthropic subscribers, direct Claude access |

    ```bash theme={null}
    ccs claude "your query"
    ccs claude --auth --add       # Add account
    ```

    [Full Documentation →](/providers/oauth/claude)
  </Tab>

  <Tab title="Qwen">
    **Qwen3 Coder** - Use the API-key Alibaba Coding Plan route

    | Feature           | Details                             |
    | ----------------- | ----------------------------------- |
    | **Models**        | Qwen3 Coder Plus, Qwen3 Coder Flash |
    | **Free Tier**     | ❌ No (subscription required)        |
    | **Auth Method**   | API key                             |
    | **Multi-Account** | Profile-based                       |
    | **Model Picker**  | ❌ No (single model)                 |
    | **Best For**      | Specialized coding tasks            |

    ```bash theme={null}
    ccs albb "your query"
    ```

    [Full Documentation →](/providers/api/alibaba)
  </Tab>

  <Tab title="iFlow">
    **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            |

    ```bash theme={null}
    ccs iflow "your query"
    ```

    [Full Documentation →](/providers/oauth/iflow)
  </Tab>

  <Tab title="MiniMax">
    **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 |

    ```bash theme={null}
    # Quick setup with preset
    ccs api create mm --preset mm

    # Use profile
    ccs mm "analyze large document"
    ```

    [Full Documentation →](/providers/api/minimax)
  </Tab>

  <Tab title="Alibaba Coding Plan">
    **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 |

    ```bash theme={null}
    # Quick setup with preset
    ccs api create --preset alibaba-coding-plan

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

    [Full Documentation →](/providers/api/alibaba)
  </Tab>

  <Tab title="Novita AI">
    **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                                                      |

    ```bash theme={null}
    ccs api create --preset novita
    ccs novita "summarize this incident"
    ```

    [Full Documentation →](/providers/api/novita)
  </Tab>
</Tabs>

### Claude Accounts

Run multiple Claude subscriptions simultaneously with separate account profiles:

| Feature                 | Details                                                                   |
| ----------------------- | ------------------------------------------------------------------------- |
| **Setup**               | `ccs auth create <profile>`                                               |
| **Multi-Account**       | ✅ Unlimited profiles                                                      |
| **Concurrent Sessions** | ✅ Different profiles use separate default account directories             |
| **Session Isolation**   | ✅ Separate by default; reusing the same profile reuses the same directory |
| **Subscription**        | Requires existing Claude Pro/Team                                         |
| **Best For**            | Work/personal separation, team collaboration                              |

**Example:**

```bash theme={null}
# 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 →](/providers/concepts/claude-accounts)

### 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:**

```bash theme={null}
# 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 →](/providers/concepts/api-profiles)

### Additional Current CLIProxy OAuth Providers

These providers are current and supported in CCS today even though they arrived
after the older nine-provider docs pass:

| Provider   | Auth Model           | Backend | Notes                                                                          | Docs                                             |
| ---------- | -------------------- | ------- | ------------------------------------------------------------------------------ | ------------------------------------------------ |
| Cursor     | Browser polling      | `plus`  | current `ccs cursor` provider path; different from the deprecated local bridge | [Cursor Provider](/providers/oauth/cursor)       |
| GitLab Duo | Browser OAuth or PAT | `plus`  | supports `--gitlab-token-login` and `--gitlab-url`                             | [GitLab Duo Provider](/providers/oauth/gitlab)   |
| CodeBuddy  | Browser polling      | `plus`  | auth and routing via CLIProxy                                                  | [CodeBuddy Provider](/providers/oauth/codebuddy) |
| Kilo AI    | Device code          | `plus`  | CLIProxy-backed device-code provider                                           | [Kilo AI Provider](/providers/oauth/kilo)        |
| Qoder      | Device code          | `plus`  | Qoder coding provider with interactive model picker                            | [Qoder Provider](/providers/oauth/qoder)         |

## 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 (deprecated)**   | ❌         | ✅             | ❌            | ✅             | ✅ Auto         | ✅ Device Code  |
| **Codex**               | ✅ Limited | ✅             | ✅            | ✅             | ✅ Auto         | ✅              |
| **Antigravity**         | ❌         | ✅             | ✅            | ✅             | ✅ Auto         | ✅              |
| **Claude**              | ❌         | ✅             | ✅            | ❌             | ✅ Auto         | ✅              |
| **iFlow**               | ❌         | ✅             | ❌            | ❌             | ✅ Auto         | ✅              |
| **Cursor**              | Varies    | ✅             | ❌            | ❌             | ✅ Auto         | Browser-driven |
| **GitLab Duo**          | Varies    | ✅             | ❌            | ❌             | ✅ Auto         | ✅              |
| **CodeBuddy**           | Varies    | ✅             | ❌            | ❌             | ✅ Auto         | Browser-driven |
| **Qoder**               | Varies    | ✅             | ✅            | ❌             | ❌ Re-auth      | ✅ Device Code  |
| **Kilo AI**             | Varies    | ✅             | ❌            | ❌             | Manual re-auth | ✅ Device Code  |
| **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 (deprecated)**   | Device Code                         | GitHub username  | ❌            | N/A                            |
| **Codex**               | Browser OAuth                       | Email            | ❌            | Incognito default              |
| **Antigravity**         | Browser OAuth                       | Email            | ❌            | Incognito default              |
| **Claude**              | Browser OAuth                       | Email            | ❌            | Incognito default              |
| **iFlow**               | Browser OAuth                       | Email            | ❌            | Incognito default              |
| **Cursor**              | Browser polling                     | Provider-managed | ❌            | No local callback              |
| **GitLab Duo**          | Browser OAuth or PAT                | GitLab user      | ✅ PAT        | Paste-callback for self-hosted |
| **CodeBuddy**           | Browser polling                     | Provider-managed | ❌            | No local callback              |
| **Kilo AI**             | Device Code                         | Provider-managed | ❌            | N/A                            |
| **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

<CardGroup cols={2}>
  <Card title="Beginner (First Time)" icon="graduation-cap">
    **→ Codex or Kiro**

    * No API keys needed
    * Good first-run coverage in CCS docs
    * Codex works well for browser OAuth
    * Kiro offers a free Builder ID route
  </Card>

  <Card title="Work/Personal Separation" icon="briefcase">
    **→ Claude Accounts**

    * Isolated sessions
    * Concurrent use
    * Separate subscriptions
    * Professional workflow
  </Card>

  <Card title="CI/CD Pipeline" icon="gears">
    **→ GHCP** (deprecated compatibility, device code)

    * Headless-friendly
    * No browser needed
    * Scriptable auth
    * Quota management
  </Card>

  <Card title="Free Tier Only" icon="dollar-sign">
    **→ Kiro**

    * CodeWhisperer via AWS Builder ID
    * Device-code friendly
    * No paid subscription required
  </Card>

  <Card title="Premium Models" icon="star">
    **→ Claude Accounts or Codex**

    * Claude Pro/Max account workflows
    * Codex paid-plan model access
    * Strong review and implementation coverage
    * Clear first-party documentation
  </Card>

  <Card title="Long-Context Tasks" icon="file-text">
    **→ MiniMax**

    * 1M token context window
    * Large codebase analysis
    * Document processing
    * API key authentication
  </Card>

  <Card title="Self-Hosted Models" icon="server">
    **→ API Profiles**

    * Custom endpoints
    * Local LLMs
    * Full control
    * Privacy-focused
  </Card>

  <Card title="AWS Ecosystem" icon="aws">
    **→ Kiro**

    * CodeWhisperer integration
    * AWS Builder ID device code by default
    * IDE token import
    * Free Builder ID
  </Card>

  <Card title="OpenAI Workflow" icon="openai">
    **→ Codex**

    * Cross-plan-safe GPT-5 Codex defaults
    * GPT-5.3 Codex / GPT-5.2 Codex when available
    * OpenAI ecosystem
  </Card>

  <Card title="Alibaba Cloud / Cost-Efficient Coding" icon="key">
    **→ Alibaba Coding Plan**

    * Qwen3 Coder Plus/Flash
    * 1M token context
    * $1.00/$5.00 per M tokens
    * `ccs api create --preset alibaba`
  </Card>
</CardGroup>

### By Authentication Preference

**Prefer Browser OAuth?**

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

**Prefer Device Code?**

* Kimi, Kiro (default), Kilo AI, Qoder, deprecated GHCP compatibility

**Prefer Browser Polling?**

* Cursor, CodeBuddy

**Prefer PAT / Token Login?**

* GitLab Duo (`--gitlab-token-login`)

**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** - Deprecated GitHub Copilot compatibility for existing setups
* **Codex paid / preview models** - Paid Codex plan required for `gpt-5.5` and `gpt-5.3-codex`; `gpt-5.3-codex-spark` is research preview for ChatGPT Pro subscribers
* **Antigravity** - Subscription
* **Claude** - Anthropic 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:

<Tabs>
  <Tab title="Email-Based (Most Providers)">
    **Codex, Gemini, Antigravity, iFlow**

    ```bash theme={null}
    # Add account
    ccs codex --auth --add

    # List accounts
    ccs codex --accounts

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

    # Switch account
    ccs codex --use work

    # Rename account
    ccs codex --nickname personal
    ```

    **Account ID:** Email prefix (`john@gmail.com` → `john`)
  </Tab>

  <Tab title="Username-Based (GHCP)">
    **GitHub Copilot (deprecated compatibility)**

    ```bash theme={null}
    # 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
  </Tab>

  <Tab title="Filename-Based (Kiro)">
    **Kiro (AWS CodeWhisperer)**

    ```bash theme={null}
    # 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
  </Tab>

  <Tab title="Provider-Managed IDs">
    **Cursor, GitLab Duo, CodeBuddy, Kilo AI**

    ```bash theme={null}
    ccs cursor --auth
    ccs cursor --accounts
    ccs cursor --use <account>

    ccs gitlab --auth --gitlab-token-login
    ccs codebuddy --auth
    ccs kilo --auth
    ```

    **Account ID:** Derived from the upstream provider session or token metadata.
  </Tab>

  <Tab title="Profile-Based (Claude)">
    **Claude Accounts**

    ```bash theme={null}
    # 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)
  </Tab>
</Tabs>

## 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
│   │   └── ...
│   ├── providers/
│   │   └── cursor.settings.json        # dedicated Cursor provider settings
│   ├── 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

```bash theme={null}
# 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

```bash theme={null}
# List all accounts
ccs <provider> --accounts

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

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

### Execution

```bash theme={null}
# Execute query (interactive session)
ccs <provider> "your prompt"

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

### Configuration

```bash theme={null}
# Provider-specific config (supported providers only)
ccs codex --config
ccs claude --config

# Global dashboard
ccs config
```

## Provider-Specific Features

### Gemini Unique Features

* ✅ Automatic CLIProxy-managed token refresh
* ✅ 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 Deprecated Compatibility Features

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

### More Current CLIProxy Providers

* ✅ **Cursor** provider path lives under `ccs cursor --auth`
* ✅ **GitLab Duo** supports browser OAuth and PAT login
* ✅ **CodeBuddy** is supported as a browser-polling provider
* ✅ **Kilo AI** is supported as a device-code provider
* ✅ **Qoder** is supported as a device-code provider with model picker

### 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)
* ✅ Separate account directories by default
* ✅ Unlimited profiles
* ✅ Work/personal separation

## Next Steps

<CardGroup cols={3}>
  <Card title="Gemini Provider" icon="google" href="/providers/oauth/gemini">
    Free tier, proactive refresh, 4 models
  </Card>

  <Card title="Kiro Provider" icon="aws" href="/providers/oauth/kiro">
    AWS CodeWhisperer, IDE import, free tier
  </Card>

  <Card title="GHCP Provider (Deprecated)" icon="github" href="/providers/oauth/ghcp">
    Compatibility path, device code, quota display
  </Card>

  <Card title="Codex Provider" icon="openai" href="/providers/oauth/codex">
    GPT-5 Codex defaults, paid-plan models, plan-aware fallbacks
  </Card>

  <Card title="Antigravity Provider" icon="star" href="/providers/oauth/agy">
    Claude Opus 4.6 Thinking, multi-model picker
  </Card>

  <Card title="Claude Provider" icon="message" href="/providers/oauth/claude">
    Direct Anthropic OAuth access
  </Card>

  <Card title="Alibaba Coding Plan" icon="code" href="/providers/api/alibaba">
    Qwen3 Coder via API key
  </Card>

  <Card title="iFlow Provider" icon="water" href="/providers/oauth/iflow">
    Various models available
  </Card>

  <Card title="Cursor Provider" icon="code" href="/providers/oauth/cursor">
    Current CLIProxy Cursor provider path
  </Card>

  <Card title="GitLab Duo" icon="git-branch" href="/providers/oauth/gitlab">
    Browser OAuth or PAT login
  </Card>

  <Card title="CodeBuddy" icon="sparkles" href="/providers/oauth/codebuddy">
    Tencent CodeBuddy provider
  </Card>

  <Card title="Kilo AI" icon="bolt" href="/providers/oauth/kilo">
    CLIProxy device-code provider
  </Card>

  <Card title="Qoder Provider" icon="code" href="/providers/oauth/qoder">
    Qoder coding provider
  </Card>

  <Card title="MiniMax Provider" icon="file-text" href="/providers/api/minimax">
    1M context window, long-context tasks
  </Card>

  <Card title="Novita Provider" icon="key" href="/providers/api/novita">
    Anthropic-compatible preset, default `deepseek/deepseek-v3.2`
  </Card>

  <Card title="Claude Accounts" icon="users" href="/providers/concepts/claude-accounts">
    Multiple subscriptions, concurrent sessions
  </Card>

  <Card title="API Profiles" icon="key" href="/providers/concepts/api-profiles">
    Custom endpoints, self-hosted models
  </Card>

  <Card title="Alibaba Coding Plan" icon="key" href="/providers/api/alibaba">
    Qwen3 Coder, 1M context, cost-effective
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Can I use multiple providers simultaneously?">
    **Yes!** Different providers are the simplest way to avoid reusing the same provider or proxy lane:

    ```bash theme={null}
    # Terminal 1
    ccs codex "task A"

    # Terminal 2
    ccs kimi "task B"

    # No conflicts
    ```
  </Accordion>

  <Accordion title="Which provider is best for beginners?">
    **Kiro or Codex** - pick the one that matches the account you already have:

    ```bash theme={null}
    ccs codex "your first query"
    # Browser opens → Provider login → Start coding
    ```
  </Accordion>

  <Accordion title="Can I switch between accounts without re-authenticating?">
    **Yes!** All OAuth providers support multi-account with instant switching:

    ```bash theme={null}
    ccs codex --use work      # Switch to work account
    ccs codex --use personal  # Switch to personal
    # No re-auth needed
    ```
  </Accordion>

  <Accordion title="Which providers work without a browser (CI/CD)?">
    * **GHCP** - Deprecated compatibility with built-in device-code flow
    * **All OAuth Providers** - Headless mode (`--headless`, copy URL manually)
    * **API Profiles** - No browser needed (API keys only)
  </Accordion>

  <Accordion title="Can I use the same account across multiple machines?">
    **Yes** for OAuth providers - tokens sync automatically if you:

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

    **Better:** Re-auth on each machine for security.
  </Accordion>

  <Accordion title="Which providers support concurrent sessions?">
    * **Different providers:** Concurrent; usually the easiest way to keep sessions separate
    * **Same provider, different accounts:** Concurrent (if supported by backend)
    * **Claude Accounts:** Concurrent with different profiles; same profile is allowed but reuses the same account directory
    * **Same provider, same account:** Provider-specific; may reuse the same provider/proxy session instead of giving full isolation
  </Accordion>
</AccordionGroup>