教程

CRS 多模型接入指南:Gemini CLI、Codex CLI 和 Droid 统一中转配置

Claude Relay Service 多模型接入完整教程:CRS 如何同时支持 Gemini CLI(gemini-2.5-pro/gemini-3)、OpenAI Codex CLI(gpt-5.1-codex-max)、Droid CLI 和 VS Code 插件的环境变量配置方法,以及 Antigravity 账户池的使用和模型选择建议。

2026/3/164分钟 阅读ClaudeEagle

CRS 不只是 Claude Code 的中转服务——它同时支持 Gemini CLI、Codex CLI、Droid CLI 等多个 AI 工具, 一个服务器搞定所有主流 AI 编程助手,拼车成员可以按需选择最适合的工具。

支持的模型和客户端总览

客户端支持模型CRS 路由路径
Claude CodeClaude Sonnet/Opus/Haiku/api/
Claude Code (Antigravity)claude-opus-4-5 等/antigravity/api/
Gemini CLIgemini-2.5-pro, gemini-3/gemini
Codex CLIgpt-5.1-codex-max/openai
Droid CLIClaude Opus 4.5, GPT-5-Codex/droid/claude
VS Code 插件同 Claude Code配置文件

Claude Code 配置(标准)

bash
# 写入 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_BASE_URL="https://你的域名/api/"
export ANTHROPIC_AUTH_TOKEN="你的CRS-API-Key"

# 测试
claude -p "hello"

Claude Code 配置(Antigravity 渠道)

Antigravity 是一个特殊渠道,接入效果媲美官方 Anthropic Console:

bash
# Antigravity 专用路径
export ANTHROPIC_BASE_URL="https://你的域名/antigravity/api/"
export ANTHROPIC_AUTH_TOKEN="你的CRS-API-Key"

# 指定模型(直接用短名,不需要加前缀)
export ANTHROPIC_MODEL="claude-opus-4-5"

claude

适合场景:需要使用最新模型(claude-opus-4-5 等)时选择 Antigravity 渠道。


Gemini CLI 配置

方式一:Gemini Assist API(推荐)

bash
# 设置环境变量
export CODE_ASSIST_ENDPOINT="https://你的域名/gemini"
export GOOGLE_CLOUD_ACCESS_TOKEN="你的CRS-API-Key"
export GOOGLE_GENAI_USE_GCA="true"
export GEMINI_MODEL="gemini-2.5-pro"

# 如果有 Gemini 3 权限
# export GEMINI_MODEL="gemini-3-pro-preview"

# 启动
gemini

认证注意:选择 Login with Google 方式认证。 如果启动时直接跳到 Google 登录,先删除旧配置:

bash
rm ~/.gemini/settings.json
gemini  # 重新启动

控制台可能提示 Failed to fetch user info: 401 Unauthorized,这是正常的,不影响使用。

方式二:Gemini API Key

bash
export GOOGLE_GEMINI_BASE_URL="https://你的域名/gemini"
export GEMINI_API_KEY="你的CRS-API-Key"
export GEMINI_MODEL="gemini-2.5-pro"

gemini

认证选择 Use Gemini API Key,提示输入 Key 时直接留空回车


Codex CLI 配置

Codex CLI 使用 ~/.codex/config.toml 配置文件:

toml
# ~/.codex/config.toml(在文件开头添加)
model_provider = "crs"
model = "gpt-5.1-codex-max"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://你的域名/openai"
wire_api = "responses"
requires_openai_auth = true

API Key 配置 ~/.codex/auth.json

json
{
    "OPENAI_API_KEY": "你的CRS-API-Key"
}

⚠️ Nginx 用户注意:使用 Nginx 反向代理时,必须在 http {} 块添加:

nginx
underscores_in_headers on;

否则带下划线的请求头(如 session_id)会被 Nginx 丢弃,导致多账号粘性会话失效。


Droid CLI 配置

