Free Claude Code: una pasarela local para agentes de programación y proveedores propios

Todo lo que hay que saber sobre Alishahryar1/free-claude-code: un proxy local que conecta Claude Code, Codex y Pi con modelos en la nube o locales elegidos por quien lo instala.

Qué es Free Claude Code

Free Claude Code (FCC) es un proxy local, distribuido con licencia MIT, para usar clientes de agentes de programación sin cambiar su interfaz habitual. Según su README y su documento de arquitectura, recibe tráfico Anthropic Messages de Claude Code y Pi, y tráfico OpenAI Responses de Codex; lo convierte y enruta hacia el proveedor configurado.

No proporciona por sí mismo un modelo ni garantiza que un proveedor sea gratis: el nombre refleja que permite seleccionar proveedores con planes gratuitos, de pago o locales. La decisión de coste, credenciales y modelo sigue siendo del usuario. El README declara 31 proveedores configurables desde una interfaz de administración local y compatibilidad con flujo continuo, herramientas, razonamiento e imágenes cuando el proveedor elegido lo admite.

Interfaz local de Free Claude Code mostrando un menú desplegable con 31 proveedores de IA configurables, con iconos de integración de VS Code y JetBrains de fondo.

El origen: del experimento con NVIDIA NIM a una pasarela multiproveedor

El repositorio actual fue creado el 28 de enero de 2026 por Alishahryar1, cuya cuenta se identifica como Ali Khokhar y describe su actividad como escritura de código comprensible. No se recuperó una publicación externa que documente el lanzamiento exacto del repositorio actual.

Sí se recuperó un anuncio del mismo autor en Hacker News, el 6 de febrero de 2026: hilo 46917761, enlazado a otro repositorio suyo, Alishahryar1/claude-code-free. Khokhar contó que empezó una implementación con Claude Code y, después de hacerla funcionar, la utilizó para desarrollar el propio proyecto. Allí describió un middleware entre Claude Code y NVIDIA NIM, Telegram para tareas remotas, conservación de razonamiento entre llamadas de herramientas, limitación de tasa y concurrencia. El envío tuvo 3 puntos y 0 comentarios, por lo que acredita el relato del autor, no recepción independiente ni la identidad técnica exacta entre aquel repositorio y el actual.

La tensión que intenta resolver es práctica: conservar los clientes y extensiones de Claude Code, Codex o Pi mientras se sustituye el proveedor ascendente por una credencial propia, un servicio compatible o un servidor local.

Filosofía y principios

Control local de la ruta del modelo: la interfaz de administración se ejecuta localmente y permite validar un proveedor antes de aplicarlo.
No casarse con un único cliente: los lanzadores fcc-claude, fcc-codex y fcc-pi apuntan sus clientes a la misma pasarela.
Conservar contratos de protocolo: la arquitectura distingue Messages de Anthropic y Responses de OpenAI para que el cliente continúe usando su protocolo esperado.

Visualización abstracta de dos flujos de datos —hexágonos azul neón de Anthropic Messages y esferas naranjas de OpenAI Responses— fusionándose en un prisma central que emite un único haz de luz.

Configurar por capacidad, no por marca: el README documenta selección de modelos, rutas por nivel de Claude, controles de razonamiento y proveedores locales separados.
Separación entre aplicación y proveedor: el documento de arquitectura sitúa el enrutamiento, los ejecutores y los adaptadores de proveedor en límites distintos, con una interfaz HTTP, lanzadores y, opcionalmente, un puente de mensajería.

Cómo funciona

El servidor fcc-server expone una API FastAPI con rutas compatibles, salud, listado de modelos, parada y administración. Los clientes Claude Code, Codex y Pi se configuran contra http://127.0.0.1:8082 por medio de los lanzadores; la interfaz local permite guardar el proveedor, elegir un identificador de modelo y validar la configuración.

