Como pegar a API key do Claude e usar em um app
Pegue a sua API key do Claude no Console do Claude, veja quais planos do Claude incluem créditos de API e use o Claude no iPhone, Android ou web sem programar.
- Para pegar uma API key (chave de API) do Claude, entre no Console do Claude em platform.claude.com, abra Settings → API keys (platform.claude.com/settings/keys), clique em Create key e copie; a chave começa com "sk-ant-" e aparece uma única vez. Adicione créditos em Billing e depois cole a chave em um app de chat que aceite a sua própria chave, como o Oriveo.
- O Claude Pro não inclui uso da API. Em 18 de novembro de 2026, os planos Claude Max, Ultra e Team vêm com créditos mensais de API, resgatados ao vincular o plano a uma organização do Console.
- Em 28 de setembro de 2026, o Claude Sonnet 5 custava $2 por milhão de tokens de entrada e $10 por milhão de tokens de saída, então uma mensagem típica de chat custava cerca de um centavo, em estimativa.

O que você precisa antes de começar
Usar o Claude num app com a sua própria chave envolve três coisas: uma conta no Console do Claude, algum crédito de API nessa conta e um app que aceite uma chave Anthropic. Nada disso exige programação. A configuração inteira costuma levar dez minutos, a maior parte preenchendo o formulário de pagamento.
Vale deixar claro qual conta da Anthropic você está usando. Os apps do Claude em claude.ai (Free, Pro, Max, Ultra e Team) são assinaturas para consumidor. O Console do Claude, em platform.claude.com, é a plataforma para desenvolvedores, onde ficam as API keys e a cobrança da API. A Anthropic cobra os dois separadamente: em 18 de novembro de 2026, os planos Free, Pro e Enterprise não incluem uso da API, enquanto os planos Max, Ultra e Team vêm com um valor mensal em créditos de API (veja abaixo). Dá para entrar nos dois com o mesmo e-mail.
Passo 1: crie uma chave de API do Claude
A Anthropic documenta o processo na página "Get your Claude API key". A chave é criada uma única vez e não pode ser vista de novo depois, então tenha pronto um lugar seguro para guardá-la, como um gerenciador de senhas.
- Acesse platform.claude.com e entre, ou crie uma conta no Console.
- Abra Settings → API keys (platform.claude.com/settings/keys).
- Clique em Create key, dê um nome que você reconheça — por exemplo "Oriveo no meu celular" — e escolha uma expiração.
- Copie a chave. Ela começa com "sk-ant-" e o Console mostra a chave completa uma única vez, na criação.
- Se perder a chave, não há como recuperá-la; crie uma nova e revogue a antiga.
Passo 2: adicione crédito e defina um limite
O uso da API do Claude é pago com créditos pré-pagos. No Console, abra Settings → Billing e compre créditos; eles ficam disponíveis assim que a compra é concluída. Opcionalmente, ative a recarga automática, que compra mais créditos quando o saldo cai abaixo de um limite que você escolhe. Enquanto você descobre quanto usa, deixar a recarga automática desligada é uma forma simples de limitar o gasto ao valor que você pagou antecipadamente.
A sua organização é colocada automaticamente num nível de uso, e cada nível tem limites de taxa (solicitações e tokens por minuto) e um limite mensal de gasto. Dá para ver os dois no Console, nas páginas Rate limits e Billing. Para chat pessoal, os limites iniciais raramente são o gargalo, mas explicam o erro ocasional de "rate limit" se você enviar muitas mensagens longas em sequência.
Os planos Claude Max, Ultra ou Team incluem créditos de API?
Sim, em 18 de novembro de 2026. A Anthropic dá créditos mensais de API a esses planos: $100 no Max, $200 no Ultra e $20 ou $100 por assento no Team (Standard ou Premium), até $500 no total por equipe. Os planos Free, Pro e Enterprise não incluem nenhum.
Para usá-los, vincule o seu plano em claude.ai a uma organização do Console do Claude. Assinaturas novas podem resgatar os créditos depois de 7 dias, e créditos não usados não passam para o próximo período de cobrança. A Anthropic diz que eles pagam a API do Claude, os Managed Agents, o Agent SDK e o Playground do Console, mas não o uso extra do Claude Code nem do app do Claude.
Como o Oriveo usa a API do Claude, uma chave criada na organização do Console vinculada pode usar esses créditos. Quando eles acabam, a organização precisa de créditos pré-pagos, como de costume.
Quanto custa o Claude pela API
O preço da API é por token, com uma tarifa para os tokens que você envia (entrada) e outra para os tokens que o Claude escreve (saída). A tabela mostra as tarifas publicadas pela Anthropic para os modelos atuais em 28 de setembro de 2026, com um custo estimado para uma mensagem típica de 2.000 tokens de entrada e 600 de saída. O lado da entrada inclui os turnos anteriores da conversa, que o app reenvia a cada mensagem.
A conta do Sonnet 5 é 2.000 × $2 / 1.000.000 + 600 × $10 / 1.000.000 = $0,010. As suas mensagens vão variar, então trate a última coluna como uma ordem de grandeza. A fatura da Anthropic, e não qualquer estimativa, é o valor final.
| Modelo | Entrada (USD / 1M tokens) | Saída (USD / 1M tokens) | Custo estimado por mensagem típica |
|---|---|---|---|
| Claude Haiku 4.5 | 1,00 | 5,00 | cerca de $0,005 |
| Claude Sonnet 5 | 2,00 | 10,00 | cerca de $0,010 |
| Claude Opus 5.5 | 4,00 | 20,00 | cerca de $0,020 |
| Claude Fable 5.1 | 10,00 | 50,00 | cerca de $0,050 |
Passo 3: adicione a chave no Oriveo
O Oriveo é um app de chat multimodelo para iPhone, Android e web que usa as suas próprias chaves. A Anthropic é um dos seus 15 provedores oficiais, na seção de provedores diretos. Os rótulos abaixo são os que o app mostra em português.
O Oriveo confere a chave assim que você toca em Continuar, pedindo à Anthropic a lista de modelos que a chave pode usar, e depois sincroniza essa lista. Se a Anthropic recusar a chave, geralmente por um erro ao copiar e colar, o Oriveo salva mesmo assim e mostra "Salvo, mas a chave parece inválida. Você pode verificá-la mais tarde nas configurações do provedor.", para você corrigir a chave antes de conversar.
| Passo | iPhone | Android | Web |
|---|---|---|---|
| Abrir a lista de provedores | Aba Provedores | Aba Provedores | Provedores na barra lateral |
| Iniciar a configuração | Adicionar provedor | Adicionar provedor | Adicionar provedor |
| Escolher o provedor | Anthropic, em Provedores diretos de IA | Anthropic, em Provedores diretos de IA | Anthropic, em Acesso direto a provedores oficiais de AI |
| Colar a chave | Campo API Key em "Conectar Anthropic" | Campo Chave da API em "Conectar Anthropic" | Campo da chave em "Conectar Anthropic"; "Obtenha sua chave em Claude" leva ao Console |
| Confirmar | Continuar | Continuar | Continuar |
| Aguardar a verificação | "Validando conexão e sincronizando modelos..." | "Validando conexão e sincronizando modelos…" | "Validando conexão e sincronizando modelos..." |
Passo 4: escolha um modelo e comece a conversar
Depois de conectar a Anthropic, os modelos dela aparecem no seletor de modelos. Escolha o que serve para a tarefa: Haiku para perguntas rápidas do dia a dia, Sonnet como escolha padrão bem capaz, Opus ou Fable para os raciocínios e textos mais difíceis. Dá para trocar de modelo no meio de uma conversa, inclusive para modelos de outros provedores conectados, e a conversa segue com o novo modelo.
Nos apps de iPhone e Android, na primeira mensagem a um provedor, o Oriveo mostra um aviso curto — "Você está prestes a usar Anthropic" — explicando que a sua mensagem será enviada à Anthropic para gerar a resposta. Em todas as plataformas, cada mensagem mostra um custo estimado ao lado, calculado pelo preço publicado da Anthropic e pela quantidade de tokens informada na resposta.
Como usar a sua chave do Claude no iPhone e no Android
Os passos acima funcionam do mesmo jeito no celular. No app do Oriveo para iPhone ou Android, abra a aba Provedores, toque em +, escolha Anthropic, cole a chave e toque em Continuar. Uma chave longa é mais fácil de passar para o celular por um gerenciador de senhas; evite mandar a chave para você mesmo por e-mail ou chat.
Os apps para iPhone e Android enviam as suas mensagens direto à Anthropic, e a chave fica no armazenamento seguro do celular: o Keychain no iPhone e o Keystore no Android. A sincronização na nuvem não envia as API keys, então um segundo aparelho não recebe a sua chave pela sincronização. Cole a chave lá também, ou crie uma chave separada para cada aparelho.
Como manter a sua chave segura
Uma chave da Anthropic pode gastar o seu crédito, então trate-a como uma senha. O Oriveo guarda as chaves dos provedores no seu aparelho ou no seu navegador, em vez de armazená-las como registros de conta. Os apps para iPhone e Android enviam as solicitações do Claude direto à Anthropic; o app web envia as solicitações por um repasse em tempo real no servidor do Oriveo: a chave é usada só naquela solicitação e não é salva como registro da conta, e as conversas BYOK não são guardadas como logs de chat. O Oriveo não cobra acréscimo sobre os preços da Anthropic.
- Crie uma chave por app ou aparelho, para poder revogar uma sem afetar as outras.
- Use crédito pré-pago sem recarga automática, ou um limite baixo de recarga, enquanto descobre o seu uso.
- Confira a página de uso do Console depois de alguns dias e compare com as estimativas no app.
- Se uma chave for colada em algum lugar público, revogue-a no Console e crie uma substituta.
Não funciona? Erros comuns da API key do Claude
A maioria dos problemas de configuração vem de um punhado de causas, e o erro costuma indicar qual delas. A lista abaixo segue a página de erros da Anthropic em 18 de novembro de 2026.
- 401 authentication_error: a chave foi copiada incompleta, foi revogada ou expirou. Copie de novo ou crie uma chave nova.
- "Your credit balance is too low to access the Anthropic API": a organização do Console ficou sem crédito. Compre créditos em Settings → Billing ou ative a recarga automática.
- 402 billing_error: há um problema com os seus dados de pagamento. Confira no Console.
- 403 permission_error: a chave não tem permissão para usar esse recurso. Confira as configurações da organização e do workspace no Console.
- 429 rate_limit_error: você enviou muitas solicitações ou mensagens muito longas em pouco tempo. Espere um minuto e tente de novo. Se os detalhes disserem enforced_spend_limit_reached, a sua organização atingiu o limite mensal de gasto do nível dela, e as solicitações continuam falhando até o dia 1º do mês seguinte (00:00 UTC), a menos que você peça um nível mais alto na página Rate limits do Console.
- 400 invalid_request_error mencionando um limite de gasto: você atingiu um limite que você mesmo definiu. Aumente esse limite no Console.
- 529 overloaded_error: a Anthropic está sobrecarregada no momento. Tente de novo daqui a pouco.
- Um modelo novo do Claude não aparece: atualize a lista de modelos do provedor no app depois que a Anthropic lançá-lo.
- Você esperava que o plano Claude Pro cobrisse isso: não cobre. O Pro não inclui créditos de API; os planos Max, Ultra e Team incluem.
- No Oriveo, uma chave recusada pela Anthropic aparece como "Chave de API inválida" no iPhone e no Android; no app web, pode aparecer "Acesso expirado".
Perguntas frequentes
Onde consigo uma chave de API do Claude?
O Claude Pro inclui acesso à API?
Posso usar a minha assinatura do Claude Max na API?
Existe API key do Claude grátis?
Quanto custa usar o Claude com a minha própria chave de API?
Posso usar uma chave de API do Claude no meu iPhone ou Android?
Preciso escrever código para usar a API do Claude?
Minha chave de API do Claude fica segura no Oriveo?
Leituras relacionadas
Converse com o Claude usando a sua própria chave
Adicione a sua chave Anthropic ao Oriveo no iPhone, no Android ou na web, alterne entre o Claude e mais de 700 outros modelos e veja um custo estimado em cada mensagem.