各位佬友们好!今天向大家介绍一个个人开发的开源项目: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 Code → Anthropic API 转换后: Claude Code → Claude Code Nexus → 用户指定的任意 OpenAI 兼容 API (如 OneAPI, Azure, Ollama 等) 简单地说就是用户把自己的第三方服务 API 信息和模型映射规则填写到 CCN 中,CCN 会自动将 CC 的请求转换为 OpenAI 兼容格式的请求并代你发送给第三方服务。
核心优势:一个平台化的解决方案
与市面上已有的、大多面向单人使用的转发服务不同,CCN 专门面向多用户、界面化、无服务架构部署设计,提供以下核心优势:
-
全图形化配置界面 所有配置项均通过 Web 界面完成,无需手动编辑配置文件。我们还内置了多个主流 LLM 供应商的 API 地址,方便快速接入。
-
独立的多用户账户体系 支持通过 GitHub 快速登录使用。每个用户都拥有独立的账户,可以单独配置自己的模型映射规则和 API 供应商。这意味着在同一个部署实例下,不同用户可以使用各自的 API 供应商服务和映射规则,互不影响。
-
灵活的部署与控制 项目基于 Cloudflare 技术栈构建,提供两种使用方式:
-
使用公共服务:我们提供了免费公开的部署实例 https://claude.nekro.ai,可直接使用。
-
私有化部署:项目完全开源,如果您对第三方服务不放心,可以将其部署到自己的 Cloudflare Worker 服务中,从而实现对数据和服务的完全控制。(免费用户有每天 10w 次 Worker 调用次数,零成本即可上线)
- 开放性与无供应商锁定:项目代码基于 MIT 协议完全开源!不进行任何形式的强制绑定。用户选择公共服务可以在后台将默认的中转服务修改为任何自定义的、或第三方信任的 API 地址并可完全自定义模型转发规则等信息。
快速上手指南
-
注册与获取 API Key:访问 https://claude.nekro.ai/,使用 GitHub 账户登录,系统将自动生成专属 API Key。
-
配置后端服务:在平台的控制台中,填入您自己的 OpenAI 兼容 API 服务地址和密钥,或选择预设的一些大厂 LLM 服务地址。
-
配置模型转发规则(可选):平台默认预制了一套模型转发规则,但是可以启用自定义配置来手动为 CC 的调用指定转发模型,填写 API 供应商相关信息后点击
获取模型列表可直接在下拉选择中选中映射的目标模型 -
配置客户端环境变量:在您的本地终端中设置以下两个环境变量。
# 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 框架。我们在论坛中也发布过相关的技术介绍:
Nekro Agent 介绍帖: https://linux.do/t/topic/839682
总结
Claude Code Nexus 致力于成为 Claude Code 的一个高效、灵活的配套设施,将 API 的选择权交还给开发者。
感谢阅读。欢迎在评论区提供任何反馈或建议。最后如果项目对您有帮助,欢迎给个 Star 支持一下!!!






