Obtenha sua chave de API do Claude

As chaves de API para a Claude API (também chamadas de chaves de API da Anthropic) ficam no Claude Console. Para visualizar suas chaves existentes ou criar uma nova, acesse Settings → API keys.

Escolha um tipo de chave

Ao criar uma chave, você escolhe seu tipo, que determina o que a chave pode fazer, onde ela funciona e quando ela deixa de funcionar. Uma chave pessoal atua como você e deixa de funcionar se você sair de uma organização. Uma chave de conta de serviço representa uma conta de serviço que pode ser usada por cargas de trabalho como pipelines de CI, serviços de produção ou agentes. Use uma chave pessoal para seu próprio desenvolvimento e uma chave de conta de serviço para qualquer coisa compartilhada.

Você também pode criar uma chave de workspace, uma chave legado sem proprietário: ela pertence ao workspace em que você a cria e continua funcionando depois que seu criador sai. É preferível usar uma chave pessoal ou de conta de serviço, pois elas deixam de funcionar automaticamente quando a conta associada é removida da organização.

Crie uma chave de API

1. 1

   Faça login no Claude Console

   Acesse platform.claude.com e faça login, ou crie uma conta se você ainda não tiver uma.

2. 2

   Abra a página de chaves de API

   Acesse Settings → API keys.

3. 3

   Crie uma chave

   Clique em Create key, dê um nome à chave, escolha uma expiração e defina Linked account como você mesmo ou uma conta de serviço. Você também pode escolher um workspace ao qual restringir o escopo da chave.

4. 4

   Copie e armazene a chave

   O Console mostra a chave completa, que começa com sk-ant-, apenas uma vez, no momento da criação. Copie-a e armazene-a em um lugar seguro, como um gerenciador de segredos. Se você perder uma chave, não poderá visualizá-la novamente no Console. Em vez disso, crie uma nova chave.

Se o botão Create key na página de chaves de API estiver desabilitado, sua função pode não permitir que você crie chaves ali. Peça a um administrador da organização para alterar sua função ou para criar uma chave de conta de serviço para sua carga de trabalho.

Use sua chave de API

Defina a chave como uma variável de ambiente:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Os SDKs de cliente leem ANTHROPIC_API_KEY automaticamente. Requisições HTTP diretas enviam a chave no cabeçalho x-api-key. Se sua chave de API funciona em vários workspaces, você também deve enviar o cabeçalho anthropic-workspace-id em cada requisição à Claude API, conforme mostrado em Selecione um workspace. Para a Admin API, consulte Chaves de API e a Admin API.

Para fazer sua primeira requisição, siga o Início rápido e consulte Autenticação para ter a visão completa, incluindo credenciais de curta duração com Workload Identity Federation.

Chaves de API e a Admin API

A Admin API inclui endpoints para gerenciar programaticamente as chaves de API da sua organização, como Recuperar chave de API e Listar chaves de API. Esses endpoints são destinados a administradores da organização que automatizam o gerenciamento de chaves. Eles aceitam uma chave de Admin API, um token OAuth com o escopo org:admin, ou uma chave pessoal ou de conta de serviço que não esteja restrita a um workspace específico; chaves de workspace não funcionam ali. Eles nunca retornam o valor secreto de uma chave, apenas uma dica parcialmente ocultada.