Saltar al contenido principal
claude-max-api-proxy es un paquete npm comunitario (no un plugin de OpenClaw) que expone una suscripción Claude Max/Pro como un endpoint de API compatible con OpenAI, para que puedas apuntar cualquier herramienta compatible con OpenAI a tu suscripción en lugar de una clave de API de Anthropic.
Solo compatibilidad técnica, no una ruta autorizada oficialmente. Anthropic ha bloqueado en el pasado algunos usos de suscripciones fuera de Claude Code; verifica las reglas de facturación actuales de Anthropic antes de depender de esto.La documentación de Claude Code de Anthropic describe claude -p como uso de Agent SDK/programático. A partir de la actualización de soporte de Anthropic del 15 de junio de 2026, Claude Agent SDK, claude -p y el uso en aplicaciones de terceros consumen los límites de uso de la suscripción con sesión iniciada (el plan separado de créditos para Agent SDK anunciado previamente está pausado). Consulta el artículo sobre el plan de Agent SDK de Anthropic, los artículos de planes Pro/Max y Team/Enterprise, y el proveedor de Anthropic para las notas propias de OpenClaw sobre facturación de Claude CLI.

Por qué usar esto

EnfoqueRuta de costeIdeal para
Clave de API de AnthropicPago por token mediante Claude ConsoleAplicaciones de producción, automatización compartida, volumen
Proxy de suscripción de ClaudeReglas de plan y crédito de Claude Code / claude -pExperimentos personales con herramientas compatibles
Este proxy permite que una suscripción Claude Max o Pro funcione con herramientas compatibles con OpenAI. No es una ruta ilimitada de tarifa plana: hereda los límites de uso de Claude Code. Las claves de API siguen siendo la ruta de facturación más clara para uso en producción.

Cómo funciona

Your App -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic
     (OpenAI format)                (converts format)              (uses your login)
El proxy inicia Claude Code CLI como subproceso por solicitud, convierte solicitudes de chat en formato OpenAI en prompts de CLI y transmite (o devuelve) la respuesta en formato OpenAI.

Primeros pasos

1

Instala el proxy

Requiere Node.js 20+ y una Claude Code CLI autenticada.
npm install -g claude-max-api-proxy

# Verify Claude CLI is authenticated
claude --version
claude auth login   # if not already authenticated
2

Inicia el servidor

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

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

Configura OpenClaw

Apunta OpenClaw al proxy como 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" },
    },
  },
}
Los IDs de modelo siguientes son el catálogo propio del proxy, no las referencias de modelos Anthropic de OpenClaw. Cada ID se asigna a un alias de modelo de Claude Code CLI (opus, sonnet, haiku), por lo que el modelo subyacente cambia cada vez que Anthropic actualiza ese alias en la CLI. Consulta el README actual del proxy antes de depender de una asignación específica.
ID de modeloAlias de CLIAsignación actual
claude-opus-4opusClaude Opus 4.5
claude-sonnet-4sonnetClaude Sonnet 4
claude-haiku-4haikuClaude Haiku 4

Configuración avanzada

Esto usa 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 el modelado de solicitudes nativo solo para OpenAI.
  • /fast y service_tier solo se aplican al tráfico directo de api.anthropic.com; las rutas de proxy dejan service_tier sin cambios (consulta modo rápido del proveedor de Anthropic).
  • Sin store de Responses, sugerencias de caché de prompts ni modelado de payload compatible con razonamiento de OpenAI.
  • Los encabezados de atribución OpenAI/Codex de OpenClaw (originator, version, User-Agent) solo se envían en tráfico OAuth nativo de api.openai.com, no en destinos personalizados de OPENAI_BASE_URL como este proxy.
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 frecuencia de claude -p de Claude Code.
  • Se vincula solo a 127.0.0.1; no envía datos a ningún servidor de terceros más allá de la propia llamada de la CLI a Anthropic.
  • Se admiten respuestas en streaming.
  • Los fallos de autenticación no se comprueban al iniciar y solo aparecen cuando una solicitud de chat se ejecuta realmente; si la CLI no está autenticada, espera que falle la primera solicitud, no que el servidor se niegue a iniciar.
Para la integración nativa de Anthropic con Claude CLI o claves de API, consulta proveedor de Anthropic. Para suscripciones OpenAI/Codex, consulta proveedor de OpenAI.

Relacionado

Proveedor de Anthropic

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

Proveedor de OpenAI

Para suscripciones OpenAI/Codex.

Selección de modelo

Resumen de todos los proveedores, referencias de modelo y comportamiento de conmutación por error.

Configuración

Referencia completa de configuración.