OpenCode (agente de codificación)

A 2026-03, el mejor conjunto de configuración para mis necesidades de codificación parece ser

Consulta mi investigación en asistentes y frameworks de agente de codificación.

Seleccione Global (scope:dev-user, todos los proyectos), Perfil:Completo.

Evolución/Actualizaciones:

Modelos de lenguaje: opencode modelos --refresh
OpenCode: opencode actualizar
OpenAgentsControl: curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/update.sh | bash actualizará los agentes de OAC en ~/.config/opencode/agen, y luego /init los leerá. Alternativamente, /plugin instalar oac y /oac:setup --core.

Apéndices#

Todo esto acabará siendo reunido como un script de shell/incat/docker creando un entorno de desarrollo estándar y alimentando las reglas y herramientas de la empresa/grupo, por lo que puede compartirse entre compañeros de equipo o contribuyentes de código abierto.

Docker#

Llámame paranoico, pero mi primer intento fue la implementación dockerizada oficial de OpenCode según la documentación de OpenCode. Necesita hacer malabares con permisos entre host y contenedor, pero asegura el control mientras se siente familiar ... y fácil, hasta que ya no fue.

El actual instalador de bash para OpenAgentControl me parece bien. La configuración en contenedor es útil para reforzar la seguridad. Pero el contenedor oficial es un Debian sin bash (necesario para el instalador de OpenAgentControl), curl, nano, apt o dpkg. Esto es adecuado para otros fines pero no para los míos.

Incus cli-dev-work#

Usaremos incus, entonces. Tengo cli-dev-work como contenedor para el desarrollo de CLI general. Lo usaré para experimentar.

Instalar Curl, jq y OpenCode#

Como root:

apt instalar curl jq
curl -fsSL https://opencode.ai/install | bash

Podríamos omitir fácilmente curl para la instalación pero jq es necesario. Pudo instalarlo temporalmente y eliminarlo después, pero ambos son útiles también para los agentes, así que lo dejé instalado.

Instalé con un usuario, por lo que el instalador creó un binario llamable en la carpeta del usuario. Tuvieron que moverlo para que cada usuario pudiera usarlo:

mv /root/.opencode/bin/opencode /usr/bin/
chown root:root /usr/bin/opencode

Ahora cualquier usuario puede llamar a opencode.

su dev-user
opencode

Esto es probablemente no el procedimiento apropiado para una instalación de usuarios múltiples real, pero seré solo yo disfrazado de diferentes usuarios porque esté accediendo desde diferentes máquinas o contenedores.

Configurar OpenCode#

Dentro de OpenCode: /connect

Utilizar Ctrl+Mayúscula+V para pegar la clave de API.

Instalar OpenAgentControl#

Como dev-user:

curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh -o installOpenAgentControl.sh
. installOpenAgentControl.sh
cd ~/.config/opencode
cp env.example .env
nano .env
opencode --agente OpenAgent

Para usos posteriores:

cd repo
opencode --agente OpenAgent

Configurar proyectos de software#

Desde dentro de OpenCode /Init

Adaptar .opencode/context/project-intelligence.md