Providers
Claude-Max-API-Proxy
claude-max-api-proxy ist ein Community-npm-Paket (kein OpenClaw-Plugin), das ein Claude-Max-/Pro-Abonnement als OpenAI-kompatiblen API-Endpunkt bereitstellt, sodass Sie jedes OpenAI-kompatible Tool mit Ihrem Abonnement statt mit einem Anthropic-API-Schlüssel verwenden können.
Gründe für die Verwendung
| Ansatz | Abrechnungsweg | Am besten geeignet für |
|---|---|---|
| Anthropic-API-Schlüssel | Tokenbasierte Abrechnung über die Claude Console | Produktionsanwendungen, gemeinsame Automatisierung, hohes Volumen |
| Claude-Abonnement-Proxy | Plan- und Guthabenregeln von Claude Code / claude -p |
Persönliche Experimente mit kompatiblen Tools |
Mit diesem Proxy kann ein Claude-Max- oder -Pro-Abonnement mit OpenAI-kompatiblen Tools verwendet werden. Es handelt sich nicht um einen unbegrenzten Pauschaltarif – es gelten die Nutzungslimits von Claude Code. API-Schlüssel bleiben für den Produktionseinsatz der transparentere Abrechnungsweg.
Funktionsweise
Ihre App -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic (OpenAI-Format) (konvertiert das Format) (verwendet Ihre Anmeldung)Der Proxy startet die Claude Code CLI für jede Anfrage als Unterprozess, konvertiert Chatanfragen im OpenAI-Format in CLI-Prompts und streamt die Antwort im OpenAI-Format zurück (oder gibt sie direkt zurück).
Erste Schritte
Proxy installieren
Erfordert Node.js 20+ und eine authentifizierte Claude Code CLI.
npm install -g claude-max-api-proxy # Prüfen, ob die Claude CLI authentifiziert istclaude --versionclaude auth login # falls noch nicht authentifiziertServer starten
claude-max-api# Server läuft unter http://localhost:3456Proxy testen
curl http://localhost:3456/healthcurl http://localhost:3456/v1/models curl http://localhost:3456/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ "model": "claude-opus-4", "messages": [{"role": "user", "content": "Hallo!"}] }'OpenClaw konfigurieren
Richten Sie OpenClaw so ein, dass der Proxy als benutzerdefinierter OpenAI-kompatibler Endpunkt verwendet wird:
{ env: { OPENAI_API_KEY: "not-needed", OPENAI_BASE_URL: "http://localhost:3456/v1", }, agents: { defaults: { model: { primary: "openai/claude-opus-4" }, }, },}| Modell-ID | CLI-Alias | Aktuelle Zuordnung |
|---|---|---|
claude-opus-4 |
opus |
Claude Opus 4.5 |
claude-sonnet-4 |
sonnet |
Claude Sonnet 4 |
claude-haiku-4 |
haiku |
Claude Haiku 4 |
Erweiterte Konfiguration
Hinweise zum OpenAI-kompatiblen Proxy
Hierbei wird die generische benutzerdefinierte OpenAI-kompatible
/v1-Route von OpenClaw verwendet – derselbe Weg wie bei jedem
anderen selbst gehosteten OpenAI-kompatiblen Backend:
- Die ausschließlich für natives OpenAI vorgesehene Anfrageaufbereitung wird nicht angewendet.
/fastundservice_tiergelten nur für direktenapi.anthropic.com-Datenverkehr; Proxy-Routen lassenservice_tierunverändert (siehe Schnellmodus des Anthropic-Providers).- Keine Responses-
store, Prompt-Cache-Hinweise oder OpenAI-Reasoning-Kompatibilitätsaufbereitung der Nutzdaten. - Die OpenAI-/Codex-Zuordnungs-Header von OpenClaw (
originator,version,User-Agent) werden nur bei nativemapi.openai.com-OAuth-Datenverkehr gesendet, nicht an benutzerdefinierteOPENAI_BASE_URL-Ziele wie diesen Proxy.
Automatischer Start unter macOS mit LaunchAgent
cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>Label</key> <string>com.claude-max-api</string> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/> <key>ProgramArguments</key> <array> <string>/usr/local/bin/node</string> <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string> </array> <key>EnvironmentVariables</key> <dict> <key>PATH</key> <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string> </dict></dict></plist>EOF launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plistHinweise
- Übernimmt das Abrechnungs-, Nutzungsguthaben- und Ratenbegrenzungsverhalten von Claude Code für
claude -p. - Bindet ausschließlich an
127.0.0.1; sendet außer dem eigenen CLI-Aufruf an Anthropic keine Daten an Drittanbieterserver. - Streaming-Antworten werden unterstützt.
- Authentifizierungsfehler werden beim Start nicht geprüft und treten erst auf, wenn tatsächlich eine Chatanfrage ausgeführt wird. Wenn die CLI nicht authentifiziert ist, schlägt daher voraussichtlich die erste Anfrage fehl, anstatt dass der Server den Start verweigert.
