opencode/packages/web/src/content/docs/pt-br/ide.mdx

---
title: IDE
description: A extensão opencode para VS Code, Cursor e outros IDEs
---

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

---

## Uso

- **Lançamento Rápido**: Use `Cmd+Esc` (Mac) ou `Ctrl+Esc` (Windows/Linux) para abrir o opencode em uma visualização de terminal dividido, ou focar em uma sessão de terminal existente se uma já estiver 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 que uma já esteja aberta. Você também pode clicar no botão opencode na interface.
- **Consciência de Contexto**: Compartilhe automaticamente sua seleção ou aba atual com o opencode.
- **Atalhos de Referência de Arquivo**: Use `Cmd+Option+K` (Mac) ou `Alt+Ctrl+K` (Linux/Windows) para inserir referências de arquivo. 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 será instalada automaticamente

Se, por outro lado, você quiser usar seu próprio IDE ao executar `/editor` ou `/export` a partir do TUI, você precisará definir `export EDITOR="code --wait"`. [Saiba mais](/docs/tui/#editor-setup).

---

### Instalação Manual

Procure por **opencode** no Marketplace de Extensões e clique em **Instalar**.

---

### Solução de Problemas

Se a extensão falhar ao instalar automaticamente:

- Certifique-se de que você está executando `opencode` no terminal integrado.
- Confirme se a CLI para seu IDE está instalado:
  - Para VS Code: comando `code`
  - Para Cursor: comando `cursor`
  - Para Windsurf: comando `windsurf`
  - Para VSCodium: comando `codium`
  - Se não, 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 seu IDE)
- Certifique-se de que o VS Code tem permissão para instalar extensões