free-claude-code es un Anthropic-compatible proxy para usar con Claude Code.
La idea no es crackear Claude Code ni ofrecer un servicio Claude oficial gratuito, sino iniciar localmente un proxy compatible con la forma de la API de Anthropic y reenviar las solicitudes de Claude Code a otros backends de modelos. El README menciona backends como NVIDIA NIM, OpenRouter, DeepSeek, LM Studio, llama.cpp y Ollama.
En pocas palabras, resuelve este problema: te gusta la experiencia de Claude Code en la terminal, pero quieres conectar las peticiones del modelo a otro provider o a un modelo local.
Qué problema resuelve
La experiencia interactiva de Claude Code es muy adecuada para tareas de desarrollo.
Puede leer código en la terminal, modificar archivos, ejecutar comandos y avanzar según el contexto del proyecto. El problema es que muchos usuarios no necesariamente quieren usar siempre el mismo backend de modelo:
- Quieren probar distintos modelos en OpenRouter
- Quieren usar modelos como DeepSeek para reducir costes
- Quieren conectar las peticiones a Ollama local
- Quieren ejecutar modelos locales con LM Studio o llama.cpp
- Quieren unificar en el entorno de desarrollo una entrada de proxy
- Quieren comparar el rendimiento de distintos modelos dentro del flujo de Claude Code
El posicionamiento de free-claude-code es añadir una capa de proxy compatible entre Claude Code y estos servicios de modelos.
Así, Claude Code sigue enviando solicitudes con estilo Anthropic, y el proxy se encarga de adaptarlas a distintos backends.
Funcionamiento
Puede entenderse como tres capas:
- El frontend es Claude Code
- En medio está el proxy
free-claude-code - El backend es OpenRouter, DeepSeek, un modelo local u otro servicio de modelo
Claude Code cree que está accediendo a una API Anthropic-compatible.
El proxy recibe la solicitud, elige el provider objetivo según la configuración, transforma los campos necesarios y devuelve la respuesta a Claude Code.
La ventaja de esta estructura es que no necesitas modificar Claude Code ni exigir que cada servicio de modelo soporte Claude Code de forma nativa. Mientras el proxy pueda alinear la interfaz, puede conectar más modelos al mismo flujo de trabajo.
Backends soportados
Las direcciones listadas en el README incluyen:
- NVIDIA NIM
- OpenRouter
- DeepSeek
- LM Studio
- llama.cpp
- Ollama
Estos backends representan varias formas de uso.
OpenRouter se parece más a una entrada agregadora de modelos, útil para probar distintos modelos comerciales y open source.
DeepSeek conviene a quienes se preocupan por capacidad en chino, capacidad de código y coste.
LM Studio, llama.cpp y Ollama se inclinan hacia la ruta de modelos locales. Sirven para ejecutar modelos en tu propia máquina o en un entorno de intranet, reducir dependencia de APIs externas y facilitar experimentos offline.
NVIDIA NIM está más orientado a inferencia empresarial y despliegue con GPU.
Por qué un Anthropic-compatible proxy
Claude Code está diseñado alrededor de la interfaz y los hábitos de modelo de Anthropic.
Si quieres conectarlo a otros modelos, el problema más directo es que las interfaces no coinciden:
- Campos de solicitud distintos
- Nombres de modelo distintos
- Formatos de streaming distintos
- Expresión de tool use distinta
- Formatos de error distintos
- Límites de tokens y contexto distintos
El valor de la capa proxy está ahí.
Mantiene la interfaz vista por Claude Code con una forma cercana a Anthropic y adapta el backend. Para el usuario, después de configurar el proxy, puede probar distintos modelos dentro del mismo flujo de Claude Code.
Escenarios adecuados
free-claude-code es adecuado para:
- Querer usar el flujo de terminal de Claude Code
- Probar modelos no Anthropic dentro de Claude Code
- Reducir costes de llamadas de modelo
- Conectar Claude Code a OpenRouter
- Integrar DeepSeek u otros servicios de modelo compatibles
- Usar Ollama, LM Studio o llama.cpp para ejecutar modelos locales
- Configurar para un equipo una entrada unificada de proxy de modelos
Si solo usas Claude Code oficial normalmente y no tienes necesidades especiales de provider, coste o despliegue local, quizá no necesites este tipo de proxy.
Pero si comparas modelos con frecuencia o quieres que Claude Code acceda a modelos locales y de terceros, este tipo de herramienta es útil.
Diferencia frente a usar directamente OpenRouter u Ollama
Usar directamente OpenRouter, Ollama o LM Studio normalmente significa conversar con el modelo o llamarlo mediante API.
El punto central de free-claude-code no es sustituir esos servicios, sino conectarlos al flujo de desarrollo de Claude Code.
La diferencia está en:
- Sigues usando la experiencia de terminal de Claude Code
- La IA puede realizar tareas alrededor del repositorio de código
- El backend de modelo puede cambiarse por otro provider
- Los modelos locales también tienen oportunidad de entrar en el flujo de Claude Code
- La configuración se concentra en la capa proxy, no se cambia por separado en cada herramienta
Por eso se parece más a un puente que a un nuevo cliente de chat.
Precauciones con modelos locales
Conectar Claude Code a modelos locales es atractivo, pero también tiene límites prácticos.
Primero, diferencia de capacidad del modelo.
Las tareas de Claude Code no son solo chat; incluyen entender código, planificar cambios, editar archivos y procesar salidas de comandos. Un modelo local pequeño no necesariamente puede completar estas tareas de forma estable.
Segundo, ventana de contexto.
Las tareas de código consumen mucho contexto. Si la ventana del modelo es demasiado pequeña, puede no leer archivos completos, perder restricciones o olvidar contexto durante varias rondas.
Tercero, compatibilidad con tool use.
El flujo de Claude Code depende de llamadas a herramientas y comportamiento estructurado. Aunque un backend pueda chatear, no necesariamente sigue bien protocolos de tool calling.
Cuarto, velocidad y hardware.
La velocidad del modelo local depende de la máquina, el método de cuantización y el tamaño del modelo. Si una tarea de código responde demasiado lento, la experiencia se degrada de forma notable.
Por eso, los modelos locales son más adecuados para experimentos, tareas de bajo riesgo y escenarios concretos. Para tareas de código realmente complejas, todavía hay que elegir con cuidado según la capacidad del modelo.
Límites de uso
Este tipo de proyecto puede malinterpretarse fácilmente por el título, así que conviene aclarar los límites.
Primero, no es cuota gratuita oficial de Claude Code.
Solo reenvía las solicitudes de Claude Code a otros backends de modelos. Al usar OpenRouter, DeepSeek, NVIDIA NIM u otras APIs, sigues teniendo que cumplir precios, cuotas y condiciones de uso de esos servicios.
Segundo, no es una herramienta para saltarse autorización.
Al usar cualquier proxy, hay que cumplir las licencias y términos de Claude Code, del proveedor de modelo y del propio proyecto. No debería entenderse como una forma de evitar restricciones oficiales.
Tercero, el proxy procesará el contenido de tus solicitudes.
Código, salida de comandos y contexto del proyecto pueden pasar por el proxy y por el servicio backend. Al desplegarlo, hay que considerar logs, claves, red y límites de privacidad. Para código de empresa o proyectos sensibles, es mejor usar un entorno controlado.
Cuarto, el rendimiento de distintos modelos puede variar mucho.
La misma operación de Claude Code puede comportarse de forma completamente distinta al cambiar de modelo. No asumas que todos los modelos pueden sustituir a Claude.
Relación con proxies como LiteLLM
Desde el punto de vista de diseño, free-claude-code pertenece a la categoría de “proxies de interfaz compatible”.
El objetivo común de estas herramientas es reducir el acoplamiento entre la aplicación superior y los servicios de modelos inferiores. La aplicación superior solo se enfrenta a una interfaz relativamente unificada, y los providers de abajo pueden cambiarse por configuración.
Cada proyecto tiene un foco distinto. Algunos se orientan a gateway de modelos general, otros a OpenAI-compatible API, y otros se adaptan específicamente a herramientas como Claude Code.
Lo interesante de free-claude-code es que coloca el escenario objetivo directamente en Claude Code, no en un proxy de chat genérico.
Usuarios adecuados
Es más adecuado para usuarios con cierta capacidad de configuración:
- Conocen Claude Code
- Saben configurar API key y provider de modelos
- Entienden cómo arrancar un proxy y variables de entorno
- Pueden diagnosticar problemas de red, puertos, nombres de modelo y streaming
- Quieren comparar el rendimiento de distintos modelos en tareas de código
Si solo quieres algo listo para usar, la configuración oficial suele ser más tranquila.
Si estás dispuesto a montar proxy, cambiar modelos, ajustar parámetros y quieres llevar Claude Code a más entornos de modelo, este proyecto merece estudio.
Referencia
Una última frase
El valor de free-claude-code no está en la palabra “free”, sino en construir un puente entre Claude Code y más backends de modelos.
Cuando quieres conservar la experiencia de desarrollo de Claude Code y al mismo tiempo probar OpenRouter, DeepSeek, modelos locales o servicios de inferencia empresariales, este tipo de Anthropic-compatible proxy tiene sentido.