---
title: Criar uma chave de API Admin
url: https://platform.claude.com/docs/pt-BR/manage-claude/admin-api-keys
description: Crie uma chave de API Admin para sua organização do Claude Console ou Claude Enterprise.
---

Uma chave de API de Admin autentica todas as APIs na seção **Admin** deste guia: a [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api), as [Analytics APIs](https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api), a [Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api), a [Spend Limits API](https://platform.claude.com/docs/pt-BR/manage-claude/spend-limits-api), a [API de Uso e Custo](https://platform.claude.com/docs/pt-BR/manage-claude/usage-cost-api) e a [Rate Limits API](https://platform.claude.com/docs/pt-BR/manage-claude/rate-limits-api). Você não precisa de uma chave separada para cada API. A única exceção são os endpoints de service-account, federation-issuer e federation-rule da Admin API, que aceitam apenas um token bearer OAuth com o escopo `org:admin`. Consulte [Obter um token bearer OAuth](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api#oauth-bearer-token).

Onde você cria a chave depende de qual produto Claude sua organização usa.

## De qual chave você precisa?

| Sua organização                                             | Crie a chave em                                                                                                                    | Prefixo da chave     | Quem pode criá-la                                                                                                                                                                                                         | Funciona com                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Claude Console** (Claude Platform, `platform.claude.com`) | Página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) no Claude Console | `sk-ant-admin01-...` | Membros da organização com a função **admin**                                                                                                                                                                             | [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api), [API de Uso e Custo](https://platform.claude.com/docs/pt-BR/manage-claude/usage-cost-api), [Rate Limits API](https://platform.claude.com/docs/pt-BR/manage-claude/rate-limits-api), [Claude Code Analytics API](https://platform.claude.com/docs/pt-BR/manage-claude/claude-code-analytics-api) e o [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) da Compliance API                                                                                                                    |
| **Claude Enterprise** (`claude.ai`)                         | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)                                             | `sk-ant-api01-...`   | O **proprietário principal** da organização pai (todas as organizações vinculadas). Um **proprietário da organização** pode criar uma chave contendo apenas escopos da Compliance API, restrita à sua própria organização | [Gerenciamento de usuários](https://platform.claude.com/docs/pt-BR/manage-claude/user-management) (os endpoints de membros, convites e grupos da Admin API), [Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api), [Claude Enterprise Analytics API](https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api) e [Spend Limits API](https://platform.claude.com/docs/pt-BR/manage-claude/spend-limits-api), de acordo com os [escopos](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key) 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.

## Criar uma chave para uma organização do Claude Console

<Steps>
  <Step title="Faça login como admin da organização">
    Apenas membros da organização com a função **admin** podem criar chaves de API Admin. Consulte [Funções e permissões da organização](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api#organization-roles-and-permissions).
  </Step>

  <Step title="Abra as configurações de Admin keys">
    No Claude Console, acesse a página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`).
  </Step>

  <Step title="Crie a chave">
    Clique em **Create admin key**, dê um nome a ela, escolha uma [expiração da chave](https://platform.claude.com/docs/pt-BR/manage-claude/authentication#key-expiration) e clique em **Add**. As chaves do Claude Console não têm escopos selecionáveis; toda chave tem acesso total a todos os endpoints que aceitam chaves de API Admin (os endpoints de service-account e federation mencionados no início desta página não aceitam chaves de API Admin).
  </Step>

  <Step title="Copie e armazene o segredo">
    Copie o segredo exibido (começando com `sk-ant-admin01-`) e armazene-o no seu gerenciador de segredos. O segredo completo é exibido apenas uma vez.
  </Step>
</Steps>

## Criar uma chave para uma organização do Claude Enterprise

<Steps>
  <Step title="Faça login como proprietário principal ou proprietário da organização">
    O **proprietário principal** da organização pai do Claude Enterprise pode criar uma chave que pode acessar todas as organizações vinculadas, ou uma restrita a uma única organização. Um **proprietário da organização** pode criar uma chave apenas com escopos da Compliance API, restrita à sua própria organização.
  </Step>

  <Step title="Abra as configurações de API">
    Acesse [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) e localize a seção **Keys**.
  </Step>

  <Step title="Clique em + Create key">
    Dê um nome à chave e selecione os escopos de que você precisa na [tabela de escopos](https://platform.claude.com/docs/pt-BR/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key). O proprietário principal pode combinar escopos de diferentes APIs (por exemplo, `read:analytics` e `read:spend_limits`) em uma única chave.
  </Step>

  <Step title="Copie e armazene o segredo">
    Copie o segredo exibido (começando com `sk-ant-api01-`) e armazene-o no seu gerenciador de segredos. O segredo completo é exibido apenas uma vez.
  </Step>
</Steps>

## Escolher escopos para uma chave do Claude Enterprise

Ao criar uma chave do Claude Enterprise, selecione todos os escopos exigidos pelas APIs que você planeja chamar. Os escopos são fixados na criação; para adicionar um escopo posteriormente, crie uma nova chave.

| Para chamar...                                                                                                                                                                                                                                                                                                                                                                                                                                   | Selecione estes escopos       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- |
| [Gerenciamento de usuários](https://platform.claude.com/docs/pt-BR/manage-claude/user-management) da Admin API: listar e consultar membros e convites; ler funções personalizadas e suas permissões                                                                                                                                                                                                                                              | `read:members`                |
| [Gerenciamento de usuários](https://platform.claude.com/docs/pt-BR/manage-claude/user-management) da Admin API: alterar funções de membros, remover membros, criar e retirar convites (para atribuir a função `managed` em uma alteração de função ou em um convite, selecione também `write:rbac_groups`)                                                                                                                                       | `write:members`               |
| [Gerenciamento de usuários](https://platform.claude.com/docs/pt-BR/manage-claude/user-management) da Admin API: ler grupos e seus membros                                                                                                                                                                                                                                                                                                        | `read:rbac_groups`            |
| [Gerenciamento de usuários](https://platform.claude.com/docs/pt-BR/manage-claude/user-management) da Admin API: criar, renomear e excluir grupos; adicionar e remover membros de grupos; com `write:members`, atribuir a função `managed` (em um convite ou em uma alteração de função) ou atribuir grupos em um convite                                                                                                                         | `write:rbac_groups`           |
| [Spend Limits API](https://platform.claude.com/docs/pt-BR/manage-claude/spend-limits-api): ler os limites de gastos efetivos dos membros e solicitações de aumento                                                                                                                                                                                                                                                                               | `read:spend_limits`           |
| [Spend Limits API](https://platform.claude.com/docs/pt-BR/manage-claude/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](https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api): relatórios de engajamento, adoção, custo e uso                                                                                                                                                                                                                                                                                            | `read:analytics`              |
| [Activity Feed da Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed): eventos de atividade de toda a organização                                                                                                                                                                                                                                                                                     | `read:compliance_activities`  |
| [Endpoints de chat, arquivo e projeto da Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-content-data) e [endpoints de sessão da Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-sessions): ler chats, arquivos, projetos, transcrições de sessões e [usuários da organização](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#list-organization-users) | `read:compliance_user_data`   |
| [Endpoints de chat, arquivo e projeto da Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-content-data): excluir chats, arquivos e projetos                                                                                                                                                                                                                                                                       | `delete:compliance_user_data` |
| [Endpoints de organização da Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data): ler metadados da organização e configurações efetivas                                                                                                                                                                                                                                                                    | `read:compliance_org_data`    |
| Endpoints de leitura do [gerenciamento de usuários](https://platform.claude.com/docs/pt-BR/manage-claude/user-management) da Admin API e todos os endpoints de leitura da Compliance API, com um único escopo somente leitura (para integrações de auditoria de segurança; não inclui as Spend Limits ou Analytics APIs)                                                                                                                         | `read:org_audit`              |

As Compliance e Analytics APIs devem estar habilitadas para sua organização antes que chaves com esses escopos possam ser usadas. Consulte [Configurar a Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access#set-up-the-compliance-api) e [Obter acesso à Claude Enterprise Analytics API](https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api).

## Usar a chave

Passe a chave no cabeçalho `x-api-key` em cada requisição. Consulte a documentação de cada API para 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 de que o endpoint precisa.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Admin API" href="https://platform.claude.com/docs/pt-BR/manage-claude/admin-api">
    Gerencie membros da organização, workspaces e chaves de API.
  </Card>

  <Card title="Spend Limits API" href="https://platform.claude.com/docs/pt-BR/manage-claude/spend-limits-api">
    Defina limites de gastos por membro e revise solicitações de aumento para sua organização do Claude Enterprise.
  </Card>

  <Card title="Analytics APIs" href="https://platform.claude.com/docs/pt-BR/manage-claude/analytics-api">
    Gere relatórios sobre a produtividade do Claude Code ou o engajamento e a adoção do Claude Enterprise.
  </Card>

  <Card title="Compliance API" href="https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api">
    Audite atividades e recupere ou exclua conteúdo de usuários em toda a sua organização.
  </Card>
</CardGroup>
