Toma de control con un clic de herramientas de programación AI

La función de toma de control (Takeover) te permite redirigir inmediatamente las herramientas de línea de comandos más populares para programación con IA hacia tu pasarela AI local, sin tener que editar ningún archivo de configuración de forma manual. Una vez habilitada, todas las peticiones de estas herramientas se enrutarán a través de http://127.0.0.1:11580 hacia los proveedores que definas en la pasarela, unificando así el control y las métricas de uso y costos.

Cómo funciona

Al ejecutar la toma de control en cada herramienta, la pasarela realiza los siguientes pasos:

1. Comprueba el estado de la pasarela para asegurar que el endpoint proxy está disponible.
2. Genera automáticamente una llave virtual exclusiva (la clave en texto plano solo se muestra una vez durante la creación, y se agrega a la configuración de la herramienta).
3. Crea una copia de seguridad del archivo de configuración original como .bak (por ejemplo, ~/.claude/settings.json.bak).
4. Escribe o fusiona con precisión la configuración para apuntar a la pasarela, manteniendo intactos el resto de tus ajustes.
5. Refresca la interfaz para mostrar el estado actualizado de la toma de control.

Al eliminar la toma de control, se realiza un borrado preciso: solo se quitan las claves asociadas al gateway cuando realmente están presentes, evitando modificar otros ajustes que hayas configurado manualmente.

Estados de toma de control

En la página AI Gateway → Endpoints, cada herramienta mostrará uno de los siguientes cuatro estados:

Estado	Significado
Controlada (este gateway)	La herramienta apunta a la pasarela AI local
Conectada (otra dirección)	La herramienta está configurada para otra dirección (cambiaste la config manualmente o usas otro gateway); la pasarela no sobrescribirá tu ajuste
Sin controlar	Se detecta la herramienta, pero aún no se ha redirigido a la pasarela
No detectada	No se encuentra el directorio de configuración de la herramienta en tu sistema

Requisitos previos

• Debes haber iniciado sesión en tu cuenta de ServBay y tener al menos un canal disponible configurado en la sección Canales.
• La herramienta AI objetivo debe estar instalada en tu equipo (la pasarela determina su existencia por la presencia de su directorio de configuración).

Proceso de toma de control con un clic

Entra en AI Gateway → Endpoints, busca la herramienta que deseas gestionar y haz clic en Toma de control con un clic. Si la redirección es exitosa, el estado cambiará a "Controlada (este gateway)". Para revertir la acción, haz clic en Eliminar / Restaurar.

Detalles de configuración de cada herramienta

La siguiente tabla muestra qué archivos y campos de configuración son modificados en cada herramienta al realizar la toma de control, para que puedas entender y depurar fácilmente el proceso:

Herramienta	Archivo de configuración	Cambios aplicados	Dirección de la pasarela
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (sin /v1)
Codex	~/.codex/config.toml	Sección [model_providers.servbay] + model_provider = "servbay" en nivel superior	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Líneas GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (compatible con OpenAI)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Sección [model_providers.servbay] + definición de modelos	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Fusión profunda del nodo de modelo servbay	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Fusión profunda del nodo provider.servbay (agrega modelos de todos los canales)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Fusión profunda del nodo providers.servbay	http://127.0.0.1:11580/v1

¿Por qué la dirección de Claude Code no lleva /v1?

Claude Code usa el protocolo de Anthropic. La pasarela agrega por sí misma rutas como /v1/messages, así que ANTHROPIC_BASE_URL debe ser únicamente la raíz, sin /v1. La mayoría de las otras herramientas funcionan con el estándar de OpenAI, por lo que requieren la ruta /v1. El proceso de toma de control aplica el formato adecuado para cada herramienta automáticamente, sin que debas preocuparte por ello.

Restauración y resolución de problemas

• Restaurar la configuración original — Haz clic en Eliminar, y la pasarela eliminará únicamente los cambios relacionados a sí misma. También puedes restaurar manualmente usando el archivo backup con extensión .bak del mismo directorio.
• Estado muestra "Conectada (otra dirección)" — Significa que la herramienta apunta actualmente a otra dirección (ya sea por tu configuración manual o por otro gateway). Para evitar sobrescribir tus ajustes, no se toma el control automáticamente. Puedes limpiar esa configuración tú mismo y luego activar la toma de control.
• La herramienta da error tras la toma de control — Comprueba que el proxy de la pasarela esté activo, también que el canal correspondiente esté operativo, y que la llave virtual no esté revocada. Puedes revisar si llegan solicitudes a través de la sección Estadísticas y Monitoreo.

Preguntas frecuentes (FAQ)

• P: ¿La toma de control con un clic dañará la configuración original de la herramienta?
  • R: No. La pasarela solo modifica de manera puntual o fusiona los campos que le corresponden, y siempre hace una copia de seguridad (.bak) antes de escribir. Todo lo demás permanece igual.
• P: ¿Puedo volver manualmente a la configuración anterior después de la toma de control?
  • R: Sí. Puedes hacer clic en "Eliminar" para revertir desde la pasarela o restaurar manualmente desde la copia .bak.
• P: ¿Dónde se encuentra la llave virtual usada para la toma de control?
  • R: El gateway crea una llave virtual personalizada para cada herramienta tomada. Puedes gestionarlas en la sección de Llaves.
• P: ¿Por qué una herramienta aparece como "No detectada" en la lista?
  • R: El software no encontró el directorio de configuración en tu equipo. Instala y ejecuta la herramienta al menos una vez para que genere su carpeta de configuración antes de intentar la toma de control.

Resumen

La toma de control con un solo clic transforma el tedioso y riesgoso trabajo de editar configuraciones manualmente en un proceso seguro y automatizado: genera llaves, realiza backups, escribe solo lo necesario y permite restaurar cuando quieras. Con la gestión unificada de canales y consumos, podrás centralizar toda la configuración y monitoreo de costos de tus herramientas de IA para programación. Si lo que buscas es integrar la pasarela directamente en tu propio código, consulta la sección de endpoints y variables de entorno.