CC Switch 接入指南
将 疾旋Token 接入 CC Switch，一键统管 Claude Code、Codex、Gemini CLI、OpenCode 等全套 AI 编程工具的供应商配置与无缝切换。
CC Switch 是一款广受好评的开源跨平台 AI CLI 统一管理控制中心（GitHub: farion1231/cc-switch）。
在日常 AI 辅助编程中，开发者通常需要使用多种命令行 Agent（如 Claude Code、Codex、Gemini CLI、OpenCode 等），而每个工具往往采用各自独立的配置文件（如 ~/.claude/settings.json、~/.codex/config.toml 等）。CC Switch 提供了统一的可视化面板，让您只需一键即可在各个工具中激活 疾旋Token 旗舰专线节点，彻底告别繁琐的手工修改。
📦 安装 CC Switch
CC Switch 支持 Windows、macOS、Linux 以及无头服务器 Web 版本：
# 推荐使用 Homebrew 一键安装
brew tap farion1231/ccswitch
brew install --cask cc-switch⚙️ 接入配置指南（GUI 可视化方式）
获取疾旋Token 专属密钥
- 登录 疾旋Token 控制台。
- 进入 「令牌」 -> 点击 「添加令牌」，创建一个专用令牌（例如命名为
CC Switch）。 - 复制生成的以
sk-开头的密钥字符串。
在 CC Switch 中添加自定义供应商 (Custom Provider)
- 启动 CC Switch 客户端。
- 在界面左侧或顶部选择您需要配置的目标工具（如 Claude Code、Codex 或 OpenCode）。
- 点击主界面右上角的 「+」 (Add Provider) 按钮，并在弹出的窗口中选择 「Custom (自定义)」 选项卡。
- 填写以下连接参数：
| 参数项 | 填写内容 | 说明 |
|---|---|---|
| 供应商名称 (Name) | 疾旋Token | 自定义标识名称，便于在列表中识别 |
| 接口地址 (Base URL) | https://token.astrumflow.com/v1 | 必须包含 /v1，不要填写子路径如 /chat/completions |
| API 密钥 (API Key) | sk-your-astrumflow-token-key | 粘贴您的疾旋Token 密钥 |
| 默认模型 (Model) | GPT-5.6-sol | 推荐主力推理，亦可配置 GPT-5.6-terra |
| 协议格式 (Wire API) | openai（或 responses） | 标准 OpenAI 格式选 openai；Codex 原生可选用 responses |
- 点击 「Add / Save」 保存配置。
激活疾旋Token 节点
在供应商列表中找到刚创建的 疾旋Token，点击右侧的 「Enable」 按钮。状态切换为 「Active」 即表示当前全局/工具配置已自动注入生效。
生效原理：点击 Enable 后，CC Switch 会自动同步修改目标工具的本地配置文件（如 ~/.claude/settings.json 或 ~/.codex/config.toml），无需手动打开文件修改。
启动终端验证使用
打开您的终端，直接启动对应的 AI 编程助手：
# 启动 Claude Code
claude
# 或启动 Codex CLI
codex
# 或启动 OpenCode
opencode在交互界面中输入任意指令（例如：请解释当前项目的目录结构与核心入口），系统将通过疾旋Token 专线高速返回推理结果！
🔗 深链一键导入 (ccswitch://)
CC Switch 支持标准 ccswitch:// Deep Link 导入协议：
- 在支持一键导入的控制台令牌管理页中，点击对应令牌下拉菜单中的 「一键填入 CC Switch」。
- 系统会自动拉起 CC Switch 客户端并弹出确认导入弹窗，核对模型分配后点击 「打开 CC Switch」 即可秒级完成接入。
🛡️ 本地代理与故障转移机制 (Local Routing)
CC Switch 内部集成了本地高可用代理服务（默认监听端口 127.0.0.1:15721）：
自动故障转移 (Failover)
支持配置备用降级节点。当主力节点遇到上游异常时，自动秒级无感切换至备用链路。
熔断保护与重试平滑
智能识别 429 限流与网络瞬断，执行指数退避重试，保障长时间代码重构不中断。
多工具统一 MCP 管理
在 CC Switch 面板中集中管理所有 MCP (Model Context Protocol) 工具服务器，全端自动同步。
💻 环境变量快速注入模式（无需 GUI）
若您在纯终端或无桌面环境下工作，也可直接通过环境变量指定疾旋Token：
export OPENAI_BASE_URL="https://token.astrumflow.com/v1"
export OPENAI_API_KEY="sk-your-astrumflow-token-key"
export ANTHROPIC_BASE_URL="https://token.astrumflow.com/v1"
export ANTHROPIC_API_KEY="sk-your-astrumflow-token-key"