Cómo usar OpenCode en VS Code: 7 comprobaciones de instalación y flujo

La extensión no sustituye al CLI. Ejecuta opencode --version dentro del terminal integrado; si falla, corrige PATH antes de tocar la extensión. Abre una carpeta de repositorio real, revisa Git y los archivos ignorados, y confirma que el proveedor y el modelo funcionan en una sesión normal. Así separas un fallo de autenticación o red de un problema del IDE.

Abre el repositorio, crea un terminal integrado y ejecuta opencode. La documentación oficial indica que la extensión se instala automáticamente en VS Code y sus variantes compatibles. Espera a que el CLI lea el proyecto y prueba Ctrl+Esc o Cmd+Esc. La instalación manual desde Marketplace es una alternativa, pero no demuestra que el ejecutable ni el proveedor estén bien configurados. Usa Ctrl+Shift+Esc o Cmd+Shift+Esc para otra sesión y evita que dos sesiones editen el mismo archivo.

Selecciona el bloque mínimo que explica la tarea: una función, una rama de error o una configuración. Una selección explícita reduce ambigüedad frente a enviar un archivo entero. Con Alt+Ctrl+K en Windows/Linux o Cmd+Option+K en macOS puedes insertar una referencia como @File#L37-42. Revisa el rango después de cambios grandes; el contexto ayuda a entender, pero no reemplaza las reglas de permiso.

Empieza por git status, define el resultado y marca los archivos que no deben cambiar. Mantén visible el terminal para comprobar directorio y comandos. Después de cada edición revisa Source Control, ejecuta la prueba o el formateador más pequeño y amplía la validación según el riesgo. Abre una sesión nueva cuando el contexto anterior ya no corresponde al objetivo; la calidad se mide por un diff limpio, no por una conversación larga.

Comprueba si el terminal apunta a local, WSL, SSH o un contenedor antes de aprobar comandos. No selecciones secretos, claves, datos de clientes ni configuración de producción. El CLI y la extensión se ejecutan en tu entorno, pero el contenido puede enviarse al proveedor del modelo. Mantén revisión humana para despliegues, bases de datos, pagos y autenticación; la comodidad del IDE no debe ampliar silenciosamente los permisos.

Si no se instala, prueba opencode dentro del terminal integrado y reinicia VS Code después de cambiar PATH. Comprueba code --version; para Cursor, Windsurf y VSCodium los comandos son cursor, windsurf y codium. Si el atajo no responde, busca conflictos de teclas. Si abre la sesión pero falla el modelo, revisa proveedor, proxy, disponibilidad y límites en vez de reinstalar.

Reinstala únicamente si opencode, code y el proveedor funcionan, pero faltan los comandos del editor. Desinstala la extensión, cierra todas las ventanas, abre el repositorio y ejecuta opencode en un terminal nuevo. En otros IDE con terminal el CLI sigue siendo útil aunque pierdas contexto automático. Para /editor o /export, EDITOR="code --wait" controla el editor externo y no sustituye la extensión.