功能特性
- 多端点轮换：自动故障转移，一个失败自动切换下一个
- API 格式转换：支持 Claude、OpenAI、Gemini 格式互转
- Codex Token Pool：支持批量导入
access_token/refresh_token，自动轮换、自动刷新、失效隔离与状态管理 - Token Pool 使用统计：单条凭证请求/错误/Token 统计，支持快捷查看
- 模型列表 API：提供
/v1/models，支持缓存与按需刷新 - 服务端鉴权：headless/server 模式支持 Basic Auth
- 实时统计：事件驱动的零延迟统计更新，支持今日/昨日/本周/本月四周期快速切换
- 端点筛选：按类型、可用性、启用状态多选筛选，快速定位端点
- 端点克隆：一键复制现有端点配置，快速创建相似端点
- WebDAV 同步：多设备间同步配置和数据
- 跨平台：Windows、macOS、Linux
- Docker：纯后端 HTTP 服务，并提供容器化运行
快速开始
1. 下载安装
- Windows: 解压后运行
ccNexus.exe - macOS: 移动到「应用程序」，首次运行右键点击 → 打开
- Linux:
tar -xzf ccNexus-linux-amd64.tar.gz && ./ccNexus
2. 添加端点
点击「添加端点」，填写 API 地址、密钥，选择转换器（Claude / OpenAI Chat / OpenAI Responses / Gemini）。
- 如果端点填写了模型，会覆盖客户端请求里的模型
- 如果端点不填写模型，则透传客户端原请求模型
如需使用 Codex Token Pool：
- 认证方式选择
Codex Token Pool - 在 Token Pool 页面导入一批 token JSON（支持
access_token+refresh_token） - 系统会自动进行 token 轮换、401 后刷新与状态管理（active/expiring/need_refresh/invalid 等）
3. 配置 CC
Claude Code
~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "随便写，不重要",
"ANTHROPIC_BASE_URL": "http://127.0.0.1:3000",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000", // 有些模型可能不支持 64k
}
// 其他配置
}
Codex CLI
只需要配置 ~/.codex/config.toml：
model_provider = "ccNexus"
model = "gpt-5-codex"
preferred_auth_method = "apikey"
[model_providers.ccNexus]
name = "ccNexus"
base_url = "http://localhost:3000/v1"
wire_api = "responses" # 或 "chat"
# 其他配置
~/.codex/auth.json 可以忽略了。
运行提示
ccNexus默认监听3000端口，可通过 CLI 参数-port或环境变量CCNEXUS_PORT覆盖。- 如果启用了 Basic Auth，首次启动且未设置密码时会自动生成随机密码并打印到日志。
/v1/models默认走缓存；如需强制刷新，可使用启用的 refresh 参数能力。- headless 模式下建议仅在可信内网使用，或通过反向代理加 TLS 和访问控制。