OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Claude Max API-proxy

claude-max-api-proxy is een community-npm-pakket (geen OpenClaw-plugin) dat een Claude Max/Pro-abonnement beschikbaar stelt als een OpenAI-compatibel API-eindpunt, zodat je elk OpenAI-compatibel hulpprogramma naar je abonnement kunt laten verwijzen in plaats van naar een Anthropic-API-sleutel.

Waarom dit gebruiken

Aanpak Kostenroute Meest geschikt voor
Anthropic-API-sleutel Betalen per token via Claude Console Productie-apps, gedeelde automatisering, volume
Claude-abonnementsproxy Plan- en tegoedregels van Claude Code / claude -p Persoonlijke experimenten met compatibele hulpmiddelen

Met deze proxy werkt een Claude Max- of Pro-abonnement met OpenAI-compatibele hulpmiddelen. Het is geen onbeperkte route met een vast tarief: de gebruikslimieten van Claude Code zijn van toepassing. API-sleutels blijven de duidelijkere factureringsroute voor productiegebruik.

Hoe het werkt

text
Jouw app -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic     (OpenAI-indeling)             (converteert indeling)           (gebruikt je aanmelding)

De proxy start voor elke aanvraag de Claude Code CLI als een subproces, zet chatverzoeken in OpenAI-indeling om in CLI-prompts en streamt de respons terug (of retourneert deze) in OpenAI-indeling.

Aan de slag

  • De proxy installeren

    Vereist Node.js 20+ en een geauthenticeerde Claude Code CLI.

    bash
    npm install -g claude-max-api-proxy # Controleren of Claude CLI is geauthenticeerdclaude --versionclaude auth login   # indien nog niet geauthenticeerd

  • De server starten

    bash
    claude-max-api# Server draait op http://localhost:3456

  • De proxy testen

    bash
    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 configureren

    Laat OpenClaw naar de proxy verwijzen als een aangepast OpenAI-compatibel eindpunt:

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • Model-id CLI-alias Huidige koppeling
    claude-opus-4 opus Claude Opus 4.5
    claude-sonnet-4 sonnet Claude Sonnet 4
    claude-haiku-4 haiku Claude Haiku 4

    Geavanceerde configuratie

    Opmerkingen over de proxy-achtige OpenAI-compatibele route

    Dit gebruikt OpenClaws algemene aangepaste /v1 OpenAI-compatibele route, hetzelfde pad als elke andere zelfgehoste OpenAI-compatibele backend:

    • Aanvraagvorming die uitsluitend voor native OpenAI geldt, is niet van toepassing.
    • /fast en service_tier zijn alleen van toepassing op rechtstreeks api.anthropic.com- verkeer; proxyroutes laten service_tier ongewijzigd (zie snelle modus van de Anthropic-provider).
    • Geen Responses-store, aanwijzingen voor promptcaching of OpenAI-reasoningcompatibele vormgeving van payloads.
    • De OpenAI/Codex-toeschrijvingsheaders van OpenClaw (originator, version, User-Agent) worden alleen verzonden bij native api.openai.com OAuth-verkeer, niet naar aangepaste OPENAI_BASE_URL-doelen zoals deze proxy.
    Automatisch starten op macOS met LaunchAgent
    bash
    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

    Opmerkingen

    • Neemt het gedrag voor facturering, gebruikstegoed en snelheidslimieten van claude -p van Claude Code over.
    • Luistert uitsluitend op 127.0.0.1; verzendt geen gegevens naar servers van derden, afgezien van de eigen aanroep van de CLI naar Anthropic.
    • Streamingresponsen worden ondersteund.
    • Authenticatiefouten worden bij het opstarten niet gecontroleerd en worden pas zichtbaar wanneer er daadwerkelijk een chatverzoek wordt uitgevoerd; als de CLI niet is geauthenticeerd, mislukt naar verwachting het eerste verzoek in plaats van dat de server weigert te starten.

    Gerelateerd

    Anthropic-provider

    Native OpenClaw-integratie met Claude CLI of API-sleutels.
    OpenAI-provider

    Voor OpenAI/Codex-abonnementen.
    Modelselectie

    Overzicht van alle providers, modelverwijzingen en failovergedrag.
    Configuratie

    Volledige configuratiereferentie.
    Was this useful?
    On this page

    On this page