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.

Nur technisch kompatibel, kein offiziell genehmigter Weg. Anthropic hat in der Vergangenheit bestimmte Nutzungen von Abonnements außerhalb von Claude Code blockiert; prüfen Sie die aktuellen Abrechnungsregeln von Anthropic, bevor Sie sich darauf verlassen.Die Dokumentation zu Claude Code von Anthropic beschreibt claude -p als Agent-SDK-/programmgesteuerte Nutzung. Gemäß der Support-Aktualisierung von Anthropic vom 15. Juni 2026 werden Claude Agent SDK, claude -p und die Nutzung von Drittanbieter-Apps auf die Nutzungslimits des angemeldeten Abonnements angerechnet (der zuvor angekündigte separate Guthabenplan für das Agent SDK ist pausiert). Weitere Informationen finden Sie im Anthropic-Artikel zum Agent-SDK-Plan, in den Planartikeln zu Pro/Max und Team/Enterprise sowie unter Anthropic-Provider mit den OpenClaw-eigenen Hinweisen zur Abrechnung der Claude CLI.

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 ist
claude --version
claude auth login   # falls noch nicht authentifiziert

Server starten

claude-max-api
# Server läuft unter http://localhost:3456

Proxy testen

curl http://localhost:3456/health
curl 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" },
    },
  },
}

Die nachstehenden Modell-IDs gehören zum eigenen Katalog des Proxys und sind keine Anthropic-Modellreferenzen von OpenClaw. Jede ID ist einem Modellalias der Claude Code CLI (opus, sonnet, haiku) zugeordnet. Daher ändert sich das zugrunde liegende Modell, sobald Anthropic diesen Alias in der CLI aktualisiert. Prüfen Sie die aktuelle README-Datei des Proxys, bevor Sie sich auf eine bestimmte Zuordnung verlassen.

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.
/fast und service_tier gelten nur für direkten api.anthropic.com-Datenverkehr; Proxy-Routen lassen service_tier unverä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 nativem api.openai.com-OAuth-Datenverkehr gesendet, nicht an benutzerdefinierte OPENAI_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.plist

Hinweise

Ü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.

Informationen zur nativen Anthropic-Integration mit der Claude CLI oder API-Schlüsseln finden Sie unter Anthropic-Provider. Informationen zu OpenAI-/Codex-Abonnements finden Sie unter OpenAI-Provider.

Anthropic-Provider

Native OpenClaw-Integration mit der Claude CLI oder API-Schlüsseln.

OpenAI-Provider

Für OpenAI-/Codex-Abonnements.

Modellauswahl

Übersicht über alle Provider, Modellreferenzen und das Failover-Verhalten.

Konfiguration

Vollständige Konfigurationsreferenz.

Overview

Concepts and configuration

Providers

Claude-Max-API-Proxy

Gründe für die Verwendung

Funktionsweise

Erste Schritte

Erweiterte Konfiguration

Hinweise

Verwandte Themen

Anthropic-Provider

OpenAI-Provider

Modellauswahl

Konfiguration

​Gründe für die Verwendung

​Funktionsweise

​Erste Schritte

​Erweiterte Konfiguration

​Hinweise

​Verwandte Themen

Anthropic-Provider

OpenAI-Provider

Modellauswahl

Konfiguration

Gründe für die Verwendung

Funktionsweise

Erste Schritte

Erweiterte Konfiguration

Hinweise

Verwandte Themen