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

Providers

Proxy de API do Claude Max

claude-max-api-proxy é um pacote npm da comunidade (não é um plugin do OpenClaw) que expõe uma assinatura Claude Max/Pro como um endpoint de API compatível com a OpenAI, para que você possa direcionar qualquer ferramenta compatível com a OpenAI à sua assinatura em vez de usar uma chave de API da Anthropic.

Por que usar isto

Abordagem Forma de cobrança Mais indicado para
Chave de API da Anthropic Pagamento por token pelo Claude Console Aplicativos de produção, automação compartilhada, volume
Proxy da assinatura Claude Regras de plano e créditos do Claude Code / claude -p Experimentos pessoais com ferramentas compatíveis

Este proxy permite que uma assinatura Claude Max ou Pro funcione com ferramentas compatíveis com a OpenAI. Ele não é um caminho ilimitado com tarifa fixa — ele herda os limites de uso do Claude Code. As chaves de API continuam sendo o caminho de cobrança mais claro para uso em produção.

Como funciona

text
Seu aplicativo -> claude-max-api-proxy -> CLI do Claude Code / claude -p -> Anthropic     (formato OpenAI)                   (converte o formato)            (usa seu login)

O proxy inicia a CLI do Claude Code como um subprocesso para cada solicitação, converte solicitações de chat no formato OpenAI em prompts da CLI e transmite (ou retorna) a resposta no formato OpenAI.

Primeiros passos

  • Instalar o proxy

    Requer Node.js 20+ e uma CLI do Claude Code autenticada.

    bash
    npm install -g claude-max-api-proxy # Verifique se a CLI do Claude está autenticadaclaude --versionclaude auth login   # se ainda não estiver autenticada

  • Iniciar o servidor

    bash
    claude-max-api# O servidor é executado em http://localhost:3456

  • Testar o 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!"}]  }'

  • Configurar o OpenClaw

    Direcione o OpenClaw ao proxy como um endpoint personalizado compatível com a OpenAI:

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

    Configuração avançada

    Observações sobre o proxy compatível com a OpenAI

    Isto usa a rota personalizada genérica /v1 do OpenClaw compatível com a OpenAI, o mesmo caminho de qualquer outro backend auto-hospedado compatível com a OpenAI:

    • A formatação de solicitações exclusiva da OpenAI nativa não se aplica.
    • /fast e service_tier aplicam-se somente ao tráfego direto para api.anthropic.com; as rotas de proxy deixam service_tier inalterado (consulte modo rápido do provedor Anthropic).
    • Sem store da Responses, dicas de cache de prompts ou formatação de payload de compatibilidade de raciocínio da OpenAI.
    • Os cabeçalhos de atribuição OpenAI/Codex do OpenClaw (originator, version, User-Agent) são enviados somente no tráfego OAuth nativo para api.openai.com, e não para destinos personalizados de OPENAI_BASE_URL como este proxy.
    Inicialização automática no macOS com 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

    Observações

    • Herda o comportamento de cobrança, créditos de uso e limites de taxa de claude -p do Claude Code.
    • Vincula-se apenas a 127.0.0.1; não envia dados a nenhum servidor de terceiros além da própria chamada da CLI à Anthropic.
    • Há suporte a respostas por streaming.
    • Falhas de autenticação não são verificadas na inicialização e só aparecem quando uma solicitação de chat é realmente executada; se a CLI não estiver autenticada, espere que a primeira solicitação falhe, em vez de o servidor se recusar a iniciar.

    Relacionados

    Provedor Anthropic

    Integração nativa do OpenClaw com a CLI do Claude ou chaves de API.
    Provedor OpenAI

    Para assinaturas OpenAI/Codex.
    Seleção de modelo

    Visão geral de todos os provedores, referências de modelo e comportamento de failover.
    Configuração

    Referência completa de configuração.
    Was this useful?
    On this page

    On this page