如何用 claude-code-router 让 Claude Code 通过 claude-relay-service 调用 Gemini 3 模型

发布时间:2026/9/15 13:42:37

如何用 claude-code-router 让 Claude Code 通过 claude-relay-service 调用 Gemini 3 模型 如何用 claude-code-router 让 Claude Code 通过 claude-relay-service 调用 Gemini 3 模型【免费下载链接】claude-relay-serviceCRS-自建Claude Code镜像一站式开源中转服务让 Claude、OpenAI、Gemini、Droid 订阅统一接入支持拼车共享更高效分摊成本原生工具无缝使用。项目地址: https://gitcode.com/GitHub_Trending/cl/claude-relay-service如果你的 Claude Code 客户端希望使用 Gemini 3 系列模型例如gemini-3-pro-preview但手头没有直接可用的 Gemini 渠道管理可以用 claude-code-routerCCR做请求格式转换再经由 claude-relay-serviceCRS完成账户调度Claude Code → CCR (模型路由) → CRS (账户调度) → Gemini API。本文按这条链路给出完整配置步骤最终效果是Claude Code 发出的 Anthropic 格式请求经 CCR 转换后进入 CRS由 CRS 调度已添加的 Gemini 账号调用 Gemini 3 模型其他模型也可以参照此流程尝试。前提条件CRS 服务已部署并正常运行已安装 Node.js 环境用于全局安装 CCR已在 CRS 中配置好 Gemini 账号并按第五节要求在 CRS 中创建cr_开头的 API Key。第一步安装 claude-code-router全局安装 CCRnpm install -g musistudio/claude-code-router验证安装是否成功应输出版本号ccr -v关于安装位置官方文档给出两点建议如果只是本地使用可以只安装到运行 Claude Code 的那台电脑上如果需要 CRS 项目接入 CCR即通过 CRS 统一管理用户访问建议安装在与 CRS 同一台服务器上。第二步配置 CCR创建或编辑 CCR 配置文件通常位于~/.claude-code-router/config.json按下面的示例填写{ APIKEY: sk-c0e7fed7b-这里随便你自定义, LOG: true, HOST: 127.0.0.1, API_TIMEOUT_MS: 600000, NON_INTERACTIVE_MODE: false, Providers: [ { name: gemini, api_base_url: http://127.0.0.1:3000/gemini/v1beta/models/, api_key: cr_xxxxxxxxxxxxxxxxxxxxx, models: [gemini-2.5-flash, gemini-2.5-pro, gemini-3-pro-preview], transformer: { use: [gemini] } } ], Router: { default: gemini, background: gemini,gemini-3-pro-preview, think: gemini,gemini-3-pro-preview, longContext: gemini,gemini-3-pro-preview, longContextThreshold: 60000, webSearch: gemini,gemini-2.5-flash } }示例中有两处需要替换成你自己的值字段替换说明APIKEY替换为你自定义的 CCR API Key示例值sk-c0e7fed7b-...可随意自定义Claude Code 将使用这个 Key 访问 CCRapi_key替换为 CRS 后台创建的 API Keycr_开头用于调度 OAuth、Gemini-API 账号其中api_base_url指向 CRS 服务的 Gemini API 地址HOST保持127.0.0.1表示 CCR 只监听本机如果 CCR 需要被其他服务器访问后面第五节会说明需要把HOST改为0.0.0.0。第三步在 CRS 中配置 Gemini 账号CCR 只负责格式转换和路由实际调用 Gemini 的能力来自 CRS 中配置的账号登录 CRS 管理界面进入「Gemini 账户」页面添加 Gemini OAuth 账号或 API Key 账号确保账号状态为「活跃」。CRS 支持的 Gemini 模型列表可在 模型配置 中核对其中包含gemini-3-pro-preview、gemini-3-flash-preview等 Gemini 3 系列模型。第四步启动 CCR 服务保存配置后启动 CCRccr start查看服务状态ccr status文档示例的输出示例结果API Endpoint: http://127.0.0.1:3456重要每次修改config.json后必须重启 CCR 服务才能生效ccr restart第五步让 Claude Code 接入这一步有两种方式按你的使用规模选择其一。方式一本地直接连接 CCR单台机器使用在运行 Claude Code 的终端中设置环境变量让 Claude Code 直接指向 CCRexport ANTHROPIC_BASE_URLhttp://127.0.0.1:3456/ export ANTHROPIC_AUTH_TOKENsk-c0e7fed7b-你的自定义Key其中ANTHROPIC_AUTH_TOKEN必须与 CCR 配置中的APIKEY一致。然后启动claude方式二通过 CRS 统一管理多人共享时推荐如果希望通过 CRS 统一管理所有用户的访问可以在 CRS 中添加 Claude Console 类型账号来代理 CCR。1. 在 CRS 添加 Claude Console 账号登录 CRS 管理界面添加一个Claude Console类型的账号字段值账户名称CCR-Gemini3或自定义名称账户类型Claude ConsoleAPI 地址http://127.0.0.1:3456CCR 服务地址API Keysk-c0e7fed7b-你的自定义Key即 CCR 配置中的APIKEY如果 CCR 运行在其他服务器上将127.0.0.1替换为实际的服务器地址并且 CCR 配置文件中需要把HOST参数改为0.0.0.0否则 CCR 不会接受外部访问。2. 配置模型映射在 CRS 中配置模型映射将 Claude 模型名映射到 Gemini 模型Claude 模型映射到 Gemini 模型claude-opus-4-1-20250805gemini-3-pro-previewclaude-sonnet-4-5-20250929gemini-3-pro-previewclaude-haiku-4-5-20251001gemini-2.5-flash官方说明Opus 和 Sonnet 映射到gemini-3-pro-previewHaiku 映射到响应更快的gemini-2.5-flash。3. 用户使用方式配置完成后用户通过 CRS 统一入口使用 Claude Codeexport ANTHROPIC_BASE_URLhttp://你的CRS服务器:3000/api/ export ANTHROPIC_AUTH_TOKENcr_用户的APIKey上面两条中的你的CRS服务器替换为实际部署 CRS 的服务器地址cr_用户的APIKey替换为该用户在 CRS 中创建的 API Key。之后 Claude Code 会自动将请求路由到 CCR再由 CCR 转发到 Gemini API。验证连接配置完成后可以用 curl 直接测试 CCR 链路是否通畅x-api-key换成你在 CCR 配置中的APIKEYcurl -X POST http://127.0.0.1:3456/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-c0e7fed7b-你的自定义Key \ -d { model: claude-sonnet-4-5-20250929, max_tokens: 100, messages: [{role: user, content: Hello}] }请求中的claude-sonnet-4-5-20250929按第五节的映射规则会被转到gemini-3-pro-preview收到正常的消息响应即说明 Claude Code → CCR → CRS → Gemini 的链路已打通。常见问题排查CCR 配置修改后没有生效配置修改后必须重启 CCR 服务ccr restart连接超时怎么办官方文档给出的检查项依次为CRS 服务是否正常运行CCR 配置中的api_base_url是否正确防火墙是否允许相应端口尝试增加API_TIMEOUT_MS的值长任务尤其需要。模型映射不生效官方文档给出的确认项CRS 中已正确配置 Claude Console 账号模型映射配置已保存重启 CRS 服务使配置生效。部署建议源文档给出的最佳实践生产环境将 CCR 部署在与 CRS 相同的服务器上减少网络延迟为每个用户创建独立的 CRS API Key便于使用统计对于长时间运行的任务适当增加API_TIMEOUT_MS。更多 CCR 的用法可以参考其官方仓库musistudio/claude-code-router。【免费下载链接】claude-relay-serviceCRS-自建Claude Code镜像一站式开源中转服务让 Claude、OpenAI、Gemini、Droid 订阅统一接入支持拼车共享更高效分摊成本原生工具无缝使用。项目地址: https://gitcode.com/GitHub_Trending/cl/claude-relay-service创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/15 13:42:37

