资讯详情

资讯详情

行业资讯

CliRelay是什么:把Claude Code、Codex、Gemini CLI全塞进一个OpenAI兼容AI网关

【免费下载链接】CliRelaySelf-hosted AI gateway for coding CLIs — one OpenAI/Claude/Gemini/Codex-compatible endpoint, with a multi-tenant web console, request logs, and spend quotas.项目地址https://gitcode.com/gh_mirrors/cl/CliRelay点击查看免费下载CliRelay 是一个自托管self-hosted的OpenAI 兼容 AI 网关专为编程 CLI 工具设计它把你已经在付费的 Claude、Codex、Gemini 订阅账号和各种 API Key 统一挂在一个端点后面让 Claude Code、Codex、Gemini CLI 以及任何 OpenAI 兼容客户端都能直接复用同时提供多租户 Web 控制台、完整请求日志和消费配额管理。为什么你需要一个 AI 网关用过 Claude Code 或 Codex 的同学大概都遇到过这些场景账号池管理头疼手上有 3 个 Claude 订阅、2 个 Codex 账号切换要反复改环境变量或配置文件用量不可控团队成员共用你的 Key跑了一天不知道烧了多少钱没有容灾某个账号额度用尽或 429 限流任务直接中断手动切账号零可观测性谁调用了哪个模型、耗了多少 token、延迟多少完全摸黑。CliRelay 的思路是客户端只认一个地址剩下的事鉴权、选账号、协议转换、失败切换、记账全部交给网关。CliRelay 核心能力一览能力说明一个端点接所有上游Claude、Codex、Gemini CLI、Antigravity、Vertex、Bedrock、xAI/Grok、Qwen、Kimi、iFlow 及任意 OpenAI 兼容上游统一收口在http://your-host:8317智能路由与故障转移通道组Channel Group 轮询/填充满先/会话粘滞调度账号耗尽或失败自动冷却并切换备用账号全链路可观测监控中心提供健康分数、P50–P99 延迟、首 Token 时间、失败分析和用户→模型→通道流量图消费管控客户端 Key 按门户账号分组支持日/周期/终身配额、RPM/TPM 限速、按模型计费和一键周期重置️团队级多租户租户之间账号、Key、数据隔离用户角色 细粒度权限安全敏感操作全部落审计日志️浏览器管理面板/manage控制台引导式登录添加账号、可视化改配置、模型与定价管理、在线升级一个请求是怎么流转的客户端发来的每一个请求在 CliRelay 内部会经过四步鉴权Authenticate客户端 Key 解析出所属门户账号和权限配置决定可用通道组、模型和配额准入Admit在请求到达上游之前先检查日/周期/终身消费、请求数配额、RPM、TPM 和并发限制路由Route按调度策略把请求投给组内健康的通道AI 账号或 Provider Key失败则冷却该通道并自动故障转移到下一个转换与记录Translate Record执行器负责 OpenAI ⇄ Anthropic ⇄ Gemini 协议互转流式返回结果并写入请求日志与用量统计驱动所有仪表盘。协议转换的实现在 internal/translator/各上游的调度、冷却与执行器在 internal/runtime/executor/。支持哪些上游CliRelay 支持的上游非常宽主流接入方式包括Provider / 通道接入方式Anthropic ClaudeOAuth 浏览器/设备码登录、会话 Key 导入、API KeyOpenAI CodexOAuth、refresh token 导入、API KeyGoogle GeminiOAuthGemini CLI、API KeyAntigravityOAuth、refresh token 导入Vertex AI / AWS Bedrock服务账号 JSON、API Key 或 SigV4xAI / Grok、Qwen、Kimi、iFlowOAuth、设备码、Cookie 导入任意 OpenAI 兼容上游API Key如 OpenRouter 等 Chat Completions 服务添加账号时控制台是引导式的按浏览器登录 / 设备码 / 凭据导入三类分组一步步告诉你该复制哪个地址、为什么登录页打不开、凭据从哪来。已有的 Claude 会话 Key、Codex refresh token、Grok SSO Cookie 可以直接批量导入成账号失败行还能单独重试。快速上手Docker Compose 三步跑起来推荐用 Docker Compose 部署它会一次性启动 CliRelay、PostgreSQL 15、Redis 7 和 updater 升级边车git clone https://gitcode.com/gh_mirrors/cl/CliRelay cd CliRelay docker compose up -d首次启动时clirelay-init服务会自动创建.env和config.yaml并生成管理密码等密钥。启动后记住两个地址入口地址API 端点http://localhost:8317管理控制台http://localhost:8317/manage用admin.env中的CLIRELAY_ADMIN_PASSWORD登录然后在控制台完成两件事加上游AI Accounts → Add AI account登录订阅账号或AI Providers添加 API Key建客户端 KeyPortal Accounts → Create user每个门户账号可持有一个或多个 Key。⚠️ 全新安装默认没有可用客户端 Key任何客户端请求都会被拒绝务必先创建 Key。config.example.yaml 里的your-api-key-*都是占位符永远无效。把你的编程 CLI 接上网关拿到客户端 Key 后各工具改一行配置就能指向 CliRelay。Claude Code——设置两个环境变量即可export ANTHROPIC_BASE_URLhttp://localhost:8317 export ANTHROPIC_AUTH_TOKENsk-your-client-key claudeCodex CLI——在~/.codex/config.toml中新增一个自定义 providermodel_provider clirelay [model_providers.clirelay] name openai base_url http://localhost:8317/v1 requires_openai_auth true任何 OpenAI 兼容客户端——直接用 Chat Completions 接口把Authorization换成你的客户端 Key 即可。 控制台里的CC Switch Config还能一键生成 Claude Code / Codex 的导入预设模型映射和通道组都填好了省去手改配置。控制台巡礼请求日志、配额与多租户请求日志每次调用都有据可查请求日志列出每一次调用的通道、门户用户与 Key、缓存/输入/输出 Token、延迟和成本支持按用户、模型、通道、状态筛选。开启正文存储后还能点开查看完整的请求与响应内容。相关查询与写入实现在 internal/usage/ 下的请求日志与滚动统计模块。通道组与模型广场流量往哪走一目了然通道组决定某个 Key 能用哪些通道、组内流量怎么分摊模型广场则展示当前租户可达的每个模型的能力、服务通道与百万 Token 价格。多租户与审计为团队而生的权限体系租户各自持有独立的账号、Key、路由和数据管理员可在头部切换生效租户角色以resource.action形式授权如providers.test、models.write决定每个用户能看到哪些页面和按钮谁改了什么、从哪里改的、是否成功全部记录在审计日志中。生产部署与进阶玩法部署形态适用场景参考文档单节点 Docker Compose个人、小团队、NASdocs/production-checklist_CN.md挂在 nginx 等反向代理后公网 HTTPS、自定义域名docs/reverse-proxy_CN.md多实例共享同一 PostgreSQL流量分摊、自动故障转移、滚动发布docs/multi-instance-deployment_CN.md其他值得了解的设计点️PostgreSQL 15 是唯一事实来源Redis 7 只存可重建的缓存、锁、限流和队列状态迁移细节见 docs/postgres-redis-migration.md⚙️配置可热改面板 Config 页提供分组表单 内联校验也能用 YAML 源码编辑器小内存主机可一键套用推荐的低资源配置在线升级updater 边车负责拉取新版本面板会展示目标版本、每个阶段和最终结果可嵌入 SDKsdk/ 提供了可嵌入的 Go SDK方便在自己的应用里复用这套代理能力用法见 docs/sdk-usage_CN.md。写在最后CliRelay 解决的本质问题很简单让你已经付费的 AI 账号像 API 池一样被管理——一个 OpenAI 兼容端点收口所有客户端账号自动调度与故障转移消费可计量可封顶团队可按租户隔离使用。如果你正在同时维护 Claude Code、Codex、Gemini CLI 多个工具又希望用量和成本尽在掌握这套网关值得部署到自己的服务器上跑一跑。项目核心入口在 cmd/server/完整部署编排见 docker-compose.yml。CliRelay 基于 MIT 协议开源感谢上游 CLIProxyAPI 项目奠定的代理核心。赞分享【免费下载链接】CliRelaySelf-hosted AI gateway for coding CLIs — one OpenAI/Claude/Gemini/Codex-compatible endpoint, with a multi-tenant web console, request logs, and spend quotas.项目地址https://gitcode.com/gh_mirrors/cl/CliRelay点击查看免费下载相关推荐十分钟上手 T3 Code把 Claude Code、Codex、Cursor 全塞进一个窗口十分钟上手 T3 Code把 Claude Code、Codex、Cursor 全塞进一个窗口 如果你是那种每个 AI 编程工具都想试一遍的开发者大概已AI Agent代码智能体后端前端移动开发桌面应用把 Claude Code、Codex、Cursor 塞进一个公司Paperclip 统一调度实战把 Claude Code、Codex、Cursor 塞进一个公司Paperclip 统一调度实战 2026 年一线开发者桌面上的现状是这样的左边开着 5人工智能AI 应用AI Agent多智能体Agent 编排Agent 工作流MCP 服务后端前端同一套 Skills 跨 Agent 迁移Claude Code、Codex、Gemini CLI 的兼容性实测同一套 Skills 跨 Agent 迁移Claude Code、Codex、Gemini CLI 的兼容性实测 当开发者的技能资产被锁定在单一工具里迁移一AI 技能AI 插件创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

准备好开启您的数字化征程了吗?

专业团队为您量身定制,让您的企业网站脱颖而出

立即咨询