ES ▾

InicioGuía

Proxy de Claude Code: usa una API de LLM compatible con OpenAI

Un proxy de Claude Code es un servidor pequeño que se sitúa entre la CLI y la API del modelo y traduce las peticiones. Necesitas uno porque Claude Code habla el formato Anthropic y esta API habla el formato OpenAI.

Una caja traductora entre un terminal y un servidor, mostrando un proxy que convierte peticiones entre dos formatos de API

Puntos clave

  1. Claude Code envía peticiones estilo Anthropic; esta API acepta peticiones estilo OpenAI
  2. Un proxy traductor como LiteLLM se sitúa en el medio y mapea los nombres de los modelos
  3. El modelo detrás es un modelo de pesos abiertos, no Claude, así que pruébalo en tus propias tareas
  4. Una sesión de codificación de 30 peticiones con 20.000 tokens de entrada y 800 de salida cada una cuesta unos $0,10

Qué hace el proxy

Un proxy de claude code es cualquier servidor que ejecutes entre la CLI de codificación de Anthropic y el modelo que responde. Claude Code lee una variable de entorno para la dirección de la API y envía sus peticiones allí. Si esa dirección es un proxy, el proxy decide lo que realmente sucede: puede registrar el tráfico, agregar reglas o reenviar la llamada a un modelo diferente.

El detalle clave es el formato de transmisión. Claude Code usa el formato Messages de Anthropic. La API en https://api.claudecodeproxyapi.com/v1 usa el formato OpenAI Chat Completions, con el ID de modelo uncensored. Son cercanos en espíritu pero no intercambiables, por lo que no puedes pegar nuestra URL directamente en Claude Code. Se necesita una capa de traducción para reescribir cada petición y cada respuesta, incluidos los fragmentos de streaming y las llamadas a funciones.

Qué se sitúa dónde

ParteHablaTrabajo
CLI de Claude CodeFormato Anthropic MessagesPlanea ediciones, llama a herramientas, muestra diffs
Proxy traductor (local)Ambos formatosConvierte peticiones y streams, mapea nombres de modelos
Esta APIChat Completions de OpenAIEjecuta el modelo de pesos abiertos, factura por token

Los proyectos de la comunidad gestionan la parte intermedia. El proxy de LiteLLM y claude-code-router son dos ejemplos documentados públicamente para este fin. Al ser software de terceros, revisa su documentación actual para ver las versiones compatibles y los flags antes de construir sobre ellos. Si algo falla en el camino, la guía de solución de problemas del proxy es el lugar para empezar, y este sitio también tiene un artículo de configuración paso a paso.

Antes de configurarlo: sé honesto sobre el modelo

Claude Code se construyó en torno a los propios modelos de Anthropic. Cambiar por un modelo diferente altera el comportamiento, y ningún proxy puede ocultarlo. El modelo aquí es un modelo de pesos abiertos gestionado por un proveedor independiente y afinado para responder sin rechazos de contenido para uso adulto lícito. No es Claude, y no es una API oficial de Anthropic ni de ningún otro proveedor.

Lo que sí te da para trabajo estilo agente:

  • Llamadas a herramientas con tools, tool_choice y tool_calls en streaming, con resultados devueltos como mensajes role: "tool".
  • Una ventana de contexto de 100.000 tokens, prompt y completado juntos.
  • Modo JSON con response_format, y streaming sobre SSE.

Lo que debes verificar tú mismo: qué tan bien sigue un bucle de agente largo, con qué frecuencia genera llamadas a funciones malformadas y cómo maneja tu lenguaje y framework. Ejecuta tres o cuatro tareas reales de tu repositorio antes de migrar todo un flujo de trabajo. El crédito de prueba de $0,50, obtenido con un clic después de iniciar sesión, es suficiente para eso.

Prueba primero el upstream

Antes de tocar Claude Code, confirma que el lado de la API funciona con una petición simple, incluyendo una llamada a herramienta, ya que los agentes dependen de ello:

curl https://api.claudecodeproxyapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the files in the src folder."}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "list_files",
        "description": "List files in a directory",
        "parameters": {
          "type": "object",
          "properties": {"path": {"type": "string"}},
          "required": ["path"]
        }
      }
    }],
    "tool_choice": "auto"
  }'

Una buena respuesta contiene una entrada tool_calls con list_files y una cadena de argumentos JSON. Si ves eso, el upstream está listo y cualquier problema posterior pertenece a la configuración del proxy o la CLI.

Dos rutas, y cuándo elegir cada una

Ruta 1: un proxy traductor para Claude Code

Elige esto si te gusta la interfaz de Claude Code, sus solicitudes de permisos y su flujo de trabajo, y quieres un modelo diferente detrás. Ejecutas el proxy localmente, apuntas la CLI hacia él y mapeas los nombres de modelo que envía la CLI a uncensored. Las variables exactas se cubren en la documentación y el artículo de configuración.

Ruta 2: un cliente que ya habla OpenAI

