Instalación y uso de OpenCode en Linux

OpenCode es un agente de código para terminal de código abierto que, a diferencia de otras herramientas atadas a un único proveedor, se puede configurar para usar Anthropic, OpenAI, Gemini, modelos vía OpenRouter o, lo más interesante para un flujo totalmente local, un modelo servido desde LM Studio u Ollama a través de su API compatible con OpenAI.

Agente de código libre y multi-proveedor: valoración y limitaciones

A favor:

  • Open source: código auditable, sin caja negra sobre qué hace exactamente el agente con nuestro repositorio.
  • Independiente del proveedor: se puede combinar con el modelo que convenga en cada momento, incluido uno local, sin cambiar de herramienta.
  • Cierra el círculo 100% local: con LM Studio sirviendo el modelo y OpenCode como agente por delante, no sale un solo token hacia internet.

Limitaciones:

  • Calidad dependiente del modelo conectado: con un modelo local pequeño el resultado queda por debajo de usar un agente con su modelo propio de frontera.
  • Más configuración manual: hay que declarar proveedores y modelos a mano en el archivo de configuración, frente a herramientas que vienen listas para usar con una sola cuenta.
  • Autonomía = riesgo, como en cualquier agente con acceso a shell: conviene revisar el diff antes de aceptar cambios.

Instalación en Linux

Se instala con un script propio o vía npm:

curl -fsSL https://opencode.ai/install | bash
# o bien:
npm install -g opencode-ai

opencode --version

Configuración de proveedores

La configuración vive en ~/.config/opencode/opencode.jsonc, donde se declaran los proveedores y modelos disponibles. Un ejemplo mínimo para apuntar a un servidor local de LM Studio sería:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lmstudio": {
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "http://localhost:1234/v1" },
      "models": { "modelo-cargado": {} }
    }
  }
}

Uso básico

Se arranca dentro del proyecto:

cd mi-proyecto
opencode

Conclusión

OpenCode es la pieza que faltaba para cerrar el círculo «100% local» de agentes de código: libertad total de proveedor, incluido un modelo propio servido en la misma máquina. A cambio de esa libertad, exige más configuración manual y la calidad del resultado depende directamente del modelo que se le conecte.

Referencias