OpenCode: La Alternativa Open Source a Claude Code y Cursor

1# Script universal — funciona en macOS y Linux
2curl -fsSL https://opencode.ai/install | bash

1# npm
2npm install -g opencode-ai
3
4# Homebrew (macOS / Linux)
5brew install opencode
6
7# Chocolatey (Windows)
8choco install opencode
9
10# Scoop (Windows)
11scoop install opencode
12
13# Arch Linux
14pacman -S opencode

1# Requiere Go 1.21+
2git clone https://github.com/opencode-ai/opencode.git
3cd opencode
4go build -o opencode
5# Asegúrate de que $(go env GOPATH)/bin esté en tu PATH

1docker run -it --rm \
2  -v $(pwd):/workspace \
3  -w /workspace \
4  ghcr.io/opencode-ai/opencode

1# Inicia OpenCode en tu proyecto
2cd mi-proyecto
3opencode
4
5# Dentro de la TUI, escribe:
6/connect

1{
2  "provider": {
3    "anthropic": {}
4  },
5  "model": "anthropic/claude-sonnet-4-6",
6  "small_model": "anthropic/claude-haiku-4-5-20251001"
7}

1# Simplemente escribe tu pregunta o instrucción
2> Explícame cómo funciona el módulo de autenticación
3
4# Referencia archivos con @
5> @src/auth/login.service.ts ¿por qué falla el refresh token?
6
7# Ejecuta comandos shell con !
8> !npm test
9
10# Usa slash commands
11> /models      # Ver modelos disponibles
12> /init        # Inicializar AGENTS.md en el proyecto
13> /undo        # Deshacer el último cambio
14> /redo        # Rehacer
15> /share       # Compartir la conversación con un link

1# Ejecutar un prompt directo sin abrir la TUI
2opencode run "Explica cómo funciona el patrón Strategy en este proyecto"
3
4# Continuar la última sesión
5opencode --continue
6
7# Usar un modelo específico
8opencode -m anthropic/claude-sonnet-4-6 run "Refactoriza este servicio"
9
10# Adjuntar archivos al contexto
11opencode run -f src/main.ts -f README.md "Actualiza el README con la nueva API"
12
13# Salida en formato JSON (útil para pipelines)
14opencode run --format json "Lista todos los endpoints de la API"
15
16# Exportar una sesión completa
17opencode export session-id-123 > sesion.json

1# Iniciar servidor HTTP
2opencode serve --port 3456
3
4# Abrir interfaz web
5opencode web
6
7# Conectarse a un servidor remoto
8opencode attach http://mi-servidor:3456

1// src/services/user.service.ts — ANTES (con problemas)
2export class UserService {
3  async getUser(id: string) {
4    const user = await db.query('SELECT * FROM users WHERE id = $1', [id]);
5    return user.rows[0];
6  }
7
8  async createUser(data: any) {
9    const result = await db.query(
10      'INSERT INTO users (name, email) VALUES ($1, $2) RETURNING *',
11      [data.name, data.email]
12    );
13    return result.rows[0];
14  }
15}

1> @src/services/user.service.ts Refactoriza este servicio:
2> 1. Agrega validación de entrada con Zod
3> 2. Manejo de errores apropiado con custom exceptions
4> 3. Tipado estricto en vez de "any"

1# 1. Instala Ollama (si no lo tienes)
2curl -fsSL https://ollama.com/install.sh | sh
3
4# 2. Descarga un modelo de código
5ollama pull qwen2.5-coder:14b
6
7# 3. Configura OpenCode para usar Ollama
8# En opencode.json:
9{
10  "provider": {
11    "ollama": {
12      "options": {
13        "baseURL": "http://localhost:11434/v1"
14      }
15    }
16  },
17  "model": "ollama/qwen2.5-coder:14b"
18}

1# 4. Inicia OpenCode — todo corre local
2opencode

1# Gestión de autenticación
2opencode auth login          # Agregar API key de un proveedor
3opencode auth list           # Ver proveedores configurados
4opencode auth logout         # Eliminar credenciales
5
6# Modelos
7opencode models              # Listar modelos disponibles
8opencode models anthropic    # Filtrar por proveedor
9opencode models --verbose    # Ver costos y metadata
10
11# Sesiones
12opencode session list        # Ver todas las sesiones
13opencode session list -n 5   # Últimas 5 sesiones
14
15# MCP (Model Context Protocol)
16opencode mcp add my-server   # Agregar servidor MCP
17opencode mcp list            # Ver servidores conectados
18
19# Agentes personalizados
20opencode agent create        # Crear un agente personalizado
21opencode agent list          # Ver agentes disponibles
22
23# Estadísticas de uso
24opencode stats               # Tokens usados y costos
25opencode stats --days 7      # Últimos 7 días
26opencode stats --models      # Desglose por modelo
27
28# Actualización
29opencode upgrade             # Actualizar a la última versión

1# AGENTS.md
2
3## Convenciones del proyecto
4- Usamos TypeScript estricto con ESLint + Prettier
5- Los servicios van en src/services/ con el sufijo .service.ts
6- Los tests van junto al archivo con el sufijo .spec.ts
7- Usamos Zod para validación de entrada
8
9## Stack
10- Runtime: Node.js 22
11- Framework: Express.js
12- ORM: Drizzle
13- DB: PostgreSQL
14- Testing: Vitest
15
16## Reglas
17- Nunca uses "any" — siempre usa tipos explícitos
18- Los errores se manejan con custom exceptions, no con try/catch genérico
19- Cada PR debe incluir tests

1# Dentro de la TUI de OpenCode
2/init