Configurações e Atalhos
As configurações são abertas pelo botão de engrenagem na barra de título. No macOS, o menu do aplicativo também tem "Settings…" (⌘,); no Windows e no Linux, pressione Alt e escolha Arquivo ▸ Configurações…. A janela de configurações tem oito categorias: Geral, Aparência, Terminal, Visualização da conversa, Comportamento, Avançado, Agentes e Atalhos. Este capítulo descreve cada item e termina com os atalhos de teclado padrão. As configurações são compartilhadas entre o aplicativo desktop e os clientes de navegador conectados a ele.

1. Geral
| Item | Descrição |
|---|---|
| Idioma | Idioma da interface. "Auto (sistema)" segue o idioma do sistema; há onze idiomas disponíveis |
| Som de notificação | Som das notificações (ativado por padrão) |
| System notifications | Ativa ou desativa as notificações do sistema (ativadas por padrão). Se o sistema ainda não tiver permitido as notificações, "Allow notifications" solicita a permissão; se elas estiverem bloqueadas, são mostradas as etapas para o seu sistema |
| Comando do shell | Somente no aplicativo desktop para macOS: "Instalar o comando ‘vela’" adiciona ao seu shell o comando vela <project-path>, que abre um projeto no VelaTerm. "Desinstalar o comando ‘vela’" remove o comando |
| Vela Skills | "Install" (depois, "Reinstall") instala as habilidades do VelaTerm para Claude Code e Codex, como /vspawn e $vspawn. Se o Codex não as listar, inicie uma nova sessão do Codex. Consulte Comandos de Sessão §2 |
2. Aparência
| Item | Descrição |
|---|---|
| Destaque | Cor de destaque: "Seguir o tema" ou uma de quatro cores |
| Densidade | "Compacta", "Normal" (padrão) ou "Espaçosa" |
| Painéis | Estilo dos painéis: "Sem borda" (padrão) ou "Cartão" |
| Divisor | "Sutil" (padrão) ou "Visível" |
| Barra lateral | "Árvore" (padrão) ou "Compacta" |
| Interface font | Fonte da interface |
| Interface size | Tamanho da fonte da interface; "Auto" acompanha a densidade |
Os temas claro e escuro são alternados na barra de título (seguir o sistema, escuro, claro), e não aqui. As sessões Claude em execução na visão de terminal acompanham a mudança de tema sem precisar reiniciar.
3. Terminal
| Item | Descrição |
|---|---|
| Colar imagem | "Colar caminho do arquivo" (padrão) salva a imagem colada como arquivo temporário e insere o caminho dela. "Colagem nativa" permite que o Claude Code ou o Codex leia a imagem da área de transferência; essa opção só está disponível no aplicativo desktop local |
| Sugestões de comandos | "Automáticas", "Com Tab" ou "Desativadas". Entra em vigor imediatamente, inclusive nos terminais abertos, e fica oculta onde não há suporte. Consulte Sugestões de Comandos |
| Shell padrão | Shell dos novos terminais. Aparece no Windows, onde há vários shells disponíveis; o macOS e o Linux sempre usam o shell do sistema |
| Terminal font | Fonte do terminal |
| Terminal size | Tamanho da fonte do terminal (padrão: 13). ⌘+ / ⌘- / ⌘0 alteram esse tamanho enquanto você trabalha |
| Altura da linha do terminal | Espaçamento entre as linhas do terminal (padrão: 1,2×) |
4. Visualização da conversa
Estas configurações se aplicam à visão de conversa das sessões de agente; consulte Visão de Conversa.
| Item | Descrição |
|---|---|
| Fonte da conversa, Tamanho da fonte da conversa, Altura da linha da conversa | Tipografia da conversa, independente das configurações do terminal (tamanho padrão: 13,5; altura da linha: 1,2×) |
| Barra de ferramentas de mensagens | Quais controles aparecem ao lado da caixa de mensagem e em que ordem: Modelo, Esforço de raciocínio, Modo de colaboração, Modo de permissões, Modo rápido, Velocidade, Tom, Servidores MCP, Tarefas em segundo plano, Conta e Créditos de redefinição do Codex. Cada controle tem uma chave para ativá-lo ou desativá-lo; as setas reordenam os controles ativados. Modelo, Esforço de raciocínio, Modo de colaboração e Modo de permissões vêm ativados por padrão |
Os controles que o agente ou o modelo atual não aceita não são exibidos. Um controle compatível continua visível quando o recurso dele está temporariamente indisponível, por exemplo Servidores MCP e Tarefas em segundo plano enquanto o processo do agente está parado.
Os controles desativados, e também os que não cabem ao lado da caixa de mensagem, ficam no menu Mais; assim, você pode usar qualquer controle compatível sem precisar ativá-lo aqui antes. O menu Mais não aparece quando todos os controles compatíveis estão ativados e cabem na linha. Um controle desativado e ativado novamente vai para o fim da linha. No celular, os controles desativados aparecem em uma segunda linha.
5. Comportamento
| Item | Descrição |
|---|---|
| Abas | "Única" (padrão) reutiliza a aba atual quando você abre uma sessão de agente e mantém a aba anterior em execução em segundo plano. "Múltiplas" abre cada sessão em uma aba própria |
| Inclusão dinâmica no filtro de status | Quando um filtro de status da barra lateral está ativo, as sessões que passam a corresponder a ele são adicionadas (ativada por padrão) |
| Background limit | Exibido no modo Única: o número máximo de abas em segundo plano (8, 16, 32 ou 64; padrão: 32). Acima desse limite, a aba em segundo plano inativa mais antiga é encerrada |
| Confirm before spawn | Mostra um cartão de confirmação antes que uma sessão filha seja iniciada (ativada por padrão); consulte Criação de Sessões e Colaboração no Git §4 |
| Usage auto-refresh | Mantém atualizado o uso da conta no painel Informações (ativada por padrão) |
| Usage refresh | Intervalo de atualização: 30 s, 1 min, 2 min ou 5 min (padrão: 5 min) |
| Continuar após a redefinição | Continua automaticamente uma tarefa do Claude ou do Codex depois que um limite de uso de cinco horas ou semanal é redefinido (ativada por padrão) |
| Limpar imagens coladas automaticamente | Remove os arquivos temporários das imagens coladas quando o aplicativo é fechado e, na inicialização, os arquivos com mais de 24 horas (ativada por padrão). "Limpar agora" os remove imediatamente |
Contexto de referências de sessão define como vrefer --ask (e a habilidade vask) entrega a conversa de outra sessão ao agente que responde. "Transcrição completa" (padrão) passa a conversa inteira. "Resumir primeiro" condensa a conversa antes, com o "Agente de resumo", o modelo e o esforço selecionados aqui. Consulte Comandos de Sessão §5.
6. Avançado
| Item | Descrição |
|---|---|
| Renderizador do terminal | "DOM" (padrão) ou "WebGL". Mantenha o padrão, a menos que tenha um motivo específico para alterá-lo |
| Redesenhar ao trocar de aba | Redesenha um terminal por completo quando você volta para a aba dele (desativada por padrão). Ative esta opção se as interfaces de terminal às vezes parecerem desconfiguradas depois de uma troca de aba |
| Saída com prioridade em primeiro plano | Mantém a digitação responsiva enquanto agentes em outras abas produzem muita saída (ativada por padrão) |
| Gravar registros de sessão | Salva a saída de terminal das sessões de agente em um arquivo de log (desativada por padrão). Quando ativada, as sessões arquivadas podem ser reproduzidas e a busca global também abrange a saída do terminal. As sessões de terminal comuns nunca são gravadas |
7. Agentes
Os "Padrões de novas sessões" se aplicam às sessões recém-criadas do agente selecionado. As configurações feitas para uma sessão específica têm prioridade, exceto o caminho do executável, que sempre vale para o tipo de agente inteiro.