Estación de trabajo en penumbra iluminada por varias ventanas de terminal que muestran una interfaz de administración local en verde y cian neón, con código Python, endpoints de API y un botón "Validate Provider".

La arquitectura recuperada describe tres superficies: proxy HTTP, lanzadores de línea de comandos y un puente opcional de Discord o Telegram. Este último inicia sesiones gestionadas del cliente y ofrece comandos de mensajería como /stats, /stop y /clear.

Tres terminales holográficas de lanzamiento (fcc-claude, fcc-codex, fcc-pi) emitiendo haces de datos que convergen en una torre de servidor central en un centro de mando cyberpunk.

El README lista proveedores de nube —entre otros NVIDIA NIM, OpenAI, OpenRouter, Google AI Studio, DeepSeek, Mistral, OpenCode, Vercel AI Gateway, Bedrock, Hugging Face, Groq y Cloudflare— y tres rutas locales: LM Studio, llama.cpp y Ollama. La lista es de integraciones declaradas por FCC; no implica respaldo de todas esas empresas.

Vista aérea de una ciudad cyberpunk nocturna donde iconos holográficos gigantes de proveedores de IA en la nube y locales están interconectados por una red de cables de fibra óptica en cian y magenta.

Estado oficial y semioficial

No se recuperó evidencia de que FCC esté aceptado en un mercado oficial de Anthropic, OpenAI, Pi, VS Code o JetBrains, ni de una certificación o patrocinio de esos proveedores. Por tanto, su estado es comunitario e independiente.

En la práctica integra clientes oficiales y extensiones mediante configuración local: el README documenta la extensión de Claude Code para VS Code, la extensión de Codex para VS Code y Claude ACP para JetBrains. Eso significa compatibilidad configurada por el proyecto, no aprobación del proveedor de cada cliente.

El ecosistema

Repositorios del autor

La API de GitHub devolvió siete repositorios públicos de Alishahryar1. Además de FCC, aparecen bifurcaciones o proyectos llamados llama.cpp, opencode y vllm, y los repositorios avazu-ctr, gpu-ops-platform y Machine-Learning-Methods-in-Physics. No se recuperó documentación que establezca que sean componentes, dependencias o productos hermanos de FCC; por ello no deben interpretarse como su ecosistema oficial.

Bifurcaciones, puertos y extensiones verificadas

Núcleo central de neón etiquetado "FCC" ramificándose en varios caminos de luz independientes que representan bifurcaciones y extensiones de la comunidad.

sepehrbayat/SEPCC (36 estrellas) se presenta explícitamente como una bifurcación de Free Claude Code que añade persistencia de contexto entre reinicios y enrutamiento para más de 17 proveedores.
simplesunny/free-claude-code (28 estrellas) es una bifurcación visible con la descripción de uso desde terminal, VS Code o Discord.
rishiskhare/free-claude-code (20 estrellas) es una bifurcación orientada a NVIDIA NIM, terminal y Telegram; diyism/cc-nim (19 estrellas) publica la misma orientación de NIM/Telegram.
La búsqueda de GitHub también devolvió Abdl-Dev/-Free-Claude-Code-Ultimate-Beginner-Setup-Troubleshooting-Guide (3 estrellas), una guía de instalación y diagnóstico para FCC. Es material comunitario, no documentación oficial.

La consulta de las 30 bifurcaciones con más estrellas no devolvió una traducción no inglesa claramente documentada como tal. Por tanto, no se afirma la existencia de una traducción oficial o comunitaria concreta. Las cifras de esta sección son la medición de la búsqueda/API de GitHub del 6 de agosto de 2026.

Proyectos relacionados y comparación de categoría

