Claude Code -  Introdução básica

Hoje vou apresentar uma introdução básica ao Claude Code para quem esta iniciando agora e precisa ter uma visão geral desta ferramenta.

O Claude Code é uma ferramenta de IA que roda no terminal. Para muita gente, essa frase é o suficiente para desanimar. Isso seria um erro. Embora possa ter sido projetado como um assistente de programação, ele é, na verdade, um agente capaz de gerenciar seus arquivos, usar habilidades e escrever e executar código (tudo por conta própria) para resolver qualquer problema que você apresentar.

O que é o Claude Code e como ele difere de um chatbot?

A maioria das ferramentas de IA funciona assim: você faz uma pergunta, recebe uma resposta e a copia para algum lugar útil. O Claude Code funciona de forma diferente. Em vez de gerar texto para você agir, ele age diretamente no seu computador.

Ele pode ler arquivos; escrever, editar e executar códigos; instalar softwares e construir coisas do zero. Você descreve o objetivo em inglês simples (ou português); o Claude descobre como alcançá-lo.

Para usuários sem o menor conhecimento ou interesse em programação, o Claude Code ainda pode ser uma ferramenta muito poderosa para coisas como:

- Resumir e reorganizar uma pasta de documentos ou notas de reunião.
- Extrair dados de um site e estruturá-los em uma planilha.
- Gerar um relatório lendo dados do Notion, Airtable ou de seus arquivos locais.
- Renomear e organizar grandes quantidades de arquivos de acordo com suas próprias regras.
- Criar uma ferramenta interna simples ou um painel de controle (dashboard).

O nome pode sugerir um assistente de código, mas o escopo real é consideravelmente mais amplo.

O terminal é a interface baseada em texto na qual o Claude Code é executado. Se você nunca o usou, a configuração é mais simples do que parece. Uma vez instalado, você digita claude para abri-lo e Ctrl+C duas vezes para fechá-lo. Depois disso, basta digitar o que deseja.



Você também pode usar o Claude Code através do aplicativo Claude para Desktop, que possui uma interface de usuário ligeiramente mais simples.

Escrevendo prompts melhores

Um prompt é simplesmente o que você digita para dizer ao Claude Code o que fazer. A qualidade do que você recebe de volta depende muito da qualidade do que você insere.

Prompts vagos produzem resultados vagos.

1- "Crie um site para mim" resultará em algo genérico.

2- "Crie um site de portfólio com fundo escuro, layout de duas colunas e um formulário de contato na parte inferior" resultará em algo útil.

Quanto mais específico você for sobre o resultado, melhor o Claude poderá entregá-lo.

Assim que o Claude entende o contexto do seu projeto, prompts curtos de acompanhamento funcionam bem. A clareza importa mais do que a extensão.

Você está sempre no controle

O Claude Code não age sem permissão. Antes de realizar uma ação significativa, como instalar um pacote, chamar um serviço externo ou excluir um arquivo, ele para e pede sua aprovação primeiro.

Você pode configurar esse comportamento em um arquivo chamado settings.local.json.

Ações rotineiras e de baixo risco, como ler arquivos ou executar testes, podem ser pré-aprovadas para que o Claude não precise pausar e verificar a cada vez. Ações mais consequentes permanecem protegidas pela sua aprovação.

Você também pode especificar uma "lista de negação" (deny list): arquivos que o Claude nunca tem permissão para ler, independentemente do que esteja fazendo. Isso é útil para manter credenciais e variáveis de ambiente completamente fora de alcance.

Você não precisa editar esse arquivo sozinho. Basta pedir ao Claude para fazer isso por você:

- Quais permissões você tem ativadas?
- Você pode adicionar permissão para fazer X no seu arquivo de configurações?

Como o Claude pensa

O Claude Code possui um conjunto de ferramentas integradas que pode utilizar: ler arquivos para entender seu projeto, escrever e editar arquivos diretamente e executar comandos de terminal. Você descreve o objetivo; o Claude combina as ferramentas conforme necessário.

Ao lado dessas ferramentas, o Claude possui uma janela de contexto (context window), que funciona como sua memória de trabalho para a conversa atual.

Tudo o que está nessa janela é o que o Claude pode ver: suas mensagens, as respostas dele e o conteúdo de quaisquer arquivos que ele tenha lido. Assim que a janela fica cheia, a qualidade das respostas pode começar a cair à medida que informações anteriores são descartadas ou resumidas.

Você pode gerenciar isso com dois comandos:

 /clear: inicia uma sessão completamente nova.
 /compact: é mais cirúrgico; ele resume o que aconteceu até agora e limpa o excesso, mantendo o que importa.

O Claude também acionará isso automaticamente quando a janela de contexto atingir cerca de 85–95% da capacidade. As sessões são salvas automaticamente, então você pode digitar claude --resume para continuar exatamente de onde parou.

