Família Claude
Os modelos Claude da Anthropic, incluindo as séries Opus, Sonnet, Haiku e Fable. Recomenda-se chamá-los pelo endpoint nativo da Anthropic, no qual extended thinking, cache de prompt, entrada de PDF e outros recursos se comportam como na API oficial. O endpoint compatível com OpenAI também funciona e é indicado para projetos que já usam o SDK da OpenAI.
Tarefas comuns
Modelos
Todos os modelos aceitam entrada de texto, imagem e PDF e suportam chamada de ferramentas. A lista completa de modelos e os preços atualizados estão na página de modelos ; também é possível consultá-los pela Models API.
anthropic/claude-opus-5.5anthropic/claude-sonnet-5.5anthropic/claude-haiku-5.5anthropic/claude-fable-5.1O prefixo anthropic/ do ID de modelo pode ser omitido, e também é possível usar o formato oficial da Anthropic. Todas as formas abaixo apontam para o mesmo modelo:
Os aliases disponíveis para cada modelo estão no campo aliases retornado pela Models API. O campo model da resposta sempre usa o formato padrão.
Escolha do endpoint
Os parâmetros completos de requisição estão em Anthropic Messages API e Chat Completions API.
Provedores
Os modelos Claude são oferecidos por dois provedores, e o mesmo modelo suporta recursos diferentes em cada um:
No endpoint nativo da Anthropic, o provedor pode ser indicado por um cabeçalho:
-H "X-OfoxAI-Provider-Type: anthropic"Se o provedor indicado não oferecer o modelo, a resposta é 400, e a mensagem de erro lista os provedores disponíveis, por exemplo:
No available channel for platform 'anthropic' on model 'anthropic/claude-sonnet-4.6'. Available platforms for this model: aws_bedrock.Outras formas de indicar o provedor estão em Roteamento de provedores.
Exemplos de chamada
Python (SDK da Anthropic)
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://api.ofox.io/anthropic",
api_key=os.environ["OFOX_API_KEY"],
)
message = client.messages.create(
model="anthropic/claude-sonnet-4.6",
max_tokens=1024,
system="Você é um engenheiro de back-end sênior e responde de forma concisa.",
messages=[{"role": "user", "content": "Explique em uma frase o que é idempotência."}],
)
print(message.content[0].text)max_tokens é obrigatório no endpoint nativo da Anthropic, e seu valor não pode ultrapassar a saída máxima do modelo.
Usar no Claude Code
O Claude Code faz as chamadas pelo endpoint nativo da Anthropic, com o endereço base https://api.ofox.io/anthropic. Os passos de configuração estão em Configuração do Claude Code.
https://api.ofox.io/anthropicErros comuns
Outros erros gerais estão em Tratamento de erros.
Documentação oficial
- Anthropic · Visão geral dos modelos
- Anthropic · Extended thinking
- Anthropic · Cache de prompt
- Anthropic · Suporte a PDF
A documentação oficial descreve o comportamento das chamadas diretas à Anthropic. Ao chamar pela OfoxAI, prevalecem os IDs de modelo e os endereços de endpoint desta página.
Perguntas frequentes
Como escrever o ID de modelo do Claude?
O formato padrão é anthropic/claude-sonnet-4.6. Também é possível omitir o prefixo anthropic/ ou usar os formatos oficiais claude-sonnet-4-6 e claude-sonnet-4-6-20260217; todos apontam para o mesmo modelo.
Posso chamar o Claude com o SDK da OpenAI?
Sim. Defina base_url como https://api.ofox.io/v1 e informe um ID de modelo como anthropic/claude-sonnet-4.6. Quando precisar de extended thinking ou das informações completas de uso do cache, recomenda-se o endpoint nativo da Anthropic.
Como ativar o modo thinking do Claude?
No endpoint nativo, envie thinking: {"type": "enabled", "budget_tokens": 2000}, com budget_tokens de no mínimo 1024 e menor que max_tokens; ou envie {"type": "adaptive"} para que o modelo decida. No endpoint compatível com OpenAI, envie reasoning: {"max_tokens": 2000}. Com o thinking ativado, não defina temperature.
O que fazer quando o cache de prompt do Claude não funciona?
Verifique, nesta ordem: se cache_control foi marcado no bloco de conteúdo fixo (nenhum dos dois endpoints faz cache automaticamente); se o conteúdo atinge o tamanho mínimo armazenável em cache; se o prefixo das duas requisições é exatamente igual; se o intervalo entre as duas requisições passou de 5 minutos.
O que fazer com o erro prompt is too long?
A entrada excedeu o contexto do modelo. O contexto do Haiku 4.5 é de 200K tokens, e o dos demais modelos Claude é de 1M tokens. Use outro modelo ou reduza a entrada.
O Claude suporta contexto de 1M? É preciso enviar o cabeçalho beta?
Todos os modelos, exceto o Haiku 4.5, suportam contexto de 1M. Na OfoxAI, não é preciso enviar o cabeçalho beta.
O que fazer quando a resposta do Claude vem truncada?
Verifique o stop_reason da resposta. Se for max_tokens, a saída atingiu o limite; aumente max_tokens. Com o thinking ativado, o conteúdo do thinking também consome a cota de max_tokens.
Qual provedor oferece o Claude na OfoxAI?
Todos os modelos são oferecidos pela Amazon Bedrock, o provedor padrão. Fable 5, Opus 4.8, Opus 4.7 e Sonnet 5 também têm o provedor Anthropic, disponível somente no endpoint nativo da Anthropic e que precisa ser indicado pelo cabeçalho X-OfoxAI-Provider-Type: anthropic.
O Claude pode fazer buscas na web?
Sim, mas é preciso indicar o provedor Anthropic. Funciona apenas com Fable 5, Opus 4.8, Opus 4.7 e Sonnet 5, e somente no endpoint nativo da Anthropic. Adicione {"type": "web_search_20250305", "name": "web_search"} em tools.
O Claude consegue ler PDFs?
Sim. No endpoint nativo, use um bloco de conteúdo document com o PDF codificado em base64; no endpoint compatível com OpenAI, use um bloco de conteúdo file, com file_data no formato data:application/pdf;base64,....