cc-switch 配置

cc-switch 是一款开源桌面工具,支持 Windows / macOS / Linux,可以通过图形界面一键切换 Codex、Claude Code 等多个 AI 工具的 API 配置,无需手动编辑文件。

安装

前往 GitHub Releases 下载对应平台的最新安装包。当前教程使用的版本为 3.12.3。

方式一:一键导入

一键导入会同时配置好 Base URL、API Key 和用量查询。

1. 创建密钥

访问 AIOSS API 密钥 并创建密钥。

2. 导出到 CCS

导出后即可正常使用,但用量查询当前还需要进一步调整。

导出到 CCS
导出到 CCS

3. 修复默认模型

cc-switch 一键导入的默认模型名称是已经不可用的 gpt-5-codex,需要手动改为推荐模型 gpt-5.6-sol

修改默认模型
修改默认模型

方式二:手动配置

1. 添加新供应商

添加新供应商
添加新供应商

2. 填写自定义配置

  • 供应商名称:AIOSS
  • 官网链接:https://www.aioss.cc
  • API Key 获取地址:https://www.aioss.cc/keys
  • API 请求地址:https://www.aioss.cc/v1

其他部分可以保持默认或按需填写。

填写供应商配置
填写供应商配置

3. 启用新增配置

启用配置
启用配置

4. 配置用量查询

点击用量查询入口:

用量查询入口
用量查询入口

启用用量查询并填写:

  • API Key 获取地址:https://www.aioss.cc/keys
  • 请求地址:https://www.aioss.cc
填写用量查询配置
填写用量查询配置

编辑提取器代码,然后保存配置:

编辑提取器
编辑提取器
({
  request: {
    url: "{{baseUrl}}/v1/usage",
    method: "GET",
    headers: {
      "Authorization": "Bearer {{apiKey}}",
      "User-Agent": "cc-switch/1.0"
    }
  },
  extractor: function(response) {
    return {
      isValid: response.isValid,
      remaining: response.remaining,
      unit: response.unit,
      used: response.usage.total.actual_cost
    };
  }
})

完成后即可查看用量:

查看用量
查看用量

常见问题

点击测试模型时报错

检查模型名称是否正确。当前支持 gpt-5.6 系列模型(推荐 gpt-5.6-sol),以及 gpt-5.5gpt-5.4gpt-5.4-mini

修复测试模型报错
修复测试模型报错