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

{
  "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 和访问控制。

获取帮助

文档

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

许可证

MIT