Manual do usuário

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.

Configurações · Aparência

1. Geral

ItemDescrição
IdiomaIdioma da interface. "Auto (sistema)" segue o idioma do sistema; há onze idiomas disponíveis
Som de notificaçãoSom das notificações (ativado por padrão)
System notificationsAtiva 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 shellSomente 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

ItemDescrição
DestaqueCor de destaque: "Seguir o tema" ou uma de quatro cores
Densidade"Compacta", "Normal" (padrão) ou "Espaçosa"
PainéisEstilo 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 fontFonte da interface
Interface sizeTamanho 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

ItemDescriçã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ãoShell 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 fontFonte do terminal
Terminal sizeTamanho da fonte do terminal (padrão: 13). ⌘+ / ⌘- / ⌘0 alteram esse tamanho enquanto você trabalha
Altura da linha do terminalEspaç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.

ItemDescrição
Fonte da conversa, Tamanho da fonte da conversa, Altura da linha da conversaTipografia da conversa, independente das configurações do terminal (tamanho padrão: 13,5; altura da linha: 1,2×)
Barra de ferramentas de mensagensQuais 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

ItemDescriçã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 statusQuando 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 limitExibido 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 spawnMostra 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-refreshMantém atualizado o uso da conta no painel Informações (ativada por padrão)
Usage refreshIntervalo de atualização: 30 s, 1 min, 2 min ou 5 min (padrão: 5 min)
Continuar após a redefiniçãoContinua 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 automaticamenteRemove 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

ItemDescriçã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 abaRedesenha 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 planoMantém a digitação responsiva enquanto agentes em outras abas produzem muita saída (ativada por padrão)
Gravar registros de sessãoSalva 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.

Configurações · Agentes

ItemDescrição
Tipo de agenteO 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ãoPermissã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ãoPara 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

Configurações · 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çãoAplicativo desktop para macOSWindows, Linux
Abrir projeto⌘OCtrl+Alt+O
Novo terminal⌘TCtrl+Alt+T
Nova sessão de agente⌘NCtrl+Alt+N
Nova aba do navegador (somente no aplicativo desktop)⌘⇧BCtrl+Alt+B
Dividir à direita⌘DCtrl+Alt+D
Dividir abaixo⌘⇧DCtrl+Alt+E
Fechar painel / aba⌘WCtrl+Alt+W
Buscar no terminal⌘FCtrl+Alt+F
Buscar em todas as sessões⌘⇧FCtrl+Alt+G
Salvar documento⌘SCtrl+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

OndeTeclaAção
Visão de conversaEnter / Shift+EnterEnviar / 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 trabalhaEscParar o turno
Cartão de confirmação de sessão filha⌘Enter (Ctrl+Enter)Iniciar a sessão
Barra de abasClique com o botão do meioFechar a aba
Barra lateral⌘/Ctrl+clique, Shift+cliqueSelecionar várias sessões ou um intervalo