A família Claude da Anthropic é a linha de modelos de código fechado mais capaz para codificação séria, trabalho autônomo e raciocínio de longo contexto, e o preço da API reflete isso: Sonnet custa $3 / $15 por milhão de tokens, Opus custa mais caro. Esse custo impede a maioria dos projetos paralelos antes mesmo de começarem. Existe um caminho que inverte completamente o modelo de cobrança: Puter.js expõe a linha completa do Claude (Opus 4.7, Sonnet 4.6, Haiku 4.5 e outras sete variantes) sem uma chave Anthropic, e cobra o usuário final em vez do desenvolvedor. Para você, como desenvolvedor, é estruturalmente gratuito e ilimitado.
Este guia detalha a configuração de ponta a ponta: os IDs dos modelos, o código funcional, o streaming e as compensações que você precisa conhecer antes de lançar.
TL;DR
- Puter.js oferece aos desenvolvedores acesso gratuito e ilimitado à família Claude completa, sem chave de API, sem cobrança da Anthropic, sem servidor.
- O usuário final cobre seu próprio uso a partir de uma conta Puter; você não paga nada.
- Modelos suportados: Opus 4.7, Opus 4.6, Opus 4.6 Fast, Opus 4.5, Opus 4.1, Opus 4, Sonnet 4.6, Sonnet 4.5, Sonnet 4, Haiku 4.5.
- Uma tag
<script>, uma chamada de função (puter.ai.chat), e você está conversando com Claude. - Streaming, prompts de sistema, conversas multi-turnos funcionam; Puter replica o formato de mensagem da Anthropic.
- Use o Apidog para testar o mesmo prompt contra Claude via Puter e contra a API oficial da Anthropic para benchmarking.
Como o “gratuito ilimitado” funciona por baixo dos panos
Puter.js é uma biblioteca de nuvem e IA serverless que é executada no navegador. A inversão da arquitetura: em vez de você possuir a chave de API da Anthropic e arcar com os custos, seu usuário final faz login no Puter (conta gratuita) e a chamada é cobrada do saldo dele. Novas contas Puter vêm com crédito inicial; os usuários recarregam se quiserem mais.
Para o desenvolvedor, isso significa três coisas:
- Nenhuma chave de API no seu repositório. Sem risco de vazamento, sem rotação, sem chaves específicas de projeto para gerenciar.
- Sem limite de uso da sua parte. Cada usuário utiliza sua própria conta, então seu “limite” escala linearmente com sua base de usuários.
- Nenhuma relação com a Anthropic é necessária. Você nunca assina um contrato com a Anthropic; Puter é o intermediário.
A contrapartida: isso é focado no navegador. Um script Python de backend não pode usar o Puter sem uma sessão de usuário logado. Para uso em backend, consulte a seção de alternativas abaixo.
Passo 1: Inclua o script
Uma tag no seu HTML, sem etapa de build:
<script src="https://js.puter.com/v2/"></script>
Essa é toda a instalação. Não há npm install, nenhuma configuração de chave, nenhuma configuração de DNS. Se você preferir NPM para um aplicativo empacotado:
npm install @heyputer/puter.js
import { puter } from '@heyputer/puter.js';
A tag CDN é o caminho de menor resistência para um site estático ou um protótipo rápido. A importação NPM oferece tree-shaking e tipos TypeScript em um build Vite ou Webpack.
Passo 2: Escolha um modelo Claude
Puter expõe o catálogo completo da Anthropic. Os IDs dos modelos seguem a nomenclatura da Anthropic com separadores de hífen:
| ID do Modelo | Quando usar |
|---|---|
claude-opus-4-7 |
Último carro-chefe; raciocínio mais profundo, melhor trabalho autônomo |
claude-opus-4-6 |
Carro-chefe anterior; boa codificação, ligeiramente mais barato |
claude-opus-4.6-fast |
Variante Opus de menor latência |
claude-opus-4-5 |
Escolha estável para agentes de produção |
claude-opus-4-1 |
Legado estável; comportamento bem compreendido |
claude-opus-4 |
Linha de base original do Opus 4 |
claude-sonnet-4-6 |
Principal para uso diário; forte equilíbrio custo/qualidade |
claude-sonnet-4-5 |
Sonnet anterior; mais barato, ainda excelente para a maioria das tarefas |
claude-sonnet-4 |
Linha de base do Sonnet 4 |
claude-haiku-4-5 |
Mais rápido, mais barato; bom para classificação de alto volume |
Os dois que você usará primeiro: claude-sonnet-4-6 para raciocínio diário e claude-haiku-4-5 para classificação rápida. Use claude-opus-4-7 quando precisar de profundidade real (raciocínio de formato longo, revisão de código complexa, planejamento autônomo multi-etapas).
Passo 3: Faça Claude conversar
A chamada mínima viável:
<!DOCTYPE html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
puter.ai.chat(
"Explique computação quântica em termos simples",
{ model: 'claude-sonnet-4-6' }
).then(response => {
puter.print(response.message.content[0].text);
});
</script>
</body>
</html>
Abra o arquivo em um navegador. O Puter lida com a chamada da API, o usuário faz login (ou cria uma conta Puter gratuita na primeira execução), e a resposta é impressa na página.
O formato da resposta espelha a API de mensagens da Anthropic. response.message.content é um array de blocos de conteúdo; para respostas de texto simples, você lê [0].text. Para respostas multipartes (texto + chamadas de ferramenta), itere o array.
Passo 4: Transmita a resposta
Respostas longas parecem lentas sem streaming. Passe `stream: true` e consuma o iterador:
const response = await puter.ai.chat(
"Escreva um ensaio detalhado sobre o impacto da inteligência artificial na sociedade",
{ model: 'claude-sonnet-4-6', stream: true }
);
for await (const part of response) {
puter.print(part?.text);
}
O padrão `for await` lê os blocos à medida que chegam. Para uma interface de chat, anexe cada `part.text` ao balão de mensagem; o usuário vê o texto aparecer palavra por palavra.
Passo 5: Conversas multi-turnos
Passe um array de mensagens em vez de uma única string. Cada mensagem tem um `role` e `content`:
const messages = [
{ role: 'user', content: 'Estou construindo um aplicativo Next.js com Postgres.' },
{ role: 'assistant', content: 'Entendi. Em que posso ajudar?' },
{ role: 'user', content: 'Como devo estruturar a pasta de migrações?' },
];
const response = await puter.ai.chat(messages, {
model: 'claude-opus-4-7',
});
console.log(response.message.content[0].text);
Para manter o estado entre as interações, adicione cada mensagem do usuário e cada resposta do assistente ao array antes da próxima chamada. Claude lê a transcrição completa e permanece consistente.
Passo 6: Prompts de sistema
Defina a persona, restrições e formato de saída com uma mensagem de sistema no início:
const messages = [
{ role: 'system', content: 'Você é um engenheiro de backend sênior. Responda em marcadores numerados, nunca mais de cinco.' },
{ role: 'user', content: 'Como eu previno injeção de SQL em um aplicativo Node?' },
];
const response = await puter.ai.chat(messages, { model: 'claude-sonnet-4-6' });
Prompts de sistema se mantêm por toda a conversa e são o lugar certo para definir tom, formato de saída e diretrizes comportamentais.
Comparando modelos com o mesmo prompt
A maneira mais rápida de encontrar o modelo Claude certo para o seu caso de uso é aplicar o mesmo prompt a todos eles e comparar. Um pequeno loop de benchmark:
const models = ['claude-haiku-4-5', 'claude-sonnet-4-6', 'claude-opus-4-7'];
const prompt = "Refatore este componente React para usar hooks: ...";
for (const model of models) {
const start = performance.now();
const response = await puter.ai.chat(prompt, { model });
const elapsed = performance.now() - start;
console.log(`${model}: ${elapsed.toFixed(0)}ms`);
console.log(response.message.content[0].text);
console.log('---');
}
Execute uma vez e você verá o padrão de compensação: Haiku é 5 a 10 vezes mais rápido que Opus, Sonnet fica no meio, Opus produz respostas visivelmente melhores em prompts difíceis. Para a maioria dos aplicativos, Sonnet 4.6 é o padrão correto.
Para fazer o benchmark do caminho gratuito do Puter contra a API oficial da Anthropic no Apidog, mantenha ambos os provedores na mesma coleção e alterne o ambiente.
O que você obtém e o que não obtém
Claude gratuito ilimitado através do Puter é real, mas a superfície é um subconjunto da API oficial. A lista honesta:
Você obtém:
- Catálogo completo de modelos Claude (Opus, Sonnet, Haiku, todas as versões atuais)
- Conversas multi-turnos
- Prompts de sistema
- Respostas em streaming
- Escala pronta para produção (Puter gerencia a infraestrutura)
- Zero exposição a cobranças para você como desenvolvedor
Você pode não obter (dependendo da versão do Puter):
- Uso nativo de ferramentas / chamada de função (verifique a documentação mais recente do Puter)
- Entrada de visão (anexos de imagem)
- Redução de custo de cache de prompt da Anthropic
- Uso server-side sem contexto de navegador
- Visibilidade direta do limite de taxa (você não vê os cabeçalhos da Anthropic)
Para fluxos de trabalho de uso profundo de ferramentas, a API oficial da Anthropic ou o teste de servidor MCP no Apidog oferece mais controle. Para um chatbot típico, aplicativo de perguntas e respostas ou gerador de conteúdo, a superfície do Puter é suficiente.
Quando usar Puter vs a API oficial da Anthropic
A divisão:
Use Puter quando:
- Você está lançando um aplicativo público gratuito e não quer exposição a cobranças.
- Você está prototipando e ainda não quer estabelecer uma relação de cobrança com a Anthropic.
- Você quer dar suporte a Claude em um site estático, projeto de hackathon ou extensão de navegador sem um backend.
- Seus usuários estão dispostos a fazer login no Puter (ou já o utilizam).
Use a API oficial da Anthropic quando:
- Você precisa de chamadas server-side (tarefas agendadas, endpoints de API, processamento em lote).
- Você precisa de cache de prompts para economizar custos em prompts de sistema estáveis.
- Você precisa de uso granular de ferramentas, entrada de visão ou a API de Arquivos.
- Você precisa de uma relação contratual para conformidade (BAAs, SOC 2, residência regional).
- Seus usuários não tolerarão uma etapa de login no Puter.
A maioria dos projetos começa no Puter para prototipagem e migra para a API oficial quando atingem um dos limites acima. A migração é direta; o formato da mensagem é o mesmo.
Para o equivalente GPT, consulte Como usar a API GPT-5.5.
Testando a integração no Apidog
As chamadas do Puter acontecem no navegador, então você não pode scriptá-las diretamente de um test runner de backend. O padrão que funciona:
- Crie uma pequena página estática com o script Puter e um parâmetro de consulta para o prompt.
- Use o Apidog para validar a superfície da API upstream da Anthropic (quando você eventualmente migrar).
- Mantenha ambos como ambientes separados na mesma coleção Apidog para que você possa alternar com um clique.
Baixe o Apidog e configure dois ambientes: `puter-prototype` (uma URL localhost hospedando sua página Puter) e `anthropic-prod` (`https://api.anthropic.com/v1`). A coleção migra de forma limpa quando você passa do Puter para a API oficial.
FAQ
Isso é realmente ilimitado, ou há um limite oculto?Ilimitado do lado do desenvolvedor, sim. O usuário final tem o saldo que estiver em sua conta Puter; novas contas recebem crédito inicial e os usuários recarregam se quiserem mais. Não há limite por desenvolvedor.
Preciso me inscrever na Anthropic?Não. O Puter gerencia a relação com a Anthropic. Você nunca verá uma chave Anthropic.
Posso usar isso em produção?Sim para aplicativos baseados em navegador. O Puter executa infraestrutura de produção. A pergunta certa é se seus usuários estão dispostos a fazer login no Puter; se sim, lance-o.
Claude via Puter tem o mesmo desempenho da API oficial?A saída do modelo é a mesma; Puter chama a API oficial da Anthropic em nome do usuário. A latência pode ser marginalmente maior devido ao salto extra, mas o comportamento do modelo permanece inalterado.
E sobre a economia de cache de prompt de Claude?O Puter não expõe os controles de preço de cache de prompt da Anthropic hoje. Se você tiver um prompt de sistema estável de 50k tokens e precisar do desconto de cache, use a API oficial.
Posso usar Claude em um bot do Discord ou serviço de backend através do Puter?Não de forma limpa. O Puter é focado no navegador e assume uma sessão de usuário. Serviços de backend devem usar a API oficial da Anthropic.
Qual modelo devo usar por padrão?`claude-sonnet-4-6`. É o equilíbrio certo de custo, velocidade e qualidade para a maioria dos prompts. Mude para `claude-opus-4-7` quando precisar de raciocínio mais profundo, e para `claude-haiku-4-5` quando precisar de classificação em massa.
Meus usuários serão cobrados muito?A maioria do uso em estilo chat custa centavos por sessão nas taxas da Anthropic. Um usuário casual pode executar dezenas de conversas com o crédito inicial do Puter antes de precisar recarregar.
Concluindo
Claude gratuito ilimitado através do Puter.js é o caminho mais limpo para qualquer aplicativo baseado em navegador que deseja saída com qualidade Anthropic sem a cobrança da Anthropic. Inclua o script, escolha um modelo, escreva o prompt. O usuário final cobre o uso; você entrega sem uma chave.
Para cargas de trabalho server-side, cache de prompt ou fluxos completos de uso de ferramentas, a API oficial da Anthropic ainda é a resposta certa. Mas para protótipos, aplicativos públicos gratuitos, projetos de hackathon, projetos paralelos e sites estáticos, Puter é a resposta.
Crie a requisição uma vez no Apidog, faça o benchmark do Puter contra a API oficial e escolha o caminho que se adequa ao seu projeto.