Introdução

O Claude Code é o sistema agentic de coding da Anthropic: um assistente nativo de CLI que lê seu repositório, planeja mudanças em várias etapas, executa comandos e itera até concluir a tarefa. Diferente de autocomplete inline, ele opera no escopo do projeto. Você descreve um resultado — refatorar autenticação, consertar suite de testes quebrada, preparar branch de release — e o agente escolhe arquivos, edições, ações no terminal e passos de verificação dentro dos limites que você permitir.

Desenvolvimento

Terminal-first por design

O design terminal-first é intencional. Como o Claude Code roda onde você já trabalha, pode invocar git, runners de teste, gerenciadores de pacote e outras ferramentas CLI sem sandbox separado de plugin de IDE. Essa composabilidade é a tese do produto: o agente deve parecer um utilitário Unix que raciocina sobre código, não um chat colado num editor.

Instalação

# macOS / Linux — instalador oficial Anthropic
curl -fsSL https://claude.ai/install.sh | bash

# Verificar
claude --version

No diretório do projeto:

cd ~/projects/meu-repo
claude

Loop orientado a objetivo

Por baixo dos panos, o Claude Code se comporta como um loop orientado a objetivo, não como completion de uma tacada só. Inspeciona o codebase, forma plano entre arquivos, aplica edições, roda testes, lê falhas e ajusta. Você continua no controle do que vai para commit, mas a execução pode avançar de forma autônoma dentro das permissões configuradas. A Anthropic descreve isso como coding agentic: o modelo age em direção a um objetivo com autonomia limitada, em vez de esperar orientação linha a linha.

Configuração no repositório

A configuração fica perto do repositório. A pasta .claude guarda regras do projeto em CLAUDE.md, permissões, comandos slash customizados, skills reutilizáveis e definições opcionais de subagentes.

Exemplo mínimo de CLAUDE.md:

# CLAUDE.md

## Projeto
Blog Hugo KaiporaLabs — tema hugo-up-business, deploy Dokku.

## Comandos
- npm run dev — servidor local
- npm run build — build produção
- git push dokku main — deploy

## Regras
- Respostas e commits em português
- Nunca commitar secrets
- Escopo mínimo nas mudanças

Essa estrutura transforma o Claude Code de chatbot genérico em operador específico do time — com padrões de código, expectativas de review e allowlists de comandos seguros codificados uma vez e reutilizados entre sessões.

Permissões e modos

# Sessão read-only para exploração
claude --permission-mode plan

# Sessão com escrita (padrão interativo)
claude

# Exemplo de tarefa
claude "corrija os testes quebrados em src/auth/"

Integrações

O Claude Code também integra para fora: sessões no terminal, fluxos em IDE e interações no GitHub via @claude fazem parte da mesma família. A superfície exata depende do setup, mas o modelo de capacidades é consistente — ler contexto, propor mudanças, executar ferramentas, reportar resultados.

Onde encaixa no ecossistema KaiporaLabs

O Claude Code brilha em tarefas focadas de engenharia: migrações, reparo de testes, arqueologia de repositório e preparação de PR. Não substitui pipeline inteiro de entrega; dá a cada dev um agente confiável que respeita repositório, shell e aprovação humana no momento do commit.

Conclusão

Conselho prático para começar:

1. Inicie com exploração read-only
2. Aperte permissões antes de liberar escrita
3. Mantenha CLAUDE.md curto e objetivo
4. Trate cada sessão como um dev júnior com acesso ao shell — capaz, rápido e que merece review

Usado assim, o Claude Code vira parte durável da stack, não demo passageira. Combine com Hermes Agent para ops em VPS e com Harness para orquestração na IDE.