Integração Claude é usar a API da Anthropic dentro do seu sistema para tarefas de texto longo e de raciocínio: revisar o catálogo inteiro, ler contrato de fornecedor, montar um agente que consulta a API do Magento. Eu integro em PHP com o SDK oficial da Anthropic ou cURL, com saída estruturada, prompt caching e Batch API para manter o custo previsível.
Atualizado em · por Roger Takemiya
Uso os três grandes provedores e escolho por tarefa. O Claude, da Anthropic, entra quando a entrada é grande e a saída precisa de cuidado. Os modelos atuais aceitam até 1 milhão de tokens de contexto: cabe um catálogo exportado inteiro, um manual de fornecedor com centenas de páginas ou um módulo Magento junto com as dependências.
Também é o que eu mais uso para agente, quando o modelo precisa chamar ferramentas em sequência (consultar pedido, ler estoque, abrir chamado) e terminar com um resultado estruturado que o meu código consegue validar.
A Anthropic organiza os modelos em famílias. O Haiku é o rápido e barato, bom para classificar e extrair em volume. O Sonnet é o meio-termo que resolve a maior parte das integrações. O Opus fica para tarefa difícil, e o Fable é o mais capaz e o mais caro. Começo sempre pelo menor que passa no teste com amostra real, e muitas vezes o Haiku basta.
A resposta sai em JSON validado contra um schema que eu defino. Acaba a gambiarra de pedir “responda só em JSON” e torcer para não vir uma frase antes.
Declaro funções como buscar pedido por número ou ler o estoque de um SKU. O modelo pede a função, o meu código executa na API do Magento com um token de permissão mínima e devolve o resultado. A credencial nunca vai para o modelo.
Instruções longas, glossário da loja e exemplos ficam marcados para cache. Nas chamadas seguintes essa parte é lida do cache e custa uma fração da entrada normal.
Para reprocessar catálogo de madrugada: envio milhares de pedidos de uma vez, o processamento é assíncrono e custa metade do preço.
Em pergunta sobre política de troca ou manual técnico, a resposta aponta o trecho exato do documento de onde saiu. Conferir fica fácil.
O Model Context Protocol é um padrão aberto para ligar o modelo a ferramentas e dados. Uso quando a mesma ferramenta precisa servir a mais de um cliente de IA sem reescrever a integração.
Um cenário comum em loja Magento antiga: 6 mil produtos com descrições escritas ao longo de dez anos por pessoas diferentes. Medida em polegada num produto e em centímetro no irmão dele, garantia de 6 meses aqui e de 1 ano ali, nome de marca grafado de três jeitos. Ninguém tem tempo de ler tudo. O roteiro que eu uso:
A mesma ideia de processar em lote sem estragar a coluna que serve de chave aparece no post sobre traduzir o pt_BR.csv do Magento 2.
A Anthropic mantém um SDK oficial para PHP (composer require anthropic-ai/sdk), e eu uso ele no lugar do cURL na mão quando o projeto aceita Composer. O mínimo:
use Anthropic\Client;
$client = new Client(apiKey: getenv('ANTHROPIC_API_KEY'));
$resposta = $client->messages->create(
model: $modelo,
maxTokens: 2000,
messages: [
['role' => 'user', 'content' => $instrucoes . "\n\n" . $loteDeProdutos],
],
);
foreach ($resposta->content as $bloco) {
if ($bloco->type === 'text') { $texto = $bloco->text; }
}Repare no laço. A resposta é uma lista de blocos, e o primeiro nem sempre é texto: pode ser um bloco de raciocínio ou um pedido de ferramenta. Ler $resposta->content[0]->text direto funciona no teste e quebra em produção. O consumo vem em $resposta->usage, inclusive quanto foi lido do cache, e vai para o log de custo. Chamada longa assim roda em CLI, nunca dentro do PHP-FPM, pelo motivo que explico em timeout do PHP-FPM na chamada de IA.
O Claude está disponível em quatro lugares. O modelo é o mesmo; muda quem fatura, como autentica e quais recursos chegam primeiro.
| Caminho | Quando eu indico | O que muda na integração |
|---|---|---|
| API da Anthropic | Loja ou sistema sem nuvem corporativa, ou projeto que precisa dos recursos mais novos | Conta e cobrança na Anthropic, com chave de API própria |
| Amazon Bedrock | Empresa que já roda na AWS e quer a mesma fatura e as mesmas permissões (IAM) | Credencial da AWS e ID de modelo com prefixo da Anthropic |
| Google Cloud Vertex AI | Empresa que já está no Google Cloud | Autenticação do Google Cloud, sem chave da Anthropic |
| Microsoft Foundry | Empresa padronizada em Azure | Endpoint e chave do Foundry |
O SDK oficial tem cliente próprio para cada uma dessas plataformas, então mudar depois mexe na configuração e em pouco código.
Para comparar com GPT e Gemini no mesmo critério, veja a página de integração com IA.
O claude.ai é o aplicativo de chat, com assinatura. A integração usa a API da Anthropic, com conta própria e cobrança por token, e o resultado entra direto no seu sistema. Uma assinatura não substitui a outra.
Funciona bem em português do Brasil. Mesmo assim eu escrevo as regras e os exemplos do prompt em português, com os termos que a loja usa, e testo com produtos reais antes de rodar em volume.
Por padrão, não. Os dados enviados pela API comercial não entram no treino dos modelos. Se a empresa precisa de retenção zero, isso é contratado à parte com a Anthropic.
Dá, com tool use. Eu defino as funções que ele pode pedir, como buscar pedido por número ou ler o estoque de um SKU, e o meu código executa essas consultas na API do Magento com um token de permissão mínima. O modelo nunca recebe a credencial.
Uso a Batch API, que é assíncrona e custa metade do preço normal, junto com prompt caching nas instruções que se repetem. Antes de rodar tudo, processo uma amostra e projeto o custo total a partir do consumo de tokens que a própria API informa.
Não. Dá para usar direto pela API da Anthropic. O Amazon Bedrock, o Google Cloud Vertex AI e o Microsoft Foundry são alternativas para empresas que já concentram a infraestrutura e o faturamento numa dessas nuvens.
Me conte o que está acontecendo. Respondo pessoalmente, em horário comercial.