快速开始

通过 CC Switch 一站式管理 Claude Code、Codex、Gemini CLI 的 API 配置，三步完成接入。

第一步：注册并获取 API Key

1. 前往 RootFlow AI 账户中心 注册账号
2. 联系工作人员充值（按量计费，无最低消费，详见 服务定价）
3. 进入账户中心 令牌 → 新建令牌，复制生成的 API Key（sk- 开头）

详细说明见 获取 API Key。

提示：网页登录入口为 https://rootflowai.com/account，API 请求地址为 https://api.rootflowai.com 或 https://api.rootflowai.com/v1。两者用途不同，请勿混用。

第二步：安装 CC Switch

CC Switch 是一款跨平台桌面工具，可以在一个界面中统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等多个 AI CLI 工具的 API 配置，免去手动编辑配置文件的麻烦。

macOS（推荐 Homebrew）

brew tap farion1231/ccswitch
brew install --cask cc-switch

macOS（手动安装）

前往 Releases 页面 下载 .dmg 文件，拖入 Applications 即可。

Windows

下载 最新 .msi 安装包，双击安装。也提供免安装的 Portable 版本。

Linux

# Arch Linux
paru -S cc-switch-bin

# Debian / Ubuntu：下载 .deb
# Fedora / RHEL：下载 .rpm
# 通用：下载 .AppImage

所有安装包见 GitHub Releases。

第三步：配置 Provider

打开 CC Switch，点击 Add Provider，为每个 CLI 工具添加 RootFlow AI 作为 Provider。

Claude Code

模型和分组会随上游能力调整。请在模型价格页选择当前支持 Claude Code 的模型，并以页面显示的实时价格为准。

Codex（OpenAI）

在模型价格页选择支持 Responses 接口的当前 Codex 模型。不要从旧教程复制模型 ID 或倍率。

Gemini CLI

在模型价格页选择当前可用的 Gemini 模型。模型 ID、分组和价格以实时页面为准。

配置完成

在 CC Switch 中选择刚添加的 Provider，点击 Enable 启用。重启对应的 CLI 工具即可生效。

::: tip 小技巧

• Claude Code 支持热切换，无需重启终端
• 可以通过系统托盘图标快速切换不同 Provider
• CC Switch 支持为同一工具添加多个 Provider，方便在不同分组间切换

下一步

• 完整 API 接口参考 — 直接通过 SDK 调用
• Codex 安装与接入 RootFlowAI — Codex CLI、App、IDE 与手动配置
• Grok 安装与接入 RootFlowAI — 官方 Grok CLI 与 Codex 两种接入方式
• Claude Code 安装配置教程 — 不使用 CC Switch 的手动配置方式
• Cursor 接入教程 — 在 Cursor 中使用 RootFlow AI
• 服务定价 — 各分组详细价格说明