【开源】一个丝滑的 Claude Code 环境变量快速切换工具

极客密码
242 阅读3分钟

起因是给家里 M 系列芯片的 Macmini 装了 cc-switch 之后觉得非常好用，可以很方便的将很多不同的 claude code 中转 API 站管理起来，切换也非常丝滑

cc-switch

因此也给公司这台 Intel 芯片的黑苹果装上了，系统是 Big Sur 11.7.7

但因为黑苹果系统停在 MacOS Big Sur，所以导致很多使用了 Tauri 2.x 开发的软件打开基本都会丢样式

查了下说是 Big Sur 底层的 webview 版本太低了，也不想再折腾升系统了

所以就有了下面这个命令行切换工具

如果你比较喜欢 CLI 工具，想通过一行 npm install 命令就能安装一个 Claude Code 环境变量切换工具的话

那么它，将是你的不二之选。

做了新增、切换、删除、修改、额度显示等等，代码已全量开源：

github.com/isnl/ccs

CCS - Claude Code Switcher

一个用于管理多个 Claude Code API 商家配置的命令行工具。

安装

npm install -g @claude-cli/ccs

特性

  • 首次运行自动导入当前 Claude Code 配置
  • 切换前自动备份
  • 中英双语支持
  • 额度用量跟踪与显示
  • 美观的带边框表格显示

Commands / 命令

CommandAliasDescription (EN)描述 (中文)
ccs-Interactive switch交互式切换商家
ccs listccs lsList all providers列出所有商家
ccs addccs aAdd a new provider添加新商家
ccs edit [name]ccs e [name]Edit a provider编辑商家配置
ccs use [name]ccs u [name]Switch to a provider快速切换商家
ccs remove [name]ccs rm [name]Remove a provider删除商家
ccs currentccs cShow current config显示当前配置
ccs refresh [name]ccs r [name]Refresh quota info刷新额度信息
ccs lang-Switch language切换语言（中/英）
ccs --versionccs -vShow version显示版本号
ccs --helpccs -hShow help显示帮助信息

截图

2025-12-01-17-26-05

额度配置

添加或编辑商家时，可以选择配置额度显示：

  1. User ID - 在商家设置页面查看
  2. Access Token - 在设置-安全设置中获取

配置完成后，运行 ccs refresh 刷新额度信息，或在添加/编辑时自动获取。

配置

配置文件

~/.ccs.json

{
  "lang": "zh",
  "current": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "providers": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "OpenRouter",
      "description": "Main provider, cheap",
      "baseURL": "https://openrouter.ai/api/v1",
      "apiKey": "sk-or-xxx",
      "balanceConfig": {
        "enabled": true,
        "userId": "12345",
        "accessToken": "your-access-token"
      },
      "usedBalance": 12.5,
      "totalBalance": 100
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "OneAPI",
      "description": "Company internal API",
      "baseURL": "https://api.example.com/v1",
      "apiKey": "sk-xxx"
    }
  ]
}

商家字段

FieldRequiredDescription (EN)描述 (中文)
idYesUUID identifierUUID 标识符
nameYesProvider name商家名称
descriptionNoDescription/notes描述/备注
baseURLYesAPI base URLAPI 地址
apiKeyYesAPI keyAPI 密钥
balanceConfigNoQuota config object额度配置对象
balanceConfig.enabledNoEnable quota display启用额度显示
balanceConfig.userIdNoUser ID for API用户 ID
balanceConfig.accessTokenNoAccess token for API访问令牌
usedBalanceNoUsed quota (USD)已用额度 (美元)
totalBalanceNoTotal quota (USD)总额度 (美元)

切换机制

切换商家时：

  1. 备份 ~/.claude/settings.json → ~/.claude/settings.json.backup
  2. 写入 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 到 ~/.claude/settings.json

技术栈

  • Claude Code - 代码编写
  • Commander.js - 命令解析
  • Inquirer.js - 交互式提示
  • Chalk - 终端美化

License

MIT

avatar
文章
阅读
粉丝