3. Requisitos previos y entorno de trabajo

Objetivo del tema

Preparar tu equipo para ejecutar OpenCode sin sobresaltos: conocer los requisitos básicos, elegir una terminal adecuada, reunir las herramientas complementarias y las credenciales de acceso a modelos, y verificar que todo esté listo antes de instalar en el próximo tema.

3.1 Requisitos básicos

OpenCode es un binario autocontenido y liviano, disponible para Linux, macOS y Windows. Para usarlo en tu terminal necesitas dos cosas:

  • Un emulador de terminal moderno: la interfaz TUI hace uso intensivo de colores, caracteres Unicode y renderizado avanzado. La documentación oficial recomienda terminales como WezTerm o Alacritty (multiplataforma), Ghostty o Kitty (Linux y macOS).
  • Credenciales de un proveedor de modelos LLM: ya sea una clave de API del proveedor que prefieras (Anthropic, OpenAI, Google, entre otros) o una cuenta de OpenCode Zen, la lista curada de modelos del propio proyecto. Lo veremos en detalle en el tema 5.

No se requiere ninguna suscripción específica ni hardware especial: cualquier computadora capaz de ejecutar una terminal actual basta.

Si tu terminal habitual es antigua o muy minimalista, la TUI puede verse con caracteres rotos o colores planos. Antes de culpar a OpenCode, prueba con WezTerm o Alacritty: en la mayoría de los casos el problema desaparece.

3.2 Herramientas complementarias recomendadas

No son obligatorias, pero mejoran mucho la experiencia:

  • Git: OpenCode funciona en cualquier carpeta, pero trabajar sobre repositorios versionados te permite revisar diffs, deshacer cambios y colaborar con seguridad. Descárgalo desde git-scm.com.
  • Node.js o Bun: útil sólo si planeas instalar OpenCode vía npm (npm install -g opencode-ai) o Bun. Si usas el script de instalación oficial, no los necesitas.
  • Gestor de paquetes del sistema: Homebrew en macOS/Linux, Chocolatey o Scoop en Windows simplifican instalar y actualizar tanto OpenCode como sus dependencias auxiliares.
  • Runtimes de tus proyectos: Python, Go, Rust, etc., según lo que usen tus repositorios: el agente ejecutará tests y scripts locales.

3.3 Elección de terminal: comparativa rápida

Emuladores de terminal recomendados para la TUI de OpenCode
Terminal Plataformas Destacado
WezTerm Linux, macOS, Windows Multiplataforma, configurable por Lua, excelente soporte TUI.
Alacritty Linux, macOS, Windows Liviana y muy rápida, renderizado por GPU.
Ghostty Linux, macOS Moderna, rendimiento destacado y soporte nativo de funciones avanzadas.
Kitty Linux, macOS Muy completa, extensible y rápida.
Windows Terminal / PowerShell Windows Funciona, aunque la experiencia óptima se logra dentro de WSL.

3.4 Consideraciones para Windows

OpenCode puede instalarse de forma nativa en Windows (Chocolatey, Scoop o npm), pero la recomendación oficial es usar WSL2 (Windows Subsystem for Linux) para obtener mejor rendimiento y compatibilidad total con todas las funciones del agente:

wsl --install          # instala WSL2 con Ubuntu por defecto

Dentro de WSL trabajarás con un entorno Ubuntu real, donde Git, los permisos POSIX y las herramientas de tu proyecto se comportan igual que en un servidor Linux. Si prefieres no usar WSL, la alternativa nativa con PowerShell funciona correctamente para la mayoría de los flujos; ten en cuenta que algunos scripts POSIX y herramientas de compilación pueden requerir pasos extra.

Si trabajas dentro de WSL, clona tus repositorios dentro del sistema de archivos de WSL (por ejemplo ~/proyectos/) y no en /mnt/c/...: el acceso a disco sobre la partición de Windows es mucho más lento y penaliza a cualquier agente que lea muchos archivos.

3.5 Verificaciones iniciales

Con las piezas anteriores en su lugar, comprueba tu entorno:

git --version
node --version        # opcional, sólo si instalarás vía npm
bun --version         # opcional, alternativa a npm
opencode --version

Como todavía no instalamos OpenCode, el último comando debería fallar con un "comando no encontrado"; es lo esperado y lo resolveremos en el próximo tema.

Aprovecha para dejar lista la identidad de Git, algo que el agente aprovechará al crear commits:

git config --global user.name "Tu Nombre"
git config --global user.email "tu@correo.com"

3.6 Checklist de preparación antes de instalar

Checklist previo a la instalación
Paso Acción Resultado esperado
1. Elegir terminal Instalar WezTerm, Alacritty, Ghostty o Kitty (o preparar Windows Terminal + WSL). La TUI de OpenCode renderizará colores y símbolos sin errores.
2. Instalar Git Verificar con git --version y configurar nombre y correo globales. Diffs y commits generados por el agente quedarán correctamente firmados.
3. Conseguir credenciales LLM Crear una clave de API en tu proveedor o registrarte en OpenCode Zen. Podrás autenticarte al primer arranque con /connect.
4. Preparar repositorio de prueba git init o git clone de un proyecto pequeño. Espacio seguro para experimentar con el agente en el tema 6.
5. Definir método de instalación Decidir entre script oficial, npm/bun, brew, choco/scoop o Docker. Instalación previsible y fácil de actualizar después.

3.7 Buenas prácticas continuas

  • Mantén tu terminal, Git y runtimes actualizados: OpenCode evoluciona rápido y se integra con versiones recientes de las herramientas.
  • Guarda tus claves de API en variables de entorno o en el almacenamiento seguro que ofrece OpenCode al autenticarse; nunca las subas a repositorios.
  • Usa un repositorio de prueba dedicado para aprender: permite equivocarse sin riesgo antes de tocar proyectos reales.
  • En equipos, acuerden una terminal soportada y una versión mínima de OpenCode para reducir diferencias de comportamiento entre compañeros.

Conclusión: con una terminal moderna, Git configurado, credenciales de algún proveedor y (en Windows) WSL2 listo, tu entorno está preparado. En el próximo tema instalaremos OpenCode usando el método que mejor se ajuste a tu sistema operativo.

Retornar