router-for-me/CLIProxyAPI (46.294 estrellas) se describe como un servicio compatible con APIs OpenAI, Gemini, Claude y Codex, que envuelve varios clientes. Coincide con FCC en el papel de proxy multiprotocolo; sus implementaciones son distintas (Go frente a Python como lenguaje principal de FCC según GitHub).
diegosouzapw/OmniRoute (40.935 estrellas) se presenta como pasarela MIT con más de 290 proveedores y clientes de código. Coincide en el enrutamiento de modelos; la descripción de la búsqueda atribuye a OmniRoute rutas de reserva y otras integraciones que no se deben trasladar automáticamente a FCC.
decolua/9router (24.763 estrellas) anuncia una conexión de varios agentes a más de 40 proveedores con rutas de reserva. Es una comparación de pasarelas, no una prueba de equivalencia funcional.
siteboon/claudecodeui (13.122 estrellas) se presenta como interfaz web/gráfica para sesiones remotas de Claude Code, OpenCode, Cursor CLI y Codex. Es complementaria: FCC enruta peticiones; esta propuesta se centra en gestionar sesiones y proyectos a distancia.

Números del repo

Medición: 6 de agosto de 2026, API de GitHub.

Métrica	Valor
Estrellas	44.535
Bifurcaciones	7.347
Suscriptores reales	301
Commits	873
Incidencias abiertas indicadas por la API	345
Lenguaje principal	Python
Licencia	MIT
Creación	28 de enero de 2026
Metadatos actualizados por GitHub	6 de agosto de 2026
Última versión recuperada	No hay publicaciones de GitHub recuperadas

El total de 873 commits procede de la última página indicada por el enlace de paginación de la API de commits. Los principales contribuidores que devolvió la API fueron Alishahryar1 (740 contribuciones), cursoragent (53), dependabot[bot] (24), rishiskhare (7) y claude (6). open_issues_count puede incluir solicitudes de cambios abiertas; no equivale necesariamente a incidencias exclusivamente. La API repite el número de estrellas en watchers_count, por lo que se informa subscribers_count como suscriptores reales.

La fecha de actualización de metadatos y actividad de la API coincide con la fecha de esta medición; no se interpreta como una proyección futura.

Cómo contribuir

El repositorio tiene guía de contribución. Pide abrir una incidencia antes de proponer cambios de README, no enviar solicitudes de integración con Docker y, para errores, adjuntar mapeos de modelo, modelo activo, error completo y pasos reproducibles.

Para desarrollo exige uv y Python 3.14, y documenta este arranque:

git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
uv python install 3.14.0
uv run fcc-server

Escritorio de desarrollador en penumbra con teclado mecánico retroiluminado en cian, un monitor ejecutando uv run fcc-server y una página de GitHub con el contador de estrellas subiendo.

Antes de una solicitud de cambios se ejecuta ./scripts/ci.sh en macOS/Linux o ./scripts/ci.ps1 en Windows. El proceso incluye formato y comprobación con Ruff, tipos con ty y pruebas con Pytest. Los cambios de código, dependencias, empaquetado o instalación exigen actualizar la versión semántica de pyproject.toml y uv.lock en el mismo cambio.

Cómo lo recibió la comunidad

La evidencia externa recuperada es limitada, pero hay señales concretas de utilidad y objeciones:

En HN 48004559, sobre usar modelos más baratos con Claude, ashish0112 escribió que FCC puede delegar las llamadas de modelo y conservar la orquestación de Claude. La búsqueda de Algolia lo situó como comentario dentro de un hilo con puntuación y total de comentarios no recuperados en la consulta de historia; se verifica el texto del comentario mediante el elemento raíz, pero no se inventan cifras para el hilo.
El anuncio propio del autor, HN 46917761, obtuvo 3 puntos y 0 comentarios. Sirve como fuente primaria de la intención y de las primeras capacidades, no como reseña independiente.
En la discusión 222, ruslaniv cuestionó el caso de uso frente a OpenCode y preguntó qué ventaja aportaba FCC. La pregunta tuvo 3 comentarios: es una crítica concreta a la diferenciación, no una conclusión técnica demostrada.
La incidencia #342 recoge que debarpon2610 sufría errores del proveedor tras 15–20 minutos en más del 75 % de sus casos; tenía 32 comentarios al recuperarla. En #319, neno-research informó de tiempos de espera de NVIDIA y de que retomar manualmente permitía continuar; acumulaba 23 comentarios. Son experiencias de usuarios y no una medición de fiabilidad general.

