针对 Gemini 和 OpenAI 模型的 Anthropic API 代理 🔄

使用 Anthropic 客户端（如 Claude Code）与 Gemini、OpenAI 或直接的 Anthropic 后端一起工作。 🤝

一个代理服务器，允许您通过 LiteLLM 使用 Anthropic 客户端与 Gemini、OpenAI 或 Anthropic 自身的模型进行交互（某种程度上是一个透明代理）。🌉

快速入门 ⚡

前提条件

• OpenAI API 密钥 🔑
• Google AI Studio（Gemini）API 密钥（如果使用 Google 提供商）🔑
• 已启用 Vertex AI API 的 Google Cloud 项目（如果使用 Application Default Credentials 来访问 Gemini）☁️
• 已安装 uv。

设置 🛠️

从源代码安装

1. 克隆此仓库：

   git clone https://github.com/1rgs/claude-code-proxy.git
   cd claude-code-proxy
   

2. 安装 uv（如果您尚未安装）：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   (uv 将根据 pyproject.toml 文件在运行服务器时自动处理依赖项)

3. 配置环境变量： 复制示例环境文件：

   cp .env.example .env
   

   编辑 .env 文件，并填写您的 API 密钥和模型配置：

   • ANTHROPIC_API_KEY：（可选）仅在代理到 Anthropic 模型时需要。
   • OPENAI_API_KEY：您的 OpenAI API 密钥（如果使用默认的 OpenAI 配置或作为备用，则为必填项）。
   • GEMINI_API_KEY：您的 Google AI Studio（Gemini）API 密钥（如果 PREFERRED_PROVIDER=google 且 USE_VERTEX_AUTH=true，则为必填项）。
   • USE_VERTEX_AUTH（可选）：设置为 true 以使用 Application Default Credentials（ADC），这样就不需要静态 API 密钥。注意：当 USE_VERTEX_AUTH=true 时，必须配置 VERTEX_PROJECT 和 VERTEX_LOCATION。
   • VERTEX_PROJECT（可选）：您的 Google Cloud 项目 ID（如果 PREFERRED_PROVIDER=google 且 USE_VERTEX_AUTH=true，则为必填项）。
   • VERTEX_LOCATION（可选）：Vertex AI 所在的 Google Cloud 区域（例如 us-central1）（如果 PREFERRED_PROVIDER=google 且 USE_VERTEX_AUTH=true，则为必填项）。
   • PREFERRED_PROVIDER（可选）：设置为 openai（默认）、google 或 anthropic。这决定了将 haiku/sonnet 映射到的主要后端。
   • BIG_MODEL（可选）：用于映射 sonnet 请求的模型。默认为 gpt-4.1（如果 PREFERRED_PROVIDER=openai）或 gemini-2.5-pro-preview-03-25。当 PREFERRED_PROVIDER=anthropic 时，此设置将被忽略。
   • SMALL_MODEL（可选）：用于映射 haiku 请求的模型。默认为 gpt-4.1-mini（如果 PREFERRED_PROVIDER=openai）或 gemini-2.0-flash。当 PREFERRED_PROVIDER=anthropic 时，此设置也无效。

   映射逻辑：

   • 如果 PREFERRED_PROVIDER=openai（默认），则 haiku/sonnet 会分别映射到带有 openai/ 前缀的 SMALL_MODEL/BIG_MODEL。
   • 如果 PREFERRED_PROVIDER=google，则 haiku/sonnet 会映射到带有 gemini/ 前缀的 SMALL_MODEL/BIG_MODEL，前提是这些模型在服务器已知的 GEMINI_MODELS 列表中；否则将回退到 OpenAI 的映射。
   • 如果 PREFERRED_PROVIDER=anthropic，则 haiku/sonnet 请求将直接传递给 Anthropic，并加上 anthropic/ 前缀，而不会重新映射到其他模型。

4. 运行服务器：

   uv run uvicorn server:app --host 0.0.0.0 --port 8082 --reload
   

   (--reload 是可选的，用于开发阶段)

使用 Docker

如果您使用 Docker，可以下载示例环境文件并将其重命名为 .env，然后按照上述说明进行编辑。

curl -O .env https://raw.githubusercontent.com/1rgs/claude-code-proxy/refs/heads/main/.env.example

之后，您可以使用 docker compose 启动容器（推荐）：

services:
  proxy:
    image: ghcr.io/1rgs/claude-code-proxy:latest
    restart: unless-stopped
    env_file: .env
    ports:
      - 8082:8082

或者使用命令行启动：

docker run -d --env-file .env -p 8082:8082 ghcr.io/1rgs/claude-code-proxy:latest

与 Claude Code 一起使用 🎮

