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

# Introduction

> CCS (Claude Code Switch) - Multi-provider profile and runtime orchestration across Claude Code and compatible CLIs

<img className="block dark:hidden" src="https://mintcdn.com/ccs-7e541244/OetEcMGoSIkCWQP9/assets/ccs-logo-medium.png?fit=max&auto=format&n=OetEcMGoSIkCWQP9&q=85&s=5e5a3a6a14b5d2b71eea6c2ec715d84d" alt="CCS Logo" width="120" data-path="assets/ccs-logo-medium.png" />

<img className="hidden dark:block" src="https://mintcdn.com/ccs-7e541244/OetEcMGoSIkCWQP9/assets/ccs-logo-medium.png?fit=max&auto=format&n=OetEcMGoSIkCWQP9&q=85&s=5e5a3a6a14b5d2b71eea6c2ec715d84d" alt="CCS Logo" width="120" data-path="assets/ccs-logo-medium.png" />

# Welcome to CCS

**CCS (Claude Code Switch)** is a multi-provider profile and runtime manager. It lets you keep one profile system while routing work into Claude Code, Factory Droid, Codex CLI, and future compatible runtimes.

## The Three Pillars

<CardGroup cols={3}>
  <Card title="Multiple Claude Accounts" icon="users" href="/providers/concepts/claude-accounts">
    Run work, personal, and team Claude accounts simultaneously with separate
    account directories by default. Optional shared context groups.
  </Card>

  <Card title="OAuth Providers" icon="key" href="/providers/concepts/overview">
    Access Codex, Kiro, Claude, Kimi, and more via OAuth with no API keys.
    Copilot remains a deprecated compatibility path for existing setups.
  </Card>

  <Card title="API Profiles & Local Models" icon="code" href="/providers/concepts/api-profiles">
    Bring your own keys for Claude, Z.AI GLM, Kimi for Coding, Novita,
    Alibaba, or run local models via llama.cpp
  </Card>
</CardGroup>

## Why CCS?

**Built for developers with both Claude subscription and alternative model access.**

### Task-Appropriate Model Selection

| Model                      | Best For                                        | Setup                        |
| -------------------------- | ----------------------------------------------- | ---------------------------- |
| Claude Sonnet 4.6          | Complex architecture, system design, debugging  | Claude Pro/Max or Direct API |
| GPT-5 Codex                | High-signal implementation and review work      | Codex OAuth or Codex CLI     |
| GPT-5 Codex Mini           | Quick iterations and prototypes                 | Codex OAuth or Codex CLI     |
| OpenRouter (300+ models)   | Unified access, model variety, cost flexibility | API key                      |
| Z.AI GLM 5 (`ccs glm`)     | Simple fixes, routine implementations, docs     | API key                      |
| Kimi OAuth (`ccs kimi`)    | Long-context analysis (1M tokens)               | OAuth                        |
| Kimi for Coding (`ccs km`) | Reasoning-first API workflows                   | API key                      |
| Alibaba Coding Plan        | Cost-effective code generation, 1M context      | API key                      |
| Local llama.cpp            | Offline, private, zero-cost inference           | Self-hosted                  |
| Qwen3 Coder                | Code-focused tasks                              | API key                      |

### Rate Limit Management

No more manual config editing when Claude hits rate limits:

```bash theme={null}
ccs           # Using Claude, hit rate limit
ccs glm       # Switch to GLM instantly
ccs codex     # Or use Codex via OAuth
ccs           # Switch back when limit resets
```

<Note>
  `ccs glmt` is deprecated and no longer marketed as a supported surface. Use
  `ccs glm` for Z.AI API profiles and `ccs km` for reasoning-first Kimi API
  profiles.
</Note>

## Quick Start

<Steps>
  <Step title="Install CCS">
    ```bash theme={null}
    npm install -g @kaitranntt/ccs
    ```
  </Step>

  <Step title="Open Dashboard">
    ```bash theme={null}
    ccs config
    ```

    Opens the dashboard on the current session URL so you
    can configure accounts, providers, and profiles visually.
  </Step>

  <Step title="Start Using">
    ```bash theme={null}
    ccs         # Default Claude
    ccs work    # Work account
    ccs codex   # Codex via OAuth
    ccs glm     # GLM via API
    ccs km      # Kimi for Coding via API
    ```
  </Step>
</Steps>

## Features

* **Instant profile switching** - One command, under 1 second switch
* **Concurrent sessions** - Run multiple accounts in different terminals
* **Cross-platform** - macOS, Linux, Windows (PowerShell, CMD, Git Bash)
* **Flexible setup** - Use IDE-local snippets or shared `~/.claude/settings.json` setup
* **Visual dashboard** - Configure everything via `ccs config`
* **Claude IDE extension setup** - Generate shared or IDE-local settings for VS Code, Cursor, and Windsurf
* **Localized dashboard** - English, Simplified Chinese, Vietnamese, and Japanese
* **Extended Thinking** - Cross-provider `--thinking` controls plus native Claude `--effort` session overrides
* **Docker deployment** - Run CCS in containerized environments via Docker or Docker Compose
* **Official channels** - Community support on Telegram, Discord, and iMessage

## Get Started

<CardGroup cols={2}>
  <Card title="Product Tour" icon="image" href="/getting-started/product-tour">
    See the dashboard, provider controls, and workflow surfaces first
  </Card>

  <Card title="Installation" icon="download" href="/getting-started/installation">
    Install CCS via npm or package manager
  </Card>

  <Card title="Quick Start" icon="rocket" href="/getting-started/quickstart">
    Get up and running in 2 minutes
  </Card>

  <Card title="Your First Session" icon="play" href="/getting-started/first-session">
    Run an end-to-end first provider flow with a concrete example
  </Card>
</CardGroup>