【开源推荐】一行命令自由切换Claude Code api_key

1,038 阅读2分钟

在使用claude code的过程中,厌倦了切换api时一个个的复制粘贴,于是自己动手写了个管理api的包,节省了不少力气。

@4xian/ccapi Claude Code settings.json中key自动配置工具,方便API_KEY、AUTH_TOKEN配置切换

功能特性

  • 🚀 一键切换 - 轻松在不同 Claude API 配置间切换
  • 🔒 安全备份 - 修改前自动备份 settings.json 文件
  • 📝 友好提示 - 详细的错误信息和操作指导
  • 🎯 智能识别 - 自动识别当前使用的配置
  • 🛡️ 数据保护 - 敏感信息脱敏显示

安装

全局安装(推荐)

npm install -g @4xian/ccapi

使用方法

1. 查看版本

ccapi -v

2. 设置配置文件路径

初次使用需要设置 Claude Code 的 settings.json 文件路径和自定义API配置文件路径:

例如:
# 同时设置两个路径
ccapi set --settings /Users/4xian/Desktop/settings.json --api /Users/4xian/Desktop/api.json

# 或分别设置
ccapi set --settings /Users/4xian/Desktop/settings.json
ccapi set --api /Users/4xian/Desktop/api.json

3. 自定义API配置文件格式

创建一个api.json文件,格式如下:

{
  "openrouter": {
    "url": "xxx",
    "token": "your-auth-token",
    "model": "claude-sonnet-4-20250514",
    "fast": "claude-3-5-haiku-20241022",
    "timeout": 120000,
    "tokens": 20000
  },
  "anyrouter": {
    "url": "xxx",
    "key": "you-api-key",
    "model": "claude-sonnet-4-20250514"
  }
}

字段说明: 【不同厂商提供的可能是key, 也可能是token, 若不能使用可将key和token互换一下】 【本工具只支持Anthropic格式的配置, 当然只要Claude能用就都可以】

  • url: API厂商服务器地址(必需)
  • key: API_KEY(key 和 token 至少需要一个)
  • token: AUTH_TOKEN(key 和 token 至少需要一个)
  • model: 模型名称(非必需,默认claude-sonnet-4-20250514)
  • fast: 快速模型名称(非必需,默认claude-3-5-haiku-20241022)
  • timeout: 请求超时时间(非必需,默认600000ms)
  • tokens: 最大输出令牌数(非必需,默认25000)

4. 列举api配置文件中的可用配置

ccapi ls 或者 ccapi list

image.png

*号的配置表示当前正在使用

5. 自由切换配置(切换成功后记得重启Claude终端才会生效!!!)

ccapi use any

image.png

系统要求

  • Node.js >= 14.0.0
  • 支持的操作系统: macOS, Linux, Windows