OpenCode agente de código de código abierto: instalar y monitorizar

OpenCode agente de código (MIT): instalación según el README, permisos, aislamiento y seguimiento de logs, tokens y costes por sesión.
OpenCode agent de code open source : installer et superviser

OpenCode agente de código de código abierto: el repositorio anomalyco/opencode se presenta como «el agente de código de IA de código abierto». Es un agente que corre en tu terminal (con una aplicación de escritorio en beta), lee tu repositorio, propone modificaciones y lanza comandos, con el modelo que elijas. Tiene unas 219 900 estrellas en octubre de 2026, lo que lo convierte en uno de los repositorios más seguidos de la serie.

Un agente de código que ejecuta comandos y escribe archivos es un actor más en tu cadena de entrega. Este artículo sigue el README y la documentación del proyecto: qué es, la instalación, qué se ve de la interfaz, los límites de seguridad que describe el propio proyecto y cómo seguir logs, tokens y costes. Para la monitorización en la empresa, consulta monitorizar un agente de código en la empresa.

Una precisión de honestidad: span.observer no ha instalado ni probado OpenCode. Los comandos proceden del README y de la documentación. La primera captura está publicada en el repositorio; las otras dos son extractos de esos documentos, renderizados por nosotros.

OpenCode agente de código de código abierto: qué dice el repositorio

  • Quién: el repositorio pertenece a la organización de GitHub anomalyco. El archivo LICENSE lleva «Copyright (c) 2025 opencode».
  • Licencia: MIT.
  • Cifras consultadas el 22 de octubre de 2026 en la página del repositorio: unas 219 900 estrellas, unos 29 400 forks, 20 722 commits en la rama dev.
  • Versión: por comprobar, consulta más abajo. El CHANGELOG del repositorio describe «OpenCode V2» y su última entrada es la v2.1.2 del 21 de octubre de 2026, mientras que la página de releases mostraba la v1.19.3 del 16 de octubre. El proyecto tiene dos líneas de versiones, V1 y V2, que ya no se instalan en paralelo por defecto.
  • Agentes integrados: build (acceso completo, por defecto) y plan (solo lectura: rechaza las modificaciones de archivos y pide permiso antes de los comandos de shell), que se alternan con la tecla Tab. Un subagente general sirve para las búsquedas complejas.
  • Modelos: el proyecto es independiente de cualquier proveedor; la documentación describe la configuración de proveedores y modelos. La captura de abajo muestra un modelo de Claude y el servicio «OpenCode Zen».

Recorrido por la interfaz

Esta es la captura del terminal publicada en el repositorio (procede de la página de inicio del proyecto y de una versión más antigua). La cabecera de la sesión muestra el número de tokens, el porcentaje de contexto usado y el coste en dólares. Las llamadas a herramientas (Grep, Glob, Read) se enumeran a lo largo de la conversación, y después el agente hace una pregunta antes de modificar nada.

Captura del repositorio OpenCode: terminal con una sesión titulada Homepage button color change in repo workflow, llamadas Grep, Glob y Read enumeradas, un contador de 39 413 tokens, 20 % del contexto y 0,29 dólares, y la barra de atajos
Source : github.com

Este contador es útil para la monitorización: cada sesión expone su coste en tokens en pantalla, incluso antes de conectar una métrica. Los atajos de abajo recuerdan las funciones principales: Esc para interrumpir, Tab para cambiar de agente, Ctrl+T para las variantes de modelo, Ctrl+P para la paleta de comandos.

Instalación según el README

Paso 1: instalar el CLI

El README propone un script y varios gestores de paquetes:

curl -fsSL https://opencode.ai/v2/install | bash
npm i -g @opencode/cli@latest
brew install anomalyco/tap/opencode-v2
brew install opencode
sudo pacman -S opencode
mise use -g opencode
nix run github:anomalyco/opencode

Pasar un script remoto a un shell es una práctica de riesgo: prefiere un gestor de paquetes, o lee el script antes de ejecutarlo. El script respeta el orden $OPENCODE_INSTALL_DIR, $XDG_BIN_DIR, $HOME/bin y, por último, $HOME/.opencode/bin. La guía de migración precisa que una instalación V1 gestionada por un paquete debe retirarse antes de instalar la V2.

Paso 2: la aplicación de escritorio (beta)

El README da los paquetes de macOS (Apple Silicon e Intel), Windows y Linux (.deb, .rpm, .AppImage) y el comando brew install --cask opencode-desktop para macOS.

Paso 3: acotar los permisos

La documentación describe una configuración permission donde cada acción vale allow, ask o deny. Gana la última regla que coincide; por eso se coloca primero la regla general "*". El ejemplo de la página:

Extracto de la documentación de OpenCode: archivo opencode.json con una sección permission donde la regla general vale ask, shell vale allow y edit vale deny

La opción --auto aprueba automáticamente las peticiones que no se rechazan de forma explícita; las reglas deny siguen aplicándose. Resérvala para un entorno aislado.

