# OpenCode Distilled: Tu modelo. Tus reglas. Tu arnés. > De cero en OpenCode a experto en su arnés. Para ingenieros de software. - **Autor:** [Camilo Bernal](https://www.camilobernal.dev) - **Prólogo:** Claude (Anthropic) (IA) - **Sello:** Camilo Bernal - **Edición:** 2.ª edición (v2.3) (versión 2.3.0) - **Publicado:** 14 de octubre de 2026 · **Actualizado:** 14 de octubre de 2026 - **Idioma:** Español - **Páginas:** 286 - **Nivel:** Intermedio. Ingenieros de software, arquitectos y líderes técnicos que quieren trabajar con agentes de código con criterio. - **Licencia:** Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0): https://creativecommons.org/licenses/by-sa/4.0/deed.es - **Acceso:** Gratis - **Ficha:** https://www.camilobernal.dev/ebooks/opencode-distilled - **PDF:** https://cdn.camilobernal.dev/ebooks/Camilo_Bernal_OpenCode_Distilled_v2.3.pdf (7,4 MB) ## Sinopsis 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. ## 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. ## 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. ## Licencia 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 - 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. **Cómo atribuir esta obra:** > «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. ## 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í > 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. ## 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: ```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}, } ``` ## Temas OpenCode · Agentes de código · AGENTS.md · MCP · Spec-Driven Development · Seguridad --- Versión HTML: https://www.camilobernal.dev/ebooks/opencode-distilled Descripción corta: Guía práctica de OpenCode para ingenieros: arnés, AGENTS.md, skills, subagentes, MCP, seguridad y Spec-Driven Development. Gratis, CC BY-SA 4.0. Título SEO: OpenCode Distilled: agentes de código para ingenieros