Blog - Jorge Rodriguez Flores
← Volver al blog

OpenCode: El Agente de Coding Open Source que Desafía a Claude Code y Cursor

opencode ia terminal coding llm herramientas
Compartir: X / Twitter LinkedIn
OpenCode: El Agente de Coding Open Source que Desafía a Claude Code y Cursor

El ecosistema de herramientas de programación asistidas por IA se ha llenado de opciones propietarias y costosas. OpenCode, desarrollado por el equipo detrás de SST (Serverless Stack), llega a cambiar esa ecuación: un agente de coding completamente open source, orientado a la terminal, que soporta más de 75 proveedores de IA, funciona con modelos locales y ofrece modelos gratuitos sin necesidad de API key. Con más de 129.000 estrellas en GitHub y 825 contribuidores, no es un proyecto menor.

¿Qué es OpenCode?

OpenCode es un agente de programación open source para la terminal que permite escribir, depurar y refactorizar código usando lenguaje natural, sin salir de la línea de comandos. Está licenciado bajo MIT y su código fuente está disponible en github.com/sst/opencode.

A diferencia de herramientas como Claude Code (vinculado exclusivamente a Anthropic) o Cursor (un fork de VS Code), OpenCode adopta una arquitectura cliente/servidor flexible que le permite conectarse con prácticamente cualquier proveedor de IA: desde los grandes modelos en la nube hasta modelos locales vía Ollama o LM Studio.

El proyecto también ofrece una aplicación de escritorio (beta), una interfaz web y una extensión para VS Code, pero su corazón es la TUI (Terminal User Interface) construida con Bubble Tea.

Instalación

OpenCode se puede instalar de varias formas según el sistema operativo:

# Instalador universal (recomendado)
curl -fsSL https://opencode.ai/install | bash

# npm
npm install -g opencode-ai

# macOS con Homebrew
brew install opencode

# Arch Linux
sudo pacman -S opencode

# Windows con Chocolatey
choco install opencode

# Docker
docker run -it --rm -v $(pwd):/app anomalyco/opencode:latest

Después de instalar, si el binario no está en el PATH, agrega la siguiente línea a tu ~/.bashrc o ~/.zshrc:

export PATH="$HOME/.opencode/bin:$PATH"

Primeros Pasos y Comandos Principales

Para iniciar la TUI interactiva en el directorio de tu proyecto:

# Lanzar en el directorio actual
opencode

# Continuar la última sesión
opencode -c

# Continuar una sesión específica
opencode -s <session-id>

# Especificar modelo al iniciar
opencode -m anthropic/claude-sonnet-4-20250514

OpenCode también soporta un modo no interactivo ideal para scripts y pipelines de CI/CD:

# Ejecutar una instrucción directamente
opencode run "Corrige el bug en main.go"

# Pasar contexto desde stdin
git diff | opencode run "Analiza estos cambios y sugiere mejoras"

# Revisión de seguridad automatizada
opencode run "Revisa este código en busca de vulnerabilidades"

Otros comandos útiles de la CLI:

opencode models      # Lista los modelos disponibles
opencode stats       # Muestra uso de tokens y costos
opencode serve       # Inicia un servidor headless
opencode web         # Inicia servidor con UI web en localhost:3000
opencode upgrade     # Actualiza a la última versión
opencode mcp         # Gestiona servidores MCP

Agentes y Comandos Slash dentro de la TUI

Dentro de la interfaz interactiva, OpenCode ofrece tres agentes integrados que se pueden alternar con la tecla Tab:

  • build — agente con acceso completo: lee, escribe y ejecuta comandos. Es el agente por defecto para desarrollo.
  • plan — agente de solo lectura para análisis y exploración sin modificar archivos.
  • general — agente para búsquedas complejas en múltiples pasos, invocable con @general.