大数据实践全记录:集群部署、性能调优、可视化大屏与遥感数据

和“大数据实践”死磕的路上,这些坑我必须记下来熟悉我的朋友都知道,我一直在以“实践笔记”的方式记录自己做大数据项目的全过程。这篇“大数据实践笔记2”,是我最近从重新规划集群、到动手跑数据任务、再到做大屏可视化、甚至去啃遥感卫星轨…

2026/9/15 13:57:38

文件上传漏洞从攻击到防御:绕过手法、代码审计与加固实践

做安全的这些年,如果说哪个漏洞让我觉得“看似不起眼、实际特别致命”,文件上传漏洞绝对排得上前三名。很多开发同学觉得上传功能不过就是“接收文件、存到服务器”,能有什么风险?可真出了问题,往往就是服务器直接被拿…

2026/9/15 13:57:38

TraffMonetizer与PacketStream带宽劫持解析及彻底清理指南

1. 先搞清楚:TraffMonetizer和PacketStream到底是什么1.1 它们的正常用途:把闲置带宽换成钱先说结论:TraffMonetizer和PacketStream本身并不是传统意义的木马或病毒,它们是正规注册的"共享带宽"商业项目。官网自己怎么定…

2026/9/15 13:57:38

GitHub新手入门:从建仓到协作的全流程实战指南

