o problema
Assistente de código nasceu dentro do editor e ficou preso ao gesto do editor: sugerir o próximo trecho de texto no cursor. Só que digitar não é o trabalho. O trabalho é ler o repositório até entender onde a coisa mora, mudar cinco arquivos que dependem um do outro, rodar a suíte, ler o erro que voltou e refazer. Um sugestor de texto participa de um passo desse ciclo e fica de fora dos outros quatro. Ele não pode rodar o teste que provaria que a sugestão presta.
O segundo problema é de superfície. A configuração de como o time escreve código — biblioteca preferida, decisão de arquitetura, checklist de review — mora na cabeça das pessoas ou num documento que a ferramenta não lê. E cada contexto de trabalho (editor, terminal, CI, celular) exige montar tudo de novo. O resultado sai como sugestão, que alguém ainda precisa aplicar à mão.
a ideia
Dar ao agente as mesmas ferramentas que a pessoa tem: sistema de arquivos, shell, git. Ele lê o codebase, edita arquivos, executa comandos, cria branch, escreve a mensagem de commit e abre o pull request. A conversa deixa de ser “me dê o código” e passa a ser “escreva os testes do módulo de auth, rode e conserte o que falhar”.
O segundo movimento é separar o motor da superfície. Terminal, extensão de VS Code, plugin de JetBrains, app de desktop e navegador são portas para o mesmo engine. O que define o comportamento — CLAUDE.md, settings, servidores MCP — vive no repositório e vale em todas.
como funciona
A sessão começa num diretório. Você faz cd no projeto e roda claude; a partir daí o agente tem o repositório como contexto. Fora do modo interativo, claude -p recebe prompt e stdin, o que o coloca na composição unix como qualquer outro comando:
tail -200 app.log | claude -p "Slack me if you see any anomalies"
git diff main --name-only | claude -p "review these changed files for security issues"A personalização tem três camadas. CLAUDE.md na raiz do projeto é lido no início de toda sessão e carrega instruções persistentes; além dele, o agente monta uma auto memory com o que aprende ao longo do tempo. Skills empacotam fluxos repetíveis que o time compartilha, no formato de comandos como /review-pr ou /deploy-staging. Hooks executam shell antes ou depois de ações do agente, para lint antes do commit ou formatação depois de cada edição. MCP é a porta para dados externos: Google Drive, Jira, Slack, ou ferramenta própria.
Para tarefas grandes, o agente abre subagentes que trabalham em partes diferentes em paralelo, com um líder que distribui e junta. Sessões inteiras em paralelo ficam visíveis na agent view. E há agendamento em dois lugares distintos: Routines rodam na nuvem e sobrevivem à sua máquina desligada, disparadas por tempo, chamada de API ou evento do GitHub; tarefas agendadas do desktop rodam local, com acesso aos seus arquivos.
A sessão também não fica presa à superfície onde nasceu. claude --cloud empurra para a web, claude --teleport traz de volta para o terminal, /desktop continua no app.
o que isso custou
A matriz de plataforma. /desktop só existe em macOS e Windows x64. O app de Linux está em beta, via apt, em Ubuntu e Debian. No Windows nativo, sem Git for Windows instalado o agente perde a tool Bash e cai para PowerShell. Teleport e handoff para desktop exigem assinatura claude.ai. A maioria das superfícies exige assinatura ou conta no Console; só terminal, VS Code e JetBrains aceitam provedor terceiro.
O canal de atualização é um trade-off explícito. A instalação nativa se atualiza sozinha. Homebrew e WinGet, não — e o cask claude-code fica tipicamente uma semana atrás do claude-code@latest, pulando releases com regressão grave. Estabilidade custa atraso, e o atraso vale também para correção de segurança.
E há o que a página não cobre por ser visão geral: nada sobre custo, taxa de erro, ou o que acontece quando o agente roda o comando errado. Permissão e controle de acesso a ferramenta aparecem uma vez, de passagem, na descrição do Agent SDK. Quem coloca isso em CI está entregando um shell a um modelo, e essa decisão precisa ser tomada em outra página que não esta.
onde isso aparece hoje
O CLAUDE.md virou artefato versionado como qualquer outro arquivo de configuração de projeto. MCP, descrito aqui como padrão aberto para conectar ferramentas de ia a fontes de dados externas, é o ponto de extensão que a ferramenta consome em vez de reinventar.
O agente também saiu do desktop do desenvolvedor: GitHub Actions e GitLab CI/CD para review e triagem automáticos, Chrome para depurar aplicação web ao vivo, @Claude no Slack transformando relato de bug em pull request. E o Agent SDK abre as mesmas ferramentas para quem quer construir o próprio agente em cima delas.