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

Providers

Proxy API Claude Max

claude-max-api-proxy è un pacchetto npm della community (non un plugin di OpenClaw) che espone un abbonamento Claude Max/Pro come endpoint API compatibile con OpenAI, così puoi indirizzare qualsiasi strumento compatibile con OpenAI al tuo abbonamento anziché a una chiave API Anthropic.

Perché utilizzarlo

Approccio Modalità di addebito Ideale per
Chiave API Anthropic Pagamento per token tramite Claude Console Applicazioni di produzione, automazione condivisa, volumi
Proxy abbonamento Claude Piano e regole sui crediti di Claude Code / claude -p Esperimenti personali con strumenti compatibili

Questo proxy consente a un abbonamento Claude Max o Pro di funzionare con strumenti compatibili con OpenAI. Non è una soluzione illimitata a tariffa fissa: eredita i limiti di utilizzo di Claude Code. Le chiavi API rimangono il percorso di fatturazione più chiaro per l'uso in produzione.

Come funziona

text
La tua applicazione -> claude-max-api-proxy -> CLI di Claude Code / claude -p -> Anthropic     (formato OpenAI)                       (converte il formato)              (usa il tuo accesso)

Il proxy avvia la CLI di Claude Code come sottoprocesso per ogni richiesta, converte le richieste di chat in formato OpenAI in prompt per la CLI e trasmette in streaming (o restituisce) la risposta in formato OpenAI.

Per iniziare

  • Installa il proxy

    Richiede Node.js 20+ e una CLI di Claude Code autenticata.

    bash
    npm install -g claude-max-api-proxy # Verifica che la CLI di Claude sia autenticataclaude --versionclaude auth login   # se non è già autenticata

  • Avvia il server

    bash
    claude-max-api# Il server è in esecuzione su http://localhost:3456

  • Verifica il proxy

    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": "Hello!"}]  }'

  • Configura OpenClaw

    Indirizza OpenClaw al proxy come endpoint personalizzato compatibile con OpenAI:

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • ID modello Alias CLI Corrispondenza attuale
    claude-opus-4 opus Claude Opus 4.5
    claude-sonnet-4 sonnet Claude Sonnet 4
    claude-haiku-4 haiku Claude Haiku 4

    Configurazione avanzata

    Note sulla compatibilità con OpenAI tramite proxy

    Questa soluzione utilizza il percorso /v1 personalizzato generico di OpenClaw compatibile con OpenAI, lo stesso percorso di qualsiasi altro backend compatibile con OpenAI ospitato autonomamente:

    • Non si applica la strutturazione delle richieste riservata esclusivamente a OpenAI nativo.
    • /fast e service_tier si applicano solo al traffico diretto verso api.anthropic.com; i percorsi tramite proxy lasciano invariato service_tier (consulta la modalità rapida del provider Anthropic).
    • Nessuna strutturazione dei payload per store di Responses, indicazioni sulla cache dei prompt o compatibilità del ragionamento OpenAI.
    • Le intestazioni di attribuzione OpenAI/Codex di OpenClaw (originator, version, User-Agent) vengono inviate solo nel traffico OAuth nativo verso api.openai.com, non verso destinazioni OPENAI_BASE_URL personalizzate come questo proxy.
    Avvio automatico su macOS con 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

    Note

    • Eredita il comportamento di fatturazione, dei crediti di utilizzo e dei limiti di frequenza di claude -p di Claude Code.
    • Si associa esclusivamente a 127.0.0.1; non invia dati ad alcun server di terze parti oltre alla chiamata della CLI ad Anthropic.
    • Sono supportate le risposte in streaming.
    • Gli errori di autenticazione non vengono verificati all'avvio e si manifestano solo quando viene effettivamente eseguita una richiesta di chat; se la CLI non è autenticata, la prima richiesta non riuscirà anziché impedire l'avvio del server.

    Contenuti correlati

    Provider Anthropic

    Integrazione nativa di OpenClaw con la CLI di Claude o le chiavi API.
    Provider OpenAI

    Per gli abbonamenti OpenAI/Codex.
    Selezione del modello

    Panoramica di tutti i provider, dei riferimenti ai modelli e del comportamento di failover.
    Configurazione

    Riferimento completo della configurazione.
    Was this useful?
    On this page

    On this page