@4xian/ccapi

English | 中文 | Codex文档

一个Claude 和 Codex 配置管理工具，一键切换多个中转站API配置； 一键切换系统环境变量，一键测试API延迟，一键测试API有效性，自动择优线路切换与国际化支持。 当前文档为Claude Code配置介绍，Codex文档请点击右上角↗️查看

功能特性

• 🚀 一键切换 - 轻松在不同 Claude / Codex API 配置间切换
• 🌐 环境变量管理 - 一键设置API配置到系统环境变量
• ⚡ 延迟测试 - 快速同时测试所有中转站延迟以及API配置的可用性
• 🎯 自动优选 - 自动测试并切换到延迟最低的最优配置
• 📄 多格式支持 - 支持 JSON、JSON5、YAML、TOML 配置文件
• 🌍 国际化支持 - 支持中文和英文界面语言切换

安装

全局安装（推荐）

# 安装
npm install -g @4xian/ccapi

# 卸载
npm uninstall -g @4xian/ccapi

使用方法

1. 查看版本

ccapi -v

2. 设置配置文件路径

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

# windows 默认settings.json路径在 C:\Users\Administrator\.claude\settings.json
# mac 默认settings.json路径在 ~/.claude/settings.json
# 若无settings.json文件可自己创建一个

# 三种方式设置路径(例如)：
1. mac同时设置两个路径
ccapi set --settings ~/.claude/settings.json --api /Users/4xian/Desktop/api.json5

2.分别设置
ccapi set --settings ~/.claude/settings.json
ccapi set --api /Users/4xian/Desktop/api.json5

3.直接在配置文件中修改路径
# (若无 .ccapi-config.json 文件可自己创建一个)
在 ~/.ccapi-config.json 文件中(与.claude同级)，有存储路径的变量，直接修改即可
  {
    "settingsPath": "~/.claude/settings.json",
    "apiConfigPath": "/Users/4xian/Desktop/api.json5",
  }

# 查询当前设置的配置文件路径
ccapi set

3. 重要：自定义API配置文件格式(注意格式要配置正确)

支持多种配置文件格式：JSON、JSON5、YAML、TOML 创建一个配置文件（如 api.json、api.yaml、api.json5 或 api.toml），格式如下：

JSON5 格式示例：

{
  "openrouter": {
    "url": "https://api.openrouter.ai",
    "token": "your-auth-token",
    "model": "claude-sonnet-4-20250514",
    "fast": "claude-3-5-haiku-20241022",
    "timeout": 600000,
    "tokens": 65000
  },
  // 推荐使用数组形式，可进行多个配置
  "multiconfig": {
    "url": [
      "https://api.example1.com",
      "https://api.example2.com"
    ],
    "token": [
      "token1-for-auth",
      "token2-for-auth"
    ],
    "model": [
      "claude-sonnet-4-5-20250929",
      "claude-sonnet-4-20250514"
    ]
  }
}

YAML 格式示例：

openrouter:
  url: "https://api.openrouter.ai"
  token: "your-auth-token"
  model: "claude-sonnet-4-20250514"
  fast: "claude-3-5-haiku-20241022"
  timeout: 600000
  tokens: 65000

multiconfig:
  url:
    - "https://api.example1.com"
    - "https://api.example2.com"
  token:
    - "token1-for-auth"
    - "token2-for-auth"
  model:
    - "claude-sonnet-4-5-20250929"
    - "claude-sonnet-4-20250514"

字段说明： 【不同厂商提供的可能是key, 也可能是token, 若不能使用可将key和token互换一下】 【本工具只提供快速切换环境变量的功能，因此只支持Anthropic格式的配置, 只要Claude Code能用就都可以】

• url: API厂商服务器地址（必需）
  • 字符串格式: 直接指定一个URL
  • 数组格式: 可指定多个URL，支持通过索引切换
• key: API_KEY（key 和 token 同时只需要一个）
  • 字符串格式: 直接指定一个API Key
  • 数组格式: 可指定多个API Key，支持通过索引切换
• token: AUTH_TOKEN（key 和 token 同时只需要一个）
  • 字符串格式: 直接指定一个Auth Token
  • 数组格式: 可指定多个Auth Token，支持通过索引切换
• model: 模型名称（非必需，默认claude-sonnet-4-20250514）
  • 字符串格式: 直接指定一个模型
  • 数组格式: 可指定多个模型，支持通过索引切换
• fast: 快速模型名称（非必需，默认claude-3-5-haiku-20241022）
  • 字符串格式: 直接指定一...