工具教程

CC Switch 教程：多工具 API Key 统一管理，一键切换 OpenStarry

📅 2026-06-09✍️ OpenStarry
工具教程CC Switch教程openstarry.com

如果你同时使用 Claude Code + Codex CLI + Cursor + Cline + OpenCode，你大概率会经历这种痛苦：

  1. 某天 OpenAI 官方 Key 突然报 429 限流
  2. 你想切到 OpenStarry 的 GLM-5.1 应急
  3. 结果要去改 5 个不同的配置文件（~/.zshrc、~/.codex/config.toml、Cursor 设置、Cline 设置、opencode.json），每改一处都得重启工具
  4. 过两天想切回 OpenAI，又得改 5 处

CC Switch（github.com/farion1231/cc-switch）就是为这个场景设计的：在一个 GUI / CLI 里管理所有 AI 编程工具的 Provider，一键切换 OpenStarry / 官方 / 其他厂商的 Key 和 base_url，所有相关工具自动生效。配合 OpenStarry，5 分钟配好、终身受益。完整官方文档可参考 OpenStarry Docs · 工具接入。

一、CC Switch 能做什么

1.1 核心功能

1.2 支持的工具一览

工具配置文件路径CC Switch 改写方式
Claude Code~/.zshrc 中的 ANTHROPIC_* 环境变量写入 ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY
Codex CLI~/.codex/config.toml改写 model_providers.openstarry 块
Cursor~/.cursor/settings.json改写 openai.baseUrl + openai.apiKey
Cline / Kilo / RooVS Code 扩展配置（全局 settings.json）改写 cline.apiProvider + baseUrl + apiKey
OpenCodeopencode.json（项目级或 ~/.config/opencode/）改写 provider.openstarry 块
Trae Agent~/.trae-agent/config.yaml改写 llm.api_base + llm.api_key
Gemini CLI~/.gemini/settings.json改写 apiBaseUrl + apiKey
Hermes Agent~/.hermes/config.yaml改写 providers.openai_compatible 块

二、环境准备

2.1 安装 CC Switch

CC Switch 提供 GUI（macOS / Windows / Linux）和 CLI（所有平台）两种形态，建议都装。

GUI 安装

# macOS（Homebrew Cask）
brew install --cask cc-switch

# Windows（winget）
winget install cc-switch

# Linux（AppImage，Ubuntu/Debian/Fedora 通用）
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch.AppImage
chmod +x cc-switch.AppImage
./cc-switch.AppImage

CLI 安装（推荐，无头服务器友好）

# macOS
brew install cc-switch-cli

# Linux / WSL / 容器
curl -fsSL https://raw.githubusercontent.com/farion1231/cc-switch/main/install.sh | bash

# 验证
cc-switch --version
# 期望：cc-switch 1.x.x

2.2 获取 OpenStarry API Key

  1. 访问 openstarry.com 注册账号
  2. 进入 Dashboard → API Keys → 创建新 Key，复制（sk- 开头）
  3. 首次注册赠送 星痕版 200 次免费调用

推荐订阅 星途版 ¥99/月 · 20000 次/月，计费规则，适合重度开发者。

三、配置 OpenStarry Provider（核心步骤）

方式 1：GUI（推荐首次使用）

  1. 打开 CC Switch
  2. 左侧 Providers 标签 → 点击 + Add Provider
  3. 填写：
    • Name: OpenStarry
    • Base URL: https://api.openstarry.com/v1
    • API Key: sk-your-key-here
  4. 勾选要应用此 Provider 的工具：Claude Code、Codex CLI、Cursor、Cline、OpenCode、Trae Agent、Gemini CLI、Hermes（可多选）
  5. 点击 Save & Apply

CC Switch 会自动重写每个工具的配置文件并在底部显示 diff，确认无误后点 Confirm 即可。

方式 2：CLI（适合 SSH 远端或脚本化）

