Agent Switchboard
Descargar

Idioma

Guardamos el idioma que elijas en una cookie.

Tema
Documentos de la guía

Solución de problemas

Antes de nada

  • Actualiza la app a la última versión: muchos problemas ya están resueltos en versiones nuevas. Si usas funciones que dependen del teléfono o de otro PC, el PC conectado también tiene que estar al día.
  • Fíjate en el texto exacto del error. La app da indicaciones distintas según la causa.

Instalación y actualizaciones

Windows muestra un aviso de SmartScreen

Aparece porque los instaladores de Windows todavía no tienen firma de código Authenticode. Comprueba que descargaste el archivo de la página oficial y pulsa Más información → Ejecutar de todas formas. Tienes más detalles en Instalación y primer inicio.

La versión Portable no se actualiza sola

Windows Portable no puede instalar actualizaciones desde la app. Descarga el archivo nuevo desde la página de descargas y sustituye el anterior. Si quieres actualizaciones automáticas, usa la versión Setup.

No conecta con el servidor de actualizaciones

Si la app no llega a la dirección de actualizaciones, abre la página de versiones en tu navegador predeterminado. Desde ahí puedes descargar el instalador a mano. Para actualizar no hace falta cuenta ni token de acceso.

No me llegan avisos de actualización

  • Si elegiste 나중에 (Más tarde), la app no vuelve a avisarte durante 4 horas en esa sesión.
  • Si elegiste 이번 버전 건너뛰기 (Omitir esta versión), no te avisará automáticamente de esa versión.
  • Si buscas actualizaciones a mano con el icono de descarga de la parte superior, vuelven a aparecer las versiones aplazadas y las omitidas.

La actualización no se instala

El motivo aparece en la ventana de actualización y en la de confirmación del reinicio.

  • macOS: si hay un error durante la verificación de la instalación o se superan los 120 segundos de espera, puedes reintentarlo.
  • Linux .deb: durante la instalación debe aparecer una ventana pidiendo permisos de administrador. Si no aparece en 3 minutos, la instalación se detiene y la app te da el comando para instalar desde la terminal. El mensaje es distinto si cancelaste la ventana de permisos o si no se pudieron obtener.
  • Linux, si abriste la app desde un shell en sandbox: la restricción NoNewPrivs puede impedir elevar privilegios. En ese caso, la app abre la ventana de autenticación a través de systemd de usuario y, si tampoco funciona, te explica cómo instalar con sudo desde una terminal fuera de la app.

Conexión con el teléfono y QR

No puedo pulsar «연결 QR 만들기» (Crear QR de conexión)

El QR solo se puede crear cuando el PC ya está conectado al servidor de retransmisión. En 환경 설정 › 휴대폰 (Preferencias › Teléfono), comprueba que 휴대폰 연결 켜기 (Activar la conexión con el teléfono) está activado y que el estado indica que está conectado.

No puedo activar la conexión con el teléfono

Si el PC no puede usar el almacén seguro del sistema operativo, la conexión con el teléfono no se puede activar, y la app tampoco recurre a guardar nada en texto plano. En Linux, activa un keyring como Secret Service y reinicia la app.

Dice que el QR ha caducado o ya se usó

Cada QR vale para un solo uso durante 5 minutos. Crea otro en el PC y vuelve a conectar.

Aparece «연결 시도가 너무 잦습니다» (Demasiados intentos de conexión)

Cuando una conexión falla la autenticación, el PC la bloquea un momento (alrededor de 1 minuto) en el servidor de retransmisión. Espera ese minuto y vuelve a intentarlo con un QR nuevo.

Aparece «연결이 해제되었습니다» (Se ha cerrado la conexión)

Ocurre cuando se desconectó este teléfono desde el PC o se generó una identidad de escritorio nueva. Crea un QR nuevo en el PC y vuelve a conectar. Si te conectaste con una cuenta de Google, basta con volver a aceptarlo en la ventana de aprobación del PC.

Dice que el PC está apagado

Comprueba que el PC está encendido y que Agent Switchboard está abierto. En cuanto el PC se enciende, la conexión se recupera sola.