Droid CLI 读取 ~/.factory/config.json,添加自定义模型:

json
{
  "custom_models": [
    {
      "model_display_name": "Opus 4.5 [CRS]",
      "model": "claude-opus-4-5-20251101",
      "base_url": "https://你的域名/droid/claude",
      "api_key": "你的CRS-API-Key",
      "provider": "anthropic",
      "max_tokens": 64000
    },
    {
      "model_display_name": "GPT5-Codex [CRS]",
      "model": "gpt-5-codex",
      "base_url": "https://你的域名/openai",
      "api_key": "你的CRS-API-Key",
      "provider": "openai",
      "max_tokens": 32000
    }
  ]
}

VS Code Claude 插件配置

~/.claude/config.json 中添加:

json
{
    "primaryApiKey": "crs"
}

如果文件不存在,手动创建。 Windows 路径:C:/Users/你的用户名/.claude/config.json

💡 IntelliJ IDEA 用户推荐使用 Claude Code Plus 插件, 直接在 IDE 里使用 Claude Code,支持代码理解、文件读写、命令执行。


模型选择建议

场景推荐模型通过 CRS 路由
日常编程辅助claude-sonnet-4-5/api/
复杂架构设计claude-opus-4-5/antigravity/api/
快速简单任务claude-haiku-3-5/api/
长文本处理gemini-2.5-pro/gemini
代码补全gpt-5.1-codex-max/openai

在 CRS 管理面板限制客户端

在创建 API Key 时,可以设置「客户端限制」:

Key A(Claude 专用)→ 只允许:ClaudeCode Key B(全功能)→ 允许:ClaudeCode, Gemini-CLI, Codex Key C(Gemini 专用)→ 只允许:Gemini-CLI

这样可以精确控制每个拼车成员能用哪些工具。


来源:CRS GitHub 项目 - https://github.com/Wei-Shaw/claude-relay-service

相关文章推荐

教程Codex CLI 接入 CRS 中转完整教程:config.toml 配置与拼车使用 gpt-5.1-codex-max通过 CRS(Claude Relay Service)中转 OpenAI Codex CLI 的完整配置:config.toml 文件的 model_provider 和 base_url 设置、auth.json API Key 配置、model_reasoning_effort 参数调优(low/medium/high)、disable_response_storage 隐私设置、Nginx 必须开启 underscores_in_headers 的原因,以及 gpt-5.1-codex-max 模型的实际体验对比。2026/3/17教程CRS 接入 Gemini CLI 完整教程:两种方式配置 gemini-2.5-pro 拼车使用通过 CRS(Claude Relay Service)中转 Gemini CLI 的完整配置指南:Gemini Assist API 方式(推荐)与 Gemini API 方式的环境变量设置、认证方式选择(Login with Google vs API Key)、settings.json 重置方法、gemini-2.5-pro 和 gemini-3-pro-preview 模型切换,以及 Nginx 反向代理下的注意事项。2026/3/17教程CRS 一键脚本部署完整教程:最简单的 Claude Code 中转服务安装方式Claude Relay Service(CRS)一键脚本部署完整指南:manage.sh 脚本安装流程、交互式配置向导(端口/Redis/目录)、crs 命令行工具完整用法(install/start/stop/restart/status/update/uninstall)、首次启动后的账号配置步骤,以及脚本部署与 Docker 部署的对比选择建议。2026/3/16教程Claude Relay Service Docker 部署完整教程:一键搭建 Claude Code 中转服务CRS(Claude Relay Service)Docker 部署完整指南:服务器选择建议(避开阿里云/腾讯云海外)、Docker Compose 一键部署步骤、环境变量配置(JWT_SECRET/ENCRYPTION_KEY)、管理员密码获取、Claude OAuth 账户添加、API Key 创建,以及 Nginx 反向代理和 HTTPS 配置。2026/3/16教程Claude Code Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10