OpenCode: OpenCode TUI (Terminal User Interface)
Última atualização: 2026-08-31
--- title: Interface TUI do Terminal OpenCode description: Compreenda profundamente a interface TUI do OpenCode, dominando comandos slash, referência de arquivos, atalhos e outros modos de interação centrais order: 7 lang: pt-br
O TUI é o modo de uso central do OpenCode — toda análise, modificação e execução de código passa por esta interface.
1. O Que Você Vai Aprender
- Inicialização e interação básica do TUI
- Referência de arquivos (@)
- Execução de comandos Shell (!)
- Lista completa de comandos slash
- Atalhos de teclado
2. Iniciar o TUI
opencode
# ou especificando diretório
opencode /path/to/project
3. Interação Básica
Digite linguagem natural na caixa de entrada:
Resuma rapidamente a estrutura deste projeto
4. Referência de Arquivos (Funcionalidade Central)
Use @ para referenciar arquivos:
Como a autenticação está implementada? Veja @packages/functions/src/api/index.ts
Recursos: busca fuzzy, leitura automática, sem cópia manual.
5. Executar Comandos Bash
Use ! para entrar no modo Shell:
!ls -la
Resultados são adicionados automaticamente ao contexto.
6. Comandos Slash (/)
| Comando | Função | Atalho |
|---|---|---|
/connect |
Adicionar provedor LLM | — |
/compact |
Comprimir contexto | Ctrl+X → C |
/details |
Detalhes de execução | Ctrl+X → D |
/editor |
Abrir editor externo | Ctrl+X → E |
/exit |
Sair do TUI | Ctrl+X → Q |
/export |
Exportar conversa | Ctrl+X → X |
/help |
Painel de ajuda | Ctrl+X → H |
/init |
Criar AGENTS.md | Ctrl+X → I |
/models |
Listar modelos | Ctrl+X → M |
/new |
Nova sessão | Ctrl+X → N |
/redo |
Refazer | Ctrl+X → R |
/sessions |
Listar sessões | Ctrl+X → L |
/share |
Compartilhar sessão | Ctrl+X → S |
/themes |
Trocar tema | Ctrl+X → T |
/thinking |
Mostrar raciocínio | — |
/undo |
Desfazer | Ctrl+X → U |
7. Atalhos
Ctrl+X é a tecla líder padrão (similar ao Leader do Vim):
| Função | Atalho |
|---|---|
| Comando palette | Ctrl+X → H |
| Nova sessão | Ctrl+X → N |
| Desfazer | Ctrl+X → U |
| Refazer | Ctrl+X → R |
| Modelos | Ctrl+X → M |
| Tema | Ctrl+X → T |
| Exportar | Ctrl+X → X |
8. Integração com Editor
export EDITOR="code --wait"
Depois use /editor no TUI para abrir um editor externo.
Suporta: VS Code, Cursor, Vim/Neovim, Nano.
9. Gerenciamento de Sessões
| Operação | Comando |
|---|---|
| Nova sessão | /new |
| Ver sessões | /sessions |
| Continuar anterior | opencode --continue |
| Sessão específica | opencode --session <id> |
10. Configuração do TUI
{
"tui": {
"scroll_speed": 3,
"scroll_acceleration": { "enabled": true }
}
}
❓ FAQ
P: TUI com problemas de exibição no Windows?
R: Use Windows Terminal ou WSL. O cmd.exe padrão tem suporte limitado para renderização TUI.
P: Como digitar mensagens multilinha?
R: Use /editor para abrir um editor externo ou Shift+Enter para nova linha.
📖 Resumo
- TUI é a interface de interação central do OpenCode
@referencia arquivos,!executa comandos,/chama comandos internos- Ctrl+X é a tecla líder dos atalhos
- Use @ frequentemente para melhorar a precisão
- Sempre confirme que o Git está commitado antes de operações importantes
📝 Exercícios
-
Básico: Use @ para referenciar um arquivo e pedir à IA para analisar a lógica.
-
Intermediário: Execute um comando Shell com ! e peça sugestões baseadas no resultado.
-
Avançado: Use /editor para escrever um prompt multilinha complexo e complete uma tarefa em múltiplas etapas.
