Instalación y primer inicio

Entornos compatibles

Agent Switchboard se ejecuta en los tres entornos siguientes.

macOS solo es compatible con Apple Silicon. No se ofrecen archivos para Mac con Intel.

Los archivos de instalación se descargan desde la página de descargas. La página de descargas muestra primero el sistema operativo que está usando.

Windows

Elegir entre Setup y Portable

• Se recomienda Setup (Agent-Switchboard-Setup-…exe). Después de instalarlo, puede descargar e instalar nuevas versiones desde la propia aplicación.
• Portable (Agent-Switchboard-Portable-…exe) se ejecuta sin instalación. No admite la instalación automática desde la aplicación. Cuando salga una nueva versión, debe volver a descargar el archivo desde la página de descargas.

Advertencia de SmartScreen

Los archivos de instalación de Windows todavía no tienen firma de código Authenticode. Por eso, al descargarlos con el navegador o al ejecutarlos por primera vez, Windows SmartScreen puede advertir que no puede verificar el editor.

1. Compruebe que descargó el archivo desde la página oficial de descargas (switchboard.twentyoz.kr).
2. En la ventana de advertencia, pulse Más información y luego Ejecutar de todas formas.

Las actualizaciones que se descargan desde la aplicación después de instalarla se verifican por separado. Solo se instalan después de comprobar, con la clave pública incluida en la aplicación, la firma de la política de actualización y el hash SHA-512 del archivo de instalación. Esta verificación no sustituye la firma de código del sistema operativo.

macOS

1. Abra el archivo …-mac-arm64.dmg.
2. Arrastre Agent Switchboard a la carpeta Aplicaciones.
3. Ejecute la aplicación desde la carpeta Aplicaciones.

Los archivos de distribución para macOS se publican con firma Developer ID y notarización de Apple (notarization). Antes de publicarse también deben superar la verificación de Gatekeeper. Por eso, los archivos descargados desde la página oficial se abren como cualquier otra aplicación.

Linux

AppImage

AppImage no requiere instalación; basta con darle permiso de ejecución.

chmod +x Agent-Switchboard-<버전>-linux-x86_64.AppImage
./Agent-Switchboard-<버전>-linux-x86_64.AppImage

.deb (familia Debian/Ubuntu)

sudo apt install ./Agent-Switchboard-<버전>-linux-amd64.deb

Almacén seguro (keyring)

Las claves de API se guardan cifradas en el almacén seguro del sistema operativo. En Linux se necesita un keyring de escritorio como Secret Service. Si no se puede usar el keyring, la clave no se guarda en texto plano y se muestra el motivo por el que no se puede guardar encima de 저장 후 적용 (Guardar y aplicar) en la conexión de clave de API. Active el keyring y reinicie la aplicación. La conexión con el teléfono también requiere un almacén seguro para poder activarse.

Primer inicio

Al abrir la aplicación por primera vez verá el rail a la izquierda y el área de trabajo. Empiece en este orden.

1. Registrar una carpeta de proyecto: pulse el icono 폴더 추가 (Añadir carpeta) en la parte inferior del rail izquierdo y elija la carpeta en la que va a trabajar. Al elegirla se abre la página de inicio del proyecto de esa carpeta.
2. Registrar una conexión: abra 환경 설정 (Preferencias) en la parte inferior de la barra lateral (atajo Ctrl+, en Windows y Linux, ⌘, en macOS) y registre una clave de API o un gateway en 연결 · 인증 (Conexiones y autenticación). Si solo usa el inicio de sesión de suscripción (OAuth), puede omitir este paso.
3. Aplicar a una herramienta: en 도구 설정 (Configuración de herramientas) de la página de inicio del proyecto, elija una herramienta y defina la conexión y el modelo. Consulte los detalles en Conexiones y configuración por proyecto.
4. Ejecutar: ejecute la herramienta directamente desde la cabecera de la página de inicio del proyecto, o elíjala en el menú del proyecto en el rail ⋯ → 새 세션 (Nueva sesión). La ubicación de ejecución predeterminada es una pestaña de terminal dentro de la aplicación.

En la aplicación, 도움말 (Ayuda) → 처음 연결하기 (Primera conexión) explica el mismo orden.

Agent Switchboard no sustituye a las CLI de cada agente de programación, como Codex o Claude Code. La aplicación detecta si las herramientas están instaladas y, para las que no lo están, indica la vía de instalación oficial.

Actualización automática

Cuándo se comprueba

• Unos 2,5 segundos después de iniciar la aplicación se comprueba si hay una nueva versión.
• Mientras la aplicación está abierta, se comprueba cada 15 minutos.
• Al volver de la suspensión, se vuelve a comprobar a los 5 segundos.
• Puede comprobarlo manualmente en cualquier momento con el icono de descarga de la parte superior.

Las actualizaciones se descargan del servidor oficial (https://switchboard.twentyoz.kr/releases). No se necesita cuenta ni token de acceso.

Cuando hay una nueva versión

1. Elija una opción: 업데이트 다운로드 (Descargar actualización), 이번 버전 건너뛰기 (Omitir esta versión) o 나중에 (Más tarde).
2. La descarga se realiza en segundo plano y muestra el progreso, el tamaño y la velocidad. Puede cancelarla a mitad de camino.
3. Al terminar la descarga, no se instala automáticamente. Debe pulsar 재시작하여 설치 (Reiniciar e instalar) y confirmar una vez más para que la aplicación se cierre y se instale.

Si elige Más tarde, no se le volverá a avisar durante 4 horas en la ejecución actual. Si lo comprueba manualmente, también se vuelven a mostrar esta espera y las versiones omitidas. En la ventana de actualización puede leer el registro de cambios hasta la versión omitida.

Comportamiento por sistema operativo

Si la instalación falla, el motivo se muestra en la ventana de actualización y en la ventana de confirmación de reinicio. Consulte las soluciones en Solución de problemas.