Todas as APIs na seção Admin deste guia (a Admin API, as Analytics APIs, a Compliance API, a Spend Limits API, a Usage and Cost API e a Rate Limits API) são autenticadas com uma chave de Admin API. Você não precisa de uma chave separada para cada API.
O local onde você cria a chave depende de qual produto Claude sua organização usa.
| Sua organização | Crie a chave em | Prefixo da chave | Quem pode criá-la | Funciona com |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Claude Console > Settings > Admin keys | sk-ant-admin01-... | Membros da organização com a função admin | Admin API, Usage and Cost API, Rate Limits API, Claude Code Analytics API e o Activity Feed da Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Organization settings > API | sk-ant-api01-... | O proprietário principal da organização | Compliance API, Claude Enterprise Analytics API e Spend Limits API, de acordo com os escopos que você selecionar |
Uma chave criada em uma organização não pode ser usada para gerenciar uma organização diferente. Se sua empresa usa tanto o Claude Console quanto o Claude Enterprise, crie uma chave em cada um.
Faça login como administrador da organização
Apenas membros da organização com a função admin podem criar chaves de Admin API. Consulte Funções e permissões da organização.
Abra as configurações de Admin keys
Crie a chave
Clique em Create key, dê um nome a ela e clique em Create. As chaves do Claude Console não têm escopos selecionáveis; cada chave concede acesso completo à Admin API.
Copie e armazene o segredo
Copie o segredo exibido (começando com sk-ant-admin01-) e armazene-o em seu gerenciador de segredos. O segredo completo é exibido apenas uma vez.
Faça login como proprietário principal
Apenas o proprietário principal da organização pai do Claude Enterprise pode criar essas chaves.
Abra as configurações de API
Acesse claude.ai > Organization settings > API e localize a seção Keys.
Clique em + Create key
Dê um nome à chave e selecione os escopos necessários na tabela de escopos. Você pode combinar escopos de diferentes APIs (por exemplo, read:analytics e read:spend_limits) em uma única chave.
Copie e armazene o segredo
Copie o segredo exibido (começando com sk-ant-api01-) e armazene-o em seu gerenciador de segredos. O segredo completo é exibido apenas uma vez.
Ao criar uma chave do Claude Enterprise, selecione todos os escopos que as APIs que você planeja chamar exigem. Os escopos são fixados no momento da criação; para adicionar um escopo posteriormente, crie uma nova chave.
| Para chamar... | Selecione estes escopos |
|---|---|
| Spend Limits API: ler os limites de gastos efetivos dos membros e solicitações de aumento | read:spend_limits |
| Spend Limits API: definir ou remover limites de gastos por usuário; aprovar ou negar solicitações de aumento | write:spend_limits |
| Claude Enterprise Analytics API: relatórios de engajamento, adoção, custo e uso | read:analytics |
| Activity Feed da Compliance API: eventos de atividade de toda a organização | read:compliance_activities |
| Endpoints de conteúdo da Compliance API: ler chats, arquivos, projetos e usuários | read:compliance_user_data |
| Endpoints de conteúdo da Compliance API: excluir chats, arquivos e projetos | delete:compliance_user_data |
| Endpoints de organização da Compliance API: ler metadados e configurações da organização | read:compliance_org_data, read:compliance_org_settings |
As APIs de Compliance e Analytics devem estar habilitadas para sua organização antes que chaves com esses escopos possam ser usadas. Consulte Obter acesso à Compliance API e Analytics APIs.
Passe a chave no cabeçalho x-api-key em cada requisição. Consulte a documentação de cada API para obter exemplos completos de requisições.
Uma chamada que excede os escopos da chave retorna 403 Forbidden com uma mensagem listando os escopos que a chave possui e os escopos que o endpoint requer.
Gerencie membros da organização, workspaces e chaves de API.
Defina limites de gastos por membro e revise solicitações de aumento para sua organização do Claude Enterprise.
Gere relatórios sobre a produtividade do Claude Code ou sobre o engajamento e a adoção do Claude Enterprise.
Audite atividades e recupere ou exclua conteúdo de usuários em toda a sua organização.
Was this page helpful?