Guia · Chave de API da Anthropic
Anthropic Console: chave de API do Claude para o Chaterimo
Cadastre-se no Anthropic Console (agora Claude Console), compre créditos, crie uma chave de API do Claude e use-a no Chaterimo como chave própria (BYOK).
Em resumo
- 01Uma chave de API da Anthropic permite que o seu chatbot do Chaterimo responda com modelos Claude, e a Anthropic cobra diretamente de você o que o chatbot usa (BYOK).
- 02Você cria a chave no Claude Console (platform.claude.com), antes chamado Anthropic Console e acessado em console.anthropic.com; a conta do Console é separada da conta do claude.ai.
- 03A API do Claude funciona com créditos pré-pagos: quando o saldo chega a zero, o chatbot para de responder até você comprar mais.
- 04Crie a chave para um único espaço de trabalho (workspace). Uma chave que funciona em vários espaços de trabalho também precisa do Anthropic Workspace ID no Chaterimo.
- 05O Console mostra uma chave nova só uma vez, então cole-a logo no Chaterimo, em Configurações da Conta.
O que você precisa
- Um plano do Chaterimo que usa a sua chave de API própria (BYOK). O teste grátis e os planos com chaves de API do Chaterimo não precisam de chave.
- Um endereço de e-mail ou uma conta Google para se cadastrar no Claude Console.
- Um cartão de pagamento para os créditos pré-pagos da API do Claude.
Conteúdo 5
Para obter uma chave de API da Anthropic, cadastre-se no Claude Console (platform.claude.com), compre créditos pré-pagos e crie uma chave na página de chaves de API. Claude Console é o novo nome do Anthropic Console, e o endereço console.anthropic.com agora leva até ele. Depois, cole a chave no Chaterimo em Configurações da Conta e escolha um modelo Claude para o seu chatbot. Este guia é para lojas virtuais cujo plano do Chaterimo usa uma chave de API própria (BYOK: você usa a sua própria chave e paga diretamente à Anthropic pelo que o chatbot usa).
Passo a passo
1Crie uma conta no Claude Console
Acesse platform.claude.com e cadastre-se ou, se você já tem uma conta, entre. Você pode usar Continue with Google (continuar com o Google) ou Continue with email (continuar com e-mail). Com e-mail, o Console envia um link de acesso em vez de pedir uma senha.1 Entre sempre com o mesmo método que usou no cadastro.
O Claude Console não é o claude.ai. O claude.ai é o aplicativo de chat da Anthropic; o Console é onde ficam as chaves de API e a cobrança da API. São contas separadas, mesmo quando você usa o mesmo endereço de e-mail nas duas.1 Uma assinatura paga do Claude é cobrada separadamente da API.2
2Compre créditos pré-pagos
A API do Claude funciona com créditos pré-pagos. Abra a página Billing do Console (Settings → Billing), selecione Buy credits, informe o valor e confirme. Só membros com a função Admin ou Billing podem comprar créditos. Quando o saldo chega a zero, a Anthropic interrompe as solicitações à API e o seu chatbot não consegue responder até você comprar mais.3
Ative a recarga automática para que o chatbot não pare à noite ou no fim de semana. Na seção Credit balance, selecione Set up auto-reload, informe o saldo que dispara uma compra (When credit balance reaches) e o saldo que deve ser restaurado (Bring credit balance back up to) e selecione Turn on. Os créditos expiram um ano após a compra.3
Dica
Para limitar o gasto mensal, use a seção Spend limits na mesma página Billing: Set limit, ou Adjust limit quando já existe um limite. Quando o uso atinge o seu limite, a Anthropic recusa as solicitações à API até o limite ser renovado ou você aumentá-lo, e então o seu chatbot também para de responder.4
3Crie a chave de API da Anthropic
Abra a página API keys do Console e selecione Create key. Preencha a caixa de diálogo:5
- Name
- Um nome que você vai reconhecer depois, por exemplo “Chaterimo”.
- Expiration
- Escolha Never (nunca) para a chave do seu chatbot. Uma chave expirada para de funcionar, e o seu chatbot deixa de responder com ela. Se a sua organização não permite Never, escolha o prazo mais longo e substitua a chave antes que ela expire. A Anthropic envia um e-mail a quem criou a chave 7 dias antes de uma chave com validade de 14 dias ou mais expirar.6
- Linked account
- Você mesmo (uma chave pessoal) ou uma conta de serviço. Uma chave pessoal para de funcionar quando você é removido da organização. Se várias pessoas administram a sua conta do Console, peça a um administrador da organização uma chave de conta de serviço, para que o chatbot não dependa de uma única pessoa.6
- Workspace
- Restrinja a chave a um único espaço de trabalho; a caixa de diálogo permite escolhê-lo. Uma chave criada para um espaço de trabalho funciona só nele e não precisa de Workspace ID no Chaterimo.6
Copie a chave quando o Console a mostrar. Ela começa com sk-ant-. O Console mostra a chave completa só uma vez; se você a perder, crie uma chave nova.5
Atenção
Trate a chave como uma senha. Nunca a envie por e-mail ou chat e nunca a coloque no código da sua loja. Qualquer pessoa que tenha a chave pode usar a API às suas custas. Se uma chave vazar, crie uma nova, cole-a no Chaterimo e depois desative ou exclua a antiga na página API keys.6
4Cole a chave no Chaterimo
No Chaterimo, abra Configurações da Conta no menu. Na seção Chaves dos provedores de IA, cole a chave em Chave de API da Anthropic e selecione Salvar. O campo passa a mostrar Chave salva. O Chaterimo guarda a chave criptografada e a usa apenas para solicitações à Anthropic. Uma única chave atende a todos os chatbots da sua organização.
Deixe Anthropic Workspace ID (opcional) vazio quando você criou a chave para um único espaço de trabalho. Preencha o campo só quando a chave funciona em mais de um espaço de trabalho: nesse caso, a Anthropic precisa saber em qual espaço de trabalho cada solicitação é executada.6 Copie o ID da coluna ID na página Workspaces do Console (Settings → Workspaces). Ele começa com wrkspc_. O Chaterimo o envia com cada solicitação que faz com a sua chave.
Se você não vê a seção Chaves dos provedores de IA, o seu plano não precisa de chave própria: no teste grátis e nos planos com chaves de API do Chaterimo, o Chaterimo usa as chaves dele. Os planos estão na página de preços.
5Escolha um modelo Claude para o seu chatbot
Abra Configurações do Chat & Incorporação. Em Configurações gerais do chatbot, escolha um modelo Claude em Tipo de modelo de IA e selecione Salvar alterações. Um modelo Claude sempre usa a chave da Anthropic do passo 4; um modelo GPT ou Gemini precisaria de uma chave do próprio provedor.
O modelo certo para a sua loja depende das perguntas dos seus clientes e do seu orçamento. O nosso benchmark de IA compara modelos com perguntas reais de atendimento ao cliente, e o artigo como escolher um LLM para atendimento ao cliente explica os prós e contras.
Como verificar se funciona
- Abra Testar chatbot e faça uma pergunta que os seus clientes fazem com frequência. Se o chatbot responder, a chave, o espaço de trabalho e o modelo funcionam.
- Se o Chaterimo mostrou um aviso vermelho sobre a sua chave da Anthropic, ele desaparece depois da próxima resposta bem-sucedida.
- A página Usage do Console mostra as solicitações do seu chatbot.
Solução de problemas
- “Você ainda não salvou uma chave de API de um provedor de IA”
- O seu plano usa chave própria, mas o Chaterimo não tem nenhuma. Cole a chave em Configurações da Conta (passo 4).
- “A Anthropic exige um Workspace ID para esta chave de API”
- A chave funciona em mais de um espaço de trabalho, então a Anthropic recusa solicitações sem um Workspace ID. Copie o ID de Settings → Workspaces no Console para Anthropic Workspace ID (opcional) no Chaterimo, ou crie uma chave para um único espaço de trabalho (passo 3) e cole-a no lugar. Comprar créditos não resolve isso. O Chaterimo também envia esse aviso por e-mail ao proprietário da conta, no máximo uma vez por dia.
- “Insira um Anthropic Workspace ID válido que comece com wrkspc_.”
- O campo aceita apenas um ID de espaço de trabalho completo. Copie o valor inteiro da coluna ID, não o nome do espaço de trabalho.
- “A sua chave de API para Anthropic é inválida ou foi revogada”
- A chave foi excluída, desativada ou expirou, foi copiada de forma incompleta ou era a chave pessoal de alguém que saiu da organização. Crie uma chave nova (passo 3) e cole-a no Chaterimo. O Chaterimo também envia esse aviso por e-mail, no máximo uma vez por dia.
- “Seu provedor de IA (Anthropic) informa que os créditos da sua conta acabaram ou que um limite de gastos foi atingido”
- O saldo de créditos chegou a zero ou o uso atingiu o limite de gastos que você definiu (o Chaterimo mostra o mesmo aviso nos dois casos). Compre créditos na página Billing (passo 2) e ative a recarga automática, ou aumente o limite em Spend limits.
- O chatbot parou de responder depois que você salvou um Workspace ID
- O ID pertence a um espaço de trabalho que a chave não pode usar, por exemplo um de outra organização; a Anthropic então recusa as solicitações com “Workspace not found”.6 Copie o ID de novo na organização em que você criou a chave, ou apague o ID e use uma chave criada para um único espaço de trabalho.
- O botão Create key está desativado
- A sua função na organização do Console não permite criar chaves. Peça a um administrador da organização que mude a sua função ou que crie uma chave de conta de serviço para o chatbot.5
- Você não encontra API keys nem Billing
- Provavelmente você está no claude.ai em vez do Claude Console, ou em outra organização. Abra platform.claude.com (console.anthropic.com também leva até lá), entre com o método que usou no cadastro e confira em qual organização você está.
Próximo passo
Compare o Claude com outros modelos no benchmark de IA e escolha o que combina com as perguntas dos seus clientes. Para experimentar também os modelos GPT ou Gemini, siga os guias da chave de API da OpenAI e da chave de API do Gemini. Depois, teste o chatbot com as suas próprias perguntas em Testar chatbot antes de exibi-lo na sua loja.
-
Anthropic, “Log in to your Console account”, acesso em 19 de outubro de 2026, https://support.claude.com/en/articles/13371040-log-in-to-your-console-account ↑↑
-
Anthropic, “Why is Claude API usage billed separately from my paid Claude plan?”, acesso em 19 de outubro de 2026, https://support.claude.com/en/articles/9876003 ↑
-
Anthropic, “How do I pay for my Claude API usage?”, acesso em 19 de outubro de 2026, https://support.claude.com/en/articles/8977456 ↑↑
-
Anthropic, “Rate limits”, acesso em 19 de outubro de 2026, https://platform.claude.com/docs/en/api/rate-limits ↑
-
Anthropic, “Get your Claude API key”, acesso em 19 de outubro de 2026, https://platform.claude.com/docs/en/get-api-key ↑↑↑
-
Anthropic, “Authentication”, acesso em 19 de outubro de 2026, https://platform.claude.com/docs/en/manage-claude/authentication ↑↑↑↑↑↑
Perguntas frequentes
O que é o Anthropic Console?
É o painel da Anthropic para desenvolvedores, onde você cria chaves de API do Claude, compra créditos da API e vê o uso. A Anthropic agora o chama de Claude Console. Ele funciona em platform.claude.com, e console.anthropic.com leva até lá.
O Claude Console é a mesma conta do claude.ai?
Não. O claude.ai e o Claude Console são contas separadas, mesmo com o mesmo endereço de e-mail. Uma assinatura paga do Claude é cobrada separadamente da API; segundo a Anthropic, os planos Max e Team incluem créditos mensais para a API do Claude.
Preciso de créditos para usar a API da Anthropic?
Sim. A API do Claude funciona com créditos pré-pagos. Sem créditos, as solicitações falham e o chatbot não consegue responder.
O que é o Anthropic Workspace ID no Chaterimo?
É o ID do espaço de trabalho do Console em que as suas solicitações são executadas; ele começa com wrkspc_. O Chaterimo só precisa dele para uma chave que funciona em mais de um espaço de trabalho. Para uma chave criada para um único espaço de trabalho, deixe o campo vazio.
Posso usar uma única chave da Anthropic para vários chatbots no Chaterimo?
Sim. A chave fica salva em Configurações da Conta e atende a todos os chatbots da sua organização. Cada chatbot pode usar um modelo Claude diferente.
Quanto custa a API do Claude para um chatbot?
Depende do modelo e do número de conversas. A Anthropic publica os preços na página de preços da API do Claude. O plano do Chaterimo é cobrado separadamente; veja a página de preços do Chaterimo.
Histórico de alterações
- Reescrito conforme a versão atual do Claude Console e das configurações do Chaterimo, com o Workspace ID e solução de problemas.
- Publicado.