Portada de OpenCode Distilled: Tu modelo. Tus reglas. Tu arnés.

OpenCode Distilled

Tu modelo. Tus reglas. Tu arnés.

De cero en OpenCode a experto en su arnés. Para ingenieros de software.

Camilo Bernal · Prólogo: Claude (Anthropic) (IA)

Sinopsis de OpenCode Distilled: Tu modelo. Tus reglas. Tu arnés.

OpenCode Distilled recorre OpenCode de punta a punta: fundamentos de IA para ingenieros, instalación y la TUI, la arquitectura del servidor y el bucle agéntico, y el diseño del arnés (guardrails, AGENTS.md, comandos, skills, subagentes, plugins y MCP).

También cubre Spec-Driven Development, operación y observabilidad, trabajo en paralelo, modelo de amenazas, seguridad y calidad del código generado, un proyecto real con recetas, ingeniería agéntica avanzada y OpenCode como plataforma.

  • OpenCode
  • Agentes de código
  • AGENTS.md
  • MCP
  • Spec-Driven Development
  • Seguridad

Lo que aprenderás

  • Instalar OpenCode y dominar su interfaz de terminal.
  • Entender la arquitectura del servidor y el bucle agéntico.
  • Diseñar un arnés con guardrails, AGENTS.md, comandos, skills y subagentes.
  • Integrar herramientas externas mediante MCP y plugins.
  • Aplicar Spec-Driven Development con agentes de código.
  • Modelar amenazas y controlar la calidad del código generado.

Contenido

  1. Prólogo, cómo leer este libro y mapa de ruta

    Cómo está organizado el libro y por dónde empezar según tu nivel.

  2. Parte I · Fundamentos

    Conceptos de IA para ingenieros; anatomía de un agente de IA; OpenCode en el ecosistema; licencia, costos y modelo de negocio.

  3. Parte II · Preparación

    Requisitos del entorno; instalación y configuración inicial; la TUI a fondo; primera sesión y trabajo con intervención humana.

  4. Parte III · Por dentro

    Arquitectura del servidor; el bucle agéntico completo; ventana de contexto y caché de prompts; modelos y proveedores; API, eventos, resiliencia y concurrencia.

  5. Parte IV · Diseñar el arnés

    Ingeniería de arnés y guardrails; instrucciones y front matter; AGENTS.md; comandos personalizados; skills; agentes y subagentes; plugins y hooks; MCP; criterios para elegir cada pieza.

  6. Parte V · Spec-Driven Development

    Fundamentos del Spec-Driven Development; SDD con GitHub Spec Kit y con piezas nativas.

  7. Parte VI · Operar

    Planificación antes de tocar código; observabilidad; varios proyectos y repositorios; trabajo en paralelo, integración y conflictos.

  8. Parte VII · Seguridad y calidad

    Modelo de amenazas; configuración segura y guardrails operativos; seguridad y calidad del código generado; datos, entrenamiento y telemetría; propiedad intelectual y cumplimiento.

  9. Parte VIII · Proyecto real

    El scaffold ideal del arnés; portabilidad entre máquinas; recetas.

  10. Parte IX · Ingeniería agéntica avanzada

    Evaluación del arnés con evidencia; patrones de orquestación; contratos, salida estructurada y memoria; autonomía de larga duración; modos de fallo y economía multiagente.

  11. Parte X · OpenCode como plataforma

    SDK, cliente y API; RPC de plugins; Console y gobierno de costos; servidores MCP y conocimiento interno; interoperabilidad y migración entre agentes.

  12. Parte XI · Maestría

    Prácticas de alto impacto; antipatrones y hoja de ruta de adopción; caso de estudio de principio a fin.

  13. Epílogo, hoja de referencia y apéndices

    Tu primer mes con OpenCode; comandos nativos y CLI; plantillas, glosario, fuentes y respuestas comentadas.

A quién va dirigido

Ingenieros de software, arquitectos y líderes técnicos que quieren trabajar con agentes de código con criterio. · Nivel intermedio

  • Experiencia desarrollando software
  • Comodidad con la terminal y Git

Licencia: CC BY-SA 4.0

Creative Commons Atribución-CompartirIgual 4.0 Internacional

Puedes compartir la obra siguiendo las condiciones de la licencia.

  • Leer en línea: permitido
  • Descargar: permitido
  • Compartir y redistribuir: permitido
  • Adaptar y crear obras derivadas: permitido
  • Uso comercial: permitido

