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 un plugin de OpenClaw) que expone una suscripción Claude Max/Pro como un endpoint de API compatible con OpenAI, para que puedas dirigir cualquier herramienta compatible con OpenAI a tu suscripción en lugar de usar una clave de API de Anthropic.

Por qué usarlo

Enfoque Modalidad de coste 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 Claude Reglas del plan y los créditos de Claude Code / claude -p Experimentos personales con herramientas compatibles

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

Cómo funciona

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

El proxy inicia la CLI de Claude Code como un subproceso por cada solicitud, convierte las solicitudes de chat con formato OpenAI en instrucciones para la CLI y transmite (o devuelve) la respuesta en formato 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 # Verify Claude CLI is authenticatedclaude --versionclaude auth login   # if not already authenticated

  • Iniciar el servidor

    bash
    claude-max-api# Server runs at 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": "Hello!"}]  }'

  • Configurar OpenClaw

    Configura OpenClaw para que use el proxy como un endpoint personalizado compatible con OpenAI:

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • ID del modelo Alias de la CLI Asignación 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 el proxy compatible con OpenAI

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

    • No se aplica la adaptación de solicitudes exclusiva de OpenAI nativo.
    • /fast y service_tier solo se aplican al tráfico directo hacia api.anthropic.com; las rutas del proxy dejan service_tier intacto (consulta el modo rápido del proveedor de Anthropic).
    • No se incluye store de Responses, indicaciones de caché de instrucciones ni adaptación de cargas útiles para 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 el tráfico OAuth nativo hacia api.openai.com, no a destinos personalizados de 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 frecuencia de claude -p de Claude Code.
    • Solo se vincula 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 realmente una solicitud de chat; si la CLI no está autenticada, la primera solicitud fallará 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 de 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