CC Switch CLI 默认配置文件在 ~/.cc-switch/config.yaml。

# 初始化（首次运行）
cc-switch init

# 添加 OpenStarry provider
cc-switch provider add openstarry \
  --base-url https://api.openstarry.com/v1 \
  --api-key sk-your-key-here \
  --tools claude-code,codex-cli,cursor,cline,opencode,trae-agent,gemini-cli,hermes

# 查看所有 provider
cc-switch provider list

# 切换到 OpenStarry（应用到所有已勾选的工具）
cc-switch switch openstarry

# 切换到 OpenAI 官方（备选）
cc-switch provider add openai-official \
  --base-url https://api.openai.com/v1 \
  --api-key sk-openai-xxxx
cc-switch switch openai-official

方式 3：直接编辑配置文件（高级）

配置文件 ~/.cc-switch/config.yaml：

# ~/.cc-switch/config.yaml
active_provider: openstarry

providers:
  openstarry:
    name: OpenStarry
    base_url: https://api.openstarry.com/v1
    api_key: ${OPENSTARRY_API_KEY}    # 引用环境变量，配置文件不进 Git
    models: [glm-5.1, deepseek-v4-pro, claude-sonnet-4-6, kimi-k2.6]
    note: 主力 provider，国产 + 国际旗舰混合

  openai-official:
    name: OpenAI
    base_url: https://api.openai.com/v1
    api_key: ${OPENAI_API_KEY}
    models: [gpt-4o, gpt-5.4]
    note: 备选，仅在 OpenStarry 故障时切换

tools:
  claude-code:    { enabled: true, config: ~/.zshrc,           env_keys: [ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL] }
  codex-cli:      { enabled: true, config: ~/.codex/config.toml }
  cursor:         { enabled: true, config: ~/.cursor/settings.json }
  cline:          { enabled: true, config: ~/.config/Code/User/settings.json }
  opencode:       { enabled: true, config: ~/.config/opencode/config.json }
  trae-agent:     { enabled: true, config: ~/.trae-agent/config.yaml }
  gemini-cli:     { enabled: true, config: ~/.gemini/settings.json }
  hermes:         { enabled: true, config: ~/.hermes/config.yaml }

执行 cc-switch apply 让配置生效。

四、典型使用场景

场景 1：日常编码用 OpenStarry GLM-5.1

cc-switch switch openstarry
# 所有工具现在都走 OpenStarry，按 Coding Plan ¥99/月 / 20000 次计费

# 验证
claude    # 启动 Claude Code，会话里问"你底层接的是哪个模型？"
codex     # 启动 Codex CLI，问同样的问题
# 都会回答：通过 OpenStarry，使用 glm-5.1

场景 2：OpenStarry 故障时切回 OpenAI 官方

# 1 秒切换全部工具
cc-switch switch openai-official

# 不需要重启任何工具，下一次发起请求时自动用新 Key

场景 3：按项目自动选择

在 ~/.cc-switch/projects.d/ 下创建项目级 override：

# ~/projects/client-a/.cc-switch.yaml
provider: openstarry
model: claude-opus-4-7
note: 客户 A 项目，必须用最强模型

# ~/projects/internal-tools/.cc-switch.yaml
provider: openstarry
model: deepseek-v4-flash
note: 内部工具，用便宜模型即可

在 cd 进项目目录时 CC Switch 自动加载项目级 override：

# 安装 shell 钩子（首次）
cc-switch install-shell-hook
source ~/.zshrc

# 现在进项目自动切
cd ~/projects/client-a
claude    # 启动后自动用 claude-opus-4-7

cd ~/projects/internal-tools
claude    # 自动用 deepseek-v4-flash

场景 4：与 GitHub Actions / CI 集成