O uso é medido em tokens, aproximadamente três quartos de uma palavra cada. Cada prompt, resposta e leitura de arquivo custa tokens. Você pode acompanhar seus gastos a qualquer momento com o comando:  /cost.

Escolhendo o modelo certo

O Claude Code utiliza uma família de modelos entre os quais você pode alternar no meio da conversa usando /model:

Haiku: mais rápido e barato, bom para tarefas simples ou repetitivas.
Sonnet: o polivalente equilibrado e o padrão sensato para a maioria dos trabalhos.
Opus: o mais capaz, mas também o mais caro.

A maioria dos trabalhos se encaixa naturalmente no Sonnet. Vale a pena reservar o Opus para problemas genuinamente complexos. Se você estiver tentando estender seu limite de uso diário, o Haiku será seu aliado.

Fazendo o Claude lembrar de suas preferências

O Claude Code possui dois sistemas para transportar informações entre sessões:

CLAUDE.md: é um arquivo markdown localizado dentro da pasta do seu projeto. O Claude o lê no início de cada sessão. Use-o para descrever a estrutura do projeto, definir regras ou fornecer contexto.

Memória: O sistema de memória é automático e funciona em todos os seus projetos. O Claude percebe padrões ao longo do tempo, como seu estilo de trabalho preferido ou como você gosta que as coisas sejam formatadas.

Atalhos e personalização

O Claude Code vem com comandos de barra (slash commands) integrados:

/init - configura um novo projeto
/compact - gerencia a janela de contexto
/help - lista tudo o que está disponível. Você também pode criar seus próprios comandos personalizados.

Skills (Habilidades): são conjuntos de instruções pré-escritas que carregam conhecimento especializado na conversa. (Veja a aula : https://macoratti.net/26/04/vda220426.htm)

Hooks (Ganchos):  são scripts externos que o Claude Code executa automaticamente em momentos específicos do ciclo de vida — como antes ou depois de rodar um comando, permitindo validações, logs e integrações customizadas. Ambos são configuráveis via settings.json ou diretamente no CLI. A documentação oficial completa está em code.claude.com/docs/en/hooks-guide e code.claude.com/docs/en/cli-reference.

Flags (Sinalizadores):  são parâmetros passados na linha de comando ao iniciar o Claude Code — como --model, --verbose ou --no-auto-update — controlando o comportamento da sessão;

Extended Thinking (Raciocínio Estendido): o Claude reserva um orçamento de tokens para "pensar" passo a passo antes de agir em problemas complexos. É um modo em que o Claude dedica mais tokens e tempo para raciocinar internamente antes de responder — útil para problemas complexos como arquitetura de sistemas, algoritmos difíceis ou debugging profundo

Acompanhando seu trabalho

Antes de cada edição de arquivo, o Claude cria um checkpoint — uma captura automática do estado atual. Se algo der errado, você pode usar /redo para restaurar estados anteriores. O Claude Code também se conecta ao Git para controle de versão.

Conectando-se ao mundo exterior

Os Servidores MCP (Model Context Protocol) estendem o Claude Code além da sua máquina local. Eles permitem que o Claude se conecte a plataformas externas como Supabase, Notion, Airtable ou Asana.

O Claude Code também suporta imagens, permitindo que você cole capturas de tela para mostrar bugs ou referências de design.

Continuando uma sessão de outro dispositivo

O Remote Control permite conectar-se a uma sessão do Claude Code em execução na sua máquina a partir de qualquer outro dispositivo. Basta rodar claude remote-control para gerar uma URL ou QR code. Isso é útil para tarefas longas; você pode iniciar algo no computador e acompanhar o progresso pelo celular.

Tornando-se autônomo

Para trabalhos maiores, o Claude Code suporta padrões de autonomia:

Sub-agentes: instâncias separadas do Claude que lidam com tarefas delegadas de forma independente.

Equipes de agentes: agentes que podem conversar entre si e compartilhar uma lista de tarefas, acelerando grandes projetos.

Modo Headless: ativado com a flag -p, roda o Claude Code sem nenhuma interação humana (sem aprovações, apenas execução autônoma).

O que tudo isso significa

O Claude Code é um passo substancial além de uma interface de chat. No nível básico, ele transforma linguagem simples em ações no seu computador. No nível avançado, ele coordena múltiplos agentes trabalhando em paralelo.

O melhor de tudo é que você pode usar quantos (ou poucos) desses recursos desejar. Mesmo sem as ferramentas extras, o Claude Code ainda é uma ferramenta poderosa.

E estamos conversados...  

"Porque se levantarão falsos cristos, e falsos profetas, e farão sinais e prodígios, para enganarem, se for possível, até os escolhidos."
Marcos 13:22