🐉 OpenCode — Agente de Código Open Source

Qué es

OpenCode es un agente de código de IA open source (MIT) que corre en terminal (TUI), escritorio, IDE y web. Trae modelos gratis incluidos y conecta 75+ proveedores —Claude, GPT, Gemini, locales— con tus propias claves o suscripciones.

💻 Repo: anomalyco/opencode · MIT

📊 Tracción: 223.199 ⭐ · 29.947 forks · ~950 contribuidores · 16M devs/mes (cifra de la web)

🏢 Empresa: Anomaly · Docs: opencode.ai/docs/es

🧭 Dos generaciones, dos documentaciones

Esto es lo primero que hay que entender para no mezclar comandos:

	v1 (docs en español)	v2 (nueva generación)
Docs	opencode.ai/docs/es	opencode.ai/v2/docs
Instalación	`curl -fsSL https://opencode.ai/install \| bash`	`curl -fsSL https://opencode.ai/v2/install \| bash`
npm	`npm install -g opencode-ai`	`npm install -g @opencode/cli`
Homebrew	`brew install anomalyco/tap/opencode`	`brew install anomalyco/tap/opencode-v2`
Última release visible	v1.19.5 (2026-10-28)	canal v2 (Docker `:2.0.0`)
Interfaz	TUI · desktop · IDE	TUI · desktop · web

La docs en español va por detrás

/docs/es documenta la v1 y está traducida completa. La v2 tiene su propia documentación en /v2/docs, por ahora en inglés. Si sigues un tutorial en español y un comando no existe, probablemente estás en v2 —o al revés.

📋 Ficha técnica

Campo	Dato
Nombre	OpenCode
Descripción oficial	«The open source AI coding agent»
Licencia	MIT
Repo	anomalyco/opencode
Estrellas / forks	223.199 / 29.947 (API, 2026-10-30)
Creado	2025-04-30
Última release v1	v1.19.5 (2026-10-28)
Proveedores	75+ vía Models.dev + modelos locales
Plataformas	macOS · Linux · Windows (WSL recomendado) · Docker
Precio	100% gratis; los proveedores externos cobran aparte

📦 Instalación

v2 (la que promociona la web)

Instalador oficial v2

curl -fsSL https://opencode.ai/v2/install | bash

Alternativas:

npm install -g @opencode/cli
brew install anomalyco/tap/opencode-v2
paru -S opencode-beta
mise use -g opencode        # requiere mise 2026.10.9+

v1 (la de la docs en español)

Instalador v1

curl -fsSL https://opencode.ai/install | bash
 
npm install -g opencode-ai
brew install anomalyco/tap/opencode
sudo pacman -S opencode      # Arch stable
paru -S opencode-bin         # Arch AUR

Windows

Lo recomendado es WSL. También hay Chocolatey, Scoop, npm, Mise y Docker:

choco install opencode
scoop install opencode
npm install -g opencode-ai
mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode

Los binarios sueltos están en Releases. La v2 no soporta gestores de paquetes de Windows: usa el binario, WSL o Docker.

🚀 Primer arranque

De cero a primer cambio

cd /ruta/al/proyecto
opencode
 
# Dentro de la TUI:
/connect        # elegir proveedor y pegar API key
/init           # analiza el proyecto y crea AGENTS.md
/models         # cambiar de modelo

/init crea un AGENTS.md en la raíz. Versiónalo en Git: es lo que le enseña a OpenCode la estructura y los patrones del proyecto.

Lo básico de la TUI

Acción	Cómo
Buscar archivos	`@` + nombre (búsqueda aproximada)
Modo Plan	`Tab` — propone, no toca archivos
Volver a Build	`Tab` otra vez
Adjuntar imagen	Arrastrarla a la terminal
Deshacer	`/undo` (varias veces)
Rehacer	`/redo`
Cambiar agente	`Tab` o el keybind `switch_agent`
Invocar subagente	`@general`, `@explore`, `@scout`

Consejo del propio docs: háblale como a un dev junior del equipo. Da contexto, ejemplos y el resultado esperado; no solo la orden.

🤖 Agentes

OpenCode trae 2 primarios y 3 subagentes:

Agente	Tipo	Para qué
Build	primario (default)	Trabajo completo, todas las herramientas
Plan	primario	Analizar y planificar; `edit` y `bash` en `ask`
General	subagente	Investigación compleja y tareas multi-paso; puede editar
Explore	subagente	Explorar código, solo lectura
Scout	subagente	Docs externas y dependencias, solo lectura
Compactación / Título / Resumen	ocultos	Mantenimiento interno de la sesión

Crear uno propio

En Markdown (.opencode/agents/ o ~/.config/opencode/agents/):

---
description: Revisa código sin editarlo
mode: subagent
model: anthropic/claude-sonnet-5-5
temperature: 0.1
tools:
  write: false
  edit: false
permission:
  bash:
    "*": ask
    "git diff": allow
---
 
Eres un revisor. Señala bugs, seguridad y rendimiento. No edites.

El nombre del archivo es el nombre del agente. También se puede configurar en opencode.json bajo "agent".

Opciones clave: description (obligatoria) · mode (primary/subagent/all) · model · temperature · steps (límite de iteraciones; maxSteps está deprecado) · prompt · tools · permission · hidden · color · top_p. Cualquier opción extra se pasa al proveedor.

Ver agentes cargados
opencode agent list

🧠 Modelos y proveedores

OpenCode usa el AI SDK y Models.dev para soportar 75+ proveedores y modelos locales.

Modelos gratis incluidos: puedes empezar sin cuenta.
Tus suscripciones: ChatGPT Plus/Pro y GitHub Copilot se pueden usar.
OpenCode Zen: modelos seleccionados y probados por el equipo.
OpenCode Go: plan de $10/mes con acceso a los mejores modelos de código (v2).

