跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
一、产品简介

CC Switch 是一款基于 Tauri 2 构建的桌面应用，可以统一管理 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 五款 AI CLI 工具。通过图形界面一键切换 API 提供商、模型与密钥，告别手动编辑 ~/.config/*、TOML、JSON 等多份配置文件。

一键切换

图形界面统一管理 5 款 CLI 工具配置，告别手动编辑

多模型聚合

搭配 GravitexAI 一份 Key 直通 Claude / GPT / Gemini / Kimi 全家族

用量追踪

内置 Usage Dashboard，实时查看花费、请求数与 Token 用量

智能容错

本地代理支持热切换、自动故障转移与熔断保护
项目信息

​
二、核心功能

​
1. Provider 管理

  • 内置 50+ 预设提供商（含 AWS Bedrock、NVIDIA NIM 等）
  • 支持自定义网关（GravitexAI 即通过这种方式接入）
  • 一键切换、拖拽排序、配置导入导出
  • 系统托盘快速访问

​
2. MCP 服务器管理

  • 统一管理所有 CLI 工具的 MCP 服务器配置
  • 双向同步：修改一处自动同步到所有应用

​
3. 更多特性

特性说明
Prompts 管理Markdown 编辑器 + 跨应用同步
Skills 安装从 GitHub 仓库或 ZIP 文件安装技能
Session 浏览器查看和恢复对话历史
云同步支持 Dropbox、OneDrive、iCloud、WebDAV
Deep Linkccswitch:// 协议一键导入配置

​
三、快速开始

​
第一步：安装 CC Switch

使用 Homebrew 安装：
brew install --cask cc-switch
或从 GitHub Releases 下载 DMG 安装包。
系统要求：Windows 10+、macOS 10.15 (Catalina)+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+

​
第二步：获取 GravitexAI 密钥

1

登录控制台

访问 GravitexAI 控制台 注册或登录账号。
2

创建令牌

进入 密钥管理 页面，点击「创建新令牌」。
3

复制密钥

复制生成的密钥（格式：sk-xxxxxxxxxx），妥善保存。

​
第三步：在 CC Switch 中配置 GravitexAI

1

打开 Provider 管理

启动 CC Switch，进入 Provider 管理页面，点击「添加」→ 选择**「自定义网关」**。
2

填写配置信息

字段值
名称GravitexAI
API 地址https://api.gravitex.ai
API Key上一步复制的密钥
启用的应用至少开启 Claude Code（按需开启 Codex / Gemini CLI / OpenCode / OpenClaw）
不同 CLI 工具对 Base URL 的要求不同：
  • Claude Code：https://api.gravitex.ai（不带 /v1）
  • Codex CLI / OpenCode：https://api.gravitex.ai/v1（必须带 /v1）
  • Gemini CLI：https://api.gravitex.ai（不带 /v1）
CC Switch 通常会根据所选应用自动适配，若手动指定请按上表填写。
3

保存配置

点击「添加」按钮保存。CC Switch 会将该配置同步到你勾选的所有 CLI 工具的配置文件中。

​
第四步：添加模型

在 Provider 配置中根据用途添加 GravitexAI 中的模型 ID： Claude 标准模型
模型名称模型标识说明
Claude Opus 4.7claude-opus-4-7最新旗舰，复杂任务首选
Claude Sonnet 4.6claude-sonnet-4-6编程能力强，性价比之选
Claude Sonnet 4.5claude-sonnet-4-5-20250929200K 长上下文
Claude Haiku 4.5claude-haiku-4-5-20251001轻量快速，副线程首选
GPT / Gemini / Kimi 系列（可在同一 Provider 下混用）
模型名称模型标识说明
GPT 5.5gpt-5.5OpenAI 最新主力
GPT 5.1 Codexgpt-5.1-codexCodex 专用（OpenCode 中需配合 Responses API）
Gemini 3.5 Flashgemini-3.5-flash高吞吐低延迟
Gemini 3.1 Pro Previewgemini-3.1-pro-preview深度推理
Kimi K2kimi-k2-250905长文本与中文场景性价比高
模型选择建议：
  • 日常编程：claude-sonnet-4-6
  • 复杂架构设计：claude-opus-4-7
  • 快速问答 / 副线程：claude-haiku-4-5-20251001
  • 性价比方案：kimi-k2-250905 或 gemini-3.5-flash
完整模型 ID 以 GravitexAI 模型广场 为准。

​
第五步：一键切换并启动 CLI

配置完成后，在 CC Switch 中将 GravitexAI 设为当前 Provider，所有勾选的 CLI 工具会自动切换到该配置。打开任意工具即可立即使用： 
# Claude Code
claude

# Codex
codex

# Gemini CLI
gemini

# OpenCode
opencode

​
四、使用指南

​
1. 同时管理多款 CLI 工具

CC Switch 支持同时管理：
工具详细配置
Claude Code/cn/integrations/claude-code
Codex CLI/cn/integrations/codex
Gemini CLI/cn/integrations/gemini-cli
OpenCode/cn/integrations/open-code
OpenClaw/cn/integrations/openclaw
所有工具共享 Provider 配置，切换一次即可全部生效。

​
2. 本地代理功能

CC Switch 内置本地代理服务器，提供：
  • 热切换：无需重启 CLI 即可切换 Provider
  • 自动故障转移：当前 Provider 不可用时自动切换到备选
  • 熔断保护：检测到持续故障时自动停止请求，防止资源浪费
建议在 CC Switch 中配置 GravitexAI 主分组 + GravitexAI 备用 Key 作为故障转移目标，最大化可用性。

​
3. 配置备份

  • 自动备份系统保留最近 10 个版本
  • 支持导入/导出完整配置
  • 云同步支持 Dropbox、OneDrive、iCloud、WebDAV

​
五、常见问题

支持 Windows 10+、macOS 10.15 (Catalina)+，以及主流 Linux 发行版（Ubuntu 22.04+、Debian 11+、Fedora 34+、Arch Linux）。
请按以下顺序排查：
  1. API Key 正确：以 sk- 开头，无空格 / 换行；
  2. Base URL 正确：Claude Code 必须使用 https://api.gravitex.ai（不带 /v1）；
  3. 账户余额充足：在 GravitexAI 控制台 查看余额；
  4. 配置已同步：在 CC Switch 中确认配置已写入 Claude Code 的 ~/.claude/ 目录；
  5. 重启 CLI：环境变量类的修改需要重启终端会话。
gpt-5.1-codex 等 Codex 系列模型仅支持 Responses API。请在 OpenCode 的 opencode.jsonc 中为该模型添加 "apiCompatibility": "responses"，详见 OpenCode 配置指南。
CC Switch 支持自动检测已安装 CLI 工具的现有配置。首次启动时会扫描 ~/.claude/、~/.codex/、~/.config/opencode/ 等目录并导入。也可手动通过 导入配置 功能导入备份文件。
Thinking（推理）模型会强制启用思维链模式，在回答前进行深度推理分析，适合复杂逻辑推理、架构设计等场景。标准模型响应更快，适合日常编程和简单任务。GravitexAI 模型广场中带 -thinking 后缀的即为对应推理版本。
CC Switch 完全免费开源（MIT 许可证）。只有 API 调用会产生费用，按 GravitexAI 的 token 定价计费。

​
六、最佳实践

高效使用建议：
  1. 统一 Provider：将所有 CLI 工具的 Provider 都统一指向 GravitexAI，避免多套 Key、多套 Base URL 维护。
  2. 善用热切换：根据任务复杂度在 claude-opus-4-7 / claude-sonnet-4-6 / claude-haiku-4-5-20251001 之间快速切换。
  3. 启用自动故障转移：配置主备双 Provider 或双 Key，确保服务连续性。
  4. 定期备份：开启云同步，避免重装系统后丢失配置。
  5. 结合 MCP：在 CC Switch 中统一管理 MCP 服务器，所有 CLI 工具共享同一套外部能力。

​
七、参考链接

CC Switch GitHub

查看源码、提交 Issue 与下载最新版本

Claude Code 配置

Claude Code 的详细配置教程

GravitexAI 控制台

管理 API 密钥与查看用量

模型广场

浏览全部 100+ 主流 AI 模型