ccNexus

English | 简体中文



功能特性

- 多端点轮换：自动故障转移，一个失败自动切换下一个
- 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


Codex CLI
只需要配置 ~/.codex/config.toml：


~/.codex/auth.json 可以忽略了。

运行提示

- ccNexus 默认监听 3000 端口，可通过 CLI 参数 -port 或环境变量 CCNEXUS_PORT 覆盖。
- 如果启用了 Basic Auth，首次启动且未设置密码时会自动生成随机密码并打印到日志。
- /v1/models 默认走缓存；如需强制刷新，可使用启用的 refresh 参数能力。
- headless 模式下建议仅在可信内网使用，或通过反向代理加 TLS 和访问控制。

获取帮助
    问题反馈请加群
    公众号
    群过期请加好友
  


文档

- 详细配置
- 开发指南
- 常见问题

许可证

MIT