Claude Code Série de Tutoriais 3: Por que apenas o terminal?

1.3 Por que escrever código no terminal?

Imagine: você está escrevendo uma nova funcionalidade e de repente precisa modificar uma função utilitária de baixo nível que está espalhada em três arquivos, com algumas chamadas cruzando módulos. Você abre o editor, pesquisa globalmente, folheia arquivo por arquivo, faz as alterações com cuidado, executa os testes — e falha. Olha o erro, verifica a stack, corrige, e repete.

Nesse processo, o tempo real gasto em "descobrir como modificar" é provavelmente menos da metade. O resto é trabalho mecânico: encontrar arquivos, alterar referências, esperar a compilação, clicar.

Colocar a IA no terminal tem como objetivo principal comprimir esse trabalho mecânico.

O terminal é o lugar mais próximo do código

Você pode usar VS Code, JetBrains ou Vim. Independentemente da sua escolha, ao escrever código, você não consegue evitar o terminal. Executar npm test, git log, grep, make build — essas operações são naturalmente feitas na linha de comando.

Então, se seu parceiro de IA estiver no mesmo terminal, as coisas ficam mais simples. Você não precisa copiar e colar o conteúdo do arquivo numa janela de chat, nem descrever "no meu projeto há uma classe chamada UserService em src/services/user.ts na linha 42...". O Claude Code está na raiz do projeto; ele mesmo pode olhar.

Isso é um ataque esmagador ao contexto. Quando você diz "me ajude a refatorar o tratamento de erros do módulo de login", ele realmente lê seu auth/login.ts, lê errors.ts, encontra todos os lugares que o chamam e faz as alterações diretamente. Você não precisa ser o transportador.

Liberte-se do papel de "operador"

Ao usar chats de IA no navegador, muitas vezes assumimos inconscientemente o papel de "intermediário": a IA gera código, nós lemos, verificamos, copiamos e colamos de volta no editor. Se funciona, ótimo; se não, copiamos o erro, perguntamos de novo, copiamos novamente. Esse processo interrompe muito o fluxo.

O design do Claude Code é fazer você retornar à posição de "pensador". Você diz a ideia, ele executa. Após as alterações, você vê o diff diretamente no terminal e decide se aceita. Ele também pode rodar testes e lint para você. Você fica sentado, na maior parte do tempo lendo código e tomando decisões, sem ficar alternando janelas.

Por que não um plugin de editor?

Você pode perguntar: por que não criar um plugin de IA diretamente no editor?

Plugins de editor são úteis, e muitas equipes já os usam. Mas o Claude Code no terminal tem algumas vantagens difíceis de substituir por plugins:

1. Sem amarras do editor. Você pode usar VS Code hoje, Neovim amanhã, ou até mesmo em servidores remotos sem GUI. O Claude Code funciona independentemente da ferramenta que você escolheu.
2. Pode fazer coisas mais "ousadas". No terminal, ele pode executar qualquer comando Shell. Isso significa que seu leque de ações é muito mais amplo — pode iniciar um contêiner Docker para verificar migrações de banco de dados, puxar branches remotos e verificar conflitos, ou rodar testes e2e automaticamente após modificar o código. Plugins de editor geralmente não se atrevem a fazer isso, ou simplesmente não conseguem.
3. Processamento em lote e automação. Você pode colocar o Claude Code em scripts, pedir que ele processe dezenas de repositórios, gere documentação em massa, ou trate Issues automaticamente. Nesse ponto, ele não é mais um "assistente", mas sim uma peça na linha de produção.

Um pequeno exemplo meu

Anteriormente, precisei migrar um projeto JavaScript para TypeScript, com cerca de vinte mil linhas de código. Minha abordagem não foi adicionar tipos manualmente arquivo por arquivo, nem esperar que um plugin de editor fizesse tudo sozinho.

Simplesmente iniciei o Claude Code no diretório do projeto e disse: "Migre este projeto gradualmente para TypeScript com modo estrito, modifique alguns arquivos por vez, e após cada lote execute tsc --noEmit. Se houver erros, corrija-os até passar."

Na meia hora seguinte, basicamente só fiz uma coisa: olhar os diffs que ele gerava e concordar ou discordar. Ocasionalmente dizia "aqui não use any, defina uma interface", e ele continuava. No final, o projeto compilou, várias vezes mais rápido do que eu estimava.

Isso não significa que o Claude Code seja mais inteligente que um plugin. Mas ele consegue completar o ciclo "modificar-verificar-corrigir" por conta própria, e essa é a diferença fundamental entre ele e a IA de chat.

No fim, o terminal dá mãos e pés à IA

Colocar a IA no terminal é, essencialmente, dar a ela capacidade de execução, e não apenas capacidade de sugestão.

Isso transforma seu repositório de código, deixando de ser apenas um monte de texto que pode ser lido, para se tornar um ambiente real que a IA pode "tocar", modificar e verificar. Isso é um salto enorme.

Você ainda mantém o controle da direção do projeto e de todas as decisões críticas, mas o trabalho tedioso, de baixa criatividade e que exige múltiplas alternâncias, agora tem um executor mais adequado.