Se intentaron búsquedas en Reddit, X, Product Hunt, blogs y boletines mediante búsqueda web directa; el servicio de búsqueda devolvió respuestas sin resultados recuperables. No se hallaron una página de Product Hunt, un lanzamiento de X verificable, una reseña de Dev.to/Hashnode o un pódcast/newsletter atribuible al repositorio. Tampoco se recuperó una página oficial independiente: GitHub y los documentos del repositorio son la documentación oficial disponible en esta investigación.

Guía rápida de uso

Instalación y primer arranque

El README exige usar el instalador del proyecto. En macOS o Linux:

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh
fcc-server

En Windows se usa el instalador de PowerShell documentado:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))

El instalador pregunta qué agentes se instalarán o verificarán; se debe escoger al menos uno. En Linux se inicia fcc-server; en Windows y macOS la aplicación aparece en la bandeja/barra de menús. Cuando el servidor está sano, abre o muestra la administración local, habitualmente http://127.0.0.1:8082/admin.

Flujos de trabajo habituales

Claude Code con un proveedor configurado: iniciar fcc-server, validar y aplicar el proveedor en la interfaz, y ejecutar fcc-claude. El selector nativo /model muestra los modelos expuestos por FCC.
Codex desde terminal: con el servidor activo, ejecutar fcc-codex; para una tarea no interactiva, el README da fcc-codex exec "hello" como ejemplo.
Pi sin alterar su configuración permanente: ejecutar fcc-pi. El README indica que registra FCC solo para ese proceso y preserva sesiones, credenciales y extensiones existentes de Pi.
Proveedor local con Ollama: ejecutar ollama pull llama3.1 y ollama serve; seleccionar después un identificador con prefijo ollama/ en FCC. El URL predeterminado es http://localhost:11434.

Configuración esencial

Interfaz Administración → proveedor y MODEL: credencial, validación y modelo por defecto. Si el proveedor no lista modelos, el README permite escribir <id-del-proveedor>/<id-exacto-del-modelo>.
MODEL_FABLE, MODEL_OPUS, MODEL_SONNET, MODEL_HAIKU: anulan selectivamente MODEL para niveles de Claude Code; el valor None conserva el modelo por defecto.
Administración → Configuración de modelo → razonamiento: conserva el ajuste del cliente, lo desactiva o fuerza un nivel; los proveedores sin esa capacidad mantienen su comportamiento.
~/.fcc/auth/: ubicación de credenciales renovables que FCC guarda al conectar una suscripción de OpenAI/ChatGPT; no modifica el inicio de sesión de Codex.
~/.codex/config.toml: archivo que el README configura para Codex App o VS Code cuando no se usa el lanzador, con base_url = "http://127.0.0.1:8082/v1" y un encabezado Bearer equivalente al token local.

Trampas frecuentes y soluciones

Claude Code sigue pidiendo inicio de sesión: añadir "hasCompletedOnboarding": true a ~/.claude.json en macOS/Linux/WSL, o a %USERPROFILE%\.claude.json en Windows, y reiniciar el cliente; es la solución documentada.
El modelo o proveedor falla tras iniciar bien: no asumir que es un fallo universal de FCC. Las incidencias #342, #319, #416 y #449 describen errores y tiempos de espera de proveedores, especialmente con NVIDIA NIM u OpenRouter. Confirmar el modelo, la credencial y el mensaje completo, y aportar esos datos en una incidencia, tal como exige la guía de contribución.
Azure no muestra el despliegue: Azure no publica nombres de despliegue personalizados en su lista de modelos; el README indica introducir el nombre como slug manual y usar el extremo v1 completo en AZURE_OPENAI_BASE_URL.
Cambiar de modelo mientras el agente ya está abierto: reiniciar el agente después de conectar OpenAI o de cambiar modelos para renovar el selector.
No dejar fcc-server en primer plano en Linux: el README advierte que el terminal debe permanecer abierto cuando se ejecuta con ese comando.