| Item | Descrição |
|---|---|
| Tipo de agente | O agente cujos padrões você está editando |
| Caminho do executável (opcional) | Caminho completo do executável do agente. Quando o campo está vazio, o comando é procurado no PATH. É preenchido automaticamente depois de uma instalação bem-sucedida com um clique |
| Argumentos de inicialização (opcional) | Argumentos de linha de comando padrão, por exemplo --model opus |
| Permissão | Permissão padrão para novas sessões. Claude, Codex e OpenCode oferecem seus modos nomeados; a maioria dos outros agentes oferece "Padrão" e "YOLO" (pular todas as confirmações de permissão); o Pi não pede permissões. Consulte Sessões do Agente de IA §6 |
| Visão padrão | Para Claude, Codex, OpenCode, Pi e OMP: "Visão de conversa" (padrão) ou "Visão de terminal" para novas sessões. As sessões existentes mantêm a visão atual |
8. Atalhos

Clique na combinação de teclas de uma ação e pressione a nova combinação; Escape cancela. Uma combinação é formada por uma letra com ⌘ (no aplicativo desktop para macOS) ou Ctrl, opcionalmente com Shift e Option/Alt. Se a combinação já estiver em uso, a mensagem indica a ação que a utiliza. "Restaurar padrões" redefine todas as combinações.
| Ação | Aplicativo desktop para macOS | Windows, Linux |
|---|---|---|
| Abrir projeto | ⌘O | Ctrl+Alt+O |
| Novo terminal | ⌘T | Ctrl+Alt+T |
| Nova sessão de agente | ⌘N | Ctrl+Alt+N |
| Nova aba do navegador (somente no aplicativo desktop) | ⌘⇧B | Ctrl+Alt+B |
| Dividir à direita | ⌘D | Ctrl+Alt+D |
| Dividir abaixo | ⌘⇧D | Ctrl+Alt+E |
| Fechar painel / aba | ⌘W | Ctrl+Alt+W |
| Buscar no terminal | ⌘F | Ctrl+Alt+F |
| Buscar em todas as sessões | ⌘⇧F | Ctrl+Alt+G |
| Salvar documento | ⌘S | Ctrl+S |
Navegadores comuns. Quando você usa o VelaTerm em um navegador comum (acesso remoto por URL), o próprio navegador usa muitas combinações com ⌘ e Ctrl; por isso, as combinações do Windows e do Linux acima valem em todos os sistemas, e a página de configurações as exibe dessa forma. A exceção é um navegador no macOS, em que dividir à direita e dividir abaixo continuam sendo ⌘D e ⌘⇧D. As janelas de conexão remota do aplicativo desktop usam as combinações do desktop.
Teclas fixas, que não podem ser alteradas: ⌘1–9 alterna entre as abas, e ⌘+ / ⌘- / ⌘0 altera ou redefine o tamanho da fonte do terminal (Ctrl no Windows, no Linux e nos navegadores).
9. Seletor de nova sessão de agente
"Nova sessão de agente" abre uma lista pesquisável de tipos de agente e predefinições salvas ("Buscar agentes e predefinições"). As escolhas usadas recentemente aparecem primeiro e são marcadas como "Último usado".
O seletor mostra onde a sessão será criada. Quando há uma sessão salva ativa, escolha "Mesmo nível" para criar a nova sessão ao lado dela ou "Sessão filha" para criá-la abaixo dela. Enquanto o campo de busca estiver em foco:
- Tab alterna entre "Mesmo nível" e "Sessão filha".
- ↑ e ↓ selecionam um resultado; Enter cria a sessão.
- Shift+Tab move o foco para o controle anterior; Escape fecha o seletor.
Você também pode clicar em um resultado e escolher "Criar". Se não houver nenhum projeto disponível, selecione um ou use "Abrir projeto" primeiro.
O seletor tem endereço próprio, que guarda o destino, a posição, o texto da busca e a seleção. Copiar o link, atualizar a página ou usar voltar e avançar restaura o seletor sem criar uma sessão. Se a criação falhar, o seletor continua aberto para que você tente novamente.
10. Outras teclas
| Onde | Tecla | Ação |
|---|---|---|
| Visão de conversa | Enter / Shift+Enter | Enviar / nova linha |
| Visão de conversa, enquanto o agente trabalha | ⌥Enter (Alt+Enter) | Adicionar a mensagem ao turno em andamento |
| Visão de conversa, enquanto o agente trabalha | ⌘Enter (Ctrl+Enter) | Parar o turno e enviar esta mensagem |
| Visão de conversa, enquanto o agente trabalha | Esc | Parar o turno |
| Cartão de confirmação de sessão filha | ⌘Enter (Ctrl+Enter) | Iniciar a sessão |
| Barra de abas | Clique com o botão do meio | Fechar a aba |
| Barra lateral | ⌘/Ctrl+clique, Shift+clique | Selecionar várias sessões ou um intervalo |