Condiciones

  • Debes dar crédito al autor, enlazar la licencia e indicar si hiciste cambios.
  • Si adaptas la obra, debes distribuir tus adaptaciones bajo la misma licencia.

Los fragmentos de código y las plantillas se ofrecen además bajo licencia MIT, sin garantía.

Leer el texto legal

Transparencia sobre IA: Asistido por IA

El autor concibe, estructura y decide; la IA apoya en investigación, borradores parciales o edición, con revisión humana total.

Dónde intervino la IA
Investigación · Estructura · Redacción · Revisión · Ejemplos de código · Edición · Ilustración
Herramientas declaradas
Claude (Anthropic), ChatGpt (OpenAI)
Revisión humana
Sí, revisada por el autor.
Construido con apoyo de IA (Claude, de Anthropic) para la investigación documental, la estructuración, la redacción asistida y la revisión pedagógica, y revisado por el autor mediante un ciclo de auditoría humana. La autoría, la dirección editorial, el criterio técnico y la responsabilidad sobre el contenido son de Camilo Bernal. El prólogo está firmado por Claude, a invitación expresa del autor.
— Camilo Bernal
¿Qué significan estas etiquetas?
Historial de versiones(mostrar)
  1. v2.3.0 · 2026-10-14

    Edición 2.3. Versión de referencia: OpenCode 2.0.25.

Preguntas frecuentes

¿Para quién es OpenCode Distilled?
Para ingenieros de software, arquitectos y líderes técnicos con experiencia en desarrollo y comodidad con la terminal y Git que quieren trabajar con agentes de código con criterio.
¿Es gratuito y puedo compartirlo?
Sí. Se publica bajo Creative Commons Atribución-CompartirIgual 4.0: puedes leerlo, descargarlo, compartirlo y adaptarlo citando al autor y manteniendo la misma licencia.
¿Se escribió con inteligencia artificial?
Fue asistido por IA (Claude, de Anthropic) en investigación, estructura, redacción y revisión, con revisión humana completa. La autoría y la responsabilidad del contenido son de Camilo Bernal.
¿Qué versión de OpenCode cubre el libro?
La edición 2.3 toma como referencia OpenCode 2.0.25, publicada el 8 de octubre de 2026. Verifica la versión que usas antes de aplicar cada receta.
¿Puedo usar el código del libro en proyectos privados?
Sí. Los fragmentos de código y las plantillas se ofrecen además bajo licencia MIT, sin garantía, por lo que puedes usarlos en proyectos privativos sin compartir tus cambios.

Cómo atribuir esta obra

Si compartes o adaptas este libro, copia este texto. Incluye el enlace a la ficha original.

«OpenCode Distilled: Tu modelo. Tus reglas. Tu arnés.» de Camilo Bernal, publicado en https://www.camilobernal.dev/ebooks/opencode-distilled bajo Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0): https://creativecommons.org/licenses/by-sa/4.0/deed.es. Si adaptas la obra, indica los cambios y compártela bajo la misma licencia.

Cómo citar

APA

Bernal, C. (2026). OpenCode Distilled: Tu modelo. Tus reglas. Tu arnés. (2.ª edición (v2.3)). Camilo Bernal. https://www.camilobernal.dev/ebooks/opencode-distilled

BibTeX

@book{bernal2026opencodedistilled, author = {Camilo Bernal}, title = {OpenCode Distilled}, subtitle = {Tu modelo. Tus reglas. Tu arnés.}, year = {2026}, edition = {2.ª edición (v2.3)}, publisher = {Camilo Bernal}, language = {es}, url = {https://www.camilobernal.dev/ebooks/opencode-distilled}, note = {CC BY-SA 4.0; v2.3.0}, }

Sobre el autor

Camilo Bernal. Arquitecto de Soluciones con más de 23 años diseñando productos, plataformas y decisiones de tecnología alineadas con el negocio.

Otros libros

¿Qué significan estas etiquetas?

Cada libro declara cuánta participación de IA tuvo. El nivel lo declara el autor; no se infiere. Siempre se indica con texto, y en las obras con IA hay revisión humana.

100 % humano
Sin IA generativa en el contenido. Las herramientas de corrección ortográfica no cuentan.
Asistido por IA
El autor concibe, estructura y decide; la IA apoya en investigación, borradores parciales o edición, con revisión humana total.
Co-creado con IA
Partes sustanciales del texto fueron generadas por IA y curadas y editadas por el autor.