Como usar OpenCode no VS Code: 7 verificações de instalação e fluxo

A extensão não substitui o CLI. Rode opencode --version no terminal integrado e corrija o PATH antes de reinstalar. Abra um repositório real, revise Git e arquivos ignorados e teste provedor e modelo em uma sessão normal. Assim autenticação, rede e IDE permanecem problemas separados.

Abra o repositório, crie um terminal integrado e execute opencode. A documentação oficial confirma a instalação automática. Teste Ctrl+Esc ou Cmd+Esc. A instalação manual não comprova CLI nem provedor. Use Ctrl+Shift+Esc ou Cmd+Shift+Esc para outra sessão e evite edições concorrentes do mesmo arquivo.

Selecione o menor bloco útil. Alt+Ctrl+K no Windows/Linux ou Cmd+Option+K no macOS insere uma referência como @File#L37-42. Revalide linhas após grandes mudanças. O contexto melhora a resposta, mas não ignora permissões de arquivos e comandos.

Comece com git status, defina resultado e limites, mantenha o terminal visível e revise o diff no Source Control. Rode primeiro o menor teste relevante. Abra nova sessão quando o contexto antigo atrapalhar e mantenha um responsável por arquivo modificado.

Confirme se o terminal está local, em WSL, SSH ou contêiner. Não selecione chaves, dados de clientes ou configuração de produção. CLI e extensão rodam no seu ambiente, mas solicitações podem ir ao provedor. Deployment, banco, pagamento e autenticação exigem revisão humana.

Se não instalar, teste opencode no terminal integrado e reinicie o VS Code após mudar PATH. Verifique code --version; Cursor, Windsurf e VSCodium usam cursor, windsurf e codium. Cheque conflitos de atalhos antes de reinstalar. Se a sessão abre mas o modelo falha, investigue provedor, proxy e limites.

Reinstale só quando opencode, code e provedor funcionarem, mas os comandos da IDE faltarem. Remova a extensão, feche janelas, abra o projeto e rode opencode em terminal novo. Em outra IDE o terminal continua útil. EDITOR="code --wait" controla /editor e /export, não substitui a extensão.