Terminal
Ruta por defecto. Tema y atajos viven en tui.json. La config de runtime vive en opencode.json. No son el mismo archivo.
Un agente abierto para tu código.
Usa los modelos gratis incluidos o conecta cualquier proveedor: Claude, GPT, Gemini y el resto del catálogo.
$
choco install opencode
01 / Funciones
Hecho para flujos de desarrollo reales.
Un agente de código abierto que escribe contigo en la terminal, el IDE o la app de escritorio.
- 01↗LSP enabled Carga automáticamente los language servers adecuados para el modelo.
- 02↗Multi-session Ejecuta varios agentes en paralelo en el mismo proyecto.
- 03↗Share links Publica un enlace de sesión para revisión o depuración.
- 04↗GitHub Copilot Entra con GitHub para usar tu cuenta de Copilot.
- 05↗ChatGPT Plus/Pro Entra con OpenAI para usar ChatGPT Plus o Pro.
- 06↗Any model Más de 75 proveedores LLM a través de Models.dev, incluidos modelos locales.
- 07↗Any editor Interfaz de terminal, app de escritorio y extensión de IDE.
02 / Inicio
De la instalación a la primera edición.
La intro oficial es un bucle corto: instala, escribe reglas del proyecto, conecta un modelo y cambia entre Plan y Build.
- 1. Instala desktop o CLI desde la página de descarga. La versión actual es v1.18.31 para Windows, macOS y Linux.
- 2. Ejecuta
opencodeen un proyecto y luego/initpara escribirAGENTS.md. Haz commit del archivo para que las sesiones posteriores vean las mismas reglas. - 3. Usa
/connectpara añadir una clave de proveedor, o entra en Copilot, ChatGPT, Claude o Zen. Los modelos gratis funcionan sin cuenta. - 4. Adjunta archivos con
@. Plan propone el trabajo con edit y bash en ask o deny. Build es el agente por defecto con las herramientas activas.
03 / Superficies
Tres superficies, un agente.
«Any editor» es una terminal, una app de escritorio y una extensión de IDE. La terminal sigue siendo la ruta de instalación por defecto.
Escritorio
Pestañas para sesiones activas en macOS, Windows y Linux. Windows necesita WebView2. Una ventana en blanco suele ser ese runtime. Firmado desde v1.3.4.
Extensión de IDE
El mismo agente dentro del editor. La página de descarga lista Terminal, luego Desktop, luego Extensions.
Deshacer y compartir
/undo y /redo revierten o restauran el último turno y sus cambios de archivos. Hace falta Git. /share publica la sesión solo cuando lo ejecutas.
04 / Adoption
Un agente de código abierto, en público.
Más de 195.000 estrellas en GitHub, 950 colaboradores y más de 13.000 commits. Lo usan más de 16 millones de desarrolladores cada mes.
05 / Privacy
Privacidad primero, por defecto.
El código y el contexto no se almacenan, así puede operar en entornos sensibles. Las FAQ nombran dos excepciones. Notas de privacidad →
- Por defecto
- El servicio no guarda código ni contexto. Puedes usarlo donde no se puede dejar una copia remota.
- Se guarda
- Hay datos si usas los modelos gratis o creas un enlace compartible. La conversación sigue privada hasta que ejecutes
/share. - En disco
- Las sesiones locales viven en
~/.local/share/opencodeo%USERPROFILE%\.local\share\opencode, incluidoauth.json. - Firma
- CLI y desktop están firmados desde v1.3.4. Comprueba el hash del instalador Windows x64 antes de excluirlo del antivirus.
06 / Permisos
Allow, ask o deny.
Desde v1.1.1 cada regla es allow, ask o deny. opencode --auto aprueba asks que no estén en deny. En Plan, edit y bash quedan apagados mientras el modelo piensa.
- external_directory
- Salta cuando una herramienta sale del directorio de trabajo. Por defecto ask. Expandir
~no salta esta guarda. - doom_loop
- Salta si la misma llamada se repite tres veces con la misma entrada. Por defecto ask.
- Archivos .env
reades allow, pero*.envy*.env.*son deny por defecto.*.env.examplesigue en allow.- Patrones
- Las herramientas de archivo y shell pueden permitir
git *y denegarrm *. Ask ofrece once, always el resto de la sesión, o reject.
07 / FAQ
Preguntas, con respuesta directa.
Un agente de código abierto que escribe y ejecuta código con cualquier modelo. Terminal, escritorio o extensión de IDE.
Instala desde la página de descarga, ejecuta opencode en un proyecto y luego /init. Conecta un proveedor, adjunta archivos con @ y usa Plan/Build.
No necesariamente. Los modelos gratis funcionan sin cuenta. También puedes conectar OpenAI, Anthropic, xAI, modelos locales o Zen.
Sí. Las FAQ oficiales nombran Claude Pro/Max, ChatGPT Plus/Pro y GitHub Copilot.
No. El escritorio cubre macOS, Windows y Linux, más una extensión de IDE.
El agente es gratis e incluye modelos gratis. Un proveedor conectado puede añadir sus cargos.
El código y el contexto no se guardan por defecto. Se almacenan datos con los modelos gratis o un enlace compartible. Las sesiones locales viven en disco.
Sí. Código público bajo licencia MIT. El nombre del proyecto en GitHub es anomalyco/opencode.
Sí. Desktop publica win-x64 y win-arm64. La documentación sigue recomendando WSL para la ruta de terminal. Desktop necesita WebView2. Ver la guía WSL.
Motores heurísticos han etiquetado DLL temporales del primer arranque como Wacatac o PDM:Trojan.Win32.Generic. Verifica el SHA256, usa el desktop firmado v1.18.31 y no apagues Smart App Control. Pasos: guía antivirus.
En Windows PowerShell: Get-FileHash .\opencode-desktop-win-x64.exe -Algorithm SHA256. El digest de v1.18.31 está en la sección de integridad.
08 / Models
Modelos fiables, elegidos para agentes.
Conecta un conjunto de modelos comprobados para agentes. Usa los modelos gratis, tus claves, Copilot, ChatGPT o un runtime local, sin atarte a un solo proveedor.
/connect
Añade un proveedor y pega una clave API, o entra en Copilot, ChatGPT, Claude o Zen.
/models
Abre el selector. Ejecuta opencode models para listar lo que puedes llamar. Los modelos se escriben como provider/model, por ejemplo openai/gpt-4.1.
OpenCode Zen
Modelos seleccionados que el proyecto probó para agentes, para que la calidad del proveedor sea menos una lotería.
Modelos locales
Conéctalos por la misma lista de más de 75 proveedores en Models.dev. Los modelos gratis incluidos funcionan sin cuenta.