Conexiones y configuración por proyecto

Conceptos básicos

Agent Switchboard gestiona tres elementos por separado.

• Conexión: la dirección y la clave de API de un gateway o provider. Se registra una vez en 환경 설정 › 연결 · 인증 (Preferencias › Conexiones y autenticación) y varias herramientas pueden elegir la misma conexión. Las herramientas que usan la misma conexión comparten la clave.
• Herramienta: una CLI de agente de programación como Codex, Claude Code o Pi. Para cada herramienta se define el método de conexión (API / 게이트웨이 [API / gateway] o OAuth / 기본 인증 [OAuth / autenticación predeterminada]), el modelo y el esfuerzo de razonamiento.
• Alcance: 전역 기본 (Predeterminado global) es el valor que siguen todas las carpetas registradas. Si guarda un valor aparte en una carpeta, ese valor propio se aplica solo a esa carpeta.

Si una carpeta no tiene configuración propia, usa el predeterminado global tal cual. La primera vez que guarda en una carpeta, se crea la configuración propia de esa carpeta tomando los valores actuales como punto de partida. El provider, la autenticación, el modelo y la configuración de razonamiento propios de la carpeta tienen prioridad sobre los globales.

Conexiones compatibles

Droid, Crush y Kimi Code también admiten la gestión de conexiones. Antigravity (agy), Copilot CLI, Cursor CLI, Amp, Goose, Aider, Kilo CLI, Grok Build y Gemini CLI solo admiten la detección de la instalación y la ejecución. La configuración y la autenticación de estas herramientas las gestiona cada herramienta.

Registrar una conexión

Clave de API o gateway

1. Abra Preferencias en la parte inferior de la barra lateral y vaya a Conexiones y autenticación.
2. Pulse 연결 추가 (Añadir conexión).
3. Elija un servicio del catálogo de providers o introduzca la dirección del gateway, añada la clave de API y guarde.

Las direcciones remotas solo se aceptan con HTTPS. HTTP solo se permite para direcciones del mismo PC (loopback).

Las claves se guardan cifradas por conexión en el almacén seguro del sistema operativo (Windows DPAPI, macOS Keychain, Linux Secret Service). Una clave guardada no se vuelve a mostrar en pantalla. En los archivos de configuración de Codex, Claude Code y Pi no se escribe la clave, sino solo el comando del credential helper de Agent Switchboard. Cuando la herramienta se ejecuta, el helper saca la clave del almacén seguro y se la entrega.

Registrar una conexión no la aplica a ninguna herramienta. Debe aplicarla siguiendo los pasos de la sección siguiente.

Inicio de sesión de suscripción (OAuth)

Si usa el inicio de sesión propio de la herramienta, como una suscripción a ChatGPT o Claude, no necesita clave de API.

1. En la pantalla de configuración de la herramienta, elija OAuth / 기본 인증 (OAuth / autenticación predeterminada).
2. Pulse 기본 인증 적용 (Aplicar autenticación predeterminada).
3. Inicie sesión con el flujo de inicio de sesión de la herramienta.

Cada CLI guarda y renueva sus tokens OAuth directamente en su propio almacenamiento. Agent Switchboard no lee ni copia esos tokens.

Usar varias cuentas

Codex, Claude Code, Pi y Qwen Code pueden usar la autenticación predeterminada con varias cuentas. Cree una cuenta en la lista de cuentas de la herramienta, inicie sesión y elija la cuenta de forma global o por proyecto. En Pi se inicia sesión con /login en una terminal abierta, y en Qwen Code con /auth. La selección de cuenta no se aplica a las conexiones de API o gateway.

Aplicar a una herramienta

Predeterminado global

1. Pulse 전역 기본 (Predeterminado global) en el rail izquierdo. También puede abrirlo con 전역 기본과 비교 (Comparar con el predeterminado global) en la página de inicio del proyecto.
2. Pulse la tarjeta de una herramienta para abrir su pantalla de configuración.
3. Elija API / 게이트웨이 (API / gateway) u OAuth / 기본 인증 (OAuth / autenticación predeterminada).
4. Si es una conexión de API, elija una conexión registrada y elija el modelo en la lista con búsqueda. Al cambiar de modelo, se aplican también el esfuerzo de razonamiento (effort) y el límite de tokens que admite ese modelo.
5. Compruebe la dirección y la autenticación con 연결 테스트 (Probar conexión).
6. Pulse 저장 후 적용 (Guardar y aplicar). En OpenCode, pulse 설정 적용 (Aplicar configuración).

