FAQ y Solución de Problemas
FAQ y Solución de Problemas
Section titled “FAQ y Solución de Problemas”❓ Preguntas Generales
Section titled “❓ Preguntas Generales”¿Es OpenCode realmente gratuito y de código abierto?
Section titled “¿Es OpenCode realmente gratuito y de código abierto?”Sí. OpenCode es 100% código abierto bajo la licencia MIT. Puedes ver el código, auto-alojarlo o modificarlo. Los únicos costes asociados son los del uso de los modelos de IA (a través de Zen o proveedores directos).
¿Cómo se compara OpenCode con Claude Code o Cursor?
Section titled “¿Cómo se compara OpenCode con Claude Code o Cursor?”OpenCode ofrece varias ventajas clave:
- Flexibilidad de modelos: Soporta más de 75 proveedores.
- Precio: Pago por uso, sin suscripciones mensuales obligatorias.
- Privacidad: Opción de usar modelos locales (Ollama) y auto-alojamiento.
🛠️ Instalación y Configuración
Section titled “🛠️ Instalación y Configuración”El comando opencode no se encuentra tras la instalación
Section titled “El comando opencode no se encuentra tras la instalación”Intenta añadirlo a tu PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrcsource ~/.bashrcLa clave de API de Zen no funciona
Section titled “La clave de API de Zen no funciona”- Regenera la clave en el panel de control de opencode.ai.
- Verifica el saldo: Asegúrate de tener créditos activos.
- Formato: La clave debe empezar por
zen_.
🚀 Uso y Funcionalidades
Section titled “🚀 Uso y Funcionalidades”Las referencias a archivos (@archivo) no funcionan
Section titled “Las referencias a archivos (@archivo) no funcionan”- Verifica que estás en el directorio correcto con
!pwd. - Usa rutas absolutas si es necesario.
- La búsqueda difusa funciona mejor con nombres de archivo únicos.
OpenCode está haciendo cambios incorrectos
Section titled “OpenCode está haciendo cambios incorrectos”- Usa
/undopara deshacer el último cambio. - Revisa
!git statuspara ver qué archivos han cambiado. - Sé más específico en tus instrucciones (menciona líneas o funciones específicas).
🤖 Agentes y Skills
Section titled “🤖 Agentes y Skills”Mi agente personalizado no aparece en la lista
Section titled “Mi agente personalizado no aparece en la lista”- Verifica que el archivo esté en
.opencode/agents/o~/.config/opencode/agents/. - Asegúrate de que el archivo termine en
.mdo.json. - Ejecuta
/agents reload.
La ejecución de una Skill falla
Section titled “La ejecución de una Skill falla”- Valida la sintaxis con
/skills validate [nombre]. - Revisa los logs en
!cat ~/.local/share/opencode/skills.log.
🔒 Seguridad y Privacidad
Section titled “🔒 Seguridad y Privacidad”¿Se envía mi código a los proveedores de IA?
Section titled “¿Se envía mi código a los proveedores de IA?”Sí, cuando usas modelos basados en la nube. Para máxima privacidad:
- Usa modelos locales (Ollama, llama.cpp).
- Usa proveedores con garantías empresariales de privacidad.
- Configura un archivo
.opencodeignorepara excluir archivos sensibles (como.env).
🤝 Comunidad y Soporte
Section titled “🤝 Comunidad y Soporte”¿Dónde puedo obtener ayuda?
Section titled “¿Dónde puedo obtener ayuda?”- Discord: Comunidad oficial.
- GitHub: Reporta problemas en el repositorio.
- Documentación: Consulta docs.opencode.ai.