Back to catalog

ccNexus

by lich0821

Pending

Intelligent API gateway for Claude Code and Codex CLI - rotate endpoints, monitor usage, and seamlessly integrate OpenAI, Gemini, and other platforms.

688stars
87forks
Go
Added 12/27/2025
CLI Toolsai-codingclaude-codeclaude-code-proxyclaude-code-router
Installation
# Add to your Claude Code skills
git clone https://github.com/lich0821/ccNexus
README.md
<div align="center"> <p align="center"> <img src="docs/images/ccNexus.svg" alt="Claude Code & Codex CLI 智能端点轮换代理" width="720" /> </p>

构建状态 许可证: MIT Go 版本 Wails

English | 简体中文

</div>

功能特性

  • 多端点轮换:自动故障转移,一个失败自动切换下一个
  • API 格式转换:支持 Claude、OpenAI、Gemini 格式互转
  • 实时统计:请求数、错误数、Token 用量监控
  • WebDAV 同步:多设备间同步配置和数据
  • 跨平台:Windows、macOS、Linux
  • Docker:纯后端 HTTP 服务,并提供容器化运行
<table> <tr> <td align="center"><img src="docs/images/CN-Light.png" alt="明亮主题" width="400"></td> <td align="center"><img src="docs/images/CN-Dark.png" alt="暗黑主题" width="400"></td> </tr> </table>

快速开始

1. 下载安装

下载最新版本

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

2. 添加端点

点击「添加端点」,填写 API 地址、密钥、选择转换器(claude/openai/gemini)。

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 可以忽略了。

获取帮助

<table> <tr> <td align="center"><img src="https://gitee.com/hea7en/images/raw/master/group/chat.png" alt="微信群" width="200"></td> <td align="center"><img src="cmd/desktop/frontend/public/WeChat.jpg" alt="公众号" width="200"></td> <td align="center"><img src="cmd/desktop/frontend/public/ME.png" alt="个人微信" width="200"></td> </tr> <tr> <td align="center">问题反馈请加群</td> <td align="center">公众号</td> <td align="center">群过期请加好友</td> </tr> </table>

文档

许可证

MIT