English | 简体中文

功能特性

• 多端点轮换：自动故障转移，一个失败自动切换下一个
• API 格式转换：支持 Claude、OpenAI Chat、OpenAI Responses、Gemini 互转
• 实时统计：请求数、错误数、Token 用量监控（更精准、更高性能；vLLM 流式请求会注入 stream_options.include_usage=true 以强制返回 usage）
• WebDAV 同步：多设备间同步配置和数据
• 跨平台：Windows、macOS、Linux（桌面端 + 无头服务）
• Web 管理界面：内置 /ui，无需额外前端构建
• Docker：纯后端 HTTP 服务，提供容器化运行

快速开始

方式一：桌面应用

下载最新版本

• Windows: 解压后运行 ccNexus.exe
• macOS: 移动到「应用程序」，首次运行右键点击 → 打开
• Linux: tar -xzf ccNexus-linux-amd64.tar.gz && ./ccNexus

方式二：无头服务（本地/服务器）

go run ./cmd/server

默认数据目录为 ~/.ccNexus，可通过环境变量覆盖：

• CCNEXUS_DATA_DIR：数据目录
• CCNEXUS_DB_PATH：数据库路径
• CCNEXUS_PORT：监听端口
• CCNEXUS_LOG_LEVEL：日志级别

启动后访问 http://localhost:3000/ui/ 进行 Web 管理。

方式三：Docker（推荐服务器部署）

cd cmd/server
docker compose up -d --build

默认映射端口 3021:3000，访问 http://localhost:3021/ui/。

端点配置

点击「添加端点」，填写 API 地址、密钥、选择转换器（claude/openai/openai2/gemini）。

客户端配置

Claude Code

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "admin 的 API Key 或你新建的 key",
    "ANTHROPIC_BASE_URL": "http://localhost: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 可以忽略了。

首次启动会自动创建 admin 用户并生成 API Key（输出到控制台日志）。启用后所有代理请求都需要携带：

Authorization: Bearer <api-key>

可在 Web 管理界面新增/管理其他用户 API Key。

获取帮助

问题反馈请加群	公众号	群过期请加好友

文档

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

许可证

MIT