Português
Documentação
IDE

IDE

A extensão OpenCode para VS Code, Cursor e outros IDEs

O OpenCode se integra com VS Code, Cursor ou qualquer IDE que suporte terminal. Basta executar opencode no terminal para começar.


Uso

  • Início Rápido: Use Cmd+Esc (Mac) ou Ctrl+Esc (Windows/Linux) para abrir o OpenCode em uma visualização de terminal dividida, ou focar em uma sessão de terminal existente se já houver uma em execução.
  • Nova Sessão: Use Cmd+Shift+Esc (Mac) ou Ctrl+Shift+Esc (Windows/Linux) para iniciar uma nova sessão de terminal OpenCode, mesmo se já houver uma aberta. Você também pode clicar no botão OpenCode na UI.
  • Consciência de Contexto: Compartilhe automaticamente sua seleção atual ou aba com o OpenCode.
  • Atalhos de Referência de Arquivos: Use Cmd+Option+K (Mac) ou Alt+Ctrl+K (Linux/Windows) para inserir referências de arquivos. Por exemplo, @File#L37-42.

Instalação

Para instalar o OpenCode no VS Code e forks populares como Cursor, Windsurf, VSCodium:

  1. Abra o VS Code
  2. Abra o terminal integrado
  3. Execute opencode - a extensão é instalada automaticamente

Se por outro lado você quiser usar seu próprio IDE quando executar /editor ou /export do TUI, precisará configurar export EDITOR="code --wait". Saiba mais.


Instalação Manual

Pesquise OpenCode no Marketplace de Extensões e clique em Instalar.


Solução de Problemas

Se a extensão não for instalada automaticamente:

  • Certifique-se de estar executando opencode no terminal integrado.
  • Confirme que o CLI do seu IDE está instalado:
    • Para VS Code: comando code
    • Para Cursor: comando cursor
    • Para Windsurf: comando windsurf
    • Para VSCodium: comando codium
    • Se não estiver, execute Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux) e pesquise "Shell Command: Install 'code' command in PATH" (ou o equivalente para seu IDE)
  • Certifique-se de que o VS Code tenha permissão para instalar extensões