Proxy de la API de Claude Max

claude-max-api-proxy es un paquete npm de la comunidad (no es un plugin de OpenClaw) que expone una suscripción a Claude Max/Pro como un endpoint de API compatible con OpenAI, para que se pueda conectar cualquier herramienta compatible con OpenAI a la suscripción en lugar de usar una clave de API de Anthropic.

Solo ofrece compatibilidad técnica; no es una vía autorizada oficialmente. Anthropic ha bloqueado anteriormente algunos usos de suscripciones fuera de Claude Code; se deben verificar las reglas de facturación actuales de Anthropic antes de depender de esta opción.La documentación de Claude Code de Anthropic describe claude -p como uso del Agent SDK/programático. Según la actualización de soporte de Anthropic del 15 de junio de 2026, Claude Agent SDK, claude -p y el uso de aplicaciones de terceros consumen los límites de uso de la suscripción con la que se inició sesión (el plan de créditos independiente para Agent SDK anunciado anteriormente está en pausa). Consulte el artículo sobre el plan de Agent SDK de Anthropic, los artículos sobre los planes Pro/Max y Team/Enterprise, y el proveedor de Anthropic para consultar las notas de facturación propias de OpenClaw sobre la CLI de Claude.

Por qué usarlo

Enfoque	Vía de facturación	Opción ideal para
Clave de API de Anthropic	Pago por token mediante Claude Console	Aplicaciones de producción, automatización compartida, volumen
Proxy de suscripción a Claude	Plan y reglas de créditos de Claude Code / `claude -p`	Experimentos personales con herramientas compatibles

Este proxy permite usar una suscripción a Claude Max o Pro con herramientas compatibles con OpenAI. No es una vía ilimitada con tarifa plana: hereda los límites de uso de Claude Code. Las claves de API siguen siendo la vía de facturación más clara para el uso en producción.

Cómo funciona

Su aplicación -> claude-max-api-proxy -> CLI de Claude Code / claude -p -> Anthropic
     (formato de OpenAI)                (convierte el formato)              (usa su inicio de sesión)

El proxy inicia la CLI de Claude Code como un subproceso para cada solicitud, convierte las solicitudes de chat con formato de OpenAI en instrucciones para la CLI y transmite (o devuelve) la respuesta en formato de OpenAI.

Primeros pasos

Instalar el proxy

Requiere Node.js 20+ y una CLI de Claude Code autenticada.

npm install -g claude-max-api-proxy

# Verificar que la CLI de Claude esté autenticada
claude --version
claude auth login   # si aún no está autenticada

Iniciar el servidor

claude-max-api
# El servidor se ejecuta en http://localhost:3456

Probar el 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": "¡Hola!"}]
  }'

Configurar OpenClaw

Configure el proxy como un endpoint personalizado compatible con OpenAI para OpenClaw:

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

Los identificadores de modelo que aparecen a continuación pertenecen al catálogo del proxy, no son referencias de modelos de Anthropic de OpenClaw. Cada identificador corresponde a un alias de modelo de la CLI de Claude Code (opus, sonnet, haiku), por lo que el modelo subyacente cambia cada vez que Anthropic actualiza ese alias en la CLI. Consulte el README actual del proxy antes de depender de una correspondencia específica.

Identificador de modelo	Alias de la CLI	Correspondencia actual
`claude-opus-4`	`opus`	Claude Opus 4.5
`claude-sonnet-4`	`sonnet`	Claude Sonnet 4
`claude-haiku-4`	`haiku`	Claude Haiku 4

Configuración avanzada

Notas sobre la compatibilidad con OpenAI mediante el proxy

Esto utiliza la ruta genérica personalizada /v1 compatible con OpenAI de OpenClaw, la misma ruta que cualquier otro backend compatible con OpenAI autoalojado:

No se aplica la adaptación de solicitudes exclusiva de OpenAI nativo.
/fast y service_tier solo se aplican al tráfico directo de api.anthropic.com; las rutas del proxy no modifican service_tier (consulte el modo rápido del proveedor de Anthropic).
No se aplican store de Responses, indicaciones de caché de instrucciones ni adaptación de cargas útiles de compatibilidad con el razonamiento de OpenAI.
Los encabezados de atribución de OpenAI/Codex de OpenClaw (originator, version, User-Agent) solo se envían en tráfico OAuth nativo de api.openai.com, no a destinos personalizados OPENAI_BASE_URL como este proxy.

Inicio automático en macOS con 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

Notas

Hereda el comportamiento de facturación, créditos de uso y límites de velocidad de claude -p de Claude Code.
Se vincula únicamente a 127.0.0.1; no envía datos a ningún servidor de terceros aparte de la propia llamada de la CLI a Anthropic.
Se admiten respuestas en streaming.
Los errores de autenticación no se comprueban al iniciar y solo aparecen cuando se ejecuta una solicitud de chat; si la CLI no está autenticada, cabe esperar que falle la primera solicitud en lugar de que el servidor se niegue a iniciarse.

Para la integración nativa con Anthropic mediante la CLI de Claude o claves de API, consulte el proveedor de Anthropic. Para las suscripciones a OpenAI/Codex, consulte el proveedor de OpenAI.

Contenido relacionado

Proveedor de Anthropic

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

Proveedor de OpenAI

Para suscripciones a OpenAI/Codex.

Selección de modelos

Descripción general de todos los proveedores, las referencias de modelos y el comportamiento de conmutación por error.

Configuración

Referencia completa de configuración.

Overview

Concepts and configuration

Providers

Proxy de la API de Claude Max

Por qué usarlo

Cómo funciona

Primeros pasos

Configuración avanzada

Notas

Contenido relacionado

Proveedor de Anthropic

Proveedor de OpenAI

Selección de modelos

Configuración

​Por qué usarlo

​Cómo funciona

​Primeros pasos

​Configuración avanzada

​Notas

​Contenido relacionado

Proveedor de Anthropic

Proveedor de OpenAI

Selección de modelos

Configuración

Por qué usarlo

Cómo funciona

Primeros pasos

Configuración avanzada

Notas

Contenido relacionado