CC Switch：49K Star 的 Claude Code 登录绕过神器，还能管 Codex 和 Gemini CLI

CC Switch：49K Star 的 Claude Code 登录绕过神器，还能管 Codex 和 Gemini CLI

Claude Code 的登录问题一直是个痛点——国内网络环境下 OAuth 登录经常卡死，即使FQ成功，有时候也会遇到各种奇怪的问题。手动改配置文件切换到第三方 API 又容易改错。

有个项目专门解决了这个问题：CC Switch，49K Star，GitHub Trending 第一。它的核心功能就是用一个桌面 GUI 管理所有 AI CLI 工具的 API Provider，一键切换，不用再碰配置文件。

本文提纲

1. 它解决了什么问题
2. 支持哪些工具
3. 怎么绕过 Claude Code 登录
4. 50+ Provider 预设
5. 其他亮点功能
6. 安装和使用

它解决了什么问题

如果你用过 Claude Code，大概率遇到过这些情况：

• OAuth 登录页面加载不出来
• 换了网络环境后登录态丢失
• 想用第三方 API 但要手动改 ~/.claude/settings.json
• 同时用 Claude Code、Codex、Gemini CLI，每个工具的配置格式都不一样（JSON、TOML、.env）

CC Switch 把这些问题全解决了。它用 SQLite 数据库存储所有 Provider 配置，切换时原子写入到对应的配置文件，不会出现改坏的情况。

支持哪些工具

5 个主流 AI CLI 工具一站管理：

工具	配置格式	切换后是否需要重启
Claude Code	JSON	不需要（热切换）
Codex	JSON	需要
Gemini CLI	TOML	需要
OpenCode	JSON	需要
OpenClaw	JSON	需要

Claude Code 是唯一支持热切换的——切换 Provider 后不用重启终端，直接生效。

怎么绕过 Claude Code 登录

核心流程就三步：

Step 1：安装 CC Switch

# macOS (推荐 Homebrew)
brew tap farion1231/ccswitch
brew install --cask cc-switch

# Windows: 下载 .msi 安装包
# Linux: 下载 .deb / .rpm / .AppImage

Step 2：添加第三方 Provider

打开 CC Switch → 点击 "Add Provider" → 从 50+ 预设里选一个（比如 AWS Bedrock、NVIDIA NIM，或者国内的 API 中转服务）→ 填入 API Key → 保存。

Step 3：启用

选中新添加的 Provider → 点击 "Enable"。Claude Code 不需要重启终端，直接就能用。

如果以后想切回官方登录，也很简单：添加一个 "Official Login" 预设 → 切换过去 → 走正常的 OAuth 登录流程。随时在官方和第三方之间切换。

50+ Provider 预设

CC Switch 内置了 50+ 个 Provider 预设，包括：

• 官方：Anthropic Claude（直连官方 API）
• 云厂商：AWS Bedrock、Google Vertex AI、Azure
• 硬件厂商：NVIDIA NIM
• 国内中转：多个社区 API 中转服务（价格通常是官方的 30-70%）
• 自定义：填入任意兼容 OpenAI/Claude 格式的 endpoint

添加方式：选预设 → 粘贴 API Key → 完成。不需要手动编辑任何配置文件。

其他亮点功能

统一 MCP 管理

一个面板管理所有工具的 MCP Server 配置，双向同步。在 CC Switch 里添加一个 MCP Server，可以一键同步到 Claude Code、Codex、Gemini CLI、OpenClaw。

System Tray 快速切换

不用打开主界面，直接从系统托盘菜单切换 Provider。适合频繁切换的场景。

Usage 费用追踪

内置使用量仪表盘，追踪每个 Provider 的花费、请求数、Token 数量，还有趋势图表和详细的请求日志。

本地代理模式

内置本地代理，支持自动故障转移（failover）和断路器。一个 Provider 挂了，自动切到下一个。

云同步

配置数据可以同步到 Dropbox、OneDrive、iCloud 或 WebDAV 服务器，多台设备间同步。

技术架构

CC Switch 用 Tauri 2 构建，前端 React + TypeScript，后端 Rust。数据库用 SQLite，所有写操作遵循"临时文件 + 重命名"的原子写入模式，防止配置文件损坏。

Frontend (React + TS + TailwindCSS + shadcn/ui)
         │ Tauri IPC
Backend (Rust + SQLite)
         │ Atomic Writes
Config Files (JSON / TOML / .env)

数据库位置：~/.cc-switch/cc-switch.db，自动备份最近 10 个版本。

---

GitHub 地址：github.com/farion1231/cc-switch

---

作者: itech001
来源: 公众号：AI人工智能时代
主页: https://www.theaiera.cn，每日分享最前沿的AI新闻和技术。

本文首发于 AI人工智能时代，转载请注明出处。