# .github/workflows/ai-review.yml
name: AI Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install CC Switch CLI
        run: curl -fsSL https://raw.githubusercontent.com/farion1231/cc-switch/main/install.sh | bash
      - name: Switch to OpenStarry
        run: |
          echo "${{ secrets.OPENSTARRY_API_KEY }}" > /tmp/key
          cc-switch provider add openstarry --base-url https://api.openstarry.com/v1 --api-key "$(cat /tmp/key)"
          cc-switch switch openstarry
      - name: Run Claude Code review
        run: |
          claude --model openstarry/clm-5.1 "review the diff in this PR and post inline comments"

五、常见问题

Q1：CC Switch 改写后 Claude Code 还是用官方 Key？

检查 echo $ANTHROPIC_API_KEY 是不是 OpenStarry 的 sk- 开头。Shell 环境变量是启动时加载的，CC Switch 改的是 ~/.zshrc 里的 export，需要 source ~/.zshrc 或重开终端才能生效。

Q2：能不能在 CC Switch 里同时保存多个 OpenStarry Key？

可以。给不同的 Key 起不同的 name：

cc-switch provider add openstarry-personal --base-url https://api.openstarry.com/v1 --api-key sk-personal-xxx
cc-switch provider add openstarry-team    --base-url https://api.openstarry.com/v1 --api-key sk-team-xxx
cc-switch switch openstarry-team   # 切到团队 Key

适合个人项目用个人 Key 计费、公司项目用公司 Key 走报销。

Q3：改写后工具报 401？

99% 是 Key 拼写错误。检查：

# 1. 确认 Key 格式
cc-switch provider show openstarry
# 应该看到 api_key: sk-xxxxxxxx

# 2. 直接测连通性
cc-switch test openstarry
# 会发送一个简单的 chat/completions 请求验证

Q4：Cursor 切到 OpenStarry 后 Settings 页面变了？

正常现象。Cursor 的 Settings → Models 页面会展示当前 provider 列表。OpenStarry 提供的模型 ID 需要手动 + Add model 加入：glm-5.1、deepseek-v4-pro 等。完整列表见 OpenStarry Docs · 模型列表。

Q5：想完全卸载 CC Switch 怎么办？

# macOS
brew uninstall --cask cc-switch
rm -rf ~/.cc-switch
# 然后手动还原备份：~/.cc-switch/backups/ 里有每次切换的 diff 备份

CC Switch 每次切换前都会把原配置备份到 ~/.cc-switch/backups/<timestamp>/，完全可逆。

总结

CC Switch 是 AI 编程时代的「Provider 切换中心」：在一个 GUI/CLI 里管理 Claude Code、Codex CLI、Cursor、Cline、OpenCode、Hermes 等所有工具的 Key 和 base_url，一键切换 OpenStarry 与其他厂商。

配合 OpenStarry：

回看 3 步：brew install --cask cc-switch → 添加 OpenStarry provider → 勾选工具 → cc-switch switch openstarry。整个过程 5 分钟内完成。

5 分钟配好 CC Switch

统一管理所有 AI 编程工具的 API Key，一键切换 OpenStarry / 官方 Key

免费注册 →
相关阅读
AI 编程

Claude Code 接入指南

配置第三方 API 实现高效 AI 编程
AI 编程

OpenCode 接入指南

配置 OpenStarry 替代 Claude Code 旗舰开源方案
AI 编程

Codex CLI 接入指南

OpenAI 官方终端 Agent 接入 OpenStarry
AI 编程

Hermes Agent 接入指南

多 Agent 编排框架接入 OpenStarry
相关阅读
工具教程

OpenCode 接入指南：配置 OpenStarry 替代 Claude Code 旗舰开源方案

📅 2026-06-09
工具教程

Hermes Agent 接入指南：多 Agent 编排框架接入 OpenStarry

📅 2026-06-09
工具教程

Codex CLI 接入指南：把 OpenAI 终端 Agent 接到 OpenStarry 用国产模型

📅 2026-06-09
工具教程

Cline 配置指南：5M 安装量的 AI 编程插件，如何接入第三方 API

📅 2026-06-08