Navegando no REPL do Claude Code: Prompts e Comandos de Barra
Uma vez que o Claude Code esteja em execução, tudo acontece dentro de uma única sessão interativa de REPL.
Essa sessão tem dois tipos de entrada: solicitações em linguagem natural e comandos de barra integrados.
Conhecer a diferença e saber como encerrar uma sessão adequadamente é a última peça da fluência básica do REPL antes de você começar a usá-lo para trabalho real.
Resumo
O prompt do REPL é onde você digita uma solicitação em inglês simples e o Claude Code a transforma em um plano de ação.
Uma barra inicial marca um tipo diferente de entrada: um comando integrado que aciona um comportamento específico do REPL, em vez de uma tarefa para o agente planejar.
Os comandos de barra cobrem coisas como construir o contexto inicial do projeto, limpar a conversa ou compactar o histórico de uma sessão longa.
A sessão persiste em muitas solicitações, então você raramente precisa reiniciar o claude no meio de uma sessão de trabalho.
Sair de forma limpa é importante porque sinaliza que você terminou, em vez de deixar a sessão em um estado inacabado.
Receita
Cartão de receita de referência rápida - pronto para copiar e colar.
# A natural-language request - plain English, no special syntax
> Add input validation to the signup form
# A slash command - built-in REPL behavior, not a task for the agent
> /init
# Clear the current conversation context
> /clear
# Exit the session cleanly
> /exitQuando usar isso:
- Qualquer momento em que você esteja dentro de uma sessão ativa do Claude Code e precise dar uma nova tarefa a ele.
- Iniciando uma nova sessão de projeto, onde
/inito ajuda a construir o contexto antecipadamente. - Uma sessão ficou longa e lenta, onde
/compactou/clearpodem ajudar. - Concluindo o trabalho do dia, onde
/exitencerra tudo adequadamente.
Exemplo de Trabalho
cd ~/projects/my-app
claude
# Build initial context about the project
> /init
# A normal natural-language request
> Explain how authentication currently works in this codebase
# A follow-up request in the same session, building on the same context
> Now add rate limiting to the login endpoint
# Free up context if the session is getting long
> /compact
# End the session when you're done
> /exitO que isso demonstra:
/inite solicitações comuns podem ser misturados livremente na mesma sessão.- Solicitações de acompanhamento se baseiam no contexto que o Claude Code já coletou anteriormente na sessão.
/compactestá disponível no meio da sessão sem a necessidade de sair e reiniciar./exité a maneira deliberada e limpa de encerrar a sessão, em vez de fechar a janela do terminal.
Mergulho Profundo
Como Funciona
- Cada linha que você digita no prompt
>é roteada para o agente como uma tarefa, ou interceptada pelo REPL como um comando de barra se começar com/. - Solicitações em linguagem natural se acumulam como parte do contexto de trabalho da sessão, que é por isso que solicitações de acompanhamento podem se referir a solicitações anteriores.
- Comandos de barra agem na própria sessão: construindo contexto, limpando-o, compactando-o ou encerrando-o, em vez de agir diretamente nos seus arquivos de projeto.
- Como a sessão é stateful, você geralmente não precisa repetir o contexto que já forneceu anteriormente na mesma sessão.
Comandos de Barra Comuns
| Comando | O que faz |
|---|---|
/init | Faz o Claude Code construir o contexto inicial sobre o projeto atual |
/clear | Limpa o contexto da conversa atual, começando do zero dentro da mesma sessão |
/compact | Compacta o histórico de uma sessão longa para liberar contexto, mantendo a essência |
/exit | Encerra a sessão de forma limpa |
Notas de Sintaxe do Prompt
# Natural language: describe the outcome, not the exact steps
> Fix the failing test in checkout.test.ts
# Slash command: always starts with a leading slash, no natural-language mixed in
> /clearArmadilhas
- Digitar um comando de barra como parte de uma frase - iniciar uma solicitação em linguagem natural com uma palavra que por acaso começa com
/pode ser mal interpretado como uma tentativa de comando. Correção: mantenha os comandos de barra como o primeiro caractere da linha, sem mais nada nessa linha. - Assumir que
/cleare/exitfazem a mesma coisa -/clearredefine o contexto, mas mantém a sessão aberta;/exitencerra a sessão completamente. Correção: use/clearpara começar do zero no meio da sessão e/exitapenas quando você realmente terminar. - Fechar a janela do terminal em vez de sair - isso pula o desligamento limpo que o REPL executa em
/exit. Correção: digite/exitantes de fechar o terminal, especialmente se algum comando em segundo plano ainda estivesse em execução. - Não usar
/initem um novo projeto - pular isso significa que a primeira solicitação real precisa construir o contexto do zero, o que pode tornar o primeiro plano mais lento ou mais fraco. Correção: execute/initcomo sua primeira ação em uma sessão de projeto totalmente nova. - Deixar uma sessão rodar por muito tempo sem compactar - um histórico de conversa muito longo pode tornar as respostas lentas ou diluir o contexto. Correção: execute
/compactperiodicamente em sessões longas, ou/clearao mudar para uma tarefa não relacionada.
Alternativas
| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Solicitação em linguagem natural | Você quer que o agente planeje e aja em uma tarefa | Você quer controlar um comportamento em nível de REPL, como limpar o contexto |
| Comando de barra | Você quer um comportamento integrado do REPL (init, clear, compact, exit) | Você quer que o Claude Code planeje uma tarefa de várias etapas |
Sair e reiniciar claude | Você mudou para um projeto completamente diferente | Você está apenas mudando de tarefa dentro do mesmo projeto |
FAQs
Como sei se devo digitar uma solicitação em linguagem natural ou um comando de barra?
Se você quer que o Claude Code planeje e aja em uma tarefa, descreva-a em inglês simples. Se você quer um comportamento integrado do REPL, como limpar o contexto ou sair, use um comando de barra inicial em vez disso.
O que `/init` realmente faz?
- Faz o Claude Code construir o contexto inicial sobre o projeto atual.
- Geralmente é o primeiro comando executado em uma sessão de projeto totalmente nova.
- Torna a primeira solicitação real subsequente mais precisa, pois o agente já tem orientação.
Qual é a diferença entre `/clear` e `/compact`?
/clear apaga o contexto da conversa atual e começa do zero dentro da mesma sessão. /compact condensa um histórico longo para mantê-lo gerenciável sem descartá-lo completamente.
Preciso usar `/exit` e reiniciar para cada nova tarefa?
Não. A sessão é stateful e persiste em muitas solicitações. Você só precisa reiniciar ao mudar para um diretório de projeto diferente.
O que acontece se eu apenas fechar o terminal sem sair?
A sessão termina abruptamente em vez de desligar de forma limpa. É melhor digitar /exit primeiro, especialmente se um comando do shell ainda estivesse em execução.
Posso misturar comandos de barra e solicitações em linguagem natural na mesma sessão?
Sim. Eles são comumente misturados, por exemplo, executando /init primeiro, depois uma série de solicitações em linguagem natural, depois /compact no meio de uma sessão longa.
Um comando de barra modifica meus arquivos de projeto diretamente?
Não. Os comandos de barra abordados aqui agem na própria sessão, contexto, histórico e ciclo de vida da sessão, não diretamente em seus arquivos. Edições reais de arquivos vêm de solicitações em linguagem natural roteadas através do agente.
Por que eu usaria `/compact` em vez de apenas `/clear`?
/compact mantém uma versão condensada do histórico da sessão, para que o agente retenha alguma memória do contexto anterior. /clear descarta-o completamente, o que é melhor quando você está mudando para uma tarefa genuinamente não relacionada.
Existe alguma diferença entre como o REPL trata uma solicitação e como uma interface de chat faria?
A solicitação do REPL passa pelo loop completo do agente: leitura de arquivos, planejamento, ação e verificação, não apenas produzindo uma resposta de texto. Essa distinção é a diferença central de uma interface de chat típica.
Qual deve ser meu primeiro comando em um projeto totalmente novo?
/init é um bom padrão, pois permite que o Claude Code construa o contexto sobre o projeto antes de você entregar uma tarefa real.
Relacionados
- Noções Básicas do Claude Code 101 - um conjunto mais amplo de exemplos da primeira sessão, incluindo instalação e inicialização.
- O Modelo Mental do Claude Code: Agente, Não Autocompletar - o que acontece nos bastidores quando uma solicitação em linguagem natural é enviada.
- Instalando o Claude Code e Conectando Seu Primeiro Projeto - como abrir uma sessão em primeiro lugar.
- Modos de Permissão Explicados: Aceitar Automaticamente vs. Perguntar Sempre - como o REPL se comporta de maneira diferente dependendo do seu modo de permissão.
Versões da Stack: Escrito contra a linha de modelos Claude atual por volta de junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos do produto mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.