Configura claude-max-api-proxy para tu suscripción

Seguro que te ha pasado: quieres usar los modelos más potentes en tus herramientas de desarrollo, pero los costes de la API por token suben demasiado rápido. Es frustrante pagar una suscripción mensual y no poder usarla directamente con tus aplicaciones favoritas que solo aceptan el formato de OpenAI.

Si tienes una suscripción de Claude Max y quieres integrarla en tu flujo de trabajo sin pagar extras, esta herramienta es la mejor opción. Te permite ahorrar dinero usando tu tarifa plana de 200 USD al mes en lugar de pagar por cada millón de tokens.

Requisitos previos

Para empezar a usar este proxy, necesitas cumplir con estos requisitos:

1. Node.js 20 o superior instalado en tu sistema.
2. Claude Code CLI instalado.
3. Una suscripción activa a Claude Max o Pro.
4. El CLI de Claude autenticado (puedes verificarlo con claude --version).

Inicio rápido

Configura el proxy en menos de 5 minutos siguiendo estos pasos:

1. Instalación

Instala el paquete de forma global usando npm:

npm install -g claude-max-api-proxy

2. Iniciar el servidor

Ejecuta el comando para activar el endpoint local:

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

3. Pruebas de conexión

Verifica que el proxy responde correctamente con un health check o listando los modelos:

# Verificar estado
curl http://localhost:3456/health

# Listar modelos disponibles
curl http://localhost:3456/v1/models

4. Ejemplo de chat

Puedes enviar una petición de prueba usando el formato estándar de OpenAI:

curl http://localhost:3456/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role": "user", "content": "¡Hola!"}]
  }'

Modelos disponibles

El proxy mapea las peticiones a estos modelos específicos:

1. claude-opus-4: Mapea a Claude Opus 4.
2. claude-sonnet-4: Mapea a Claude Sonnet 4.
3. claude-haiku-4: Mapea a Claude Haiku 4.
4. Soporte de streaming: Todas las respuestas admiten streaming completo.

Configuración con OpenClaw

Si usas OpenClaw, apunta al proxy como un endpoint personalizado en tu configuración:

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

Auto-inicio en macOS

Si quieres que el proxy arranque automáticamente, crea un archivo 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

Solución de problemas

Si encuentras problemas, revisa estos puntos basados en la documentación:

• Error de autenticación: Asegúrate de que Claude CLI está autenticado correctamente ejecutando claude --version. El proxy depende de tu sesión activa en el CLI.
• Versión de Node.js: Si el servidor no arranca, confirma que estás usando Node.js 20 o superior.

AI Setup Assistant

Próximos pasos

• Anthropic provider
• OpenAI provider