claude-worker-proxy: Proxy-Tool zur Konvertierung mehrerer Modell-APIs in das Claude-Format

claude-worker-proxyist ein Proxy-Dienst, der auf Cloudflare Workers bereitgestellt wird. Seine Hauptfunktion ist die Konvertierung des Anfrageformats einer Vielzahl von großen Modell-APIs wie Google Gemini und OpenAI in das Anthropic Claude-Format. Dadurch können Client-Anwendungen, die ursprünglich das Claude-API-Format anpassen mussten, wie z. B. Claude Code, direkt Modelle von Gemini oder OpenAI anfordern und so die Entwicklungs- und Wartungskosten senken. Das Projekt unterstützt Streaming- und Non-Streaming-Antworten sowie Tool-Aufrufe und kann mit einem einzigen Klick sofort eingesetzt werden.

Funktionsliste

• API-Format-KonvertierungNahtlose Konvertierung von API-Anfrage- und Antwortformaten für Modelle wie Gemini und OpenAI in das Claude-API-Format.
• Kompatibel mit Claude EcologyErmöglicht Clients, die für die Claude-API entwickelt wurden (z. B. Claude Code), die KI-Modelle anderer Anbieter direkt zu nutzen.
• Ein-Klick-BereitstellungBenutzer können schnell und ohne komplexe Serverkonfiguration über die Cloudflare Workers-Plattform bereitstellen.
• Unterstützung von Streaming-AntwortenKompatibel mit Streaming-API-Antwortmodi, bei denen die Daten in Echtzeit zurückgegeben werden müssen.
• Unterstützung für Tool-Aufrufe:: Unterstützung für KI-Modelle zur Interaktion mit externen Tools oder Funktionen.
• Null-Konfiguration beim Start:: Das Projekt ist so konzipiert, dass es einfach ist und von den Benutzern sofort nach der Bereitstellung verwendet werden kann, ohne dass eine zusätzliche Konfiguration erforderlich ist.

Hilfe verwenden

Einsatz und Nutzungclaude-worker-proxyEs ist sehr einfach und stützt sich stark auf die Cloudflare Workers-Plattform und den npm-Paketmanager.

Vor der Installation

1. Ein Cloudflare-Konto: Sie müssen sich bei Cloudflare registrieren und anmelden.
2. Node.js und npmStellen Sie sicher, dass Sie Node.js und npm in Ihrer Entwicklungsumgebung installiert haben.
3. Wrangler CLIWrangler ist das offizielle Cloudflare-Kommandozeilen-Tool zur Verwaltung von Workers-Projekten. Es kann global über npm installiert werden, wenn es nicht bereits installiert ist:

   npm install -g wrangler@latest
   

Prozess der Bereitstellung

1. Projektcode klonen
   Klonen Sie zunächst den Quellcode des Projekts lokal von GitHub.

   git clone https://github.com/glidea/claude-worker-proxy
   

2. Wechseln Sie in das Projektverzeichnis und installieren Sie die Abhängigkeiten

   cd claude-worker-proxy
   npm install
   

3. Bei Wrangler anmelden
   Führen Sie den Login-Befehl aus und es öffnet sich ein Browserfenster, in dem Sie den Zugang zu Ihrem Cloudflare-Konto autorisieren können.

   wrangler login
   

4. Führen Sie den Einsatzbefehl aus
   Führen Sie im Stammverzeichnis des Projekts das Deployment-Skript aus. Dieses Skript verpackt den Code und stellt ihn in einem neuen Worker-Dienst unter Ihrem Cloudflare-Konto bereit.

   npm run deploycf
   

   Nach erfolgreicher Bereitstellung gibt die Befehlszeile eine.workers.devDie URL mit dem Suffix, unter dem Ihr Proxy-Dienst aufgerufen wird.

Wie zu verwenden

Nach erfolgreicher Bereitstellung können Sie diesen Proxy verwenden, indem Sie eine HTTP-POST-Anfrage an Ihre Worker-URL senden. Es gibt bestimmte Anforderungen an das Format der URL und den Request-Header.

URL-Format

Die URL-Struktur der Anfrage sieht wie folgt aus:
{你的Worker URL}/{目标模型类型}/{目标API基础地址}/v1/messages

• {你的Worker URL}: Adresse nach erfolgreicher Bereitstellung, z. B. https://claude-worker-proxy.xxxx.workers.dev.
• {目标模型类型}:: Derzeit unterstützt gemini im Gesang antworten openai.
• {目标API基础地址}:: Die offizielle API-Basisadresse des Zielanbieters.Die API-Versionsnummer muss mitgebracht werden. Die Adresse von Gemini lautet zum Beispiel https://generativelanguage.googleapis.com/v1beta.

Kopfzeile anfordern

Die Anfrage muss einen speziellen Anfrage-Header enthalten, um den API-Schlüssel des Zielanbieters zu übergeben:

• x-api-keyDer Wert : ist der API-Schlüssel Ihres Zielanbieters (z. B. Ihr Gemini-API-Schlüssel).

Beispiel einer Anfrage: Abfrage von Gemini mit curl

Das folgende Beispiel zeigt, wie man eine Anfrage an ein Google Gemini-Modell über einen Proxy im Claude-Format sendet:

