Claude Code 的登录问题一直是个痛点——国内网络环境下 OAuth 登录经常卡死,即使FQ成功,有时候也会遇到各种奇怪的问题。手动改配置文件切换到第三方 API 又容易改错。
有个项目专门解决了这个问题:CC Switch,49K Star,GitHub Trending 第一。它的核心功能就是用一个桌面 GUI 管理所有 AI CLI 工具的 API Provider,一键切换,不用再碰配置文件。
- 它解决了什么问题
- 支持哪些工具
- 怎么绕过 Claude Code 登录
- 50+ Provider 预设
- 其他亮点功能
- 安装和使用
如果你用过 Claude Code,大概率遇到过这些情况:
- OAuth 登录页面加载不出来
- 换了网络环境后登录态丢失
- 想用第三方 API 但要手动改
~/.claude/settings.json - 同时用 Claude Code、Codex、Gemini CLI,每个工具的配置格式都不一样(JSON、TOML、.env)
CC Switch 把这些问题全解决了。它用 SQLite 数据库存储所有 Provider 配置,切换时原子写入到对应的配置文件,不会出现改坏的情况。
5 个主流 AI CLI 工具一站管理:
Claude Code 是唯一支持热切换的——切换 Provider 后不用重启终端,直接生效。
核心流程就三步:
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 登录流程。随时在官方和第三方之间切换。
CC Switch 内置了 50+ 个 Provider 预设,包括:
- 官方:Anthropic Claude(直连官方 API)
- 云厂商:AWS Bedrock、Google Vertex AI、Azure
- 硬件厂商:NVIDIA NIM
- 国内中转:多个社区 API 中转服务(价格通常是官方的 30-70%)
- 自定义:填入任意兼容 OpenAI/Claude 格式的 endpoint
添加方式:选预设 → 粘贴 API Key → 完成。不需要手动编辑任何配置文件。
一个面板管理所有工具的 MCP Server 配置,双向同步。在 CC Switch 里添加一个 MCP Server,可以一键同步到 Claude Code、Codex、Gemini CLI、OpenClaw。
不用打开主界面,直接从系统托盘菜单切换 Provider。适合频繁切换的场景。
内置使用量仪表盘,追踪每个 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人工智能时代,转载请注明出处。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/280613.html