diff --git a/README.md b/README.md index efc8d540..33c4c2c0 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,9 @@ ![CCS Logo](docs/assets/ccs-logo-medium.png) -### Switch between multiple Claude accounts, GLM, Kimi, and OAuth-based models (Gemini, Codex, Antigravity) instantly. -Stop hitting rate limits. Keep working continuously. -Features a modern React 19 dashboard with real-time updates and unified configuration. +### The universal AI profile manager for Claude Code. +Switch between multiple Claude accounts, connect **any Anthropic-compatible API**, and use OAuth providers (Gemini, Codex, Antigravity) instantly. +Stop hitting rate limits. Keep working continuously with unlimited profiles. [![License](https://img.shields.io/badge/license-MIT-C15F3C?style=for-the-badge)](LICENSE) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)]() @@ -71,7 +71,7 @@ irm ccs.kaitran.ca/install | iex
-## Zero-Config OAuth Providers +## Built-in OAuth Providers (Zero-Config) **New in v5.0.0**: Instant access to premium models with zero API key setup. Browser-based OAuth authentication. @@ -83,6 +83,9 @@ irm ccs.kaitran.ca/install | iex | **Codex** | gpt-5.1-codex-max | gpt-5.1-codex-max-high | gpt-5.1-codex-mini-high | `ccs codex "implement API"` | | **Antigravity** | gemini-3-pro-preview | gemini-3-pro-preview | gemini-2.5-flash | `ccs agy "review architecture"` | +> [!TIP] +> **These are just the built-in providers.** CCS supports **any Anthropic-compatible API** via custom profiles. See [Custom API Profiles](#custom-api-profiles-bring-your-own) below. + **First Run**: Browser opens for authentication. Tokens cached in `~/.ccs/cliproxy/auth//`. **Subsequent Runs**: Instant - no re-auth needed until token expires. @@ -219,6 +222,41 @@ $env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe" # Windows
+## Custom API Profiles (Bring Your Own) + +CCS isn't limited to the built-in providers. **Connect any Anthropic-compatible API** by creating custom profiles: + +```bash +# 1. Create a settings file for your API +cat > ~/.ccs/my-api.settings.json << 'EOF' +{ + "env": { + "ANTHROPIC_BASE_URL": "https://your-api.example.com/v1", + "ANTHROPIC_AUTH_TOKEN": "your-api-key", + "ANTHROPIC_MODEL": "your-model-name" + } +} +EOF + +# 2. Register it in config.json +# Add to ~/.ccs/config.json under "profiles": +# "my-api": "~/.ccs/my-api.settings.json" + +# 3. Use it! +ccs my-api "Your prompt here" +``` + +**Works with any API that implements the Anthropic messages format:** +- Self-hosted LLMs (Ollama, LM Studio, vLLM with Anthropic adapter) +- Alternative AI providers with Anthropic-compatible endpoints +- Enterprise API gateways and proxies +- Custom model deployments + +> [!TIP] +> **Already have API keys for GLM or Kimi?** CCS includes pre-configured profiles for these. Just add your API key to `~/.ccs/glm.settings.json` or `~/.ccs/kimi.settings.json`. + +
+ ### Your First Switch > [!IMPORTANT] @@ -395,6 +433,7 @@ graph LR ### What CCS Gives You +- **Unlimited Profiles**: Built-in OAuth, API keys, or bring your own Anthropic-compatible endpoints - **Zero Context Switching**: Keep your flow state without interruption - **Parallel Productivity**: Strategic planning in one terminal, code execution in another - **Instant Account Management**: One command switches, no config file editing @@ -407,13 +446,16 @@ graph LR ## Architecture -CCS resolves profiles in priority order: -1. **CLIProxy profiles** (gemini, codex, agy) - OAuth-based, zero config -2. **CLIProxy variants** (user-defined) - Custom model settings for CLIProxy providers -3. **Settings-based profiles** (glm, kimi) - API key required +CCS is a **universal profile manager** that resolves profiles in priority order: +1. **CLIProxy profiles** (gemini, codex, agy) - Built-in OAuth providers, zero config +2. **CLIProxy variants** (user-defined) - Custom model configurations for CLIProxy providers +3. **Settings-based profiles** (glm, kimi, **your-custom-api**) - Any Anthropic-compatible API 4. **Account-based profiles** (work, personal) - Isolated Claude instances 5. **Default** - Claude CLI with subscription +> [!NOTE] +> **Extensibility is core to CCS.** While we provide built-in profiles for common providers, you can connect **any API** that speaks the Anthropic messages format. + ### Profile Types **CLIProxy**: gemini, codex, agy (v5.0+) diff --git a/docs/ja/README.md b/docs/ja/README.md index 2ce4cbe2..7d114040 100644 --- a/docs/ja/README.md +++ b/docs/ja/README.md @@ -4,10 +4,10 @@ ![CCS Logo](../../docs/assets/ccs-logo-medium.png) -### 1コマンド、ダウンタイムなし、複数アカウント +### Claude Code用ユニバーサルAIプロファイルマネージャー -**複数のClaudeアカウント、GLM、Kimiを瞬時に切り替え。** -レート制限を回避し、継続的に作業。 +**複数のClaudeアカウント、任意のAnthropic互換API、OAuthプロバイダー(Gemini、Codex、Antigravity)を瞬時に切り替え。** +レート制限を回避し、無制限のプロファイルで継続的に作業。
diff --git a/docs/vi/README.md b/docs/vi/README.md index c2bb5c0e..7a1ad3fd 100644 --- a/docs/vi/README.md +++ b/docs/vi/README.md @@ -4,10 +4,10 @@ ![CCS Logo](../../docs/assets/ccs-logo-medium.png) -### Một lệnh, không downtime, nhiều tài khoản +### Trình quản lý profile AI đa năng cho Claude Code -**Chuyển đổi giữa nhiều tài khoản Claude, GLM, và Kimi ngay lập tức.** -Ngừng hitting rate limits. Làm việc liên tục. +**Chuyển đổi giữa nhiều tài khoản Claude, kết nối bất kỳ API tương thích Anthropic, và sử dụng OAuth providers (Gemini, Codex, Antigravity) ngay lập tức.** +Ngừng bị rate limits. Làm việc liên tục với vô số profiles.