Neste post
Em resumo: quando você aperta Enter no Claude Code, o seu prompt sai do computador como uma requisição, junto com o contexto: a conversa até ali, instruções, ferramentas e os arquivos que ele leu. Ela vai por HTTPS até a API da Anthropic, talvez atravessando um oceano em um cabo submarino, até um data center onde chips de IA rodam o modelo. A resposta volta token por token. Às vezes a resposta é um pedido para ler um arquivo ou rodar um comando na sua máquina; o Claude Code executa, depois de perguntar onde está configurado para perguntar, e envia o resultado de volta. Esse ciclo é o agente.
Uma requisição, mais do que o seu prompt
O Claude Code roda na sua máquina: nas palavras da Anthropic, ele "reads your codebase, edits files, runs commands, and integrates with your development tools" (lê o seu código, edita arquivos, roda comandos e se integra às suas ferramentas). Quando você aperta Enter, ele envia uma requisição à API do Claude, em https://api.anthropic.com, por HTTPS.
Essa requisição leva mais do que você digitou. Tudo nela conta para a janela de contexto do modelo: "the system prompt, every message in messages (including tool results, images, and documents), and your tool definitions" (o prompt de sistema, cada mensagem em messages, incluindo resultados de ferramentas, imagens e documentos, e as definições de ferramentas).
Talvez atravessando um oceano
Do seu roteador e do seu provedor, a requisição viaja pela internet até onde o modelo roda. Entre continentes, isso costuma ser um cabo no fundo do mar: a TeleGeography estima que os cabos submarinos levam "over 99%" (mais de 99%) do tráfego de dados intercontinental (o tráfego por satélite não pode ser medido com precisão).
Onde ela chega nem sempre é perto. Por padrão, a API da Anthropic diz que "inference may run in any available geography" (a inferência pode rodar em qualquer região disponível); só a opção us a mantém em infraestrutura nos EUA. Então o data center pode estar do outro lado do oceano.
Chips, camadas, tokens
No data center, chips de IA rodam o modelo. A Anthropic treina e roda o Claude em "AWS Trainium, Google TPUs, and NVIDIA GPUs". O modelo calcula a resposta um token por vez (o vídeo o desenha como camadas empilhadas: uma ilustração, não a arquitetura real).
A resposta não espera ficar pronta. Com streaming, a API a envia "incrementally … using server-sent events (SSE)" (aos poucos, com server-sent events), então cada token volta pelo mesmo caminho assim que é escrito.
O ciclo é o agente
Às vezes o que volta não é texto, mas um pedido para fazer algo: ler um arquivo, rodar um comando. Nos termos da API, o Claude responde com um bloco tool_use, "your code runs the operation and sends back a tool_result" (o seu código executa a operação e devolve um tool_result). Aqui, o seu código é o Claude Code, na sua máquina.
Ele pergunta antes. No modo manual padrão, o Claude Code pergunta antes de rodar comandos Bash (exceto um conjunto embutido de comandos só de leitura) e antes de modificar arquivos. Você aprova, ele roda na sua máquina, e o resultado volta como a próxima requisição. De novo e de novo, até a tarefa terminar: esse ciclo é o agente.
Para levar
O Claude Code é um ciclo entre a sua máquina e um modelo em um data center distante. O que roda na sua máquina roda porque o Claude Code rodou, depois de perguntar onde está configurado para perguntar.
Fontes
- Anthropic, visão geral do Claude Code
- Anthropic, permissões do Claude Code
- Anthropic, visão geral da API
- Anthropic, janelas de contexto
- Anthropic, residência de dados
- Anthropic, streaming
- Anthropic, visão geral do uso de ferramentas
- Anthropic, parceria de computação com Google e Broadcom
- TeleGeography, Mythbusting, part 3
O vídeo é animado com código (renderizado no Blender), e o roteiro foi escrito com ajuda de IA; cada fato acima foi conferido com as fontes. Ilustrativo: a rota (um provedor, um cabo, um data center), o modelo como camadas empilhadas e o texto na tela. Este é um explicativo independente, sem vínculo com a Anthropic. O vídeo está em inglês. Feito com o Shotloop, meu app gratuito para Mac de explicativos feitos com código, corrigidos uma cena de cada vez.