Kickoff Builders SP • 15 de abril de 2026

Claude Code
além do terminal

Do CLI interativo a agentes autônomos em produção

Luiz Couto PixFly Claude Code Ambassador

Sobre mim

Luiz Couto

  • PixFly — consultoria AI-native (workshops, implementação)
  • Organizador dos meetups Claude Code SP (2 edições, ~200 devs)
  • Claude Code Ambassador pela Anthropic
  • Desde janeiro, 100% do meu código passa pelo Claude Code
5
projetos em prod
0
equipe
A tese

Claude Code não é um CLI

É uma plataforma de agentes. CLI, Desktop, Web, SDK, Cloud.

Interativo CLI + Desktop
Web claude.ai/code
Programático claude -p
SDK Agent SDK
Autônomo Routines

A maioria das pessoas usa apenas o primeiro modo. Os outros três são onde as coisas ficam insanas.

Modo Programático

claude -p

Claude Code como processo headless. Sem terminal, sem interação. Entrada por stdin ou argumento, saída por stdout.

# Pipe: alimenta contexto, recebe resultado cat README.md | claude -p "Resuma em 3 bullets" # Stream JSON: metadados em tempo real claude -p "Refatore auth.ts" --output-format stream-json # Composição com ferramentas Unix git diff HEAD~5 | claude -p "Gere release notes" > CHANGELOG.md # Batch: processar N arquivos find src -name "*.ts" | xargs -I{} claude -p "Adicione JSDoc a {}"
Agent SDK

Construa seu próprio Claude Code

TypeScript e Python. Mesmo runtime, suas regras.

import { Claude } from '@anthropic-ai/claude-code'; const agent = new Claude({ systemPrompt: `Você é um agente de deploy. Só toque em arquivos dentro de src/. Nunca faça force push.`, permissionMode: "bypassPermissions", }); // Uma chamada. O agente faz o resto. const result = await agent.query({ prompt: "Corrija o bug #142 e abra um PR", options: { maxTurns: 20 } });

System prompt programático — controle total do comportamento

Structured Output — JSON Schema, Zod, Pydantic

Self-building systems

O sistema que se auto-constrói

Claude Code disponível dentro da sua aplicação via Agent SDK. O usuário final descreve o que quer. O sistema implementa, testa e faz deploy.

Usuário descreve
Agent SDK
Gera código
Testa
Deploy

Self-correct

Se o teste falha, o agente lê o erro, corrige o código e tenta de novo. Loop até passar.

Guardrails

System prompt limita escopo. Permissions controlam quais tools o agente pode usar. Sandbox isola.

Arquitetura

Como montar isso na prática

Sua Aplicação (Next.js, API, CLI)
claude -p
local, pipes, stream
Agent SDK
query() + tools
Routines
cloud, managed
Git repo
Conectores (Slack, Linear)
APIs externas
Local: Mac ou VPS (~4 EUR/mês)
Cloud: Routines na infra Anthropic
Assinatura: Pro ou Max
Anunciado ontem • 14/abr/2026

Routines

Um skill com trigger: prompt + repo + conectores + automação. Roda na infra da Anthropic. Sem VPS, sem laptop ligado.

Se você já usava /schedule no CLI, seus schedules já são Routines. Agora com 3 triggers:

Schedule

Cron na nuvem

Horário, diário, semanal. O agente acorda, clona o repo, executa o prompt, abre PR. Você configura uma vez e esquece.

GitHub

Evento do repo

PR aberto, release publicada, issue criada. A routine reage automaticamente: review, port, docs update. Cada evento vira uma sessão.

API

HTTP endpoint

Cada routine tem sua URL + token. POST com payload e o agente roda. Conecte alertas, deploys, pipelines. Retorna session URL.

Conectores incluídos: Slack, Linear, Google Drive. O agente lê issues, posta no canal, abre tickets. Tudo com suas credenciais, tudo auditável.

Por dentro de uma Routine

Sessão completa do Claude Code na nuvem

Sem approval prompts. Sem permission picker. O agente roda shell commands, usa skills do repo, chama conectores. Autonomia total.

Repos + Branches

Escolha quais repos o agente clona. Por padrão, só push em branches claude/*. Libere branch push só se precisar.

Environment

Nível de acesso à rede, variáveis de ambiente (API keys, tokens), setup script (install deps antes de cada run).

Conectores

Slack, Linear, Google Drive. Todos incluídos por padrão. Remova o que a routine não precisa. Princípio do menor privilégio.

Escopo = segurança. A routine só alcança o que você explicitamente inclui. Repos, rede, conectores. Nada mais.

8 de abril de 2026

Managed Agents

Para quem quer colocar agentes no produto, servindo seus usuários. A Anthropic cuida da infraestrutura. Você define o agente.

Harness

O loop que chama Claude e roteia tool calls. Stateless, recuperável.

Sandbox

Ambiente isolado para execução de código. Provisiona sob demanda.

Session

Log append-only de tudo que aconteceu. Durável, excede context window.

Tools + MCP

Suas ferramentas, seus MCPs. Credenciais isoladas do sandbox.

TTFT p50 caiu ~60%, p95 caiu >90%. Cada componente falha independente. Se o container morre, o harness captura como tool-call error e segue.

O mapa completo

Qual usar quando

Agent SDK

  • Onde: local (seu servidor)
  • Para: embedar Claude Code no seu código
  • Controle: total (system prompt, permissions, tools)
  • Exemplo: bot interno, automação custom

Routines

  • Onde: cloud Anthropic
  • Para: automatizar seu workflow de dev
  • Triggers: schedule, GitHub, API
  • Exemplo: review de PR, triage de alertas

Managed Agents

  • Onde: cloud Anthropic (API)
  • Para: agentes no seu produto, para seus usuários
  • Escala: enterprise, multi-tenant
  • Exemplo: SaaS com agente AI embutido

Tudo lançado nas últimas 2 semanas. Agent SDK para code, Routines para automação, Managed Agents para produto. A Anthropic está construindo a plataforma completa de agentes.

Tudo que um ser humano consegue fazer
no digital, o Claude Code
também consegue

Ler, escrever, navegar, testar, fazer deploy, mandar mensagem, abrir PR, responder alerta. A diferença é que ele faz isso a qualquer hora, sem parar, e em escala.

Obrigado

Vamos conversar no networking

Luiz Couto

luiz@pixfly.com • pixfly.com

+55 11 99633-6837

Meetups Claude Code SP • próxima edição em breve