by 4xian
ccapi - A management tool for quickly switching Claude Code and Codex configurations | A Claude Code and Codex configuration management tool that switches multiple transfer station API configurations with one click; switches system environment variables with one click; tests API latency with one click; tests API validity with one click; automatically selects the best line switching and internationalization support.
# Add to your Claude Code skills
git clone https://github.com/4xian/claude-codex-api一个Claude 和 Codex 配置管理工具，一键切换多个中转站API配置； 一键切换系统环境变量，一键测试API延迟，一键测试API有效性，自动择优线路切换与国际化支持。 当前文档为Claude Code配置介绍，Codex文档请点击右上角↗️查看
# 安装
npm install -g @4xian/ccapi
# 卸载
npm uninstall -g @4xian/ccapi
ccapi -v
初次使用需要设置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
支持多种配置文件格式：JSON、JSON5、YAML、TOML
创建一个配置文件（如 api.json、api.yaml、 或 ），格式如下：
No comments yet. Be the first to share your thoughts!
api.json5api.tomlJSON5 格式示例：
{
"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厂商服务器地址（必需）
key: API_KEY（key 和 token 同时只需要一个）
token: AUTH_TOKEN（key 和 token 同时只需要一个）
model: 模型名称（非必需，默认claude-sonnet-4-20250514）
fast: 快速模型名称（非必需，默认claude-3-5-haiku-20241022）