# Sua primeira ferramenta pequena

Transforme uma regra simples em uma calculadora local e teste entradas normais, vazias e inválidas.

Biblioteca Claude by Jaya · Exercício · Intermediário

Revisado em: 2026-09-14

Disponível em: https://jayaroberta.com/biblioteca/primeira-ferramenta

## O que você vai produzir

Uma calculadora de duração com regra explícita e testes conferidos.

## Antes de começar

Conhecer a regra do cálculo; acesso a um ambiente capaz de criar e executar a ferramenta.

## Construa algo cujo resultado você sabe conferir

Uma primeira ferramenta precisa resolver uma tarefa delimitada. Neste exercício, crie uma calculadora de duração: quantidade de encontros multiplicada pelos minutos de cada encontro. O resultado deve aparecer em minutos e em horas com minutos restantes.

A conta é determinística: para as mesmas entradas, o resultado deve ser o mesmo. Claude ajuda a construir o código; a ferramenta usa a regra matemática para calcular. Isso permite conferir o funcionamento sem depender da interpretação de uma nova resposta a cada uso.

## Descreva entradas, regra e erros

Você pode experimentar como Artifact ou usar Claude Code em uma pasta de projeto destinada ao exercício. A disponibilidade e a execução variam conforme o ambiente. Peça que Claude explique onde o resultado pode ser aberto e teste a versão real.

### Para experimentar

```text
Construa uma calculadora local de duração total.
Entradas: quantidade de encontros e minutos por encontro, ambos inteiros positivos.
Regra: total = quantidade × minutos.
Mostre o total em minutos e em horas com minutos restantes.
Campos vazios, zero, negativos e valores fracionários devem gerar uma mensagem clara, sem resultado enganoso.
Use rótulos visíveis e navegação por teclado.
Não use cadastro, API, banco ou envio de dados.
Não altere arquivos fora da pasta do exercício e não publique.
Explique como abrir e testar a ferramenta.
```

## Teste o que costuma escapar

Comece com três encontros de quarenta e cinco minutos: o resultado esperado é cento e trinta e cinco minutos, ou duas horas e quinze minutos. Depois teste um encontro de sessenta minutos. Confira se a apresentação mantém a equivalência entre os formatos.

Apague um campo, informe zero, um número negativo e uma fração. A ferramenta deve explicar o problema e não manter um resultado antigo como se fosse válido. Corrija qualquer falha e repita o caso. Conclua quando as contas e os estados de erro funcionarem no arquivo ou endereço que você realmente vai usar.

## Confira sua entrega

- [ ] A regra do cálculo está explícita.
- [ ] As duas contas de referência passaram.
- [ ] Entradas inválidas não exibem resultado enganoso.
- [ ] Testei a ferramenta real e a navegação por teclado.

## Fontes para consultar

- [Anthropic · O que são Artifacts](https://support.claude.com/en/articles/9487310-what-are-artifacts-and-how-do-i-use-them)

Próxima leitura: https://jayaroberta.com/biblioteca/coordenar-agentes