Integraciones y migración

FCC documenta configuración para Claude Code en VS Code, Codex App, Codex en VS Code y Claude ACP en JetBrains. Para VS Code/Claude se usan ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN y CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY; para Codex se configura un proveedor fcc en ~/.codex/config.toml.

También integra Discord y Telegram desde Administración → Mensajería. Se configuran token del bot, canal o usuario permitido y directorio permitido; las notas de voz pueden usar NVIDIA NIM o Whisper local. No se recuperó una guía de migración formal desde otra pasarela. La migración documentada consiste en conservar Claude Code, Codex o Pi y cambiar sus variables o configuración para que apunten al proxy local.

Dispositivo móvil y terminal de escritorio recibiendo comandos remotos mediante una interfaz de chat holográfica, con burbujas de texto magenta neón mostrando /stats, /stop y /clear.

Casos de uso y a quién puede ayudar este repositorio

Quien ya trabaja con Claude Code, Codex o Pi y quiere conservar su flujo de terminal o IDE puede redirigir esos clientes a modelos compatibles, sin adoptar otra interfaz de agente.
Equipos o personas con varias credenciales de proveedor pueden validar un proveedor en una interfaz local, seleccionar un modelo por defecto y, para Claude Code, asignar modelos diferentes a Fable, Opus, Sonnet y Haiku.
Desarrolladores que ejecutan modelos locales pueden conectar LM Studio, llama.cpp u Ollama, siempre que el servidor exponga una API compatible y el modelo soporte el contexto y las herramientas que necesita el agente.
Usuarios que operan desde móvil o mensajería pueden usar el puente de Discord o Telegram, con controles de directorio, usuarios/canales permitidos, cancelación y limpieza de sesiones. Deben tratar los tokens de bot, directorios permitidos y credenciales de proveedor como configuración sensible.
Mantenedores que desean extender una pasarela de protocolos encuentran en ARCHITECTURE.md una división explícita entre proxy, lanzadores, puente de mensajería y adaptadores de proveedor, junto a una secuencia de CI y reglas de versionado.

Recursos

Repositorio: https://github.com/Alishahryar1/free-claude-code
Documentación e instalación: https://github.com/Alishahryar1/free-claude-code#quick-start
Arquitectura y extensiones: https://github.com/Alishahryar1/free-claude-code/blob/main/ARCHITECTURE.md
Cómo contribuir: https://github.com/Alishahryar1/free-claude-code/blob/main/CONTRIBUTING.md
Conversaciones y recepción: https://news.ycombinator.com/item?id=46917761, https://news.ycombinator.com/item?id=48004559, https://github.com/Alishahryar1/free-claude-code/discussions/222
Incidencias de proveedores: https://github.com/Alishahryar1/free-claude-code/issues/342, https://github.com/Alishahryar1/free-claude-code/issues/319
Vídeo recuperado en la búsqueda: https://www.youtube.com/watch?v=d5pr0tB6h0o — vídeo de Alex Hitt cuyo título visible describe el proxy de GitHub hacia NVIDIA NIM; no se recuperó el contador de vistas.
Registro npm homónimo, no atribuido al repositorio actual: https://www.npmjs.com/package/free-claude-code — 207 descargas entre el 29 de julio y el 4 de agosto de 2026, pero sus metadatos apuntan a shurukon/FCC; no es una métrica de FCC de Alishahryar1.

Nota: este artículo combina README, arquitectura y guía de contribución de Free Claude Code, la API de GitHub, GitHub Discussions/incidencias, Hacker News, registros de paquetes y una búsqueda de YouTube consultados el 6 de agosto de 2026. Las cifras cambian con el tiempo.