Capitulo 3: Primeros Pasos

< Volver al Indice del Tutorial

Iniciar OpenCode

Para comenzar, navega a la raiz de tu proyecto y ejecuta:

opencode

OpenCode detecta automaticamente el tipo de proyecto (lenguaje, framework, estructura) y carga la TUI (Terminal User Interface).

La Interfaz TUI

La TUI es la interfaz principal de OpenCode. Se compone de varias areas:

Area de Input

En la parte inferior de la pantalla. Aqui escribes tus prompts y comandos. Soporta multiples lineas con Shift+Enter.

Area de Output

Ocupa la mayor parte de la pantalla. Muestra las respuestas del agente, el codigo generado, los archivos modificados y la salida de comandos ejecutados.

Status Bar

En la parte superior muestra informacion clave:

• Agente activo (Build o Plan)
• Modelo LLM en uso
• Tokens consumidos en la sesion
• Estado de la conexion

Conectar un Proveedor

La primera vez que uses OpenCode necesitas autenticarte con un proveedor LLM:

/connect

Esto abre un menu interactivo donde seleccionas tu proveedor y configuras la API key. Los proveedores mas comunes son:

• Anthropic: necesitas ANTHROPIC_API_KEY
• OpenAI: necesitas OPENAI_API_KEY
• Google: necesitas GOOGLE_API_KEY

Tambien puedes configurar las keys como variables de entorno antes de iniciar OpenCode:

export ANTHROPIC_API_KEY=sk-ant-...
opencode

Inicializar el Proyecto

El comando /init es fundamental. Analiza tu proyecto y genera un archivo AGENTS.md en la raiz:

/init

El archivo AGENTS.md contiene:

• Estructura del proyecto detectada
• Convenciones de codigo identificadas
• Comandos de build, test y lint
• Reglas especificas del proyecto

Importante: commitea AGENTS.md al repositorio. Asi todos los miembros del equipo (y el propio OpenCode) comparten el mismo contexto.

git add AGENTS.md
git commit -m "feat: agregar AGENTS.md para OpenCode"

Alternar entre Agentes

OpenCode incluye dos agentes built-in. Usa Tab para alternar entre ellos:

Agente	Funcion	Puede Modificar
Build	Desarrollo activo: lee, escribe, ejecuta	Si
Plan	Analisis y planificacion	No (solo lectura)

Usa Plan cuando quieras analizar un problema sin riesgo de modificaciones. Usa Build cuando estes listo para implementar.

Referenciar Archivos con @

Puedes referenciar archivos directamente en tus prompts usando @:

Refactoriza @src/index.ts para separar las rutas en su propio archivo

Explica que hace @src/utils/parser.ts

Agrega tests para @src/services/auth.ts

El @ le da contexto especifico al agente sobre que archivos mirar. Puedes referenciar multiples archivos en un mismo prompt.

Slash Commands Basicos

Los comandos se ejecutan escribiendo / seguido del nombre:

Gestion de Sesion

Comando	Descripcion
/clear	Limpia el historial de la sesion actual
/compact	Comprime el contexto para ahorrar tokens
/share	Genera un enlace para compartir la sesion

Edicion

Comando	Descripcion
/undo	Deshace el ultimo cambio realizado por el agente
/redo	Rehace el ultimo cambio deshecho

Configuracion

Comando	Descripcion
/models	Lista y cambia el modelo LLM activo
/help	Muestra todos los comandos disponibles

Modo No Interactivo

Para automatizacion, scripts y CI/CD, OpenCode soporta ejecucion directa sin abrir la TUI:

opencode run "agrega un endpoint GET /health que retorne status 200"

El agente ejecuta la tarea y termina. Util para:

• Pipelines de CI/CD
• Scripts de automatizacion
• Tareas repetitivas
• Integracion con otras herramientas

Puedes combinar con flags adicionales:

# Usar un modelo especifico
opencode run --model claude-sonnet-4-20250514 "genera tests unitarios para auth.ts"

# Limitar herramientas
opencode run --tools read,write "corrige el typo en README.md"

Flujo de Trabajo Tipico

Un flujo de trabajo comun con OpenCode se ve asi:

1. opencode — abrir la TUI en tu proyecto
2. /init — generar AGENTS.md (solo la primera vez)
3. Tab para Plan — analizar que necesitas hacer
4. Tab para Build — implementar los cambios
5. Revisar los cambios con git diff
6. /undo si algo no quedo bien
7. Commitear cuando estes satisfecho

Atajos de Teclado

Atajo	Accion
Tab	Alternar entre agentes
Ctrl+C	Cancelar la generacion actual
Ctrl+D	Salir de OpenCode
Shift+Enter	Nueva linea en el input
Up/Down	Navegar historial de prompts

---

Siguiente: Capitulo 4: Configuracion —>