Elegir modelo

/models
opencode models                 # lista por CLI
opencode --model anthropic/claude-sonnet-5-5

Formato del ID: provider/model-id (ej. opencode/gpt-6.1-sol).

Modelos recomendados por el docs (v1): GPT 5.2 · GPT 5.1 Codex · Claude Opus 4.5 · Claude Sonnet 4.5 · Minimax M2.1 · Gemini 3 Pro. La lista no es exhaustiva ni permanente.

Variantes: Anthropic trae high/max; OpenAI none→xhigh; Google low/high. Se cambian con variant_cycle o se definen a mano en opencode.json.

Prioridad al cargar: --model → model del config → último usado → prioridad interna.

🔐 Permisos

Cada regla se resuelve en allow, ask o deny. Se pueden escribir globales o por herramienta:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "bash": {
      "*": "ask",
      "git *": "allow",
      "rm *": "deny",
      "grep *": "allow"
    },
    "edit": {
      "*": "deny",
      "packages/web/src/content/docs/*.mdx": "allow"
    },
    "external_directory": {
      "~/projects/personal/**": "allow"
    }
  }
}

Regla de oro: coincidencia por comodines (*, ?) y la última regla que coincide gana. Pon lo general primero y lo específico después.

Permiso	Qué controla
`read` / `edit`	Leer y modificar archivos
`glob` / `grep`	Buscar archivos y contenido
`bash`	Comandos de shell
`task`	Invocar subagentes
`skill`	Cargar skills
`webfetch` / `websearch`	Red
`external_directory`	Rutas fuera del proyecto
`doom_loop`	Misma llamada 3 veces con input idéntico

Defaults: la mayoría en allow; doom_loop y external_directory en ask. Los .env están denegados por defecto (*.env, *.env.*), salvo .env.example.

Cuando pregunta: once (esta vez) · always (patrones sugeridos por el resto de la sesión) · reject.

🧩 Skills: compatibilidad con esta bóveda

OpenCode descubre SKILL.md en:

.opencode/skills/<name>/SKILL.md (proyecto)
~/.config/opencode/skills/<name>/SKILL.md (global)
.claude/skills/ y ~/.claude/skills/ (compatibilidad Claude)
.agents/skills/ y ~/.agents/skills/ (compatibilidad agentes)

Esto conecta directo con Ryukami Labs

Tus skills de la bóveda viven en .agents/skills/ (vault-ingest, vault-query, obsidian-scorch-design). OpenCode las lee desde ahí sin copiarlas. Igual pasa con las 23 skills de Scorch si las dejas en .agents/skills/.

El frontmatter que espera OpenCode es mínimo: name y description (1–1024 caracteres). license, compatibility y metadata son opcionales.

Nombre válido: ^[a-z0-9]+(-[a-z0-9]+)*$, 1–64 caracteres, igual al nombre de la carpeta.

Permisos de skills:

{
  "permission": {
    "skill": {
      "*": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

🛠️ Ecosistema

Pieza	Para qué
MCP servers	Conectar herramientas y datos externos
Plugins	Extender OpenCode
SDK	Automatizar desde código
Server	Modo servidor / integraciones
LSP	Diagnósticos y navegación de código
Formatters	Formateo automático al editar
Commands	Comandos slash propios
Themes / Keybinds	Apariencia y atajos
ACP	Integración con editores
Custom tools	Herramientas propias
GitHub / GitLab	Integración con la plataforma

Docs: MCP · Plugins · SDK · CLI · Config

🛡️ Privacidad

OpenCode no almacena tu código ni el contexto para operar en entornos sensibles.
Tus datos solo se guardan cuando usas los modelos gratis de OpenCode.
Con proveedores externos, las claves y el consumo van por tu cuenta.
Los modelos locales se ejecutan en tu máquina.

🐉 Mi lectura

Por qué está en esta bóveda

No es «otro chat de código»: es la pieza que hace que tus skills, agentes y permisos vivan en archivos del proyecto. Eso encaja con la filosofía de Ryukami Labs —texto plano, Git y cero cajas negras— y con el hecho de que esta bóveda ya usa .agents/skills/.

Lo que vigilaría: la división v1/v2. La docs en español es excelente, pero es v1; si instalas v2 y sigues un tutorial viejo, vas a pelear con comandos que ya no existen. Fija la versión en tus notas y en tus scripts.

🔗 Enlaces

⚔️ OpenCode 2.0 vs Antigravity CLI — comparativa y sinergia entre ambos.
🧠 Catálogo de Modelos Gratuitos y APIs 2026 — qué modelo conectar.
🛰️ Antigravity CLI — la otra mitad del stack.
🧠 Claude Code Best Practices — agentes, skills y hooks.
⚡ Scorch Ryukami Skills — las skills que OpenCode puede leer desde .agents/skills/.
Docs: Introducción ES · v2 · Agentes · Modelos · Permisos · Skills

⚡ Ryukami Labs

Explorador

🐉 OpenCode — Agente de Código Open Source (Guía y Docs en Español)

🐉 OpenCode — Agente de Código Open Source

🧭 Dos generaciones, dos documentaciones

📋 Ficha técnica

📦 Instalación

v2 (la que promociona la web)

v1 (la de la docs en español)

Windows

🚀 Primer arranque

Lo básico de la TUI

🤖 Agentes

Crear uno propio

🧠 Modelos y proveedores

🔐 Permisos

🧩 Skills: compatibilidad con esta bóveda

🛠️ Ecosistema

🛡️ Privacidad

🐉 Mi lectura

🔗 Enlaces

Vista Gráfica

Tabla de Contenidos

Retroenlaces