1. 安装 Claude Code（如果您尚未安装）：

   npm install -g @anthropic-ai/claude-code
   

2. 连接到您的代理：

   ANTHROPIC_BASE_URL=http://localhost:8082 claude
   

3. 完成！ 您的 Claude Code 客户端现在将通过代理使用配置好的后端模型（默认为 Gemini）。🎯

模型映射 🗺️

代理会根据配置的模型自动将 Claude 模型映射到 OpenAI 或 Gemini 模型：

Claude 模型	默认映射	当 BIG_MODEL/SMALL_MODEL 是 Gemini 模型时
haiku	openai/gpt-4o-mini	gemini/[model-name]
sonnet	openai/gpt-4o	gemini/[model-name]

支持的模型

OpenAI 模型

以下 OpenAI 模型支持自动添加 openai/ 前缀：

• o3-mini
• o1
• o1-mini
• o1-pro
• gpt-4.5-preview
• gpt-4o
• gpt-4o-audio-preview
• chatgpt-4o-latest
• gpt-4o-mini
• gpt-4o-mini-audio-preview
• gpt-4.1
• gpt-4.1-mini

Gemini 模型

以下 Gemini 模型支持自动添加 gemini/ 前缀：

• gemini-2.5-pro
• gemini-2.5-flash

模型前缀处理

代理会自动为模型名称添加相应的前缀：

• OpenAI 模型会加上 openai/ 前缀
• Gemini 模型会加上 gemini/ 前缀
• BIG_MODEL 和 SMALL_MODEL 会根据它们是否属于 OpenAI 或 Gemini 模型列表来决定添加哪个前缀。

例如：

• gpt-4o 会变成 openai/gpt-4o
• gemini-2.5-pro-preview-03-25 会变成 gemini/gemini-2.5-pro-preview-03-25
• 当 BIG_MODEL 被设置为 Gemini 模型时，Claude Sonnet 会映射到 gemini/[model-name]。

自定义模型映射

您可以通过 .env 文件中的环境变量或直接进行控制：

示例 1：默认（使用 OpenAI） 无需更改 .env 文件，只需确保设置了 API 密钥即可，或者保持如下配置：

OPENAI_API_KEY="your-openai-key"
GEMINI_API_KEY="your-google-key" # 如果 PREFERRED_PROVIDER=google，则为必填项
# PREFERRED_PROVIDER="openai" # 可选，默认就是 openai
# BIG_MODEL="gpt-4.1" # 可选，默认是 gpt-4.1
# SMALL_MODEL="gpt-4.1-mini" # 可选，默认是 gpt-4.1-mini

示例 2a：优先使用 Google（使用 GEMINI_API_KEY）

GEMINI_API_KEY="your-google-key"
OPENAI_API_KEY="your-openai-key" # 用于备用
PREFERRED_PROVIDER="google"
# BIG_MODEL="gemini-2.5-pro" # 可选，默认是 gemini-2.5-pro
# SMALL_MODEL="gemini-2.5-flash" # 可选，默认是 gemini-2.5-flash

示例 2b：优先使用 Google（使用 Vertex AI 和 Application Default Credentials）

OPENAI_API_KEY="your-openai-key" # 用于备用
PREFERRED_PROVIDER="google"
VERTEX_PROJECT="your-gcp-project-id"
VERTEX_LOCATION="us-central1"
USE_VERTEX_AUTH=true
# BIG_MODEL="gemini-2.5-pro" # 可选，默认是 gemini-2.5-pro
# SMALL_MODEL="gemini-2.5-flash" # 可选，默认是 gemini-2.5-flash

示例 3：直接使用 Anthropic（仅作为 Anthropic 代理模式）

ANTHROPIC_API_KEY="sk-ant-..."
PREFERRED_PROVIDER="anthropic"

# 在此模式下，BIG_MODEL 和 SMALL_MODEL 会被忽略
# haiku/sonnet 请求会直接传递给 Anthropic 模型

使用场景：此模式使您能够在使用代理基础设施（用于日志记录、中间件、请求/响应处理等）的同时，仍使用真正的 Anthropic 模型，而不必强制映射到 OpenAI 或 Gemini。

示例 4：使用特定的 OpenAI 模型

OPENAI_API_KEY="your-openai-key"
GEMINI_API_KEY="your-google-key"
PREFERRED_PROVIDER="openai"
BIG_MODEL="gpt-4o" # 示例特定模型
SMALL_MODEL="gpt-4o-mini" # 示例特定模型

工作原理 🧩

该代理的工作流程如下：

1. 接收请求，格式为 Anthropic 的 API 格式 📥
2. 将请求转换为 OpenAI 格式，通过 LiteLLM 实现 🔄
3. 发送转换后的请求至 OpenAI 📤
4. 将响应转换回 Anthropic 格式 🔄
5. 返回格式化后的响应给客户端 ✅

