Toma de control de herramientas de programación con IA en un solo clic
La toma de control con un solo clic (Takeover) te permite apuntar tus herramientas CLI de programación con IA más habituales hacia la puerta de enlace de IA local sin tener que editar manualmente ningún archivo de configuración. Una vez realizada la toma de control, las solicitudes de estas herramientas se enrutan de forma unificada a través de http://127.0.0.1:11580 hacia los canales de proveedores que hayas configurado en la puerta de enlace y quedan incluidas en las estadísticas unificadas de uso y costes.
Cómo funciona
Al ejecutar la toma de control con un solo clic para cada herramienta, la puerta de enlace realiza los siguientes pasos en orden:
- Comprueba el estado de salud de la puerta de enlace para confirmar que el punto de conexión del proxy está disponible.
- Crea automáticamente una clave virtual exclusiva (la puerta de enlace la escribe en la configuración de la herramienta; el texto en claro puede recuperarse en cualquier momento desde la página de claves).
- Hace una copia de seguridad del archivo de configuración original con el sufijo
.bak(por ejemplo,~/.claude/settings.json.bak). - Escribe con precisión / fusiona en profundidad la configuración que apunta a la puerta de enlace, manteniendo intactos tus demás ajustes.
- Actualiza el estado de la interfaz para mostrar la situación actual de la toma de control.
Al detener la toma de control también se realiza una "eliminación precisa": solo se retiran las claves correspondientes cuando la configuración apunta realmente a esta puerta de enlace, evitando borrar por error otros ajustes que hayas configurado manualmente; además, se revoca la clave virtual creada automáticamente durante la toma de control.
Estado de la toma de control
En la página Puerta de enlace de IA → Gestión de integración → Cliente, cada herramienta muestra uno de estos cuatro estados:
| Estado | Significado |
|---|---|
| Con toma de control (esta puerta de enlace) | La herramienta apunta a la puerta de enlace de IA local |
| Conectada (otra dirección) | La herramienta tiene configurada otra dirección (ya sea por ti manualmente o apuntando a otra puerta de enlace); la puerta de enlace no la sobrescribirá por su cuenta |
| Sin toma de control | Se ha detectado la herramienta, pero aún no apunta a la puerta de enlace |
| No detectada | No se ha encontrado en el equipo local el directorio de configuración de esta herramienta |
Requisitos previos
- Tener la sesión iniciada en la cuenta de ServBay y haber configurado al menos un canal disponible en la página Canales.
- Tener instalada en el equipo local la herramienta de IA de destino (la puerta de enlace determina su existencia según su directorio de configuración).
Operación de toma de control con un solo clic
Accede a la página Puerta de enlace de IA → Gestión de integración → Cliente, localiza la herramienta de destino en la lista y haz clic en Toma de control con un solo clic. Si la operación se realiza correctamente, el estado cambia a "Con toma de control (esta puerta de enlace)". Si deseas revertirla, basta con hacer clic en Detener toma de control.
Detalles de la toma de control de cada herramienta
La siguiente tabla muestra los archivos de configuración y el contenido que se modifica realmente al aplicar la toma de control en cada herramienta, para que puedas entenderlo y solucionar problemas:
| Herramienta | Archivo de configuración | Contenido escrito | Dirección de la puerta de enlace |
|---|---|---|---|
| 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" de nivel superior | http://127.0.0.1:11580/v1 |
| 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 del modelo | http://127.0.0.1:11580/v1 |
| CodeBuddy | ~/.codebuddy/models.json | Fusión en profundidad del nodo de modelo servbay | http://127.0.0.1:11580/v1 |
| opencode | ~/.config/opencode/opencode.json | Fusión en profundidad del nodo provider.servbay (agrega los modelos de cada canal) | http://127.0.0.1:11580/v1 |
| Crush | ~/.config/crush/crush.json | Fusión en profundidad del nodo providers.servbay | http://127.0.0.1:11580/v1 |
Por qué la dirección de Claude Code no lleva /v1
Claude Code utiliza el protocolo de Anthropic y la puerta de enlace concatena por sí misma rutas como /v1/messages, por lo que ANTHROPIC_BASE_URL debe ser la dirección raíz de la puerta de enlace (sin /v1). La mayoría de las demás herramientas utilizan el protocolo compatible con OpenAI, por lo que necesitan el sufijo /v1. La toma de control con un solo clic lo rellena automáticamente según la convención de cada herramienta, así que no necesitas distinguirlo manualmente.
Restauración y solución de problemas
- Restaurar la configuración original — Haz clic en Eliminar y la puerta de enlace retirará con precisión la configuración que apunta a esta puerta de enlace. También puedes restaurarla manualmente usando el archivo de copia de seguridad
.bakdel mismo directorio. - El estado muestra "Conectada (otra dirección)" — Indica que la herramienta apunta actualmente a otra dirección (configurada por ti manualmente o apuntando a otra puerta de enlace). Para no sobrescribir tu configuración, la puerta de enlace no aplicará la toma de control automáticamente; puedes limpiar manualmente esa configuración primero y luego aplicar la toma de control.
- La herramienta sigue dando error tras la toma de control — Comprueba que el servicio de proxy de la puerta de enlace esté en ejecución, que el canal correspondiente esté en buen estado y que la clave virtual no haya sido revocada; además, puedes consultar en la página Estadísticas y monitorización si las solicitudes llegan a la puerta de enlace.
Preguntas frecuentes (FAQ)
- P: ¿La toma de control con un solo clic dañará mi configuración original de las herramientas?
- R: No. La puerta de enlace solo escribe o fusiona con precisión las claves relacionadas con ella y, antes de escribir, respalda el archivo original como
.bak. Los demás ajustes permanecen sin cambios.
- R: No. La puerta de enlace solo escribe o fusiona con precisión las claves relacionadas con ella y, antes de escribir, respalda el archivo original como
- P: ¿Puedo volver a cambiar la configuración manualmente tras la toma de control?
- R: Sí. Haz clic en "Eliminar" para que la puerta de enlace lo revierta, o restaura manualmente usando la copia de seguridad
.bak.
- R: Sí. Haz clic en "Eliminar" para que la puerta de enlace lo revierta, o restaura manualmente usando la copia de seguridad
- P: ¿Dónde está la clave virtual utilizada para la toma de control?
- R: La puerta de enlace crea automáticamente una clave virtual exclusiva para cada herramienta con toma de control; puedes consultarla y gestionarla en la página Claves.
- P: ¿Por qué aparece "No detectada" para una herramienta en la lista?
- R: Significa que no se ha encontrado en el equipo local el directorio de configuración de esa herramienta. Instálala y ejecútala una vez para que genere el directorio de configuración antes de aplicar la toma de control.
Resumen
La toma de control con un solo clic convierte la tediosa y propensa a errores tarea de "editar manualmente los archivos de configuración de cada herramienta" en un solo clic: creación automática de claves, copia de seguridad automática, escritura precisa y restauración en cualquier momento. Junto con los canales unificados y las estadísticas de uso, puedes hacer que todas tus herramientas de programación con IA compartan el mismo conjunto de configuración de proveedores y la misma vista de costes. Si quieres llamar a la puerta de enlace desde tu propio código, consulta Puntos de conexión y variables de entorno.