curl -X POST https://claude-worker-proxy.xxxx.workers.dev/gemini/https://generativelanguage.googleapis.com/v1beta/v1/messages \
-H "x-api-key: YOUR_GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-1.5-flash",
"messages": [
{"role": "user", "content": "Hello"}
]
}'

bitte angebenhttps://claude-worker-proxy.xxxx.workers.devErsetzen Sie sie durch Ihre tatsächliche Adresse des Arbeitnehmers und dieYOUR_GEMINI_API_KEYErsetzen Sie ihn durch Ihren gültigen Gemini-API-Schlüssel.

Verwendung in Claude Code

Für Claude Code-Benutzer können API-Anfragen an diesen Proxy-Dienst geleitet werden, indem sie ihre Konfigurationsdatei ändern.

1. Konfigurationsdatei bearbeiten ~/.claude/settings.json.
2. Ändern Sie die Umgebungsvariablen darin, wie im folgenden Beispiel gezeigt:

   {
   "env": {
   "ANTHROPIC_BASE_URL": "https://claude-worker-proxy.xxxx.workers.dev/gemini/https://generativelanguage.googleapis.com/v1beta",
   "ANTHROPIC_CUSTOM_HEADERS": "x-api-key: YOUR_GEMINI_API_KEY",
   "ANTHROPIC_MODEL": "gemini-1.5-pro",
   "ANTHROPIC_SMALL_FAST_MODEL": "gemini-1.5-flash",
   "API_TIMEOUT_MS": "600000"
   }
   }
   

   • ANTHROPIC_BASE_URLSetzen Sie sie auf Ihre Proxy-URL und fügen Sie den Zielmodelltyp und die API-Adresse ein.
   • ANTHROPIC_CUSTOM_HEADERSLegen Sie den API-Schlüssel fest.
   • ANTHROPIC_MODELGeben Sie an, welches große Modell Sie verwenden möchten.
   • ANTHROPIC_SMALL_FAST_MODEL: Geben Sie die Miniaturen an, die Sie verwenden möchten.
3. Nachdem Sie die Konfigurationsdatei gespeichert haben, führen Sie sie direkt im Terminal aus claude um das konfigurierte Modell über den Proxy zu verwenden.

Anwendungsszenario

1. Einheitliche Entwicklungsschnittstelle
   Für Anwendungen, die die Claude-API angepasst haben, müssen Entwickler die API-Anforderungslogik für verschiedene Modelle wie Gemini oder OpenAI nicht neu schreiben. Richten Sie Anfragen einfach an diesen Proxy, um schnell zwischen Modellen verschiedener Anbieter zu wechseln und diese zu nutzen.
2. Verwendung mit spezifischen Werkzeugen
   Werkzeuge wie Claude Code, die von Haus aus für die Claude-API konzipiert sind, können über diesen Agenten nahtlos zu anderen, kostengünstigeren oder leistungsfähigeren Modellen wechseln, wie z. B. das Gemini-Modell für codebezogene Aufgaben.
3. Rationalisierung der Front-End-Anwendungsentwicklung
   Dieser Worker-Agent kann bei der Entwicklung von Web- oder Desktop-Anwendungen als einheitliches Back-End-API-Gateway verwendet werden. Die Front-End-Anwendung muss nur einem API-Format folgen, während die Proxy-Schicht die Kommunikationsdetails mit verschiedenen KI-Dienstanbietern handhabt.

QA

1. Ist dieses Programm kostenlos?
   Der Quellcode des Projekts ist quelloffen und kostenlos. Der Einsatz auf Cloudflare Workers verbraucht jedoch Plattformressourcen, und Cloudflare hat ein kostenloses Kontingent, für das Sie bezahlen müssen. Auch die Zielmodell-APIs, die Sie aufrufen (z. B. Gemini), werden pro Nutzung an ihre Anbieter (z. B. Google) bezahlt.
2. Warum muss ich die API-Basisadresse des Zielanbieters in der URL angeben?
   Dieses Design bietet mehr Flexibilität. Es ermöglicht dem Benutzer, jeden API-Service-Endpunkt, der mit OpenAI- oder Gemini-Formaten kompatibel ist, dynamisch zu spezifizieren, anstatt ihn fest in den Code zu codieren. Das heißt, wenn der Anbieter die API-Version in Zukunft aktualisiert oder Sie eine kompatible API eines Drittanbieters verwenden, ändern Sie einfach die Anfrage-URL.
3. Wird dieser Proxy meinen API-Schlüssel oder meine Anfragedaten speichern?
   Dem Open-Source-Code des Projekts zufolge dient es nur als Zwischenschicht für die Weiterleitung von Anfragen und die Formatkonvertierung und zeichnet den API-Schlüssel des Nutzers und den Inhalt der Anfrage nicht auf oder speichert ihn. Wenn es jedoch auf einer Plattform eines Drittanbieters eingesetzt wird, unterliegt es weiterhin den Daten- und Datenschutzrichtlinien dieser Plattform.
4. Was sind die Vorteile der Verwendung dieses Proxys gegenüber dem direkten Aufruf der API von Gemini oder OpenAI?
   Der Hauptvorteil ist die API-Kompatibilität für bestehende Claude-Clients. Wenn Ihre Anwendung oder Toolchain um die Claude-API herum aufgebaut ist, bietet Ihnen die Verwendung dieses Agenten die Flexibilität, Ihre Backend-KI-Modelle durch Gemini oder OpenAI zu ersetzen, ohne den Client-Code zu ändern.