OpenCode

Qué es OpenCode

Agente open source (sst/opencode) para escribir código en terminal, IDE o desktop. Soporta varios proveedores LLM, skills, MCP y endpoints OpenAI-compatible (incl. local).

Docs: opencode.ai

Orden sugerido

1. Instalación y modelo

Sigue el README oficial (npm, brew, etc.). Configura el proveedor que vayas a usar (API en nube o localhost).

2. Contexto del repo

AGENTS.md en la raíz con build, tests y convenciones — no repitas el mismo bloque en cada chat.

3. Skills

Carpeta de skills según documentación OpenCode. Formato Agent Skills. Guía: ¿Qué es un skill?.

4. MCP

Integración MCP en opencode.ai — añade solo lo que uses. Guía: ¿Qué es un MCP?. Ejemplo: Context7.

5. Modelos locales (ventaja de OpenCode)

OpenCode acepta base URL OpenAI-compatible apuntando a:

• Ollama — http://localhost:11434 (lo más simple para probar)
• vLLM — si ya tienes servidor de inferencia propio

Antes de pull a ciegas: llmfit. Mapa completo: Modelos nube vs locales.

6. Herramientas opcionales

• Headroom — wrap/proxy si el contexto de tools explota.
• no-mistakes — gate en git push (equipos).

Dónde va cada cosa

Pieza	Ubicación
Contexto repo	AGENTS.md
Skills	Según doc OpenCode (proyecto / global)
MCP	Config OpenCode (ver doc)
Modelo local	Base URL en config → Ollama/vLLM

OpenCode vs Claude Code vs Codex

	OpenCode	Claude Code	Codex
Licencia	Open source	Anthropic	OpenAI
Dónde corre	Terminal, IDE, desktop	Terminal, IDE, desktop	Terminal / CLI
Skills	Según doc OpenCode	~/.claude/skills/	~/.agents/skills/
Ollama / local	Sí (habitual)	No típico	No típico

Cuándo elegir OpenCode

• Quieres agente open source sin atarte a un vendor.
• Necesitas Ollama o vLLM con un agente serio en terminal.
• Alternativa a Claude Code / Codex / Gemini CLI.

Errores comunes

• Configurar muchos MCPs antes de tener flujo básico estable.
• No documentar en el repo qué agente y qué endpoint usa el equipo.
• Instalar Ollama + vLLM + Headroom el mismo día sin un problema concreto.