该代理同时支持流式和非流式响应，确保与所有 Claude 客户端的兼容性。🌊

贡献 🤝

欢迎贡献！请随时提交 Pull Request。🎁

claude-code-proxy 快速上手指南

claude-code-proxy 是一个代理服务器，允许你在使用 Anthropic 客户端（如 Claude Code）时，无缝切换后端模型为 Google Gemini、OpenAI 或 原生 Anthropic 模型。它基于 LiteLLM 构建，实现了协议格式的自动转换。

环境准备

在开始之前，请确保满足以下前置条件：

• 操作系统：Linux / macOS / Windows (需支持 Docker 或 Python 环境)
• 核心依赖：
  • uv：高性能 Python 包管理器和运行时（推荐安装方式）。
  • 或者使用 Docker / Docker Compose。
• API 密钥（根据选择的后端至少准备一个）：
  • OPENAI_API_KEY：OpenAI 密钥（默认备用或首选）。
  • GEMINI_API_KEY：Google AI Studio 密钥（若使用 Google 直连）。
  • ANTHROPIC_API_KEY：Anthropic 密钥（若仅作为透传代理）。
  • 可选：Google Cloud Project 及 Vertex AI 权限（若使用 ADC 认证）。

提示：国内用户安装 uv 若遇网络问题，可尝试配置国内镜像源或使用代理。

安装步骤

你可以选择 源码运行 或 Docker 部署。

方式一：源码运行 (推荐开发者)

1. 克隆仓库

   git clone https://github.com/1rgs/claude-code-proxy.git
   cd claude-code-proxy
   

2. 安装 uv (如果尚未安装)

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   注：uv 会自动读取 pyproject.toml 处理依赖，无需手动 pip install。

3. 配置环境变量 复制示例配置文件并编辑：

   cp .env.example .env
   

   使用编辑器打开 .env，填入你的密钥和配置。以下是常用配置示例：

   • 场景 A：默认使用 OpenAI (将 haiku/sonnet 映射为 gpt-4o-mini/gpt-4o)

     OPENAI_API_KEY="sk-..."
     # PREFERRED_PROVIDER="openai" (默认值，可不填)
     

   • 场景 B：首选 Google Gemini (将 haiku/sonnet 映射为 gemini 模型)

     GEMINI_API_KEY="AIza..."
     OPENAI_API_KEY="sk-..." # 作为备用
     PREFERRED_PROVIDER="google"
     BIG_MODEL="gemini-2.5-pro"
     SMALL_MODEL="gemini-2.0-flash"
     

   • 场景 C：仅作为 Anthropic 透传代理 (用于日志记录等中间件功能)

     ANTHROPIC_API_KEY="sk-ant-..."
     PREFERRED_PROVIDER="anthropic"
     

4. 启动服务

   uv run uvicorn server:app --host 0.0.0.0 --port 8082 --reload
   

   服务将在 http://localhost:8082 运行。

方式二：Docker 部署 (推荐生产环境)

1. 下载配置文件

   curl -O .env https://raw.githubusercontent.com/1rgs/claude-code-proxy/refs/heads/main/.env.example
   

   请记得编辑 .env 文件填入真实的 API Key。

2. 启动容器 使用单条命令启动：

   docker run -d --env-file .env -p 8082:8082 ghcr.io/1rgs/claude-code-proxy:latest
   

   或者使用 docker-compose (创建 docker-compose.yml 后运行 docker compose up -d)：

   services:
     proxy:
       image: ghcr.io/1rgs/claude-code-proxy:latest
       restart: unless-stopped
       env_file: .env
       ports:
         - 8082:8082
   

基本使用

配置好代理服务后，即可让官方的 claude-code 客户端连接到本地代理。

1. 安装 Claude Code CLI

   npm install -g @anthropic-ai/claude-code
   

2. 连接代理并启动 通过设置 ANTHROPIC_BASE_URL 环境变量指向你的代理地址：

   ANTHROPIC_BASE_URL=http://localhost:8082 claude
   

3. 验证效果 启动后，客户端发出的请求会被代理拦截。

   • 如果你配置了 PREFERRED_PROVIDER=google，当你调用 sonnet 模型时，实际后台会请求配置的 Gemini 模型。
   • 整个过程对客户端透明，无需修改客户端代码。

---

模型映射逻辑简述：

• Haiku (小模型) -> 默认映射为 gpt-4o-mini 或配置的 SMALL_MODEL。
• Sonnet (大模型) -> 默认映射为 gpt-4o 或配置的 BIG_MODEL。
• 代理会自动为模型名称添加 openai/ 或 gemini/ 前缀以适配 LiteLLM 路由。