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.

Apenas compatibilidade técnica, não um caminho oficialmente autorizado. A Anthropic já bloqueou no passado alguns usos de assinaturas fora do Claude Code; verifique as regras atuais de cobrança da Anthropic antes de depender disso.A documentação do Claude Code da Anthropic descreve claude -p como uso programático/do Agent SDK. De acordo com a atualização de suporte da Anthropic de 15 de junho de 2026, o Claude Agent SDK, claude -p e o uso de aplicativos de terceiros consomem os limites de uso da assinatura com sessão iniciada (o plano de créditos separado para o Agent SDK, anunciado anteriormente, está suspenso). Consulte o artigo sobre o plano do Agent SDK, os artigos sobre os planos Pro/Max e Team/Enterprise, além do provedor Anthropic, para ver as observações do próprio OpenClaw sobre a cobrança da CLI do Claude.

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

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.

npm install -g claude-max-api-proxy

# Verifique se a CLI do Claude está autenticada
claude --version
claude auth login   # se ainda não estiver autenticada

Iniciar o servidor

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

Testar o proxy

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

Configurar o OpenClaw

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

{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

Os IDs de modelo abaixo pertencem ao catálogo do próprio proxy, não às referências de modelo Anthropic do OpenClaw. Cada ID corresponde a um alias de modelo da CLI do Claude Code (opus, sonnet, haiku), portanto o modelo subjacente muda sempre que a Anthropic atualiza esse alias na CLI. Consulte o README atual do proxy antes de depender de um mapeamento específico.

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

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.

Para integração nativa com a Anthropic usando a CLI do Claude ou chaves de API, consulte o provedor Anthropic. Para assinaturas OpenAI/Codex, consulte o provedor OpenAI.

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.

Overview

Concepts and configuration

Providers

Proxy de API do Claude Max

Por que usar isto

Como funciona

Primeiros passos

Configuração avançada

Observações

Relacionados

Provedor Anthropic

Provedor OpenAI

Seleção de modelo

Configuração

​Por que usar isto

​Como funciona

​Primeiros passos

​Configuração avançada

​Observações

​Relacionados

Provedor Anthropic

Provedor OpenAI

Seleção de modelo

Configuração

Por que usar isto

Como funciona

Primeiros passos

Configuração avançada

Observações

Relacionados