教程

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 MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code 输出格式控制完全指南:JSON、流式、结构化输出使用方法Claude Code 和 Claude API 输出格式完整控制指南:--output-format 参数(text/json/stream-json)、非交互模式(-p)的输出控制、结构化 JSON 输出(--json-schema 字段约束)、流式输出(Server-Sent Events)的处理方式、include-partial-messages 流式渐进显示、以及 CI/CD 管道中解析 JSON 输出的实用技巧。2026/3/18