Saltar al contenido principal

​
Claude Max API Proxy

claude-max-api-proxy es una herramienta comunitaria que expone tu suscripción a Claude Max/Pro como un endpoint de API compatible con OpenAI. Esto te permite usar tu suscripción con cualquier herramienta que admita el formato de API de OpenAI.
Esta ruta es solo de compatibilidad técnica. Anthropic ha bloqueado en el pasado algunos usos de suscripciones fuera de Claude Code. Debes decidir por tu cuenta si quieres usarla y verificar los términos actuales de Anthropic antes de depender de ella.

​
¿Por qué usar esto?

EnfoqueCostoIdeal para
API de AnthropicPago por token (~15/Mdeentrada,15/M de entrada, 75/M de salida para Opus)Apps de producción, alto volumen
Suscripción Claude Max$200/mes fijosUso personal, desarrollo, uso ilimitado
Si tienes una suscripción Claude Max y quieres usarla con herramientas compatibles con OpenAI, este proxy puede reducir el costo en algunos flujos de trabajo. Las claves de API siguen siendo la vía de política más clara para uso en producción.

​
Cómo funciona

Tu app → claude-max-api-proxy → Claude Code CLI → Anthropic (mediante suscripción)
   (formato OpenAI)            (convierte el formato)    (usa tu inicio de sesión)
El proxy:
  1. Acepta solicitudes en formato OpenAI en http://localhost:3456/v1/chat/completions
  2. Las convierte en comandos de Claude Code CLI
  3. Devuelve respuestas en formato OpenAI (con streaming compatible)

​
Primeros pasos

1

Install the proxy

Requiere Node.js 20+ y 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

Apunta OpenClaw al proxy como un endpoint personalizado compatible con OpenAI:
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

​
Modelos disponibles

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

​
Avanzado

Esta ruta usa la misma vía de proxy compatible con OpenAI que otros backends personalizados de /v1:
  • No se aplica la conformación nativa de solicitudes solo para OpenAI
  • No hay service_tier, no hay store de Responses, no hay pistas de caché de prompt ni conformación de payload compatible con reasoning de OpenAI
  • Los encabezados ocultos de atribución de OpenClaw (originator, version, User-Agent) no se inyectan en la URL del proxy
Crea un LaunchAgent para ejecutar el proxy automáticamente:
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

​
Enlaces

​
Notas

  • Esta es una herramienta comunitaria, sin soporte oficial de Anthropic ni de OpenClaw
  • Requiere una suscripción activa a Claude Max/Pro con Claude Code CLI autenticado
  • El proxy se ejecuta localmente y no envía datos a servidores de terceros
  • Las respuestas con streaming son totalmente compatibles
Para la integración nativa de Anthropic con Claude CLI o claves de API, consulta Anthropic provider. Para suscripciones de OpenAI/Codex, consulta OpenAI provider.

​
Relacionado

Anthropic provider

Integración nativa de OpenClaw con Claude CLI o claves de API.

OpenAI provider

Para suscripciones de OpenAI/Codex.

Model providers

Resumen de todos los proveedores, refs de modelos y comportamiento de failover.

Configuration

Referencia completa de configuración.