Vai al contenuto principale
claude-max-api-proxy è uno strumento della community che espone il tuo abbonamento Claude Max/Pro come endpoint API compatibile con OpenAI. Questo ti consente di usare il tuo abbonamento con qualsiasi strumento che supporti il formato dell’API OpenAI.
Questo percorso offre solo compatibilità tecnica. In passato Anthropic ha bloccato alcuni utilizzi degli abbonamenti al di fuori di Claude Code. Devi decidere autonomamente se usarlo e verificare le regole di fatturazione attuali di Anthropic prima di farci affidamento.La documentazione di supporto attuale di Anthropic indica che claude -p è uso Agent SDK/programmatico. L’aggiornamento di supporto Anthropic del 15 giugno 2026 ha sospeso il piano di crediti Agent SDK separato annunciato. Per ora, Claude Agent SDK, claude -p e l’uso di app di terze parti continuano a consumare i limiti di utilizzo dell’abbonamento con cui hai effettuato l’accesso.Prima di fare affidamento su questo percorso, consulta l’articolo sul piano Agent SDK di Anthropic, oltre agli articoli di supporto di Claude Code per gli account Pro/Max o Team/Enterprise.

​
Perché usarlo?

ApproccioPercorso dei costiIdeale per
API AnthropicPagamento per token tramite Claude Console o cloudApp di produzione, automazione condivisa, volume
Proxy abbonamento ClaudeRegole del piano e dei crediti Claude Code / claude -pEsperimenti personali con strumenti compatibili
Se hai un abbonamento Claude Max o Pro e vuoi usarlo con strumenti compatibili con OpenAI, questo proxy può adattarsi ad alcuni flussi di lavoro personali. Non è un percorso illimitato a tariffa fissa. Le chiavi API restano il percorso più chiaro per policy e fatturazione nell’uso in produzione.

​
Come funziona

Your App → claude-max-api-proxy → Claude Code CLI / claude -p → Anthropic
     (OpenAI format)              (converts format)          (uses your login)
Il proxy:
  1. Accetta richieste in formato OpenAI su http://localhost:3456/v1/chat/completions
  2. Le converte in comandi Claude Code CLI
  3. Restituisce le risposte in formato OpenAI (streaming supportato)

​
Primi passi

1

Install the proxy

Richiede Node.js 22+ e Claude Code CLI.
npm install -g claude-max-api-proxy

# Verify Claude CLI is authenticated
claude --version
2

Start the server

claude-max-api
# Server runs at http://localhost:3456
3

Test the proxy

# Health check
curl http://localhost:3456/health

# List models
curl http://localhost:3456/v1/models

# Chat completion
curl http://localhost:3456/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
4

Configure OpenClaw

Punta OpenClaw al proxy come endpoint personalizzato compatibile con OpenAI:
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

​
Catalogo integrato

ID modelloMappa a
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4

​
Configurazione avanzata

Questo percorso usa lo stesso instradamento proxy compatibile con OpenAI degli altri backend /v1 personalizzati:
  • La modellazione delle richieste nativa solo OpenAI non si applica
  • Nessun service_tier, nessuno store Responses, nessun suggerimento di prompt-cache e nessuna modellazione del payload di compatibilità reasoning OpenAI
  • Le intestazioni di attribuzione OpenClaw nascoste (originator, version, User-Agent) non vengono iniettate sull’URL del proxy
Crea un LaunchAgent per eseguire automaticamente il proxy:
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

  • Questo è uno strumento della community, non supportato ufficialmente da Anthropic o OpenClaw
  • Richiede un abbonamento Claude Max/Pro attivo con Claude Code CLI autenticata
  • Eredita il comportamento di fatturazione, crediti di utilizzo e limiti di frequenza di Claude Code claude -p
  • Il proxy viene eseguito localmente e non invia dati a server di terze parti
  • Le risposte in streaming sono completamente supportate
Per l’integrazione nativa Anthropic con Claude CLI o chiavi API, vedi provider Anthropic. Per gli abbonamenti OpenAI/Codex, vedi provider OpenAI.

​
Correlati

Anthropic provider

Integrazione nativa OpenClaw con Claude CLI o chiavi API.

OpenAI provider

Per abbonamenti OpenAI/Codex.

Model selection

Panoramica di tutti i provider, dei riferimenti modello e del comportamento di failover.

Configuration

Riferimento completo della configurazione.