CC Switch CLI：服务器上怎么装、怎么切
CC Switch CLI 是社区维护的命令行版，不是 CC Switch 官方产品：官方 README 写明 CC Switch 本身只发布需要图形界面的桌面应用，并在服务器、SSH 会话或没有桌面环境的机器上推荐它。它是 CC Switch 的 CLI 分支（fork），由另一位作者独立发版。下面按该项目的 README 写安装、切换与共用数据目录，接 QCode 的字段照 QCode 文档。
更新于 2026-10-20
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
要点：它是什么、怎么装、怎么切、数据目录、接 QCode
不是 CC Switch 官方产品
它是 CC Switch 的 CLI 分支，由另一位作者独立发版，不是 CC Switch 官方出品；官方 README 在服务器、SSH 会话或没有桌面环境的机器上推荐它。
两条安装路径
该项目 README 写的快速安装是 curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash，装到 ~/.local/bin；也写了 Homebrew 的 brew install cc-switch-cli。
列出与切换
该项目 README 列的基本用法：cc-switch 进全屏终端界面；cc-switch provider list 列出已保存的接入配置；cc-switch provider switch（id） 切换；cc-switch use（id） 是上一条的简写；cc-switch --app codex provider list 用 --app 指定工具，默认是 claude。
与桌面版共用数据目录
QCode 文档写明：该 CLI 默认和桌面版共用 ~/.cc-switch 数据目录；它支持的数据库版本有时落后于桌面版，遇到数据库版本过新的提示就升级 CLI，或等它跟进。
什么时候用得上命令行版
在服务器、SSH 会话、容器这类没有桌面环境的机器上，桌面版装不了，这时可以用命令行版。该项目自己的 README 写它提供全屏终端界面与可写进脚本的命令行两种用法。
官方推荐与最新版本
CC Switch 官方 README 的常见问题「有没有命令行版」一节推荐社区维护的 CC Switch CLI；该 CLI 项目最新版本为 v5.11.2（发布于 2026-10-16）。
时间线
CC Switch 桌面版 v4.0.12 发布；QCode 文档页写明下载与命令行章节是按 2026-10-15 的 README 与 Releases 核对的。
QCode 文档《CC Switch 配置》页标注的更新日期；该页写明官方没有命令行版、服务器与 SSH 场景推荐社区 CLI，以及默认共用 ~/.cc-switch 数据目录。
社区 CLI 项目发布 v5.11.2（release 页的 tag 是 v5.11.2，发布时间 2026-10-16T13:51:51Z）；QCode 文档页在 2026-10-15 核对时记的是 v5.11.1。
哪些有出处，哪些没有
有出处的内容
① 官方 README 写明 CC Switch 只发布需要图形界面的桌面应用。② 服务器、SSH 会话或没有桌面环境的机器上，官方 README 推荐社区维护的 CC Switch CLI；据社区项目 README 与 QCode 文档，它是 CC Switch 的 CLI 分支，由另一位作者独立发版，不是 CC Switch 官方出品。③ 该项目 README 给出两条安装路径：安装脚本与 Homebrew。④ 基本用法包括进入全屏终端界面、列出、切换、简写切换、用 --app 指定工具、只让一次启动用指定配置。⑤ 默认与桌面版共用 ~/.cc-switch 数据目录，核心数据在 ~/.cc-switch/cc-switch.db，可用 CC_SWITCH_CONFIG_DIR 换目录。⑥ 接 QCode 的字段照 QCode 文档：Claude 侧 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，Codex 侧 Base URL 与 API Key。
官方与社区项目都没写的
① 官方没有给出命令行版与桌面版的功能差异对照表，QCode 文档也写明没有逐项测试社区 CLI。② 社区项目的 README 没有写它与桌面版之间的数据库版本兼容关系。③ 两边都没有写「database version is too new」出现的具体条件。④ 两边都没有写这个 CLI 在容器镜像里需要哪些依赖。
命令行版与桌面版
桌面版（官方）
QCode 文档页列出的桌面版安装方式是各系统的安装包与包管理器命令；装完是一个带图形界面的应用。
命令行版（社区分支）
社区项目提供全屏终端界面与可写进脚本的命令行两种用法；两边版本不一致时，CLI 会提示数据库版本过新。
在服务器上装好、切配置、确认版本
① 安装：按该项目 README 跑 curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash，装到 ~/.local/bin；或用 Homebrew 的 brew install cc-switch-cli。② 加配置：cc-switch provider add，字段照 QCode 文档填。③ 切换：cc-switch provider switch（id），简写是 cc-switch use（id）；只想让这一次启动用指定配置，用 cc-switch start claude（id），README 写明这只影响该命令启动的会话，provider switch 与 use 仍会改全局配置。④ 数据目录与升级：核心数据默认在 ~/.cc-switch/cc-switch.db，可用 CC_SWITCH_CONFIG_DIR 换到别的目录（README 写明 ~/.cc-switch 里已有的数据不会自动迁移）；README 写明用 Homebrew 装的应改用 brew upgrade cc-switch-cli。
在 QCode 上
照 QCode 文档《CC Switch 配置》：Claude 侧填 ANTHROPIC_BASE_URL https://api.qcode.cc/api 与 ANTHROPIC_AUTH_TOKEN（cr_ 开头的密钥），Codex 侧填 Base URL https://api.qcode.cc/openai 与 API Key；CC Switch 会把配置写进 ~/.claude/settings.json 与 ~/.codex/config.toml。QCode 按 token 计费，各模型单价见 qcode.cc/models。要在服务器上长跑 Claude Code 或 Codex，可以用 QCode 云服务器：把机器放在海外，在服务器上装好 Claude Code / Codex，用你的 QCode Key 调用模型；AI 服务和云服务器共用一个余额（qcode.cc/cloud）。
常见问题
CC Switch 有官方命令行版吗？
没有。官方 README 写明 CC Switch 只发布需要图形界面的桌面应用；服务器、SSH 会话或没有桌面环境的机器上，官方 README 推荐社区维护的 CC Switch CLI（据社区项目 README 与 QCode 文档，它不是 CC Switch 官方出品）。
服务器上怎么装？
该项目 README 给了两条：Homebrew 的 brew install cc-switch-cli；或者 curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash，装到 ~/.local/bin。README 也写了手动下载对应平台的压缩包、再放进 PATH 的方式，Linux 版提供的是静态 musl 构建。
怎么切到另一个配置？
该项目 README 的基本用法：cc-switch provider list 列出已保存的接入配置；cc-switch provider switch（id） 切换；cc-switch use（id） 是上一条的简写；cc-switch --app codex provider list 用 --app 指定工具，默认是 claude。只想让一次启动用指定配置，用 cc-switch start claude（id）。
提示 database version is too new 怎么办？
官方 README 的常见问题与 QCode 文档都写明：该 CLI 默认和桌面版共用 ~/.cc-switch 数据目录，它支持的数据库版本有时落后于桌面版；看到这个提示就升级 CLI，或等它跟进。
接 QCode 要填哪些字段？
照 QCode 文档《CC Switch 配置》：Claude 侧 ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api，ANTHROPIC_AUTH_TOKEN 填 cr_ 开头的密钥；Codex 侧 Base URL 填 https://api.qcode.cc/openai，API Key 填同一把密钥。CC Switch 会把这些写进 ~/.claude/settings.json 与 ~/.codex/config.toml。以上字段名出自 QCode 文档对桌面版的说明，QCode 文档写明没有逐项测试社区 CLI，在命令行里用 cc-switch provider add 时请以界面里实际出现的提示为准。
npm 上有同名的 cc-switch-cli 吗？
有，但与 README 里的这个项目不是同一个东西：npm registry 上那个包的维护者是 jacob.shi，最新版 1.0.1，发布于 2026-04-26；而官方 README 指向的项目是 Rust 写的二进制程序，命令名是 cc-switch，README 里没有 npm 的安装方式。按 README 装 Homebrew 版或安装脚本版。
信息来源
社区 CC Switch CLI 项目的 README 与 releases/latest（tag v5.11.2，发布于 2026-10-16，2026-10-20 抓取核对）；QCode 文档《CC Switch 配置》页（更新于 2026-10-15，2026-10-20 抓取核对）；npm registry 上同名包的元数据（2026-10-20 抓取核对）。
相关阅读
Claude Code 按量包：不包月，7–90 天有效
一次买一笔额度，7–90 天有效，不订阅；续买累加到同一把 Key。
CC Switch 使用教程：Claude Code/Codex 切换 API
桌面版怎么在 Claude Code 与 Codex 之间切换 API，配置字段与切换不生效的排查。
CC Switch 4.0 聚合模式、深链与 CLI（2026）
4.0 把直连、路由、聚合拆成三个标签，并写明官方 README 里没有命令行版。
加密货币充值指南
9 种币、56 条网络，0 平台手续费购买 AI 编程 API 额度。
本页内容核对于 2026-10-20，以社区 CC Switch CLI 项目的 README 与 release、QCode 文档为准；该项目由社区维护并独立发版，版本与功能可能随时变化，安装前请先读它的 README。QCode 侧的配置字段以 QCode 文档为准，模型可用性以 /models 为准。