Skip to content

🔀 CC Switch 配置 7Code.cc 教程

CC Switch 是一款跨平台桌面应用,用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI CLI 工具的 API 提供商配置。无需手动修改各工具的配置文件,一键切换即可生效。更多信息请参考 CC Switch GitHub


方式一:一键导入(推荐)

7Code.cc 控制台支持一键导入配置到 CC Switch,无需手动填写 API 地址和密钥。

  1. 访问 7Code.cc 控制台 - 令牌管理
  2. 找到你要使用的令牌,点击右侧的「聊天」下拉菜单
  3. 选择 CC Switch,即可自动将 API 配置导入到 CC Switch

提示

一键导入会自动配置 API 地址和密钥,导入后在 CC Switch 中点击启用即可开始使用。


方式二:手动配置

如果一键导入不可用,也可以按照以下步骤手动配置。


步骤 1:安装 CC Switch

🍎 macOS

方法一:Homebrew(推荐)

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

方法二:手动安装

前往 CC Switch Releases 下载最新 DMG 安装包。

macOS 安全提示

首次打开可能提示「无法验证开发者」,请前往「系统设置」→「隐私与安全性」中点击「仍要打开」。

⊞ Windows

前往 CC Switch Releases 下载 MSI 安装包或便携版 ZIP。

🐧 Linux

  • Arch Linux:paru -S cc-switch-bin
  • 其他发行版:前往 CC Switch Releases 下载 DEB / RPM / AppImage

步骤 2:获取 API 密钥

访问 7Code.cc 控制台,创建一个新的令牌:

  • 点击「添加令牌」
  • 名称:随便填写,方便自己区分即可
  • 令牌分组:根据实际需要选择,分组有详细描述(必填项,不能留空)
  • 额度建议:设置为无限额度

创建成功后,复制令牌备用。


步骤 3:添加 7Code.cc 提供商

  1. 打开 CC Switch,点击主界面中的 Add Provider(添加提供商)
  2. 填写以下配置信息:
    • API Base URLhttps://ai.7code.cc
    • API Key:粘贴从 7Code.cc 控制台复制的令牌
    • 模型名称:填写你需要使用的模型(如 claude-opus-4-6
  3. 选择目标应用(Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw)
  4. 点击确认保存

重要提示

API 地址必须填写 https://ai.7code.cc,请勿遗漏或填错!


步骤 4:启用并验证

  1. 在 CC Switch 的提供商列表中,找到刚添加的 7Code.cc 配置
  2. 点击 Enable(启用)激活该提供商
  3. 重启终端使配置生效(Claude Code 支持热切换,无需重启)
  4. 在对应的 CLI 工具中发送一条消息,确认能正常响应

切换提供商

CC Switch 支持一键在不同提供商之间切换。如需切换回官方登录,添加 Official Login 预设并启用即可。


支持的 CLI 工具

CC Switch 会自动修改各工具的原生配置文件:

CLI 工具配置文件路径
Claude Code~/.claude/settings.json
Codex~/.codex/config.toml
Gemini CLI~/.gemini/.env
OpenCode对应配置文件
OpenClaw~/.openclaw/openclaw.json

常见问题

问题可能原因解决方案
切换后 CLI 工具无响应终端未重启关闭并重新打开终端(Claude Code 除外)
API 请求失败API 密钥或地址错误检查 7Code.cc 令牌是否正确,API 地址是否为 https://ai.7code.cc
macOS 无法打开应用安全策略限制前往「系统设置」→「隐私与安全性」中允许打开

可用模型:访问 7Code.cc 模型广场 查看所有可用模型。

对接一:配置用量查询

对接7Code.cc后 配置用量查询,可在工具中更方便的查看余额使用情况。

  1. 访问 7Code.cc 控制台 - 个人资料
  2. 点击[安全]中的[访问令牌],生成访问令牌并复制
  3. 打开 CC Switch,点击配置用量查询图标
  4. 启用用量查询,预设模板选择NewAPI,填写以下配置:
    1. 请求地址:https://ai.7code.cc
    2. 访问令牌:粘贴从 7Code.cc 控制台复制的令牌
    3. 用户ID:从7Code.cc控制台获取,如找不到请联系客服获取
    4. 超时时间:默认10秒即可
    5. 自动查询间隔:默认1分钟查询,推荐5-10分钟,0为关闭自动查询
  5. 点击下方的测试脚本,如果正常,就点击保存配置即可

提示

  1. 访问令牌是必填项,请勿删除。