Claude Code CLI: como funciona a ferramenta de IA no terminal

Programar conversando com o terminal parece coisa de filme, mas é o dia a dia com o Claude Code

O Claude Code é uma ferramenta de programação agêntica da Anthropic que vive no terminal

Ele entende o teu codebase, executa tarefas, explica código e cuida de fluxos de git a partir de comandos em linguagem natural

Neste post eu vou te mostrar COMO essa natureza de linha de comando funciona: por que ele roda no terminal, como instalar, como abrir a primeira sessão, os recursos que só fazem sentido nesse formato e um teste real que fiz pra ver o comportamento dele na prática

Por que o Claude Code vive no terminal (e não numa janela)

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

A sacada aqui é simples: o Claude Code não é um chat de navegador nem uma extensão bonitinha com botões

Ele é um agente de linha de comando que tu roda DENTRO do diretório do teu projeto

É como contratar um dev experiente, sentar ele na tua cadeira, apontar pra pasta do projeto e falar o que precisa em português mesmo

Aí ele age no codebase local: lê arquivos, roda comandos, mexe no git, tudo ali no terminal onde teu código já mora

Por que isso importa? Porque o terminal é o lugar onde o trabalho de verdade acontece

Um chat de navegador te obriga a copiar código pra lá, colar de volta, explicar contexto na mão

O formato CLI corta esse vaivém: o agente já está no projeto, já enxerga a estrutura, já executa o que precisa sem tu ficar de babá

Como instalar o Claude Code

A Anthropic recomenda o instalador nativo, e o passo muda conforme teu sistema

1. macOS ou Linux: abre o terminal e roda o instalador nativo via curl

curl -fsSL https://claude.ai/install.sh | bash

O bom desse método é que ele não exige Node.js nem outros runtimes instalados antes

2. Windows: o caminho nativo é via PowerShell

irm https://claude.ai/install.ps1 | iex

3. npm (método legado): a instalação via npm ainda existe e funciona, mas hoje é tratada como método depreciado

npm install -g @anthropic-ai/claude-code

O erro comum aqui é justamente esse: muita gente sai rodando o npm install achando que é o jeito recomendado

Não é mais

A recomendação atual é o instalador nativo: o curl no macOS/Linux e o PowerShell no Windows

Se tu quer conferir a fonte, tudo isso está no repositório oficial do Claude Code

Como começar uma sessão no terminal

Instalado, o começo é mais tranquilo do que parece

1. Navega até a pasta do teu projeto pelo terminal

cd meu-projeto

2. Roda o comando pra abrir a sessão

claude

Pronto, a sessão inicia ali dentro e tu já pode passar o primeiro pedido em linguagem natural

Na primeira interação espera que ele reconheça o contexto do projeto: os arquivos que existem, a estrutura da pasta, o que dá pra fazer dali

O erro comum desse passo é rodar o claude fora do diretório do projeto

Se tu iniciar a sessão na pasta errada, o agente age no lugar errado

Tome cuidado! Sempre confirma que tu está DENTRO da pasta certa antes de digitar o comando

Depois que a sessão está de pé, vale afiar o jeito de pedir as coisas, e eu já falei sobre técnicas de prompt no Claude Code em outro post

Recursos que só fazem sentido no terminal: slash commands e Plan Mode

Aqui é onde o formato CLI mostra o valor dele

Existem recursos que só existem porque tu está numa sessão viva de terminal, não numa janelinha de chat

Slash commands

Slash commands são comandos que tu digita dentro da sessão ativa, começando com barra, e que executam na hora

Dois exemplos que aparecem bastante:

• /clear pra limpar o contexto da conversa
• /compact pra compactar o histórico da sessão

É digitar a barra, o comando e apertar enter

Sem menu, sem mouse, sem sair do fluxo

Plan Mode

O Plan Mode é um respiro de segurança muito massa

Com ele ligado, o agente é obrigado a apresentar um plano ESCRITO e esperar tua aprovação antes de mexer em qualquer arquivo

Tu aciona ciclando os modos de permissão com Shift+Tab

Por que isso é bom? Porque tu vê a intenção do agente antes dele encostar no teu código

É o oposto do vibe coding 100% no escuro: tu lê o plano, aprova, e só então ele age

Esse tipo de controle fino é filho direto do formato de terminal

E se tu quer levar o Claude Code além, dá pra plugar ferramentas externas via MCP servers no Claude Code

Na prática: testando o Claude Code no terminal com o RTK

Bora ver na prática?

No vídeo abaixo eu abri um projeto que já existia e iniciei o Claude Code direto no terminal pra testar

Passei um prompt pedindo pra ele analisar o projeto: contar os arquivos, listar as dependências, ver se havia testes, rodar npm install seguido de npm run build e checar em que ponto o git estava

E se liga no que aconteceu: pra atender o pedido, o Claude Code disparou VÁRIOS comandos por conta própria no terminal

git status, git log, npm install, npm run build, tudo sozinho, sem eu acionar cada um na mão

Ele roda esses comandos de forma involuntária durante o trabalho, e não dá pra impedir a ferramenta de executá-los quando ela julga que precisa

O detalhe que me chamou atenção: a saída de cada comando executado entra no contexto automaticamente, mesmo quando aquela saída não serve pra nada no resultado final

Aí encerrei o Claude Code com Control C, reiniciei a sessão e rodei o MESMO prompt em outra condição, dessa vez com uma ferramenta gratuita chamada RTK

Os números que eu vi no teste:

A economia total de tokens naquele prompt de teste foi de 33%

E o comando que mais economizou, um LS, chegou a 75% de economia

A conclusão que tirei é essa: quando o Claude Code trabalha no terminal, ele executa comandos sozinho e joga a saída deles no contexto automaticamente

E é justamente esse comportamento que consome tokens e encurta a tua sessão

Saber disso já muda o jeito de trabalhar, porque tu entende de onde o gasto vem

Conclusão

O Claude Code ser uma ferramenta de linha de comando não é detalhe, é o ponto todo

Esse formato coloca o agente dentro do teu projeto, deixa ele agir no codebase local, executar comandos e cuidar do git sem tu ficar copiando e colando pra lá e pra cá

Em troca, tu ganha controle fino com coisas como slash commands e o Plan Mode, que só fazem sentido numa sessão viva de terminal

O comportamento de rodar comandos sozinho tem custo em tokens, e entender isso já te deixa na frente

Próximo passo é o mais simples de todos: instala o Claude Code, entra na pasta de um projeto teu e roda claude

A melhor forma de sentir o formato CLI é abrindo uma sessão e conversando com ela…