Seguridad: lo que dice el proyecto de sí mismo

  • El archivo SECURITY.md del repositorio es explícito: OpenCode no pone al agente en un sandbox. El sistema de permisos es una ayuda de atención para el usuario, no un aislamiento. Para un aislamiento real, el proyecto recomienda lanzar la herramienta en un contenedor Docker o en una máquina virtual.
  • El modo servidor (opencode serve, opencode web) es opcional. La documentación pide definir OPENCODE_SERVER_PASSWORD para activar una autenticación HTTP básica; sin contraseña, el servidor corre sin autenticación, con una advertencia.
  • Los datos enviados al proveedor de modelo dependen de sus condiciones; los servidores MCP que configures quedan fuera del perímetro de confianza del proyecto.

Aplica las mismas precauciones que con cualquier agente con privilegios: barreras de seguridad de los agentes de IA en producción y, si conectas servidores MCP, la guía del servidor MCP de GitHub.

Límites y puntos abiertos

  • Dos líneas de versiones: V1 y V2 coexisten. La V2 cambia la API de plugins, los contratos del servidor y la configuración del cliente de terminal; campos experimentales de la V1 (entre ellos openTelemetry) se ignoran, según la guía de migración. Comprueba la versión mostrada antes de seguir un tutorial.
  • Cadencia: más de 20 000 commits; fija la versión en tus puestos de desarrollo.
  • Modelos gratuitos: el CHANGELOG menciona modelos de coste cero y una variable OPENCODE_DISABLE_FREE_MODELS para ocultarlos; comprueba qué se envía a qué proveedor antes de poner en ellos código propietario.
  • El proyecto precisa que no acepta informes de seguridad generados por IA.

Observar OpenCode: logs, tokens, costes

OpenCode es una herramienta local, no un servicio: la monitorización parte del puesto o del contenedor. Estas pistas valen tanto para Dynatrace SaaS como para Dynatrace Managed si recoges los datos mediante un Collector de OpenTelemetry.

  • Logs locales: la página de resolución de problemas indica ~/.local/share/opencode/log/ en macOS y Linux, con archivos fechados de los que se conservan los diez más recientes. opencode --log-level DEBUG detalla la salida, y --print-logs la muestra en el terminal.
  • Tokens y costes: opencode stats muestra el uso en tokens y el coste de las sesiones, con las opciones --days, --tools, --models y --project. Para seguir ese coste en un backend, consulta el coste de un agente de IA en tokens con OpenTelemetry.
  • Exportación de OpenTelemetry (por comprobar): en el código fuente de la rama principal, el módulo packages/util/src/observability.ts lee OTEL_EXPORTER_OTLP_ENDPOINT y OTEL_EXPORTER_OTLP_HEADERS y, si se define un punto de acceso, envía logs a /v1/logs y trazas a /v1/traces. Esta función no aparece en la documentación que hemos leído: pruébala en tu versión antes de fiarte de ella.
  • Auditoría de comandos: la sección permission es también un registro de intenciones; exige ask para shell y edit en los puestos compartidos.
Comandos citados en el README y la documentación de OpenCode: instalación con script, opencode --log-level DEBUG, opencode run --auto y opencode stats

Cómo comprobar que funciona

  1. opencode abre la interfaz en un repositorio de prueba.
  2. Con el agente plan, se rechaza una petición de modificación: es el modo de solo lectura.
  3. Tras una sesión, opencode stats muestra los tokens y el coste.
  4. Aparece un archivo de log fechado en el directorio de logs.

Buenas prácticas

  • Lanza el agente en un contenedor o una máquina virtual para los repositorios sensibles.
  • Empieza con el agente plan y reglas ask, y flexibiliza después si hace falta.
  • Define siempre OPENCODE_SERVER_PASSWORD antes de abrir el modo servidor o web.
  • Mantén las claves de proveedores fuera de los repositorios y de los logs.
  • Sigue el coste por sesión y revisa las desviaciones sin buscar culpables.

Preguntas frecuentes

¿OpenCode es realmente gratuito?

El software tiene licencia MIT. Los modelos tienen un coste según el proveedor elegido, y el CHANGELOG menciona modelos gratuitos cuyos límites cambian; el proyecto no vende los tokens de tus otros proveedores.

¿Mi código va a parar a un tercero?

El contexto enviado va al proveedor de modelo que configures, y SECURITY.md precisa que su tratamiento de los datos depende de él. Elígelo según tu política de datos.

¿OpenCode aísla los comandos que lanza?

No, según SECURITY.md: los permisos no son un sandbox. Usa un contenedor o una máquina virtual.

Conclusión

OpenCode merece su popularidad entre quienes quieren un agente de código de código abierto, con libertad de elección del modelo y configurable por archivo. Hay que adoptarlo con conocimiento de causa: versión V1 o V2 por comprobar, permisos estrictos, aislamiento por contenedor y seguimiento de tokens y logs. Para otro agente de código abierto de la misma serie, consulta OpenClaw. Fuentes: repositorio anomalyco/opencode.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
CLI-Anything logiciels agents : piloter GIMP ou Blender en CLI

CLI-Anything software para agentes: controla GIMP o Blender por CLI

Next Post
wshobson agents marketplace : plugins pour agents de code

Marketplace wshobson agents: plugins para agentes de código

Related Posts