Claude Platform 101 • Aula visual

Da API ao agente em producao.

Ambiente de estudo sobre a Claude Developer Platform: Messages API, modelos, tools, skills, MCP, extended thinking, managed agents e Claude Code. Uma pagina pronta para publicar no Tela Preta.

Comecar estudo telapreta.dev.br

3camadas da plataforma

1chamada central: messages.create

8modulos do Claude Platform 101

claude-platform-101.ts

const response = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  system: "Voce e um assistente tecnico objetivo.",
  messages: [
    {
      role: "user",
      content: "Explique MCP, Tools e Skills."
    }
  ],
});

Ideia central

Claude deixa de ser apenas uma conversa e passa a fazer parte do produto: recebendo requisicoes estruturadas, usando ferramentas, seguindo procedimentos e executando agentes.

O que e a Claude Developer Platform?

E a infraestrutura da Anthropic para construir aplicacoes com Claude de forma programatica: API REST, SDKs, CLIs e console para chaves, uso, agentes, testes e observabilidade.

01 • Primitives

Construir

Messages API, tool use, files, web search, code execution, MCP servers e skills.

Messages APITool useFilesMCPSkills

02 • Infrastructure

Escalar

Managed agents, retries, filas, observabilidade, prompt caching e memoria.

Managed AgentsRetriesQueuesObservability

03 • Controls

Operar

Dashboards, evals, workspaces, logs, limites de uso, limites de gasto e request logs.

DashboardsEvaluationsLogsSpend limits

Build with primitives, scale on infrastructure, run with control.

Em portugues direto: construa com os blocos basicos, escale com infraestrutura e opere com controles de producao.

Videos do curso

Ja inseri o embed real da primeira aula, What is the Claude Developer Platform?. Os demais cards ficam prontos para receber os proximos IDs de YouTube, Vimeo ou MP4.

Sua primeira chamada API

O padrao central e messages.create. Voce escolhe o modelo, define o limite de tokens e envia uma lista de mensagens.

messages.create basico

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const msg = await client.messages.create({
  model: "claude-opus-4-7",
  max_tokens: 1024,
  messages: [{
    role: "user",
    content: "Hello, Claude",
  }],
});

Parametros essenciais

O que a chamada precisa?

A chamada messages.create exige um model, um limite de max_tokens e uma lista de messages. O system prompt e opcional, mas muito util para definir comportamento e tom.

model max_tokens messages system

Escolhendo o modelo certo

A melhor escolha e o modelo mais barato que entrega qualidade suficiente para voce publicar em producao.

Haiku

Rapido e barato

Ideal para classificacao, extracao, roteamento e tarefas simples em alto volume.

Sonnet

Equilibrio

Bom para a maioria das tarefas de producao, equilibrando inteligencia, velocidade e custo.

Opus

Alta complexidade

Use para raciocinio profundo, analise complexa, codigo multi-etapas e escrita mais sofisticada.

Agent loop explicado

Um agente e Claude em loop: observa, decide, age, recebe resultado e repete ate finalizar.

Mensagem

O usuario envia uma tarefa para Claude com ferramentas disponiveis.

Decisao

Claude decide responder ou solicitar o uso de uma ferramenta.

Execucao

O seu codigo executa a ferramenta solicitada.

Retorno

O resultado volta para Claude como tool_result.

Fim

O loop para quando o stop_reason e end_turn.

Tools, Skills e Thinking

Sao recursos diferentes para dar capacidade, procedimento e raciocinio ao Claude.

Recurso	Para que serve	Quando usar
Tools	Conectam Claude aos seus sistemas, dados e acoes. Claude solicita, mas seu codigo executa.	Banco de dados, APIs internas, CRM, sistemas proprios e automacoes.
Skills	Ensinam um procedimento, formato, checklist ou padrao de trabalho.	Relatorios, release notes, padroes de revisao, templates e rotinas.
Extended Thinking	Da mais espaco para Claude raciocinar antes de responder.	Matematica, logica, debug, analise regulatoria e decisoes com trade-offs.

MCP: Model Context Protocol

MCP evita que voce mantenha manualmente integracoes de terceiros. O provedor publica um servidor MCP e Claude descobre ferramentas, schemas e autenticacao.

Tools

Seu codigo

Use para dados e sistemas internos. Voce cria e mantem a integracao.

Skills

Seu processo

Use quando o "como fazer" importa tanto quanto o resultado final.

MCP

Servicos externos

Use para ferramentas de terceiros mantidas pelo proprio provedor do servico.

Managed Agents

Um managed agent e o loop do agente rodando na infraestrutura da Anthropic, em vez de rodar no seu servidor.

Quando usar

Trabalho longo, sandboxed ou resiliente

Ideal quando o agente pode rodar por minutos ou horas, usar muitos arquivos, precisar de ambiente isolado, persistencia e retomada apos falhas.

Primitivos

Agent → Environment → Session → Events

Voce cria o agente, define o ambiente, inicia uma sessao e consome eventos: mensagens, tool uses, resultados e status idle.

Claude Code

Claude Code e um agente que edita arquivos, executa comandos, le erros e corrige codigo dentro do terminal.

Comando importante

# Invoca a skill integrada para trabalhar com Claude API
/claude-api

# Adiciona skills da Anthropic pelo marketplace
/plugin marketplace add AnthropicsSkills

Quiz rapido

Use esta area como revisao antes do assessment.

Quais tres parametros o messages.create exige?

Resposta: Um model, um max_tokens limit e uma lista de messages.

Quando Claude decide usar uma tool, quem executa?

Resposta: O seu codigo executa a ferramenta e envia o resultado de volta.

Por que contexto importa em agentes longos?

Resposta: A janela e finita e voce paga pelo que esta nela; o objetivo e colocar as informacoes certas.

Qual trabalho combina com managed agent?

Resposta: Trabalho longo, sandboxed ou em background.

Qual comando slash invoca a skill Claude API no Claude Code?

Resposta: /claude-api.

Treinamentos em Open Source, Cloud e IA

Conteudo pratico para quem quer aprender tecnologia de verdade: Linux, Docker, Azure, AWS, Kubernetes, DevOps e Inteligencia Artificial.

Conheca a Tela Preta Ver videos