Preguntas Frecuentes
Este capítulo recopila los problemas más comunes y sus soluciones al usar el plugin Antigravity Auth. Ya sea por fallos de autenticación OAuth, errores en solicitudes de modelo, o problemas de compatibilidad de plugins, aquí encontrarás las guías correspondientes para la resolución de problemas.
Requisitos Previos
Antes de comenzar, asegúrate de
- ✅ Haber completado la instalación rápida y agregado exitosamente tu cuenta
- ✅ Haber completado la primera autenticación y comprendido el flujo OAuth
Ruta de Aprendizaje
Según el tipo de problema que encuentres, selecciona la guía de resolución correspondiente:
1. Resolución de fallos de autenticación OAuth
Resuelve problemas comunes relacionados con la autenticación OAuth, la actualización de tokens y las cuentas.
- La autorización del navegador tiene éxito pero el terminal indica "autorización fallida"
- De repente aparece el error "Permission Denied" o "invalid_grant"
- Fallo del callback OAuth en el navegador Safari
- No se puede completar la autenticación en entornos WSL2/Docker
2. Migración de cuentas
Migra cuentas entre diferentes máquinas y maneja las actualizaciones de versión.
- Migrar cuenta de la computadora vieja a la nueva
- Comprender los cambios en el formato de almacenamiento (v1/v2/v3)
- Resolver errores de invalid_grant después de la migración
3. Resolución de modelo no encontrado
Resuelve problemas relacionados con modelos, como modelo no encontrado y errores 400.
- Resolución de error "Model not found"
- Error 400 "Invalid JSON payload received. Unknown name "parameters""
- Error en la llamada del servidor MCP
4. Compatibilidad de plugins
Resuelve problemas de compatibilidad con plugins como oh-my-opencode, DCP, etc.
- Configurar correctamente el orden de carga de plugins
- Desactivar métodos de autenticación conflictivos en oh-my-opencode
- Habilitar desplazamiento PID para escenarios de agentes paralelos
5. Advertencia ToS
Comprende los riesgos de uso y evita que la cuenta sea bloqueada.
- Conocer las restricciones de los términos de servicio de Google
- Identificar escenarios de alto riesgo (nuevas cuentas, solicitudes intensivas)
- Dominar las mejores prácticas para evitar el bloqueo de cuentas
Localización Rápida de Problemas
| Fenómeno de error | Lectura recomendada |
|---|---|
| Fallo de autenticación, tiempo de espera de autorización | Resolución de fallos de autenticación OAuth |
| invalid_grant, Permission Denied | Resolución de fallos de autenticación OAuth |
| Model not found, error 400 | Resolución de modelo no encontrado |
| Conflicto con otros plugins | Compatibilidad de plugins |
| Cambio de computadora, actualización de versión | Migración de cuentas |
| Preocupado por la seguridad de la cuenta | Advertencia ToS |
Siguiente Paso
Después de resolver el problema, puedes:
- 📖 Leer Funciones avanzadas para dominar a fondo múltiples cuentas, recuperación de sesiones y otras características
- 📚 Consultar Apéndice para conocer el diseño de arquitectura y referencia completa de configuración
- 🔄 Seguir el registro de cambios para obtener las últimas funciones y actualizaciones