CC Switch CLI
在服务器、SSH 和终端里用命令行版 CC Switch 配置 OminiApi
CC Switch CLI 适合服务器、SSH、macOS 终端和自动化场景。习惯图形界面的话，用前面的桌面版教程即可。
CC Switch CLI 是 CC Switch 的命令行版本，用来管理 Claude Code、Codex、OpenCode 与 OpenClaw 的供应商配置，也支持 MCP、Skills、提示词、本地代理和环境检查。
它包含两部分：
- TUI 界面：运行
cc-switch进入终端图形界面，可以像桌面版一样新增供应商、填写 API Key、保存并切换。 - CLI 命令：用命令完成供应商查看、切换、环境检查、MCP 同步等操作。
第一次配置推荐用 TUI；配置好以后，日常切换和排错直接用命令更快。
安装
macOS 和 Linux 推荐一键安装脚本：
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash默认安装到 ~/.local/bin。如果提示找不到 cc-switch，确认 ~/.local/bin 已经加入 PATH。
也可以手动安装：
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-darwin-universal.tar.gz
tar -xzf cc-switch-cli-darwin-universal.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
# 如遇「无法验证开发者」提示
xattr -cr /usr/local/bin/cc-switch配置前准备
先确认目标 CLI 已经安装：
cc-switch env tools建议先运行一次目标 CLI 的帮助命令，让它创建自己的配置目录：
claude --help
codex --help然后在控制台「API 密钥」页面创建一个密钥并复制，见 API 密钥。
配置 OminiApi
下面以 Claude Code 为例，Codex 的步骤相同，只需要用 --app codex 切换目标应用。
进入 TUI：
cc-switch # 默认是 Claude Code
cc-switch --app codex # 直接配置 Codex在左侧选择 Providers，进入供应商管理页面，新增一个自定义供应商。
按工具填写：
| 工具 | 请求地址 | API Key | 模型 |
|---|---|---|---|
| Claude Code | https://omini.ominiapi.top | 你的 API 密钥 | 如 claude-sonnet-5-5 |
| Codex | https://omini.ominiapi.top/v1 | 你的 API 密钥 | 如 gpt-6.1-sol |
模型怎么选见 Claude Code 配置 和 Codex 配置。填好后保存。
回到供应商列表，确认当前选中的是刚添加的 OminiApi。
如果配置的是 Claude Code，进入「设置」，确认「跳过 Claude Code 初次安装确认」已开启。这个选项会向 ~/.claude.json 写入 hasCompletedOnboarding=true，避免 Claude Code 首次启动时卡在登录流程。
打开对应 CLI 测试能否正常对话：
claude
# 或
codex常用命令
cc-switch # 进入交互界面
cc-switch env tools # 检查本地 CLI 是否安装
cc-switch env check # 检查环境变量冲突
cc-switch provider list # 查看 Claude 供应商
cc-switch provider current # 查看当前 Claude 供应商
cc-switch provider switch <id> # 切换 Claude 供应商
cc-switch --app codex provider list # 查看 Codex 供应商
cc-switch provider stream-check <id> # 检查供应商流式响应
cc-switch provider fetch-models <id> # 拉取远端模型列表
cc-switch update # 更新 CC Switch CLIclaude 是默认应用，管理 Codex、OpenCode 或 OpenClaw 时用全局参数 --app 指定。
让 AI 助手帮你操作
已经在 Claude Code 或 Codex 里工作的话，可以直接让它调用 cc-switch 检查和切换配置，例如：
帮我运行 cc-switch provider list，看一下当前有哪些 Claude 供应商。帮我运行 cc-switch --app codex provider current，确认 Codex 当前是不是 OminiApi。帮我运行 cc-switch env check --app claude，检查有没有环境变量覆盖配置。AI 助手负责执行命令和解释结果，你只需要确认切换供应商、覆盖配置这类关键操作。
常见问题
切换供应商后没有生效
先确认目标 CLI 已经初始化过配置目录（运行一次 claude --help / codex --help），然后重新切换一次供应商，并在新终端里启动 CLI。
环境变量覆盖了配置
如果系统里设置了 ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL、OPENAI_API_KEY 等环境变量，CLI 可能优先读取环境变量，导致 CC Switch CLI 写入的配置不生效。运行下面的命令检查：
cc-switch env check --app claude
cc-switch env check --app codex找到冲突的变量后删除它，重新打开终端即可。