La app de Android solo muestra «네트워크 연결을 확인하세요» (Comprueba la conexión de red)

La app de Android firmada con la clave de distribución (0.6.0 o posterior) necesita que la app del PC sea 0.65.2 o posterior para conectarse con la cuenta de Google. Actualiza la app del PC.

Aparece «Google 계정을 확인하지 못했습니다» (No se pudo verificar la cuenta de Google)

Si el reloj del PC va atrasado, puede fallar la verificación del inicio de sesión de Google. El caso de un ligero atraso se corrigió en la versión 0.65.3 del PC. Actualiza la app del PC y activa la sincronización automática de la hora en el sistema operativo.

El PC muestra «Google에 다시 로그인해 주세요» (Vuelve a iniciar sesión en Google)

Ha caducado el inicio de sesión de Google del PC. Pulsa Google 다시 로그인 (Volver a iniciar sesión en Google) en Preferencias › Teléfono. Hasta que lo hagas, ningún dispositivo nuevo podrá conectarse.

No puedo reinstalar la app de Android

Si antes instalaste un APK con otra firma, el nuevo no se puede instalar encima. Desinstala la app anterior, instala el APK nuevo y vuelve a enlazar el PC e iniciar sesión con Google.

La lista de PC está vacía desde que cambió la dirección de la app web

La app web para el teléfono está ahora en https://app.switchboard.twentyoz.kr. Los datos de conexión de la dirección anterior no pasan a la nueva. Vuelve a conectar con un QR o, si usabas una cuenta de Google, inicia sesión de nuevo para cargar la lista de PC.

Claves y autenticación

«저장 후 적용» (Guardar y aplicar) está desactivado (Linux)

En un PC sin acceso al almacén seguro del sistema operativo (keyring) no se pueden guardar claves de API, y el motivo aparece encima del botón. Activa el keyring y reinicia la app.

No se aplica el modelo elegido

Tanto en la prueba de conexión como al aplicar, la app comprueba que el modelo elegido se pueda usar de verdad, y si no se puede, no aplica el cambio. Elige otro modelo disponible de la lista.

La CLI da el error «credential is not configured»

Puede pasar si, después de cambiar la conexión de la carpeta, se lanza la CLI con un perfil de ejecución antiguo. Vuelve a aplicar esa conexión en la configuración de la herramienta y reinicia la CLI. Si la carpeta tiene configuración de Codex pero ha desaparecido solo su perfil de conexión, la app lo vuelve a crear con la configuración guardada.

Sigue apareciendo «SECURE_STORAGE_BOOTSTRAP_FAILED»

  1. Comprueba que Agent Switchboard y todos sus procesos están cerrados.
  2. Si la app se cerró a la fuerza durante la inicialización y solo ha quedado el archivo de bloqueo .secure-storage-bootstrap.lock, haz una copia de ese archivo en otro sitio, bórralo y vuelve a abrir la app.
  3. No borres ni modifiques el archivo Local State ni la carpeta credentials. Déjalos como están y escríbenos.

Dice que no se pudo confirmar si se admite el esfuerzo de razonamiento

Cuando no se puede confirmar si un nivel de esfuerzo de razonamiento está admitido, la petición sale con el valor por defecto de la herramienta y la app te lo indica. Si en una versión anterior este mensaje te impedía empezar la conversación, actualiza la app.

En Windows, el inicio de sesión OAuth solo abre una terminal vacía

Era un problema causado por el perfil de inicio de PowerShell del usuario, que bloqueaba el comando de inicio de sesión. Desde la versión 0.61.2, la ventana de autenticación se salta el perfil de inicio. Actualiza la app.

Si necesitas escribirnos

Si nos informas de un problema de seguridad, no adjuntes claves de API, tokens OAuth, archivos de autenticación ni archivos de configuración completos. Basta con la dirección de conexión, el sistema operativo, la versión de la app, los pasos para reproducirlo y el mensaje de error con los datos sensibles ocultos. Escríbenos a hello@twentyoz.kr.