Los comandos slash más importantes dentro de la TUI:

  • /init — analiza el proyecto y crea un archivo AGENTS.md con instrucciones personalizadas
  • /connect — configura las API keys de los proveedores
  • /models — cambia el modelo de IA en uso
  • /undo y /redo — revierte o restaura cambios realizados por el agente
  • /share — genera un enlace compartible de la conversación
  • /compact — comprime la ventana de contexto cuando se acerca al límite
  • @archivo — referencia un archivo del proyecto con búsqueda difusa

Soporte de Proveedores y Modelos

Una de las mayores fortalezas de OpenCode es su soporte para más de 75 proveedores de IA. Entre los principales:

  • Anthropic — Claude Sonnet, Claude Opus (via API key o autenticación por navegador)
  • OpenAI — GPT-4o, GPT-5 y variantes
  • Google — Gemini via Vertex AI
  • Amazon Bedrock — con credenciales AWS
  • xAI (Grok), DeepSeek, Groq, Together AI
  • OpenRouter — gateway a decenas de modelos adicionales
  • Ollama y LM Studio — para modelos completamente locales

OpenCode también ofrece modelos gratuitos sin API key a través de su plataforma OpenCode Zen, lo que lo hace accesible sin costo alguno para empezar:

# Modelos gratuitos disponibles sin configuración
# opencode/big-pickle
# gpt-5-nano
# mimo-v2-omni-free
# nemotron-3-super-free

Configuración

OpenCode usa archivos JSON o JSONC para su configuración. La precedencia (de mayor a menor) es: configuración remota de la organización → configuración global del usuario → variable de entorno → configuración del proyecto.

Archivo de configuración global en ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "providers": {
    "anthropic": { "apiKey": "{env:ANTHROPIC_API_KEY}" },
    "openai": { "apiKey": "{env:OPENAI_API_KEY}" }
  },
  "theme": "opencode",
  "instructions": ["AGENTS.md", "docs/"]
}

Para configurar Ollama (modelos locales), OpenCode lo detecta automáticamente si está corriendo. Para un endpoint OpenAI-compatible personalizado:

{
  "providers": {
    "mi-servidor": {
      "name": "Mi Servidor Local",
      "baseURL": "http://localhost:8080/v1",
      "apiKey": "dummy"
    }
  }
}

El archivo AGENTS.md en la raíz del proyecto actúa como instrucciones persistentes para el agente — similar al CLAUDE.md de Claude Code — y se aplica automáticamente en cada sesión.

Integración con LSP y MCP

OpenCode se conecta con servidores LSP (Language Server Protocol) para obtener diagnósticos en tiempo real, verificación de tipos, definiciones y referencias en más de 40 lenguajes. Esto significa que el agente no solo edita texto: entiende la semántica del código igual que tu IDE.

También soporta MCP (Model Context Protocol), lo que permite extender sus capacidades con herramientas externas. Para configurar un servidor MCP en el proyecto:

{
  "mcp": {
    "postgres": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-postgres"],
      "environment": {
        "POSTGRES_URL": "{env:DATABASE_URL}"
      }
    }
  }
}

OpenCode vs Claude Code vs Cursor

¿Cuándo elegir cada herramienta? Aquí un resumen comparativo:

  • OpenCode — para desarrolladores que valoran el open source, la privacidad y la flexibilidad de modelos. Ideal si quieres evitar el vendor lock-in, usar modelos locales o aprovechar modelos gratuitos sin API key.
  • Claude Code — para quienes ya usan Claude y quieren la mejor integración con el ecosistema de Anthropic. Excelente razonamiento y flujos de trabajo agénticos avanzados, pero solo funciona con modelos de Anthropic.
  • Cursor — para quienes prefieren un IDE visual completo basado en VS Code, con autocompletado inline y curva de aprendizaje más baja para usuarios no familiarizados con la terminal.

OpenCode representa una apuesta clara por la apertura y la flexibilidad en un mercado dominado por soluciones propietarias. Su soporte para modelos locales lo hace especialmente relevante en entornos donde la privacidad del código es crítica. Con su comunidad activa de más de 825 contribuidores y el respaldo del equipo de SST, es una herramienta que merece un lugar en el toolkit de cualquier desarrollador moderno.

Artículos relacionados