【开源|公益】基于 CloudFlare 的无服务架构多用户零配置 Claude Code 兼容 OpenAI API 转发站~

各位佬友们好!今天向大家介绍一个个人开发的开源项目:Claude Code Nexus

这是一个为 Claude Code 设计的代理服务平台。其核心能力在于:解除 Claude Code CLI 对 Anthropic 官方 API 的绑定,使其能够通过任何兼容 OpenAI 规范的 API 服务运行。并提供了多用户独立配置的 API 服务,支持多人使用互不干扰!

项目背景与目标

Claude Code 有多好用想必不用我多说了,但其默认配置与 Anthropic 官方 API 深度绑定,这在实际使用中带来了一些限制:

  • 成本控制:只能接受官方的高昂定价模型。

  • 模型灵活性:无法切换至其他更具性价比模型,例如 gpt-4o-mini 或本地部署的 Ollama

  • 访问性:在部分网络环境中可能存在连接问题。

本项目的目标就是解决以上问题,为用户提供更大的灵活性和控制权。

实现原理

Claude Code Nexus (以下简称 CCN) 的工作模式类似于一个协议转换网关。它部署在 Claude Code 与用户指定的 LLM 服务之间,负责将 CC 发出的 Anthropic API 格式请求,实时转换为标准的 OpenAI API 格式。

转换前: Claude CodeAnthropic API 转换后: Claude CodeClaude Code Nexus用户指定的任意 OpenAI 兼容 API (如 OneAPI, Azure, Ollama 等) 简单地说就是用户把自己的第三方服务 API 信息和模型映射规则填写到 CCN 中,CCN 会自动将 CC 的请求转换为 OpenAI 兼容格式的请求并代你发送给第三方服务。

核心优势:一个平台化的解决方案

与市面上已有的、大多面向单人使用的转发服务不同,CCN 专门面向多用户、界面化、无服务架构部署设计,提供以下核心优势:

  • 全图形化配置界面 所有配置项均通过 Web 界面完成,无需手动编辑配置文件。我们还内置了多个主流 LLM 供应商的 API 地址,方便快速接入。

  • 独立的多用户账户体系 支持通过 GitHub 快速登录使用。每个用户都拥有独立的账户,可以单独配置自己的模型映射规则和 API 供应商。这意味着在同一个部署实例下,不同用户可以使用各自的 API 供应商服务和映射规则,互不影响。

  • 灵活的部署与控制 项目基于 Cloudflare 技术栈构建,提供两种使用方式:

  1. 使用公共服务:我们提供了免费公开的部署实例 https://claude.nekro.ai,可直接使用。

  2. 私有化部署:项目完全开源,如果您对第三方服务不放心,可以将其部署到自己的 Cloudflare Worker 服务中,从而实现对数据和服务的完全控制。(免费用户有每天 10w 次 Worker 调用次数,零成本即可上线)

  • 开放性与无供应商锁定:项目代码基于 MIT 协议完全开源!不进行任何形式的强制绑定。用户选择公共服务可以在后台将默认的中转服务修改为任何自定义的、或第三方信任的 API 地址并可完全自定义模型转发规则等信息。

快速上手指南

  1. 注册与获取 API Key:访问 https://claude.nekro.ai/,使用 GitHub 账户登录,系统将自动生成专属 API Key。

  2. 配置后端服务:在平台的控制台中,填入您自己的 OpenAI 兼容 API 服务地址和密钥,或选择预设的一些大厂 LLM 服务地址。

  3. 配置模型转发规则(可选):平台默认预制了一套模型转发规则,但是可以启用自定义配置来手动为 CC 的调用指定转发模型,填写 API 供应商相关信息后点击 获取模型列表 可直接在下拉选择中选中映射的目标模型

  4. 配置客户端环境变量:在您的本地终端中设置以下两个环境变量。


# 1. 设置您的 Nexus API Key

export ANTHROPIC_API_KEY="ak-your-nexus-key"

# 2. 设置 Nexus 代理服务地址

export ANTHROPIC_BASE_URL="https://claude.nekro.ai"

配置完成后,claude 命令的所有请求都将通过您指定的 OpenAI API 服务处理,开始快乐 Vibe Coding 吧!

相关的开源 Agent 项目

如果您对跨平台沙盒化 AI Agent 框架感兴趣,希望构建一个能够接入多种平台(如 QQ、Minecraft、B站直播等)、具备代码执行和动态扩展能力的智能体,可以关注我们的另一个开源项目 Nekro Agent

它是一个面向事件流的通用 Agent 框架。我们在论坛中也发布过相关的技术介绍:

:right_arrow: Nekro Agent 介绍帖: https://linux.do/t/topic/839682

总结

Claude Code Nexus 致力于成为 Claude Code 的一个高效、灵活的配套设施,将 API 的选择权交还给开发者。

感谢阅读。欢迎在评论区提供任何反馈或建议。最后如果项目对您有帮助,欢迎给个 Star 支持一下!!!

136 个赞

我立刻支持!!!

1 个赞

感谢分享

1 个赞

我立刻点赞支持!

2 个赞

项目基于 MIT 协议开源,基底模板是自己做的基于CF的无服务全栈应用模板,理论上稍加 Vibe + 发卡网 可实现供应商绑定、营收等功能,佬友们可以自由发挥QwQ~(最好还是友好营收Orz)

3 个赞

来了喵~

好帅哦,这个项目

1 个赞

哇 真的需要

好项目,帮顶,但是就是有点疑惑
论坛上有gpt-load、claude-relay-service、new-api ,当然还有佬的CCN,不知道这些是有点功能重叠,还是有其他不一样地方。因为最近在研究自建claude中转(自用),不知道哪个更佳

有一些不一样的,因为Claude Code只会按Claude API的格式构造请求,所以没办法直接接入OpenAI系的接口使用,像new-api、one-api等这些项目都是把各种来源的api转换成OpenAI格式的接口提供服务的,Claude Code无法直接接入使用;CCN本身只提供从OpenAI API到Claude API的转换过程,并且针对Claude Code的场景做了些可配置的优化(比如模型映射),而不是真正对接LLM供应商的服务

1 个赞

佬,和ccr最大的区别是什么

支持DeepSeek r1推理模型吗

主要是可以多人一起用,每个人独立配置,还有界面化交互配置起来方便一些,不介意的话直接使用公益服务甚至不用部署

1 个赞

我记得deepseek有openai兼容接口,但是我没测试过,ds貌似不支持function call,而且也不支持多模态,可以自行试一下但不保证能用啊

1 个赞

第八个star,支持佬~

2 个赞

太强了!

太强大了吧

gemini api 保存时会自动变成 https://api.nekro.ai/v1,可以帮忙看看吗

1 个赞


在网站上使用gemini的源站,点击获取模型列表会提示“获取模型列表失败,请检查API Key和Base URL是否正确”,保存配置时,会自动变成“https://api.nekro.ai/v1”

1 个赞

一样的问题