No se instala, ¿qué hacer: solución de problemas de instalación e inicio de sesión
Si WorkBuddy no se instala o no puedes iniciar sesión, lo más probable es que estés atascado en tres puntos: los residuos de una versión antigua bloquean la instalación, el software de seguridad o el navegador bloquea el inicio de sesión, o el dispositivo mismo está fuera del rango compatible. Esta página recorre, según el «texto original», los errores frecuentes del FAQ oficial y de pruebas de la comunidad, dando causa y solución para cada uno: primero usa la verificación rápida de 60 segundos para orientarte y luego encuentra tu caso. Basado en v5.9.3 (2026-10-27), lectura de unos 10 minutos.
Primero aclaremos los límites: los errores de la fase de ejecución de tareas (códigos de error 4100, 1001, Bot sin respuesta, puntos no acreditados) y la tabla completa de códigos de error están en R1 Consulta rápida de solución de problemas: códigos de error y problemas frecuentes; los códigos de error de red 3002 / 3003 / 3007, como también pueden bloquear el inicio de sesión, se tratan igualmente en esta página con ideas de diagnóstico.
Qué podrás hacer al terminar
- Usar la «herramienta de diagnóstico» integrada oficial para localizar en 60 segundos cuál de los elementos falla: red, disco, software de seguridad, registros de fallos
- Reparar los casos típicos de WorkBuddy fallo de instalación: error 4551, mensaje de actualización «existe un directorio de proyectos de usuario en el directorio de instalación», Win11 ARM64 no instala
- Reparar las tres causas oficiales de WorkBuddy fallo de inicio de sesión: navegador predeterminado, permisos de la carpeta de la cuenta, bloqueo por software de seguridad
- Saber cómo diagnosticar los códigos de error de red 3002 / 3003 / 3007; los usuarios de Mac sabrán gestionar «no se puede verificar al desarrollador» y «no se puede actualizar automáticamente»
- Recuperar la carpeta del espacio de trabajo desaparecida tras la actualización y saber dónde están los registros y a quién reportar
Tu situación actual
- Descargaste un instalador de más de cien MB y al instalar o desinstalar aparece un 4551, igual por muchos reintentos
- Doble clic en WorkBuddy sin respuesta, o al hacer clic en iniciar sesión el navegador no abre y tras escanear el código QR el cliente no cambia en nada
- Al abrir WorkBuddy por primera vez en Mac aparece «no se puede verificar al desarrollador» y no sabes si este software es de fiar
Cuándo usar este método
Cuando necesites:
- Reparar problemas de instalación, actualización e inicio de sesión atascados en 1.2 flujo principal de instalación o en 1.2b método de instalación alternativo
Y no quieras:
- Desinstalar y reinstalar en bucle ante cualquier error: primero localiza la causa; en la mayoría de los casos basta una instalación de sobrescritura
- Confundir «bloqueo por software de seguridad» con «el software está roto» y desgastar el sistema en vano
🎒 Preparativos antes de empezar
- Haber recorrido 1.2 flujo principal de instalación — no importa en qué paso te hayas atascado, esta página es justamente para desatascarte
- Que el sistema esté dentro del rango compatible: Windows 10 o superior (x64) o macOS 12 o superior; Win11 ARM64 ver más abajo (versión oficial: no admitido por ahora)
- Poder abrir el Administrador de tareas (Windows,
Ctrl + Shift + Esc) o la Terminal (Mac) - Tener el hábito de conservar el texto del error y capturas de las ventanas emergentes — la parte oficial los pide al reportar
Idea central
WorkBuddy no se instala: primero distingue en qué enlace estás atascado. De la descarga hasta entrar a la interfaz principal hay que superar cuatro etapas, y los errores de cada etapa se ven distintos:
| Etapa | Qué ocurre | Juicio rápido | Manifestación típica | A qué grupo ir |
|---|---|---|---|---|
| 1. Dispositivos y sistemas | Sistema fuera del alcance de soporte | Consultar los requisitos oficiales del entorno | Win11 ARM64 no se puede instalar | Grupo 1 |
| 2. Instalación/actualización | Residuos de versiones antiguas, instalación en ubicación incorrecta | Ver el número de error o el texto del mensaje | 4551, «existe un directorio de proyectos del usuario en el directorio de instalación», Mac no abre | Grupos 1 y 3 |
| 3. Inicio de sesión | Navegador, permisos, software de seguridad, red | El cliente no responde tras hacer clic en iniciar sesión | Sin respuesta al hacer clic, fallo de inicio de sesión | Grupo 2 |
| 4. Anomalías tras la actualización | Pérdida de datos, fallo de actualización | Localizar la carpeta, comprobar actualizaciones | Desaparición del espacio de trabajo, imposibilidad de actualización automática | Grupo 3 |
Una herramienta oficial es lo más práctico: la herramienta de diagnóstico. WorkBuddy incorpora una «herramienta de diagnóstico» que, con un solo clic, comprueba la red, los recursos del sistema, el software de seguridad, la información del entorno y los registros de fallos, y genera automáticamente un informe de diagnóstico anonimizado. Ante problemas para iniciar sesión, fallos de conexión o anomalías del cliente, la recomendación oficial es ejecutar primero esta autocomprobación (consulte el uso en la comprobación rápida de 60 segundos).
💡 El texto original del error es el mejor término de búsqueda
El título de la ventana emergente y el número de error (como 4551) son justamente el texto original que necesitas: úsalo para cotejarlo con los títulos de abajo, o cópialo directamente para buscar. No pruebes remedios de origen desconocido.
Primera comprobación: comprobación rápida de 60 segundos
Si no se abre o no se puede iniciar sesión, ejecuta primero la autocomprobación integrada del cliente y revisa luego los requisitos mínimos del sistema:
# 1. Abre WorkBuddy → «Ayuda» en la parte superior → «Herramienta de diagnóstico» → iniciar la comprobación
# —— con un solo clic comprueba la red, el disco (alerta por debajo de 3 GB / fallo con 1 GB), el software de seguridad y los registros de fallos
# 2. Cuando se detecta un bloqueo del software de seguridad, la ventana emergente muestra las rutas que deben añadirse a la lista blanca
# 3. Coteja los requisitos del sistema: Windows 10+ (x64, no compatible con Win7/8/8.1); macOS 12+
# 4. Sal temporalmente del software de seguridad (Huorong / 360 Seguridad / PC Manager / Seguridad de Windows) y reintenta el inicio de sesión
# 5. ¿Sigue sin estar claro? Menú Ayuda → «Abrir carpeta de registros» (Mac) / «Abrir directorio de registros» (Windows), y lleva el registro .zip para enviar comentariosDeberías ver: la herramienta de diagnóstico genera un informe .txt (guardado en el directorio de registros logs/self-check/, conserva los últimos 10), con sugerencias de reparación orientativas para los elementos fallidos. Corrige primero el elemento que aparezca en rojo: para cuentas personales y la versión internacional solo se muestra el grupo «Red», lo cual es normal.
Comprobación de problemas frecuentes
WorkBuddy: fallos de instalación: no se instala, no se desinstala, no se abre
"Error de instalación o desinstalación 4551"
Causa: el programa de actualización detectó archivos de copia de seguridad heredados de una versión antigua o registros históricos de proyectos; normalmente se trata de carpetas llamadas _, backup, old, backup_old en el directorio de instalación. (La solución proviene de pruebas de terceros en la comunidad de Tencent Cloud; la documentación oficial no recoge este código de error)
Solución:
- Abre el directorio de instalación de WorkBuddy (por ejemplo
D:\WorkBuddy) - Busca y elimina la carpeta llamada
_y limpia también las carpetas con nombres similares abackup,old,backup_old - Abre el Administrador de tareas (
Ctrl + Shift + Esc) y finaliza todos los procesos llamadosWorkBuddy.exeyWorkBuddy Service.exe - Ve al sitio web oficial de WorkBuddy, descarga de nuevo el instalador de la última versión y realiza una instalación sobrescribiendo la existente
Deberías ver: el asistente de instalación se completa con normalidad y ya no aparece 4551.
"Se ha detectado un directorio de proyectos del usuario en el directorio de instalación de la aplicación"
Causa: el FAQ oficial explica que, al actualizar o reinstalar WorkBuddy, el directorio de instalación se vacía primero y luego se vuelven a escribir los archivos; si hay archivos locales propios en el directorio, podrían sobrescribirse y perderse. Los usuarios con chips NVIDIA pueden encontrar archivos de NVIDIA Corporation generados en la ruta de instalación, lo que provoca el fallo de la actualización.
Solución: ve al sitio web oficial de WorkBuddy, descarga manualmente el instalador de la última versión y realiza una instalación sobrescribiendo la existente.
Deberías ver: la instalación sobrescrita se completa y la versión se actualiza a la más reciente.
⚠️ No coloques archivos propios en el directorio de instalación
El directorio de instalación se vacía y se reescribe durante las actualizaciones. Coloca los archivos de trabajo en el espacio de trabajo o en un directorio independiente; no los metas en el directorio de instalación de WorkBuddy.
"No se puede instalar en Windows 11 con arquitectura ARM 64"
Causa: el FAQ oficial indica claramente que «la versión actual no es compatible de momento con Windows 11 de arquitectura ARM 64». (Otra parte de la guía de instalación dice que «la compatibilidad con dispositivos ARM64 depende de lo indicado en la versión actual»; cotejando ambas, se trata como no compatible por ahora)
Solución: la recomendación oficial es cambiar a un entorno de dispositivo compatible (Windows 10 o superior, x64, o macOS 12 o superior), o esperar a que una versión posterior lo admita.
Deberías ver: tras cambiar de dispositivo, la instalación se realiza con normalidad siguiendo el proceso principal de instalación 1.2. No confíes en paquetes ARM modificados de origen dudoso.
En el primer arranque en Mac aparece el aviso "no se puede verificar el desarrollador"
Causa: el mecanismo de seguridad de aplicaciones de macOS bloqueó el primer inicio. (El procedimiento proviene de pruebas de terceros en la comunidad de Tencent Cloud; la guía oficial de instalación para Mac no recoge este punto por separado)
Solución: ve a «Preferencias del Sistema → Seguridad y Privacidad» y haz clic en Abrir de todos modos para permitir el primer inicio.
Deberías ver: al volver a hacer doble clic en WorkBuddy la aplicación se inicia con normalidad y entra en la pantalla de inicio de sesión.
WorkBuddy Fallos de inicio de sesión y problemas de red: no responde, no escanea, no conecta
"Al hacer clic en WorkBuddy no hay respuesta; no se puede iniciar sesión o el inicio de sesión falla"
El FAQ oficial enumera tres tipos de causas frecuentes; compruébalas en orden:
Causa 1: no se ha configurado un navegador predeterminado.
Solución:
Windows:
- Entra en Configuración del sistema → Aplicaciones predeterminadas y establece Chrome como navegador predeterminado
- Haz clic de nuevo en iniciar sesión e intenta que se abra la ventana de verificación de inicio de sesión
- Si no se abre: elige «Copiar enlace», abre el navegador por tu cuenta,
Ctrl + Vo pega el enlace en la barra de direcciones con clic derecho, y completa la verificación de inicio de sesión
Mac:
- Abre «Preferencias del Sistema» → «General»
- Configura Chrome o Safari como navegador predeterminado
- Reinicia la aplicación y vuelve a iniciar sesión
Causa 2: la carpeta de la cuenta no tiene permisos de operación (el propietario del directorio no es el usuario actual).
Solución: en tres pasos — primero confirmar los permisos, luego otorgarlos y, por último, volver a iniciar sesión.
En Mac, ejecuta en la terminal para confirmar si el propietario del directorio es el usuario actual (whoami permite consultar el nombre de usuario):
ls -la ~/Library/Application\ Support/CodeBuddyExtension/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/auth/Si el propietario no es el usuario actual, otorga los permisos:
sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtensionEn Windows, ejecuta en PowerShell para confirmar que la lista de Owner y Access incluye al usuario actual:
Get-Acl "$env:APPDATA\CodeBuddyExtension" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public\auth" | Format-ListSi no lo incluye, abre PowerShell como administrador para otorgar los permisos:
$user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
$path = "$env:APPDATA\CodeBuddyExtension"
takeown /F $path /R /D Y
icacls $path /grant "${user}:(OI)(CI)F" /TTras otorgar los permisos, cierra WorkBuddy, vuelve a abrirlo e inicia sesión de nuevo.
Causa 3: bloqueo por parte del software de seguridad. Texto oficial literal: «WorkBuddy suele ser bloqueado por error; basta con cerrar el software de seguridad y volver a intentarlo».
Solución: sal temporalmente de los siguientes software de seguridad y vuelve a intentarlo: Huorong, 360 Seguridad, PC Manager, Seguridad de Windows.
Deberías ver: tras tratar la causa correspondiente, al pulsar iniciar sesión el navegador abre correctamente la página de inicio de sesión oficial y, tras escanear el código QR con WeChat, el cliente entra a la interfaz principal.
"Error de conexión de red, comprueba la red y vuelve a intentarlo" (código de error 3002 / 3003 / 3007)
Causa: la documentación oficial de códigos de error clasifica 3002 (fallo de conexión), 3003 (tiempo de espera de conexión) y 3007 como problemas del entorno de red. El inicio de sesión se completa en el navegador (al pulsar iniciar sesión, el navegador abre la página de login de workbuddy.cn); si la red no funciona, la página de inicio de sesión naturalmente no se abre; durante la ejecución de tareas también aparece el mismo aviso.
Solución:
- Primero confirma si estás usando la red de la empresa o la red doméstica
- Red de la empresa: contacta con el departamento de TI de tu empresa para que ayude a investigar
- Red doméstica: trata los puntos uno a uno según el proceso oficial de diagnóstico de red
- Trata el proxy según la explicación oficial de «Proxy de red» — WorkBuddy incluye desde 5.3.0 una función integrada de cambio de proxy de red; si no conoces las diferencias entre las opciones, usa «Seguir al sistema»
Deberías ver: la tarea continúa cuando se restablece la red. Explicación oficial: ante fluctuaciones de red, WorkBuddy intenta primero reconectarse automáticamente (en el progreso de la tarea se muestra «Fallo de red, intentando reconectar…»); el contenido ya generado y el registro de ejecución se conservan; cuando la red se restablece, continúa automáticamente a continuación de la respuesta original.
Problemas de actualización: la actualización se queda bloqueada, el espacio de trabajo desaparece
Mac muestra "Error al comprobar actualizaciones" o "No se puede actualizar automáticamente"
Causa: la guía oficial de instalación para Mac advierte — si tras hacer doble clic en el .dmg ejecutas directamente desde la imagen de disco, WorkBuddy se ejecutará sobre una imagen de disco de solo lectura y después no podrá actualizarse automáticamente.
Solución (la oficial da dos caminos):
- Mover con un clic: pulsa el botón «Mover a Aplicaciones» del aviso y WorkBuddy se moverá automáticamente a la carpeta «Aplicaciones»
- Mover manualmente: abre la carpeta y arrastra WorkBuddy a la carpeta «Aplicaciones»
Una vez hecho, reinicia WorkBuddy desde «Aplicaciones» y podrás comprobar y completar la actualización con normalidad.
Deberías ver: avatar en la esquina inferior izquierda → Comprobar actualizaciones, mostrando «Ya tienes la última versión» o la actualización automática completada.
"Tras actualizar o reiniciar al día siguiente, la carpeta original del espacio de trabajo desaparece"
Causa: fenómeno conocido en Windows registrado en las FAQ oficiales — tras reiniciar por una actualización, el espacio de trabajo original desaparece de la interfaz; algunos usuarios pueden encontrar la carpeta histórica en el directorio de usuario pero con archivos faltantes, y a otros les desaparece el directorio completo.
Solución:
- Abre el Explorador de archivos (Windows) o Finder (Mac) y localiza la carpeta grande de WorkBuddy:
- Windows:
C:\Users\<用户名>\workbuddy - Mac:
/Users/用户名/WorkBuddy
- Windows:
- Abre mediante WorkBuddy la carpeta con nombre de fecha o con el nombre definido por el usuario para recuperar el historial original
- Recomendación oficial: guarda también los archivos importantes en un directorio independiente, no dependas solo del espacio de trabajo
Deberías ver: las sesiones históricas y los archivos reaparecen en la lista del espacio de trabajo.
¿Sigue sin funcionar?
Recopila primero las pruebas y luego da retroalimentación. Recomendación de uso de las FAQ oficiales: prioriza conservar las pruebas — código de error, capturas del mensaje de error, versión del sistema, entorno de red y hora en que ocurrió.
| Qué recopilar | Cómo obtenerlo |
|---|---|
| Informe de diagnóstico | Ayuda → Herramienta de diagnóstico → Exportar informe (.txt, ya anonimizado: la IP conserva solo los dos primeros segmentos, el nombre de usuario se sustituye por ***) |
| Paquete de registros | Mac: Ayuda → «Abrir carpeta de registros»; Windows: menú desplegable de Ayuda → «Abrir directorio de registros» (paquete comprimido .zip) |
| Captura del error | Texto original del aviso emergente + código de error (si lo hay) |
| Información del sistema | Versión del sistema, entorno de red, hora en que ocurrió |
Dónde preguntar:
| Canal | Para qué sirve |
|---|---|
| Retroalimentación desde el cliente: menú desplegable de Ayuda → helpFeedback, o avatar → Configuración → Ayuda y retroalimentación → Enviar opinión (marcando subir registros) | La vía más rápida, con los registros incluidos |
| Correo electrónico workbuddy@tencent.com | Buzón de consultas indicado por las FAQ oficiales |
| FAQ oficial / Explicación de códigos de error | Fuente de la mayoría de las entradas de esta página |
Puntos de control ✅
- He pasado la herramienta de diagnóstico una vez y sé si se queda atascado en la red, el disco, el software de seguridad o los permisos
- Error 4551: eliminé las carpetas
_/backup/old, terminé el proceso WorkBuddy y luego hice una instalación sobrescribiendo - Fallo de inicio de sesión: he revisado una por una las tres causas oficiales (navegador predeterminado / permisos de carpeta / software de seguridad)
- Mac: WorkBuddy está en la carpeta «Aplicaciones» y «Comprobar actualizaciones» funciona con normalidad
- Si sigue sin funcionar, llevaré el informe de diagnóstico + los registros + la captura del error a Enviar opinión o enviaré un correo electrónico
Resumen de esta lección
✅ Si WorkBuddy no se instala, primero separa por etapas: requisitos del sistema → instalación/actualización → inicio de sesión → anomalías tras el arranque; cada etapa tiene sus propios puntos de verificación fijos.
✅ Los dos grandes casos típicos de fallo de instalación tienen soluciones fijas: 4551 limpiar las carpetas residuales + cerrar procesos + instalar sobrescribiendo; «existe un directorio de proyecto de usuario bajo el directorio de instalación» se resuelve directamente descargando la última versión desde el sitio oficial e instalando encima.
✅ Ante fallos de inicio de sesión, revisa según las tres causas oficiales: configurar el navegador predeterminado → comprobar los permisos de la carpeta de la cuenta (chown / takeown) → salir del software de seguridad. WorkBuddy suele ser bloqueado por error; primero cierra el software de seguridad y reintenta.
✅ Recuerda las dos vías oficiales de ayuda: retroalimentación dentro del cliente (con registros) o el correo workbuddy@tencent.com.
Consulta rápida de señales clave:
| Señal | Etapa | Primer paso |
|---|---|---|
| Error 4551 | Instalación/desinstalación | Eliminar _ / backup y demás carpetas residuales, cerrar procesos e instalar sobrescribiendo |
| «Existe un directorio de proyectos de usuario en el directorio de instalación» | Actualización | Instala la última versión descargada del sitio oficial por encima |
| Win11 ARM64 no se puede instalar | Sistema | Aún no hay soporte oficial, cambia a un dispositivo compatible |
| No responde al hacer clic / falla el inicio de sesión | Inicio de sesión | Navegador predeterminado → permisos de carpeta → software de seguridad |
| Mac «No se puede verificar el desarrollador» | Inicio en Mac | Seguridad y privacidad → Abrir de todos modos |
| Mac no se actualiza automáticamente | Actualización en Mac | Arrastra de vuelta a la carpeta «Aplicaciones» y vuelve a iniciar |
| El espacio de trabajo desaparece tras la actualización | Datos | Recupéralos en la carpeta workbuddy del directorio de usuario |
Los códigos de error de la fase de ejecución (4100 modelo personalizado, 1001 anomalía del modelo, 6003/6004 límite de frecuencia, etc.) se detallan en R1 Consulta rápida de resolución de problemas: códigos de error y preguntas frecuentes.
Avance de la próxima lección
Ya instalado y con sesión iniciada, la próxima lección empieza a trabajar de verdad: Primera tarea: de una frase a un producto aceptable.
Aprenderás:
- El flujo completo de cinco pasos desde la descarga hasta el inicio de sesión y la creación de una tarea
- WorkBuddy Las cuatro zonas de la interfaz: barra de herramientas, barra lateral, zona de conversación y zona de resultados
- Dónde ver los productos: las cuatro pestañas de productos, páginas web, archivos del espacio de trabajo y cambios