Português
Documentação
IDE

IDE

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

O OpenCode se integra ao VS Code, Cursor ou qualquer IDE que suporte um 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 uma sessão de terminal já existente.
  • Nova sessão : Use Cmd+Shift+Esc (Mac) ou Ctrl+Shift+Esc (Windows/Linux) para iniciar uma nova sessão de terminal do OpenCode, mesmo que já exista uma aberta. Você também pode clicar no botão do OpenCode na interface.
  • Reconhecimento de contexto : Compartilhe automaticamente sua seleção ou aba atual com o OpenCode.
  • Atalhos de referência a arquivos : Use Cmd+Option+K (Mac) ou Alt+Ctrl+K (Linux/Windows) para inserir referências a arquivos. Por exemplo, @File#L37-42 .

Instalação

Para instalar o OpenCode no VS Code e em forks populares como Cursor, Windsurf e 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 ao executar /editor ou /export na TUI, será preciso definir export EDITOR="code --wait". Saiba mais.


Instalação manual

Procure por OpenCode no Extension Marketplace e clique em Install.


Solução de problemas

Se a extensão não instalar automaticamente:

  • Verifique se você está executando opencode no terminal integrado.

  • Confirme se a CLI do seu IDE está instalada:

    • 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 procure por "Shell Command: Install 'code' command in PATH" (ou o equivalente para o seu IDE)
  • Verifique se o VS Code tem permissão para instalar extensões