3.7.2 · Primeira chamada e o formato de mensagens

Instalação e primeira chamada

pip install anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

import anthropic

client = anthropic.Anthropic()          # lê ANTHROPIC_API_KEY do ambiente

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    system="Você é um analista funcional SAP especialista em MM.",
    messages=[
        {"role": "user", "content": "Explique a diferença entre bloqueio de fatura e bloqueio de pagamento."}
    ],
)

for block in response.content:
    if block.type == "text":
        print(block.text)

Sete linhas úteis. Repare em três decisões que já estão embutidas:

• anthropic.Anthropic() sem argumento. Passar api_key="sk-ant-..." funciona, e é o começo de todo vazamento de chave em repositório.
• system é parâmetro próprio, fora de messages. Papel, regras e contexto estável vão aí.
• max_tokens=16000 é o padrão razoável sem streaming. Valor baixo demais corta a resposta; valor alto demais sem streaming arrisca timeout.

Os modelos, e a conta

preview — pode mudar · Preços e IDs conferidos em julho de 2026. Consulte a página de pricing antes de fechar proposta com número.

A escolha de modelo é a alavanca de custo mais grossa disponível: entre Haiku 4.5 e Opus 5 há cinco vezes de diferença na entrada. E é exatamente aqui que o módulo 3.6 se paga: rodar a avaliação com o modelo barato responde, com número, se ele aguenta a tarefa. Sem avaliação, a escolha de modelo é palpite com fatura no fim do mês.

Anatomia da resposta

response.id            # "msg_01..."
response.model         # o modelo que respondeu
response.content       # LISTA de blocos
response.stop_reason   # por que parou
response.usage.input_tokens
response.usage.output_tokens

max_tokens é o erro mais silencioso da API. Não levanta exceção, não vira log de erro: você recebe um texto que termina no meio de uma frase, e o código a jusante segue como se estivesse completo. Em pipeline desassistido, isso vira uma FS truncada entregue ao cliente.

Streaming

with client.messages.stream(
    model="claude-opus-5",
    max_tokens=64000,
    messages=[{"role": "user", "content": "Redija a especificação funcional completa do RICEFW 17."}],
) as stream:
    for texto in stream.text_stream:
        print(texto, end="", flush=True)

    final = stream.get_final_message()   # a mensagem completa, com usage e stop_reason

Quando streaming deixa de ser opcional:

get_final_message() é o que permite usar streaming sem perder nada: você exibe o texto em tempo real e ainda recebe o objeto completo, com usage e stop_reason, no fim.

Três coisas que sumiram da API

Regra Wayon Chave de API é credencial de sistema, tratada como qualquer outra credencial de projeto: cofre ou variável de ambiente, nunca em repositório, nunca em notebook compartilhado, nunca em anexo. Uma chave por projeto de cliente, para que revogar uma não derrube as outras. Código que chama a API em produção lê stop_reason e trata max_tokens e refusal explicitamente — resposta cortada não pode seguir para o cliente como se estivesse completa.

📖 Client SDKs · Streaming · Pricing