Pular para o conteúdo principal
claude-max-api-proxy é uma ferramenta da comunidade que expõe sua assinatura Claude Max/Pro como um endpoint de API compatível com OpenAI. Isso permite usar sua assinatura com qualquer ferramenta que ofereça suporte ao formato da API OpenAI.
Este caminho é apenas para compatibilidade técnica. A Anthropic já bloqueou no passado alguns usos de assinatura fora do Claude Code. Você deve decidir por conta própria se deseja usá-lo e verificar as regras atuais de cobrança da Anthropic antes de depender dele.A documentação de suporte atual da Anthropic diz que claude -p é uso programático/do Agent SDK. A atualização de suporte da Anthropic de 15 de junho de 2026 pausou o plano anunciado de créditos separados para o Agent SDK. Por enquanto, o Claude Agent SDK, claude -p e o uso em aplicativos de terceiros ainda consomem os limites de uso da assinatura conectada.Antes de depender deste caminho, consulte o artigo sobre o plano do Agent SDK da Anthropic, além dos artigos de suporte do Claude Code para contas Pro/Max ou Team/Enterprise.

​
Por que usar isso?

AbordagemRota de custoMelhor para
API AnthropicPague por token pelo Claude Console ou pela nuvemAplicativos de produção, automação compartilhada, volume
Proxy de assinatura ClaudeRegras de plano e créditos do Claude Code / claude -pExperimentos pessoais com ferramentas compatíveis
Se você tem uma assinatura Claude Max ou Pro e quer usá-la com ferramentas compatíveis com OpenAI, esse proxy pode atender a alguns fluxos de trabalho pessoais. Ele não é um caminho ilimitado de tarifa fixa. As chaves de API continuam sendo o caminho mais claro de política e cobrança para uso em produção.

​
Como funciona

Your App → claude-max-api-proxy → Claude Code CLI / claude -p → Anthropic
     (OpenAI format)              (converts format)          (uses your login)
O proxy:
  1. Aceita solicitações no formato OpenAI em http://localhost:3456/v1/chat/completions
  2. Converte-as em comandos do Claude Code CLI
  3. Retorna respostas no formato OpenAI (com suporte a streaming)

​
Primeiros passos

1

Instale o proxy

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

# Verify Claude CLI is authenticated
claude --version
2

Inicie o servidor

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

Teste o 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 o OpenClaw

Aponte o OpenClaw para o proxy como um endpoint personalizado compatível com OpenAI:
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

​
Catálogo integrado

ID do modeloMapeia para
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4

​
Configuração avançada

Este caminho usa a mesma rota no estilo de proxy compatível com OpenAI que outros backends /v1 personalizados:
  • A formatação de solicitação nativa somente para OpenAI não se aplica
  • Sem service_tier, sem Responses store, sem dicas de cache de prompt e sem formatação de payload de compatibilidade de raciocínio da OpenAI
  • Cabeçalhos ocultos de atribuição do OpenClaw (originator, version, User-Agent) não são injetados na URL do proxy
Crie um LaunchAgent para executar o proxy automaticamente:
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

  • Esta é uma ferramenta da comunidade, sem suporte oficial da Anthropic ou da OpenClaw
  • Requer uma assinatura Claude Max/Pro ativa com Claude Code CLI autenticado
  • Herda o comportamento de cobrança, créditos de uso e limites de taxa de claude -p do Claude Code
  • O proxy é executado localmente e não envia dados a servidores de terceiros
  • Respostas em streaming têm suporte completo
Para integração nativa com a Anthropic usando Claude CLI ou chaves de API, consulte provedor Anthropic. Para assinaturas OpenAI/Codex, consulte provedor OpenAI.

​
Relacionado

Provedor Anthropic

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

Provedor OpenAI

Para assinaturas OpenAI/Codex.

Seleção de modelo

Visão geral de todos os provedores, refs de modelo e comportamento de failover.

Configuração

Referência completa de configuração.