Ir para o conteúdo
Promovaweb

O que é o Claude Code

StayCloudVPS Agêntica

O mesmo ambiente do SetupVibe, agora numa VPS

Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

Criar minha VPS na StayCloud

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

O Claude Code é o agente de código da Anthropic que lê o seu repositório, edita arquivos e executa comandos a partir de uma instrução em linguagem natural. Ele combina um modelo Claude, que escolhe o próximo passo, com as ferramentas de arquivo, busca, terminal e web que executam esse passo no seu projeto.

Sumário da página

  1. Uma instrução vira uma sequência de ações no projeto
  2. O modelo pensa e as ferramentas agem
  3. O que o agente enxerga quando você abre a sessão
  4. Sessões, janela de contexto e volta no tempo
  5. A revisão continua sendo sua

Uma instrução vira uma sequência de ações no projeto

Você abre o terminal na pasta do projeto, digita claude e escreve que os testes do módulo de autenticação estão falhando. A partir daí o agente roda a suíte para ver o que quebrou, lê a saída do erro, procura os arquivos citados, lê o código, faz a edição e roda os testes outra vez. Você não descreveu nenhum desses passos um a um. O agente escolhe cada ação a partir do resultado da ação anterior.

A documentação da Anthropic chama essa sequência de loop agêntico. Ela tem três fases que se misturam o tempo todo: reunir informação, agir e verificar o resultado. Uma pergunta sobre o código pode parar na primeira fase. Uma correção de bug passa pelas três várias vezes, até o teste passar ou até o agente precisar de uma informação sua.

  1. Tarefa

    Você descreve o trabalho em linguagem natural.

  2. Reunir informação

    O agente lê arquivos, faz buscas e consulta o estado do Git.

  3. Agir

    Edita arquivos e executa comandos dentro das permissões da sessão.

  4. Verificar

    Roda testes ou o build e lê a saída para continuar ou parar.

O loop agêntico descrito pela Anthropic: cada ferramenta devolve um resultado ao modelo, que escolhe a próxima ação até a tarefa fechar. Você pode interromper em qualquer ponto.

Você continua dentro do loop. A tecla Esc interrompe o agente na hora e cancela a ferramenta que estava rodando. Uma correção digitada com Enter, sem parar o agente, entra na fila e o agente a lê assim que as chamadas em andamento terminam, ainda no mesmo turno.

O modelo pensa e as ferramentas agem

O Claude Code não é o modelo. Ele é a camada em volta do modelo, que oferece as ferramentas e controla o que o modelo enxerga a cada passo. A documentação usa o termo harness para essa camada. Sem ferramentas, o modelo só responde com texto. Com elas, ele lê o seu código, edita arquivos, roda comandos, pesquisa na web e conversa com serviços externos.

As ferramentas embutidas caem em cinco grupos. As operações de arquivo leem, criam, editam e renomeiam. A busca encontra arquivos por padrão e procura conteúdo com expressão regular. A execução roda comandos de shell, sobe servidores, roda testes e usa o Git. As ferramentas de web buscam páginas e documentação. A inteligência de código mostra erros de tipo depois de uma edição e encontra definições e referências, com plugins específicos para isso. O agente também tem ferramentas para abrir subagentes e para fazer perguntas a você.

Os modelos são os da família Claude. A documentação indica o Sonnet para a maior parte das tarefas de código e o Opus para raciocínios mais pesados de arquitetura. Você troca de modelo durante a sessão com /model ou já abre o agente com claude --model seguido do apelido ou do nome completo. Os apelidos, como sonnet e opus, apontam para a versão recomendada no seu provedor e mudam com o tempo. O nome completo fixa uma versão.

O que o agente enxerga quando você abre a sessão

Ao rodar claude numa pasta, o agente ganha acesso aos arquivos dessa pasta e das subpastas, ao terminal com os mesmos comandos que você usaria, ao estado do Git com branch atual, mudanças não commitadas e histórico recente, ao seu CLAUDE.md e à auto memory que ele mesmo grava. Arquivos fora da pasta exigem a sua permissão. As extensões que você configurar, como servidores MCP, skills e subagentes, entram por cima disso.

Essa visão do projeto inteiro muda o tipo de tarefa que faz sentido. Um assistente que só completa linhas no editor enxerga apenas o arquivo aberto. No Claude Code, a instrução de corrigir o bug de autenticação leva o agente a procurar os arquivos ligados ao problema, ler vários deles, editar todos de forma coordenada, rodar os testes e fazer o commit quando você autoriza.

Sessões, janela de contexto e volta no tempo

Cada conversa é uma sessão ligada à pasta onde você abriu o agente. O Claude Code grava a sessão localmente num arquivo JSONL em ~/.claude/projects/. Por isso você retoma uma conversa com claude --continue ou claude --resume. Uma cópia independente sai com --fork-session ou /branch. Cada sessão nova começa com a janela de contexto vazia. O que precisa passar de uma sessão para outra fica no CLAUDE.md ou na auto memory.

A janela de contexto guarda a conversa, o conteúdo dos arquivos lidos, a saída dos comandos, o CLAUDE.md e as instruções do sistema. Quando ela enche, o agente compacta a conversa num resumo. O resumo mantém as suas instruções e os trechos de código principais, mas instruções do começo podem se perder. O comando /context mostra o que ocupa espaço. O /compact aceita um foco para a compactação.

Antes de editar um arquivo, o agente guarda uma cópia do estado atual. Cada mensagem sua que inicia um turno cria um checkpoint. O comando /rewind, ou Esc duas vezes com o campo vazio, abre o menu para voltar. Os checkpoints são separados do Git e só cobrem as edições feitas pelas ferramentas de arquivo. Banco, API e deploy não voltam com eles. Esses efeitos dependem do modo de permissão e das permissões allow, ask e deny que você define, assunto do hub de permissões.

A revisão continua sendo sua

O Claude Code é um produto proprietário da Anthropic, distribuído sob os Commercial Terms da empresa. O repositório público anthropics/claude-code concentra o CHANGELOG, as issues e os plugins oficiais. A versão de referência deste portal é a 2.1.327, a mais recente do CHANGELOG na consulta de 18/11/2026.

A própria documentação deixa a revisão do código e dos comandos com você antes de cada aprovação. Um teste verde mostra que o comando terminou sem erro. Ele não prova que a aplicação faz o que o cliente precisa. Ler a comparação das mudanças, entender por que cada arquivo mudou e rodar o fluxo real continua no seu lado da mesa. Para trabalhar com agentes de código ao lado de um desenvolvedor experiente, o Desenvolvimento Colaborativo da Dev Side Studio programa com você no editor e no terminal, sobre o código do seu produto.