Agent Switchboard
Descargar

Idioma

Guardamos el idioma que elijas en una cookie.

Tema
Documentos de la guía

Instalación y primer inicio

Sistemas compatibles

Agent Switchboard funciona en estos tres entornos.

Sistema operativo Arquitectura Instalador
Windows x64 Agent-Switchboard-Setup-<versión>-x64.exe, Agent-Switchboard-Portable-<versión>-x64.exe
macOS Apple Silicon (arm64) Agent-Switchboard-<versión>-mac-arm64.dmg, ZIP
Linux x64 Agent-Switchboard-<versión>-linux-x86_64.AppImage, Agent-Switchboard-<versión>-linux-amd64.deb

En macOS solo hay versión para Apple Silicon; no se ofrecen archivos para Mac con Intel.

Descarga el instalador desde la página de descargas. Verás primero los archivos para el sistema que estás usando.

Windows

¿Setup o Portable?

  • Setup (Agent-Switchboard-Setup-…exe) es la opción recomendada. Una vez instalada, la app descarga e instala las versiones nuevas por sí misma.
  • Portable (Agent-Switchboard-Portable-…exe) se ejecuta sin instalar nada. A cambio, no puede instalar actualizaciones desde la app: cada vez que salga una versión nueva tendrás que descargarla de nuevo desde la página de descargas.

Aviso de SmartScreen

Los instaladores de Windows todavía no tienen firma de código Authenticode. Por eso, al descargarlos o al abrirlos por primera vez, Windows SmartScreen puede avisarte de que no reconoce al editor.

  1. Comprueba que descargaste el archivo de la página oficial (switchboard.twentyoz.kr).
  2. En el aviso, pulsa Más información y luego Ejecutar de todas formas.

Las actualizaciones que la app descarga después tienen su propia verificación: con la clave pública incluida en la app se comprueban la firma de la política de actualización y el hash SHA-512 del instalador, y solo se instala si todo cuadra. Eso sí, esta verificación no sustituye a la firma de código del sistema operativo.

macOS

  1. Abre el archivo …-mac-arm64.dmg.
  2. Arrastra Agent Switchboard a la carpeta Aplicaciones.
  3. Abre la app desde Aplicaciones.

Los archivos para macOS se publican firmados con Developer ID y notarizados por Apple (notarization), y antes de cada publicación pasan la verificación de Gatekeeper. Si los descargas de la página oficial, se abren como cualquier otra app.

Linux

AppImage

El AppImage no necesita instalación; solo hay que darle permiso de ejecución.

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

.deb (Debian, Ubuntu y derivadas)

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, así que en Linux necesitas un keyring de escritorio, como Secret Service. Si no hay keyring disponible, la app no guarda la clave en texto plano: encima del botón 저장 후 적용 (Guardar y aplicar) de la conexión con clave de API te explica por qué no puede guardarla. Activa el keyring y reinicia la app. La conexión con el teléfono también necesita el almacén seguro para poder activarse.

Primer inicio

La primera vez que abres la app verás el rail a la izquierda y el área de trabajo. Para empezar, sigue este orden.

  1. Registra una carpeta de proyecto: pulsa el icono 폴더 추가 (Añadir carpeta) en la parte baja del rail izquierdo y elige la carpeta en la que vas a trabajar. Se abrirá el inicio de ese proyecto.
  2. Añade una conexión: abre 환경 설정 (Preferencias) en la parte baja de la barra lateral (atajo Ctrl+, en Windows y Linux, ⌘, en macOS) y registra una clave de API o un gateway en 연결 · 인증 (Conexiones y autenticación). Si solo vas a usar tu suscripción (OAuth), puedes saltarte este paso.
  3. Asígnala a una herramienta: en 도구 설정 (Configuración de herramientas), dentro del inicio del proyecto, elige una herramienta y define la conexión y el modelo. Tienes todos los detalles en Conexiones y configuración por proyecto.
  4. Ejecuta: lanza la herramienta desde la cabecera del inicio del proyecto o elígela en el menú del proyecto en el rail, ⋯ → 새 세션 (Nueva sesión). Por defecto se abre en una pestaña de terminal dentro de la app.

Estos mismos pasos están en la app, en 도움말 (Ayuda) → 처음 연결하기 (Primera conexión).

Agent Switchboard no reemplaza a las CLI de los agentes de programación, como Codex o Claude Code. La app comprueba si cada herramienta está instalada y, si falta alguna, te indica cómo instalarla por la vía oficial.

Actualización automática

Cuándo busca versiones nuevas

  • Unos 2,5 segundos después de abrir la app.
  • Cada 15 minutos mientras está abierta.
  • 5 segundos después de que el equipo salga de la suspensión.
  • Cuando quieras, con el icono de descarga de la parte superior.

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

Cuando hay una versión nueva

  1. Elige entre 업데이트 다운로드 (Descargar actualización), 이번 버전 건너뛰기 (Omitir esta versión) y 나중에 (Más tarde).
  2. La descarga se hace en segundo plano y muestra progreso, tamaño y velocidad. Puedes cancelarla en cualquier momento.
  3. Terminada la descarga, no se instala sin más: tienes que pulsar 재시작하여 설치 (Reiniciar e instalar) y confirmarlo una vez más para que la app se cierre y se instale.

Si eliges Más tarde, la app no vuelve a avisarte durante 4 horas en esa sesión. Si buscas actualizaciones a mano, vuelven a aparecer tanto las versiones aplazadas como las omitidas. En la ventana de actualización puedes leer los cambios hasta la versión omitida.

Comportamiento según el sistema

Formato Instalación automática desde la app
Windows Setup Sí
Windows Portable No. Descarga el archivo nuevo desde la página de descargas
macOS (app firmada) Sí. La app se cierra cuando termina la verificación de la instalación; si hay un error o se superan los 120 segundos de espera, puedes reintentarlo
Linux AppImage Sí. La versión nueva se abre cuando se cierra la anterior
Linux .deb Sí. Durante la instalación aparece una ventana para pedir permisos de administrador

Si la instalación falla, el motivo aparece en la ventana de actualización y en la de confirmación del reinicio. Para resolverlo, consulta Solución de problemas.