我这两年陆陆续续带过不少新人入门 GitHub,发现一个很有趣的现象:大部分人是被第一次的全英文报错吓退的,而不是被概念难倒。什么 “Permission denied (publickey)”“non-fast-forward”“Failed to connect to github.com port 443”&…

2026/9/15 13:52:38

Matlab电机仿真工程拆解:PMSM控制与FFRLS惯量辨识实战

简介:面向电子信息工程、计算机、数学等专业学生,这份基于Matlab的电机仿真项目资料整理了完整的源码、数据与报告,适合在课程设计、期末大作业或毕业设计中作为仿真实例与代码参考。压缩包共68个文件,以27个m脚本、25个slx仿真模…

2026/9/15 4:54:30

拯救者Y7000黑屏故障排查与维修实战指南

1. 项目概述:一台黑屏的拯救者Y7000,到底卡在哪一步? 联想拯救者Y7000系列笔记本,从2018年第一代搭载i5-8300H开始,到后来的i7-9750H、i7-10750H、i5-11400H,再到2023年款的R7-7840HS,它始终是学…

2026/9/15 0:01:16

AI英语单词APP开发:自适应学习算法与移动端优化实践

1. 项目概述 作为一名在移动应用开发领域摸爬滚打多年的老手,我最近完成了一个AI英语单词APP的开发项目。这个项目将传统单词记忆方法与现代AI技术相结合,打造了一款能够智能适应不同用户学习习惯的英语学习工具。 市面上大多数单词APP都存在一个通病&a…

2026/9/15 0:01:16

Flutter与OpenHarmony结合开发手语学习APP实战

1. 项目背景与核心价值作为一名同时接触过Flutter和OpenHarmony的开发者,最近我完成了一个基于Flutter for OpenHarmony的手语学习APP实战项目。这个项目最大的特点在于实现了跨平台框架与国产操作系统深度结合的创新实践——用Flutter开发的应用能完美运行在OpenHa…

2026/9/15 0:01:16

六个月成为机器人工程师:从ROS2到SLAM的实战路径

1. 六个月的紧迫感从哪来:先搞清楚你要成为哪种机器人工程师说实话,六个月的期限并不是一个宽松的时间线。市面上任何一本正经的机器人学教材都超过五百页,ROS2的官方文档可以翻到你怀疑人生,再加上ABB、KUKA这些工业机器人厂家动…

2026/9/14 11:59:31

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/14 13:53:59

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/15 11:42:23

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码