claude-code-proxy

Anthropic API Proxy for Gemini & OpenAI Models 🔄

Use Anthropic clients (like Claude Code) with Gemini, OpenAI, or direct Anthropic backends. 🤝

A proxy server that lets you use Anthropic clients with Gemini, OpenAI, or Anthropic models themselves (a transparent proxy of sorts), all via LiteLLM. 🌉

Quick Start ⚡

Prerequisites

- OpenAI API key 🔑
- Google AI Studio (Gemini) API key (if using Google provider) 🔑
- Google Cloud Project with Vertex AI API enabled (if using Application Default Credentials for Gemini) ☁️
- uv installed.

Setup 🛠️

From source

1. Clone this repository:

2. Install uv (if you haven't already):

   *(uv will handle dependencies based on pyproject.toml when you run the server)*

3. Configure Environment Variables:
   Copy the example environment file:

   Edit .env and fill in your API keys and model configurations:

   *   ANTHROPIC_API_KEY: (Optional) Needed only if proxying *to* Anthropic models.
   *   OPENAI_API_KEY: Your OpenAI API key (Required if using the default OpenAI preference or as fallback).
   *   GEMINI_API_KEY: Your Google AI Studio (Gemini) API key (Required if PREFERRED_PROVIDER=google and USE_VERTEX_AUTH=true).
   *   USE_VERTEX_AUTH (Optional): Set to true to use Application Default Credentials (ADC) will be used (no static API key required). Note: when USE_VERTEX_AUTH=true, you must configure VERTEX_PROJECT and VERTEX_LOCATION.
   *   VERTEX_PROJECT (Optional): Your Google Cloud Project ID (Required if PREFERRED_PROVIDER=google and USE_VERTEX_AUTH=true).
   *   VERTEX_LOCATION (Optional): The Google Cloud region for Vertex AI (e.g., us-central1) (Required if PREFERRED_PROVIDER=google and USE_VERTEX_AUTH=true).
   *   PREFERRED_PROVIDER (Optional): Set to openai (default), google, or anthropic. This determines the…