Un agente de programación en la terminal que no cuesta nada parece una decisión fácil. La trampa está en los detalles: qué modelo es realmente gratuito, durante cuánto tiempo, qué pasa con tu código y si la guía que copias coincide con la documentación actual. OpenCode con DeepSeek V4.1 Flash Free es un buen ejemplo de por qué esos detalles importan.
Qué es OpenCode y qué no es
Un agente de programación es un programa que recibe una petición en lenguaje normal, lee los archivos de tu proyecto, escribe o modifica código y puede ejecutar comandos para comprobar el resultado. OpenCode se presenta como un agente de programación de código abierto que funciona como interfaz de terminal, aplicación de escritorio o aplicación web. La terminal es la ventana de texto donde escribes comandos en lugar de hacer clic.
La forma de trabajar se parece a Claude Code: describes una tarea, el agente planifica, edita archivos y te informa. Pero OpenCode es un proyecto independiente de otro equipo. No es Claude Code con otro nombre y no usa modelos de Anthropic salvo que tú los conectes. Lo que toma prestado es la idea y, como verás, parte de la estructura de carpetas.
¿De verdad DeepSeek V4.1 Flash es gratis en OpenCode?
Sí, pero solo una entrada concreta. La lista de modelos de OpenCode incluye dos opciones de DeepSeek casi idénticas. «DeepSeek V4.1 Flash» es de pago: 0,30 dólares por millón de tokens de entrada y 1,20 dólares por millón de tokens de salida. Un token es un fragmento pequeño de texto, más o menos una parte de una palabra. «DeepSeek V4.1 Flash Free», con el identificador deepseek-v4.1-flash-free, figura como gratuito para entrada, salida y lecturas en caché.
La documentación añade tres condiciones. La entrada gratuita está disponible solo por tiempo limitado. Su proveedor sigue una política de retención cero, es decir, no guarda los datos, y no los usa para entrenar modelos. Y los modelos de chat gratuitos solo funcionan dentro del cliente de OpenCode, no mediante una API directa ni con otra herramienta. La página no da límites de uso numéricos.
Pequeño detalle, gran diferencia. Si eliges la entrada que no lleva «Free» en el nombre, estás pagando por uso. Además, la lista gratuita no es uniforme: en otros modelos gratuitos de la misma lista se indica que los datos recogidos pueden usarse para mejorar el modelo. Si tu proyecto contiene código de clientes o algo confidencial, merece la pena leer esa línea antes del primer prompt. Si prefieres no ver los modelos gratuitos, puedes ocultarlos con la variable de entorno OPENCODE_DISABLE_FREE_MODELS=1.
Qué es DeepSeek V4.1 Flash
DeepSeek lanzó V4.1-Flash el 10 de septiembre de 2026. Su nombre en la API es deepseek-flash. DeepSeek lo describe como el modelo más pequeño de su nueva familia de arquitectura, con comprensión visual nativa. Es un modelo de mezcla de expertos, en el que solo una parte de la red trabaja en cada petición: 552.000 millones de parámetros en total, de los que 8.000 millones están activos para la entrada y 16.000 millones para la salida. Según DeepSeek, su caché de trabajo necesita una cuarta parte de la memoria que requería la generación anterior.
DeepSeek afirma que supera en pruebas de rendimiento a su anterior modelo insignia, V4-Pro, y ya redirige las peticiones de V4-Pro a V4.1-Flash. Son cifras del fabricante. Te dicen dónde mirar, no cómo se comportará el modelo con tu código.
Cómo instalar OpenCode y elegir el modelo gratuito
La documentación oficial recoge varios métodos de instalación. Con el script: curl -fsSL https://opencode.ai/v2/install | bash. Si ya usas Node.js, también sirve npm install -g @opencode/cli, y aparecen Homebrew, Bun, pnpm y otros gestores de paquetes.
Un orden sensato sería este. Primero, crea una carpeta para el proyecto y abre OpenCode dentro de ella, para que el agente solo vea los archivos de esa tarea. Segundo, conecta un proveedor con /connect desde la interfaz. La documentación describe iniciar sesión en OpenCode Console y pegar una clave de API; no aclara si los modelos gratuitos se saltan ese paso, así que cuenta con tener que iniciar sesión. Tercero, ejecuta /models y selecciona DeepSeek V4.1 Flash Free. En un archivo de configuración, el mismo modelo se escribe opencode/deepseek-v4.1-flash-free.
¿Puedes reutilizar tus skills de Claude Code?
En gran parte, sí. Una skill es un archivo de instrucciones en Markdown que el agente carga cuando una tarea encaja con ella. OpenCode busca en sus propias carpetas, ~/.config/opencode/skills y .opencode/skills, y también en las rutas compatibles con Claude, ~/.claude/skills y .claude/skills, además de .agents/skills. Una skill anidada debe llamarse exactamente SKILL.md y estar en su propia carpeta. Lo decisivo es la description del frontmatter, el bloque breve de cabecera al principio del archivo: es lo único que ve el modelo, y una skill sin descripción no se le ofrece.
Eso abarata el cambio, pero no hace que el resultado sea idéntico. Las mismas instrucciones las interpreta otro modelo. Una skill que funciona bien con uno merece una prueba nueva con el otro.
Cómo crear tu propio agente auxiliar
OpenCode permite definir agentes propios como archivos Markdown. Para un proyecto van en .opencode/agents/<nombre>.md; para todos los proyectos, en ~/.config/opencode/agents/. El cuerpo del archivo se convierte en el prompt de sistema del agente, sus instrucciones permanentes. En el frontmatter, description explica su propósito y mode fija su papel: primary funciona como agente principal de una sesión, subagent se ejecuta en una sesión secundaria cuando el agente principal lo llama, y all permite ambas cosas. Con una lista de permissions puedes permitir, pedir confirmación o bloquear acciones concretas.
Un uso típico para empezar es un explicador de errores: un agente que lee el proyecto, describe cada fallo con palabras sencillas y propone una corrección. Antes de que el agente arregle nada, escribe qué debe hacer la página o la herramienta. Después compara el resultado con esa descripción. Código escrito por el agente y código que hace lo que querías no son lo mismo, y solo lo segundo cuenta.
Dónde tiene sentido esta configuración
Para aprender, hacer prototipos o crear pequeñas herramientas internas, un modelo gratuito dentro de un agente de código abierto es una forma de bajo riesgo de comprobar si programar con agentes encaja contigo. Hay dos motivos para la prudencia. «Tiempo limitado» significa que la entrada gratuita puede desaparecer, así que no montes una rutina que dependa de ella. Y los nombres de carpeta cambian entre versiones: la documentación usa ahora las carpetas en plural agents y skills, de modo que guías antiguas con otras rutas pueden no tener ningún efecto sin avisar. ¿Un ajuste parece ignorado? Compara primero tu ruta con la documentación antes de culpar al modelo.
