- FreeToken claude code funciona mejor como un flujo de trabajo con una puerta de enlace local para agentes de programación.
- Comienza localmente instalando el lanzador, abriendo la interfaz de administración y seleccionando un proveedor.
- Enruta los modelos con un modelo predeterminado y anulaciones opcionales específicas por nivel.
- Protege las credenciales mediante variables de entorno, autenticación del proxy y directorios restringidos.
- Resuelve los problemas de forma metódica comprobando el servidor, el puerto, el token, el ID del modelo y el estado de reinicio del cliente.
Qué hace FreeToken Claude Code
FreeToken claude code se entiende mejor como una capa de configuración entre Claude Code y los proveedores de modelos compatibles. En lugar de cambiar la configuración de cada cliente por separado, puedes ejecutar una puerta de enlace local, seleccionar un modelo desde una única interfaz de administración y conectar clientes de terminal o editores a esa puerta de enlace.
La ventaja práctica es el enrutamiento centralizado. Un modelo predeterminado puede gestionar las solicitudes normales, mientras que configuraciones independientes pueden dirigir los niveles de estilo Fable, Opus, Sonnet o Haiku a distintos modelos compatibles. Esto facilita las pruebas y te permite cambiar de proveedor sin reconstruir toda la configuración del cliente.
Enrutamiento centralizado
Selecciona modelos desde una única interfaz y aplica la configuración a los clientes de programación conectados.
Flexibilidad del cliente
Usa lanzadores de terminal, VS Code, JetBrains, Codex App o integraciones de mensajería cuando sean compatibles.
Gestión de respaldos
Añade modelos de respaldo ordenados para que una solicitud fallida de un proveedor pueda pasar a otra opción configurada.
| Capa | Propósito principal | Punto de partida recomendado |
|---|---|---|
| Servidor local | Aloja la puerta de enlace y la interfaz de administración | Ejecuta fcc-server |
| Proveedor | Proporciona el endpoint del modelo | Elige un proveedor compatible |
| Modelo | Gestiona las solicitudes de programación | Usa un modelo compatible con herramientas |
| Cliente | Envía prompts y llamadas a herramientas | Comienza con Claude Code |
| Seguridad | Controla el acceso al proxy | Activa la autenticación cuando sea necesario |
Comienza con un proveedor y un modelo. Añade reglas de enrutamiento solo después de que funcione la conexión básica de Claude Code.
Configuración paso a paso
Sigue estos pasos en orden. El objetivo es confirmar cada capa antes de pasar a la siguiente, lo que facilita mucho el aislamiento de los errores de conexión.
Instala o actualiza el lanzador
Usa el instalador apropiado para tu sistema operativo y vuelve a ejecutar el mismo instalador cuando haya una actualización disponible. Revisa los scripts de instalación antes de ejecutarlos si tu entorno requiere aprobación manual.
Inicia el servidor local
En Windows o macOS, abre el lanzador de FreeToken Claude Code. En Linux, inicia fcc-server desde una terminal y mantén esa terminal disponible mientras el servidor esté en ejecución.
Abre la interfaz de administración
Usa la dirección local de la interfaz de administración que muestra el servidor o la aplicación de la bandeja del sistema. Configura desde esta interfaz la clave del proveedor, el puerto del proxy y el token de autenticación.
Selecciona y valida un modelo
Busca en el selector de modelos, selecciona el ID exacto del modelo del proveedor y haz clic en Validate y Apply. Si un proveedor no puede mostrar una lista de modelos, introduce manualmente el prefijo del proveedor y el ID exacto del modelo.
Inicia Claude Code
Inicia el comando correspondiente del cliente, como fcc-claude, y prueba una solicitud de programación pequeña antes de añadir extensiones del editor o rutas de respaldo.
La primera prueba exitosa debe ser deliberadamente sencilla: pide al agente que inspeccione un archivo pequeño del proyecto, explique una función o sugiera un cambio menor. Evita comenzar con una refactorización grande, ya que una solicitud pequeña confirma conjuntamente la autenticación, el acceso al modelo, la gestión del contexto y los permisos de las herramientas.
| Punto de comprobación | Qué verificar | Si falla |
|---|---|---|
| Servidor | El proceso local permanece activo | Reinicia fcc-server |
| Interfaz de administración | La página se carga en la dirección configurada | Comprueba el puerto y el firewall |
| Proveedor | La clave se valida correctamente | Vuelve a comprobar el alcance de la clave y los términos del proveedor |
| Modelo | Se acepta el ID exacto del modelo | Usa el selector de modelos o el prefijo completo |
| Cliente | Claude Code llega a la puerta de enlace | Comprueba que coincidan la URL, el token y el puerto |
No configures varios clientes a la vez. Confirma primero Claude Code y después duplica la configuración funcional de la puerta de enlace en VS Code o JetBrains.
Enrutamiento de modelos y elección de proveedores
La selección del modelo debe reflejar la tarea, no solo el nombre de la marca. Los agentes de programación necesitan llamadas a herramientas fiables, suficiente contexto para las instrucciones del proyecto y un formato de salida estable. Un modelo que funciona bien en un chat puede no ser adecuado para un agente que debe inspeccionar archivos y ejecutar comandos.
Usa la configuración predeterminada MODEL para las solicitudes normales. Las variables específicas por nivel pueden anular los niveles individuales de Claude Code cuando necesites un comportamiento diferente para razonamientos complejos, ediciones rápidas o tareas ligeras.
| Configuración de enrutamiento | Función | Uso práctico |
|---|---|---|
MODEL | Respaldo global | Úsalo para la mayoría de las solicitudes |
MODEL_OPUS | Anulación para razonamiento complejo | Tareas de diseño o depuración de gran escala |
MODEL_SONNET | Anulación equilibrada | Trabajo diario de implementación |
MODEL_HAIKU | Anulación ligera | Explicaciones breves y ediciones rápidas |
| Modelos de respaldo | Ruta de respaldo ordenada | Interrupciones del proveedor o límites de cuota |
Proveedor alojado
Configuración cómoda y amplio acceso a modelos, pero la disponibilidad, las cuotas y los términos pueden cambiar.
Entorno de ejecución local
Es útil para trabajos sensibles a la privacidad y experimentación sin conexión, siempre que el modelo admita herramientas y tenga suficiente contexto.
Ruta híbrida
Mantén un proveedor alojado como opción predeterminada y utiliza un proveedor local o secundario como respaldo cuando corresponda.
Al añadir respaldos, recuerda que una solicitud fallida puede llegar a más de un proveedor antes de completarse correctamente. Esto puede consumir uso de varias cuentas. Mantén corta la lista, ordénala intencionadamente y evita enrutar contenido confidencial del proyecto a un proveedor que no hayas revisado.
Los controles de razonamiento pueden heredarse del cliente, desactivarse o establecerse en un nivel de esfuerzo seleccionado. Comienza con el valor predeterminado del cliente. Aumenta el razonamiento solo para tareas que se beneficien de una planificación más profunda, ya que un mayor esfuerzo puede incrementar la latencia y el consumo de recursos.
El acceso gratuito, las cuotas, los catálogos de modelos y las reglas de uso aceptable están controlados por cada proveedor. Comprueba los términos actuales antes de enrutar datos del proyecto.
Conexiones de clientes y seguridad
Claude Code puede conectarse mediante una URL base local y un token de autenticación. En las integraciones con editores, los mismos valores deben coincidir exactamente con la configuración de la puerta de enlace. Un solo carácter incorrecto en el puerto, la URL o el token puede parecer un fallo del proveedor incluso cuando este funciona con normalidad.
En VS Code, añade las variables de entorno de la puerta de enlace a la configuración de la extensión de Claude Code y, después, vuelve a cargar la extensión. Para Codex App o Codex en VS Code, coloca la configuración del proveedor y del modelo en el archivo config.toml correspondiente y reinicia el cliente después de cambiar de modelo.
| Superficie del cliente | Configuración principal | Reinicio necesario |
|---|---|---|
| Terminal | Iniciar con fcc-claude | Normalmente no requiere reinicio adicional |
| VS Code | Variables de entorno de la extensión | Vuelve a cargar la extensión |
| JetBrains | Entorno de Claude ACP | Reinicia el IDE |
| Codex App | Bloque del proveedor en config.toml | Reinicia la aplicación |
| Mensajería | Token del bot, ID de usuario, directorio | Reinicia el servidor si se solicita |
Aplica estas prácticas de seguridad:
- Almacena las credenciales del proveedor fuera de los archivos del proyecto.
- Activa la autenticación del proxy antes de exponer la puerta de enlace más allá de localhost.
- Restringe las integraciones de Discord o Telegram a usuarios, canales y directorios aprobados.
- Evita colocar secretos en prompts, registros, capturas de pantalla o archivos de configuración compartidos.
- Revisa los permisos solicitados por cada bot e integración de cliente.
- Mantén limitado el directorio del proyecto en lugar de conceder acceso a toda la carpeta de inicio.
Antes de tu primer proyecto real:
- Confirma que la puerta de enlace escucha en el puerto local previsto
- Valida un proveedor y un modelo compatible con herramientas
- Activa la autenticación del proxy cuando sea necesario
- Restringe los directorios permitidos y los usuarios de mensajería
- Elimina las credenciales del historial del shell y de los archivos del proyecto
Trata la puerta de enlace local como un servicio de desarrollo, no como un endpoint público. No la expongas a internet a menos que comprendas sus controles de autenticación y red.
Resolución de problemas y preguntas frecuentes
La mayoría de los problemas de configuración pertenecen a cuatro categorías: el servidor no está en ejecución, el cliente apunta a una dirección incorrecta, el token no coincide o el modelo seleccionado no está disponible. Comprueba esas condiciones en ese orden antes de cambiar varias configuraciones.
| Síntoma | Causa probable | Solución |
|---|---|---|
| La interfaz de administración no se abre | El servidor está detenido o el puerto es incorrecto | Inicia fcc-server y usa la dirección que muestra |
| El cliente solicita iniciar sesión | El estado de incorporación no está completo | Completa la configuración del cliente y reinícialo |
| La lista de modelos está vacía | El proveedor no puede devolver un catálogo | Introduce manualmente el ID exacto del modelo |
| La solicitud falla después de la validación | El modelo no tiene las capacidades necesarias | Selecciona un modelo compatible con herramientas |
| El editor sigue usando la configuración anterior | La extensión tiene una configuración almacenada en caché | Vuelve a cargar la extensión o reinicia el IDE |
| El respaldo se comporta de forma inesperada | Varios proveedores reciben reintentos | Revisa el orden de respaldo y el impacto en el uso |
Q: ¿Para qué se utiliza FreeToken claude code?
Se refiere a un flujo de trabajo con una puerta de enlace local que conecta Claude Code con proveedores de modelos alojados o locales configurados. La puerta de enlace centraliza la selección de modelos, la autenticación y el enrutamiento opcional de respaldo.
Q: ¿Qué modelo debería elegir primero?
Comienza con un modelo del proveedor que admita herramientas de programación y tenga suficiente contexto para las instrucciones de tu agente. Usa el selector de modelos cuando esté disponible e introduce el ID exacto con el prefijo del proveedor cuando sea necesaria la configuración manual.
Q: ¿Por qué Claude Code sigue pidiéndome que inicie sesión?
Es posible que el cliente todavía esté utilizando su flujo normal de incorporación o que la URL y el token de la puerta de enlace no coincidan. Verifica ambos valores, completa cualquier incorporación local necesaria y reinicia Claude Code o el editor.
Q: ¿Puedo utilizar modelos de respaldo?
Sí. Añade una lista de respaldos ordenada en la configuración de la puerta de enlace, pero revisa los términos y el uso del proveedor, ya que una solicitud fallida puede enviarse a más de un proveedor configurado.
Una configuración estable cuenta con un servidor confirmado, un proveedor validado, un modelo probado y un cliente que se ha reiniciado después de los cambios de configuración.