OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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.

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

text
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.

    bash
    npm install -g claude-max-api-proxy # Verificar que la CLI de Claude esté autenticadaclaude --versionclaude auth login   # si aún no está autenticada

  • Iniciar el servidor

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

  • Probar el proxy

    bash
    curl http://localhost:3456/healthcurl 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:

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • 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
    bash
    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.

    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.
    Was this useful?
    On this page

    On this page