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

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

因此也给公司这台 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 商家配置的命令行工具。

安装

bash 复制代码

npm install -g @claude-cli/ccs

特性

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

Commands / 命令

Command	Alias	Description (EN)	描述 (中文)
`ccs`	-	Interactive switch	交互式切换商家
`ccs list`	`ccs ls`	List all providers	列出所有商家
`ccs add`	`ccs a`	Add 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 current`	`ccs c`	Show current config	显示当前配置
`ccs refresh [name]`	`ccs r [name]`	Refresh quota info	刷新额度信息
`ccs lang`	-	Switch language	切换语言（中/英）
`ccs --version`	`ccs -v`	Show version	显示版本号
`ccs --help`	`ccs -h`	Show help	显示帮助信息

截图

额度配置

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

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

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

配置

配置文件

~/.ccs.json

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"
    }
  ]
}

商家字段

Field	Required	Description (EN)	描述 (中文)
`id`	Yes	UUID identifier	UUID 标识符
`name`	Yes	Provider name	商家名称
`description`	No	Description/notes	描述/备注
`baseURL`	Yes	API base URL	API 地址
`apiKey`	Yes	API key	API 密钥
`balanceConfig`	No	Quota config object	额度配置对象
`balanceConfig.enabled`	No	Enable quota display	启用额度显示
`balanceConfig.userId`	No	User ID for API	用户 ID
`balanceConfig.accessToken`	No	Access token for API	访问令牌
`usedBalance`	No	Used quota (USD)	已用额度 (美元)
`totalBalance`	No	Total quota (USD)	总额度 (美元)

切换机制

切换商家时：

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

技术栈

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

License

MIT