Al probar la conexión y al aplicar, se comprueba si el modelo elegido se puede usar realmente. Si no se puede usar, la aplicación se detiene y se le avisa. En ese caso, elija usted mismo un modelo disponible de la lista.

Distinto en cada carpeta de proyecto

Es la función central de Agent Switchboard. Incluso en el mismo PC, cada carpeta puede usar un agente, un modelo, un provider y una clave distintos.

1. Al elegir un proyecto en el rail izquierdo se abre la página de inicio del proyecto.
2. En 도구 설정 (Configuración de herramientas), pulse la tarjeta de una herramienta. Las herramientas que no estén en la lista se añaden con el botón 도구 (Herramientas), que añade herramientas para mostrar en esta carpeta.
3. Elija el método de conexión, la conexión, el modelo y el esfuerzo de razonamiento igual que en el predeterminado global.
4. Al aplicar, se convierte en la configuración propia de esta carpeta.

La página de inicio del proyecto muestra, de arriba abajo, 지금 (Ahora: sesiones en ejecución, esperando entrada o con error), Configuración de herramientas y 최근 세션 (Sesiones recientes). En las tarjetas de herramientas puede ver de un vistazo la herramienta, la conexión, el modelo y el esfuerzo de razonamiento de esa carpeta. Con Comparar con el predeterminado global puede verlos junto a los valores globales.

La configuración propia de la carpeta se escribe en los siguientes archivos según la herramienta.

Cline CLI no crea un archivo de configuración de proyecto y se ejecuta en la carpeta elegida. Las herramientas que no admiten configuración de proyecto se muestran como 프로젝트 설정 미지원 (Configuración de proyecto no compatible) y usan la configuración global del PC.

Valores predeterminados para nuevas conversaciones de Switcher

El agente, el modelo y el esfuerzo de razonamiento predeterminados de las conversaciones de Switcher también se pueden definir por carpeta. En el menú de Switcher del proyecto en el rail › Configuración, pulse 이 폴더에 저장 (Guardar en esta carpeta). Si pulsa 전역 기본값 따르기 (Seguir el predeterminado global), se borran los valores de la carpeta y se vuelve a seguir el predeterminado global. Las conversaciones ya abiertas mantienen su motor, modelo y esfuerzo de razonamiento.

Cambiar rápidamente desde la bandeja

Al pulsar el icono de la bandeja del sistema (la barra de menús en macOS) se abre el panel de cambio rápido.

1. Elija una herramienta y luego API · 게이트웨이 (API · gateway) u OAuth · 기본 인증 (OAuth · autenticación predeterminada).
2. Al elegir un proveedor, se carga la lista de modelos con la conexión guardada.
3. Elija un modelo y pulse 이 공급자로 전환 (Cambiar a este proveedor).

El cambio rápido pasa por el mismo proceso de copia de seguridad, prueba de conexión y verificación que la ventana principal.

Protección de los archivos de configuración

• Antes de cambiar la configuración, se hace una copia de seguridad del original la primera vez, y en cada cambio se guarda una copia de seguridad de la revisión.
• Agent Switchboard solo cambia los elementos que gestiona y conserva el resto de la configuración del usuario.
• Después de aplicar, vuelve a leer los archivos generados para verificarlos. Si la verificación falla, revierte los cambios de esa aplicación al estado anterior.
• 최초 설정 복원 (Restaurar la configuración original) devuelve los archivos al estado que tenían antes de que Agent Switchboard los modificara por primera vez.
• Al eliminar una clave guardada, primero se cambia la conexión gestionada a la autenticación predeterminada de la herramienta.

Siguientes pasos

• Para continuar desde el teléfono, consulte Conexión con el teléfono.
• Para la pantalla de conversación y la dirección de varias sesiones, consulte Switcher y orquestación.