Varios asistentes de programación de código abierto y extensiones de editor, como Aider, Continue y Cline, pueden usar cualquier endpoint compatible con OpenAI directamente. Ingresas la URL base, la clave y el nombre del modelo, y no hay una capa de traducción que mantener. Si no necesitas específicamente la interfaz de Claude Code, esta es la ruta más corta y tiene menos partes que puedan fallar.

Una regla general: elige la ruta 2 para una prueba rápida del modelo en código, y la ruta 1 cuando tu equipo ya dependa del flujo de trabajo de Claude Code.

Coste de una sesión de codificación

Los agentes reenvían mucho contexto, por lo que los tokens de entrada dominan la factura. Toma una sesión de 30 peticiones, cada una con 20.000 tokens de entrada (archivos, historial, salida de herramientas) y 800 tokens de salida:

  • Entrada: 30 x 20.000 = 600.000 tokens, que es 0,6 x $0,15 = $0,09
  • Salida: 30 x 800 = 24.000 tokens, que es 0,024 x $0,50 = $0,012
  • Total: $0,102

Los precios son $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. La facturación se realiza con crédito prepago sin suscripción; las peticiones fallidas o rechazadas no se cobran, y el crédito no caduca. Las recargas van de $20 a $500 con bonificaciones de +5% desde $50, +10% desde $100 y +15% desde $200. Este sitio acepta recargas por cripto (USDT en TRC20, USDC en Base). La página de precios tiene la tabla completa, y la página de claves es donde te registras con Google o correo electrónico.

Límites que afectan los bucles de agente

Una clave completa permite 8 peticiones concurrentes y 300 peticiones por minuto. La clave de prueba permite 2 concurrentes y 60 por minuto. Los agentes que distribuyen subtareas pueden alcanzar el límite de concurrencia primero. La API luego responde HTTP 429 con el código concurrency, mientras que el límite de tasa de peticiones devuelve rate_limited. Una sobrecarga temporal también devuelve 429, con Retry-After: 5. Un buen proxy reintenta en 429 después del retraso, y una petición en streaming mantiene su espacio hasta que termine el flujo, por lo que los flujos atascados cuentan contra ti.

El cuerpo de la petición puede tener hasta 8 MB. Tenlo en cuenta si tu herramienta pega archivos grandes en prompts, y mantén todo el prompt bajo la ventana de 100.000 tokens.

Notas de seguridad para un proxy local

Un proxy retiene tu clave upstream, así que trátala como cualquier credencial. Vincúlala a localhost, no a todas las interfaces de red, a menos que realmente necesites que otras máquinas accedan a ella. Almacena la clave en una variable de entorno o en un gestor de secretos en lugar de en un archivo que vaya al control de versiones. Si compartes un proxy entre un equipo, dale su propia clave maestra para que puedas rotarla sin tocar la clave upstream.

También recuerda qué envía un agente. Una CLI de programación envía el contenido de los archivos, la salida de los comandos y tus prompts al modelo. Los prompts no se usan para entrenamiento aquí, pero aún así debes mantener fuera del directorio de trabajo que el agente pueda leer secretos como las claves privadas y los archivos .env.

Una forma justa de evaluar el modelo en tu código

Elige tres tareas de dificultad creciente de un repositorio real: una corrección en un solo archivo, un cambio que toque tres archivos y una pequeña refactorización con pruebas. Ejecuta cada una con el mismo prompt dos veces, una vez con tu modelo actual y otra con uncensored, y toma notas sobre cuatro cosas: si los cambios se aplicaron correctamente, si las llamadas a funciones se analizaron, cuántos reintentos fueron necesarios y cuánto costó cada ejecución. Una hora de esto te dice más que cualquier tabla de clasificación.

Si el modelo de pesos abiertos no alcanza el nivel en la tarea más difícil, aún puedes encontrar que es adecuado para tareas de menor coste como redactar pruebas, escribir mensajes de commit o explicar código desconocido. Dado que la facturación es de pago por uso desde crédito prepago sin suscripción, no hay penalización por usarlo solo para esos trabajos.

Preguntas y respuestas

¿Puede Claude Code usar esta API sin un proxy?

No. Claude Code envía solicitudes en formato Anthropic y esta API acepta solicitudes en formato OpenAI, por lo que se necesita una capa de traducción entre ellas.

¿El modelo se comportará como Claude?

No. Es un modelo de pesos abiertos de un proveedor independiente. Pruébalo en tus propias tareas antes de confiar en él.

¿La API admite llamadas a funciones?

Sí. Admite herramientas, tool_choice y tool_calls en streaming, y devuelves los resultados como mensajes con role tool.

¿Hay una opción más fácil que un proxy?

Sí. Los asistentes de programación que aceptan un endpoint compatible con OpenAI, como Aider, Continue o Cline, pueden conectarse directamente a la URL base.

¿Cuánto cuesta probarlo?

Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic tras registrarse. Es válido por 7 días y no requiere tarjeta.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.