Guia de Configuração do Terminal para Claude Code
Combina temas, ativa Shift+Enter, configura notificações, corrige truncagem em pastes longos e ativa o modo vim no iTerm2, WezTerm, Ghostty, Kitty e outros terminais.
Pare de configurar. Comece a construir.
Templates SaaS com orquestração de IA.
A forma como o teu terminal está configurado decide quanto tempo realmente pouparás com o Claude Code. As configurações padrão funcionam bem. Mas deixam muito por explorar. Um mau tratamento de quebras de linha prende-te dentro de prompts de uma linha. Notificações em falta mandam-te à cozinha buscar café que arrefece enquanto o Claude espera. E se alguma vez colaste um trecho de 200 linhas e viste metade desaparecer, o problema já te é familiar.
Abaixo está cada configuração que vale a pena ajustar. Combinação de temas, entrada multilinha, alertas, tratamento de pastes longos, modo vim, e as particularidades dos terminais que os programadores de verdade usam.
Combinação de Temas
O teu terminal tem as suas próprias cores. O Claude Code não pode mudar isso, e não tenta. O que pode fazer é alinhar a sua paleta interna com o esquema que o teu terminal está a usar.
Dentro do Claude Code, executa /config e escolhe a opção de tema. O realce de sintaxe, os marcadores de estado e os elementos da interface ajustam-se para assentar bem sobre um fundo claro ou escuro.
O mesmo fluxo /config permite configurar uma linha de estado personalizada. Essa barra fica no fundo do terminal e mostra o contexto que quiseres ter à mão. Modelo, diretório de trabalho, ramo git. Sem comandos extras para os verificar.
Um aviso. Se alternares entre claro e escuro durante o dia, executa /config novamente depois de cada mudança. A alteração de tema não é detetada automaticamente.
Métodos de Entrada Multilinha
Prompts de uma linha limitam-te. Qualquer coisa com detalhe real, qualquer código, qualquer pedido em vários passos, fica melhor em várias linhas. Há quatro formas de fazer isso dentro do Claude Code.
Método 1: Backslash + Enter (Funciona em Todo o Lado)
Escreve \ e depois carrega em Enter. Isso passa-te para uma nova linha. Todos os terminais em todos os sistemas operativos respeitam isto, o que o torna o recurso de último caso quando nada mais está configurado.
Parece desajeitado. Mas nunca falha. Usa-o quando estás ligado via SSH a uma máquina ou a explorar um terminal que não controlas.
Método 2: Shift+Enter (Suporte Nativo)
Quatro terminais lidam com Shift+Enter logo de início sem qualquer configuração:
- iTerm2
- WezTerm
- Ghostty
- Kitty
Se usas um destes, a combinação de teclas já funciona. Nada para ativar. Parece o mais natural das quatro opções porque todas as janelas de chat e editores de texto que usas já se comportam da mesma forma.
Método 3: /terminal-setup (Configuração Automática)
Quando um terminal não reconhece Shift+Enter por si próprio, o Claude Code pode configurar isso por ti. Escreve /terminal-setup dentro do Claude Code e a ligação fica configurada automaticamente.
O comando sabe como lidar com:
- Terminal integrado do VS Code
- Alacritty
- Zed
- Warp
Vale a pena saber. O comando /terminal-setup não aparece se já estiveres num terminal com suporte nativo (iTerm2, WezTerm, Ghostty, Kitty). Só aparece quando há trabalho de configuração a fazer.
Reinicia o terminal assim que /terminal-setup terminar. A ligação entra em vigor no próximo arranque.
Método 4: Option+Enter (Mac)
O macOS oferece Option+Enter como outra tecla de quebra de linha. Ativá-la é um ajuste único, e o menu que ajustas depende do terminal que usas.
Para o Terminal.app do Mac:
- Abre Definições, depois Perfis, depois Teclado
- Marca "Use Option as Meta Key"
Para iTerm2 e terminal do VS Code:
- Abre Definições, depois Perfis, depois Teclas
- Em Geral, define a tecla Option Esquerda/Direita para "Esc+"
O Option+Enter vale a pena se Option já faz parte da tua memória muscular de modificadores. A vantagem é que Shift fica livre para selecionar texto.
Notificações
Uma tarefa difícil do Claude Code pode ficar parada durante minutos. Sem alertas, ficas a olhar para o ecrã ou sais e esqueces de voltar. Boas notificações eliminam ambos os problemas.
Notificações de Sistema do iTerm2
O iTerm2 vem com banners nativos do macOS para tarefas de longa duração:
- Abre as Preferências do iTerm2
- Navega até Perfis, depois Terminal
- Ativa "Silence bell"
- Em Alertas de Filtro, ativa "Send escape sequence-generated alerts"
- Define o teu atraso de notificação preferido
Uma vez ativado, o macOS mostra um banner sempre que o Claude termina uma tarefa lenta. Os alertas disparam mesmo quando o iTerm2 está minimizado ou mudaste para outra aplicação.
Vale a pena notar. Este caminho é exclusivo do iTerm2. O Terminal.app padrão do macOS não oferece isto.
Hooks de Notificação Personalizados
Para lógica de alertas mais avançada, o Claude Code aceita hooks de notificação personalizados. Escreves o teu próprio caminho de código que corre num determinado evento. Posta no Slack. Toca um som. Dispara um webhook.
Os hooks ficam dentro do sistema de hooks mais amplo do Claude Code. Configura-os para disparar na conclusão de tarefas, em erros, ou em qualquer padrão de saída que te interesse.
Tratamento de Grandes Entradas
Colar um bloco de código longo ou uma especificação enorme diretamente no Claude Code não acaba bem. O buffer de paste na maioria dos terminais tem um limite, e atingi-lo transforma o teu texto em lixo truncado.
Três regras para entradas pesadas:
1. Não coles diretamente. Quando passas de cerca de 100 linhas, guarda primeiro num ficheiro. Depois aponta o Claude Code para esse ficheiro e diz-lhe para ler.
2. Atenção ao terminal do VS Code. O terminal integrado dentro do VS Code corta pastes longos mais agressivamente do que a maioria. Se o VS Code é a tua casa principal, o fluxo baseado em ficheiros não é opcional. É a única forma de qualquer coisa além de um prompt curto chegar intacta.
3. Divide o pedido. Em vez de colar uma especificação inteira, divide em partes. Dá ao Claude Code um pedaço, verifica a saída, e depois passa para o seguinte.
Modo Vim
Se os teus dedos já correm em hjkl, o Claude Code tem o que precisas. Há um modo vim integrado que configura um subconjunto das ligações normais do vim dentro da área de entrada.
Ativar o Modo Vim
Duas formas de o ligar:
- Escreve
/vimno Claude Code para ativar o modo vim imediatamente - Abre
/confige ativa o modo vim nas definições (este fica ativo entre sessões)
Uma vez ativado, começas no modo NORMAL. O indicador de modo habitual aparece na área de entrada para saberes sempre em que modo estás.
Referência de Atalhos de Teclado
Mudança de Modo:
| Tecla | Ação |
|---|---|
Esc | Mudar para o modo NORMAL |
i | Inserir antes do cursor |
I | Inserir no início da linha |
a | Inserir depois do cursor |
A | Inserir no fim da linha |
o | Abrir nova linha abaixo |
O | Abrir nova linha acima |
Navegação:
| Tecla | Ação |
|---|---|
h / j / k / l | Esquerda / Baixo / Cima / Direita |
w | Saltar para o início da próxima palavra |
e | Saltar para o fim da próxima palavra |
b | Saltar para o início da palavra anterior |
0 | Saltar para o início da linha |
$ | Saltar para o fim da linha |
^ | Saltar para o primeiro caracter não em branco |
gg | Saltar para a primeira linha |
G | Saltar para a última linha |
f<char> | Encontrar próximo caracter na linha |
F<char> | Encontrar caracter anterior na linha |
t<char> | Mover para antes do próximo caracter |
T<char> | Mover para depois do caracter anterior |
; | Repetir último f/F/t/T para a frente |
, | Repetir último f/F/t/T para trás |
Edição:
| Tecla | Ação |
|---|---|
x | Apagar caracter sob o cursor |
dw | Apagar até à próxima palavra |
de | Apagar até ao fim da palavra |
db | Apagar até ao início da palavra |
dd | Apagar linha inteira |
D | Apagar até ao fim da linha |
cw | Alterar até à próxima palavra |
ce | Alterar até ao fim da palavra |
cb | Alterar até ao início da palavra |
cc | Alterar linha inteira |
C | Alterar até ao fim da linha |
. | Repetir último comando de edição |
Yank e Paste:
| Tecla | Ação |
|---|---|
yy / Y | Yank (copiar) linha inteira |
yw | Yank até à próxima palavra |
ye | Yank até ao fim da palavra |
yb | Yank até ao início da palavra |
p | Colar depois do cursor |
P | Colar antes do cursor |
Objetos de Texto (usar com d, c, ou y):
| Tecla | Seleciona |
|---|---|
iw / aw | Interior / à volta da palavra |
iW / aW | Interior / à volta da PALAVRA |
i" / a" | Interior / à volta de aspas duplas |
i' / a' | Interior / à volta de aspas simples |
i( / a( | Interior / à volta de parênteses |
i[ / a[ | Interior / à volta de parênteses retos |
i{ / a{ | Interior / à volta de chavetas |
Operações de Linha:
| Tecla | Ação |
|---|---|
>> | Indentar linha |
<< | Desidentar linha |
J | Juntar linha atual com a seguinte |
Quando o Modo Vim Compensa
O modo vim ganha o seu valor em prompts longos e multilinhas. Quando estás a dar ao Claude Code um briefing detalhado com caminhos de ficheiros, trechos de código e pedidos em vários passos, os saltos e edições ao estilo vim poupam minutos reais.
Quando Saltar
Ainda não és utilizador de vim? Salta. A caixa de entrada do Claude Code não vale a pena aprender essa curva por si só.
Dicas por Terminal
Terminal Integrado do VS Code
- Executa
/terminal-setuppara configurar Shift+Enter para entrada multilinha - Atenção à truncagem de paste em entradas longas. Usa o fluxo baseado em ficheiros para qualquer coisa além de 100 linhas
- O terminal partilha recursos com o editor. Muitas extensões ativas podem fazer o Claude Code parecer lento
- Configura Option+Enter definindo a tecla Option para "Esc+" nas definições do terminal
iTerm2
- Shift+Enter funciona nativamente. Nada para configurar
- Ativa alertas de sistema através de Perfis, depois Terminal, depois "Silence bell" para banners de conclusão de tarefas
- Define a tecla Option para "Esc+" em Perfis, depois Teclas para ter Option+Enter a funcionar
- A integração tmux integrada funciona bem com sessões paralelas do Claude Code
Warp
- Executa
/terminal-setuppara configurar Shift+Enter - A entrada baseada em blocos do Warp pode às vezes confundir a deteção de prompts do Claude Code. Muda para o modo de entrada clássico se tiveres problemas
Alacritty
- Executa
/terminal-setuppara configurar Shift+Enter - O rendering acelerado por GPU torna o Alacritty um dos terminais mais rápidos para saída do Claude Code
Ghostty
- Shift+Enter funciona nativamente
- O Ghostty ainda é recente mas já funciona bem com o Claude Code. O rendering nativo do macOS e os arranques rápidos fazem dele uma escolha sólida para sessões dedicadas
Kitty
- Shift+Enter funciona nativamente
- O rendering GPU mantém o Kitty fluido mesmo em saída longa do Claude Code
- Um multiplexer integrado corre sessões paralelas sem precisar de tmux
Juntando Tudo
Um terminal corretamente configurado para o Claude Code tem cinco peças no lugar:
- Tema combinado através de
/configpara que o realce fique bem legível - Entrada multilinha configurada via Shift+Enter ou Option+Enter, conforme preferires
- Notificações ativadas para que as tarefas concluídas chamem a tua atenção
- Plano para grandes entradas definido. Fluxos baseados em ficheiros para qualquer coisa mais pesada do que um prompt curto
- Modo vim ativado se o vim já está nos teus dedos
Acerta nesses cinco pontos. O terminal deixa de estar no teu caminho e começa a comportar-se como o cockpit que devia ser.
Pare de configurar. Comece a construir.
Templates SaaS com orquestração de IA.
Configuração do Claude Code
Três ficheiros configuram o Claude Code por projeto: CLAUDE.md para contexto, servidores MCP para ferramentas, comandos slash para fluxos de trabalho. Uma hierarquia, cada sessão pronta.
Sandbox do Claude Code
O sandbox do Claude Code aplica limites de sistema de ficheiros e rede ao nível do kernel. Configuração para macOS Seatbelt, Linux e WSL2 com bubblewrap, e listas de domínios permitidos.