Documentation

Everything you need to know about CC Models — from installation to advanced configuration

Quick Start

CC Models is a cross-platform desktop application for managing API providers and configurations for Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw.

Step 1: Download & Install

Choose the right package for your operating system:

  • Windows: Download .msi installer or portable .zip
  • macOS: Use Homebrew — brew install --cask cc-models
  • Linux: Download .deb, .rpm, or .AppImage

Step 2: Add a Provider

Open CC Models, click "Add Provider", choose from 50+ built-in presets or create a custom configuration by pasting your API key.

Step 3: Switch Provider

Select your desired provider in the main UI and click "Enable". You can also quick-switch from the system tray menu.

Step 4: Start Working

Restart the relevant CLI tool to apply the changes. Claude Code supports hot-switching — no restart needed.

Installation Guide

System Requirements

  • Windows: Windows 10 or later
  • macOS: macOS 12 (Monterey) or later
  • Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+

Windows

Download the MSI installer and follow the setup wizard. A portable version (no installation required) is also available.

macOS

Recommended installation via Homebrew:

brew tap farion1231/ccmodels
brew install --cask cc-models

You can also download the DMG file manually. macOS builds are code-signed and notarized by Apple.

Linux

Debian/Ubuntu:

sudo dpkg -i CC-Models-v{version}-Linux.deb

AppImage (universal):

chmod +x CC-Models-v{version}-Linux.AppImage
./CC-Models-v{version}-Linux.AppImage

Provider Management

CC Models includes 50+ built-in provider presets covering third-party API proxies and community relays. You can:

  • Import presets: One-click import of official presets (AWS Bedrock, NVIDIA NIM, etc.)
  • Custom configuration: Create custom providers with custom API endpoints, auth methods, and model mappings
  • Drag-and-drop sorting: Reorder provider list via drag-and-drop
  • Import/Export: Import and export provider configurations
  • Universal providers: Configure once, sync to multiple apps

Proxy Gateway

CC Models includes a built-in local proxy gateway with:

  • Format conversion: Auto-convert between Anthropic and OpenAI formats
  • Auto-failover: Automatically switch to backup providers when the primary is unavailable
  • Circuit breaker: Prevents cascading failures
  • Health monitoring: Real-time provider availability tracking
  • Request rectifier: Auto-fix compatibility issues
  • App-level takeover: Proxy Claude, Codex, or Gemini independently

MCP Management

Unified MCP (Model Context Protocol) management panel:

  • Manage MCP servers across multiple apps from one panel
  • Bidirectional sync
  • Deep Link import (ccmodels://)
  • Template-based server addition
  • Per-app sync toggle

Skills Management

One-click install and manage Skills:

  • Install Skills from GitHub repos or ZIP files with one click
  • Custom repo management with symlink support
  • Cross-app Skills sync
  • Auto-backup (keeps 20 most recent backups)

Session Manager

Comprehensive AI coding session management:

  • Browse conversation history across all apps
  • Full-text search and filtering
  • One-click restore historical sessions
  • Detailed conversation view with token consumption
  • Workspace editor with Markdown preview

Dashboard

Intuitive usage and cost tracking:

  • Spending, requests, and token usage statistics
  • Trend charts
  • Cache-normalized total token count and cache hit rate
  • Custom per-model pricing
  • Date range, provider, and model filters
  • Detailed request logs

Cloud Sync

Sync configuration data across devices via:

  • Dropbox
  • OneDrive
  • iCloud
  • WebDAV
  • NAS (Network Attached Storage)
  • Custom config directory

Settings & Configuration

Global settings management:

  • Theme: Dark / Light / System
  • Language: English / 中文
  • Auto-launch: Start on system boot
  • Auto-updater: Automatic update detection and installation
  • Data storage: All data in ~/.cc-models/ — SQLite database, settings files, auto-backups (keeps 10 most recent)
  • Atomic writes: Config files are written atomically to prevent corruption

FAQ

Which CLI tools are supported?

CC Models currently supports Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw.

Do I need to restart after switching providers?

Most tools require a terminal restart. Claude Code supports hot-switching without restart.

How do I restore official login?

Add the "Official Login" preset, switch to it, restart the CLI tool, and follow the official login/OAuth flow.

Is my data sent to the cloud?

No. All data is stored locally by default. It's only synced to the cloud if you explicitly configure cloud sync.

Is CC Models free?

Yes, CC Models is completely free and open source. Only download from official channels.