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
| Parte | Habla | Trabajo |
|---|---|---|
| CLI de Claude Code | Formato Anthropic Messages | Planea ediciones, llama a herramientas, muestra diffs |
| Proxy traductor (local) | Ambos formatos | Convierte peticiones y streams, mapea nombres de modelos |
| Esta API | Chat Completions de OpenAI | Ejecuta 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_choiceytool_callsen streaming, con resultados devueltos como mensajesrole: "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.
