Administração e monitoramento

Espaços de Trabalho

Organize chaves de API, gerencie o acesso da equipe e controle custos com espaços de trabalho.

Espaços de trabalho fornecem uma maneira de organizar seu uso de API dentro de uma organização. Use espaços de trabalho para separar diferentes projetos, ambientes ou equipes, mantendo faturamento e administração centralizados.

Como funcionam os espaços de trabalho

Toda organização tem um Espaço de Trabalho Padrão que não pode ser renomeado, arquivado ou deletado. Quando você cria espaços de trabalho adicionais, pode atribuir chaves de API, membros e limites de recursos a cada um.

Características principais:

Identificadores de espaço de trabalho usam o prefixo wrkspc_ (por exemplo, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Máximo de 100 espaços de trabalho por organização (espaços de trabalho arquivados não contam)
Espaço de Trabalho Padrão não tem ID e não aparece em endpoints de listagem
Chaves de API são limitadas a um único espaço de trabalho e podem acessar apenas recursos dentro desse espaço de trabalho

Funções e permissões do espaço de trabalho

Membros podem ter diferentes funções em cada espaço de trabalho, permitindo controle de acesso granular.

Função	Permissões
Usuário do Espaço de Trabalho	Usar apenas o Workbench
Desenvolvedor do Espaço de Trabalho	Criar e gerenciar chaves de API, usar a API
Administrador do Espaço de Trabalho	Controle total sobre configurações e membros do espaço de trabalho
Faturamento do Espaço de Trabalho	Visualizar informações de faturamento do espaço de trabalho (herdado da função de faturamento da organização)

Herança de funções

Administradores da organização recebem automaticamente acesso de Administrador do Espaço de Trabalho a todos os espaços de trabalho
Membros de faturamento da organização recebem automaticamente acesso de Faturamento do Espaço de Trabalho a todos os espaços de trabalho
Usuários e desenvolvedores da organização devem ser adicionados explicitamente a cada espaço de trabalho

A função Faturamento do Espaço de Trabalho não pode ser atribuída manualmente. É herdada por ter a função de faturamento da organização.

Gerenciando espaços de trabalho

Apenas administradores da organização podem criar espaços de trabalho. Usuários e desenvolvedores da organização devem ser adicionados aos espaços de trabalho por um administrador.

Via o Console

Crie e gerencie espaços de trabalho no Claude Console.

Criar um espaço de trabalho

Abrir configurações de espaço de trabalho
No Claude Console, vá para Configurações > Espaços de Trabalho.
Adicionar um novo espaço de trabalho
Clique em Adicionar Espaço de Trabalho.
Configurar o espaço de trabalho
Digite um nome de espaço de trabalho e selecione uma cor para identificação visual.
Criar o espaço de trabalho
Clique em Criar para finalizar.

Para alternar entre espaços de trabalho no Console, use o seletor Espaços de Trabalho no canto superior esquerdo.

Editar detalhes do espaço de trabalho

Para modificar o nome ou cor de um espaço de trabalho:

Selecione o espaço de trabalho da lista
Clique no menu de reticências (...) e escolha Editar detalhes
Atualize o nome ou cor e salve suas alterações

O Espaço de Trabalho Padrão não pode ser renomeado ou deletado.

Adicionar membros a um espaço de trabalho

Navegue até a aba Membros do espaço de trabalho
Clique em Adicionar ao Espaço de Trabalho
Selecione um membro da organização e atribua a ele uma função do espaço de trabalho
Confirme a adição

Para remover um membro, clique no ícone de lixeira ao lado do seu nome.

Administradores da organização e membros de faturamento não podem ser removidos dos espaços de trabalho enquanto mantêm essas funções organizacionais.

Definir limites do espaço de trabalho

Na aba Limites, você pode configurar:

Limites de taxa: Defina limites por nível de modelo para requisições por minuto, tokens de entrada ou tokens de saída
Notificações de gastos: Configure alertas quando os gastos atingem certos limites

Arquivar um espaço de trabalho

Para arquivar um espaço de trabalho, clique no menu de reticências (...) e selecione Arquivar. Arquivar:

Preserva dados históricos para relatórios
Desativa o espaço de trabalho e todas as chaves de API associadas
Não pode ser desfeito

Arquivar um espaço de trabalho revoga imediatamente todas as chaves de API nesse espaço de trabalho. Esta ação não pode ser desfeita.

Via a Admin API

Gerencie espaços de trabalho programaticamente usando a Admin API.

Os endpoints da Admin API requerem uma chave Admin API (começando com sk-ant-admin...) que difere das chaves de API padrão. Apenas membros da organização com a função de administrador podem provisionar chaves Admin API através do Claude Console.

# Create a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# List workspaces
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archive a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Para detalhes completos de parâmetros e esquemas de resposta, consulte a referência da API de Espaços de Trabalho.

Gerenciando membros do espaço de trabalho

Adicione, atualize ou remova membros de um espaço de trabalho:

# Add a member to a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Update a member's role
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# Remove a member from a workspace
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Para detalhes completos de parâmetros, consulte a referência da API de Membros do Espaço de Trabalho.

Chaves de API e escopo de recursos

Chaves de API são limitadas a um espaço de trabalho específico. Quando você cria uma chave de API em um espaço de trabalho, ela pode acessar apenas recursos dentro desse espaço de trabalho.

Recursos limitados a espaços de trabalho incluem:

Arquivos criados via Files API
Lotes de Mensagens criados via Batch API
Skills criados via Skills API

A partir de 5 de fevereiro de 2026, caches de prompt também serão isolados por espaço de trabalho (aplica-se à Claude API e Azure apenas).

Para recuperar os IDs de espaço de trabalho da sua organização, use o endpoint Listar Espaços de Trabalho, ou encontre-os no Claude Console.

Limites do espaço de trabalho

Você pode definir limites de gastos e taxa personalizados para cada espaço de trabalho para proteger contra uso excessivo e garantir distribuição justa de recursos.

Definindo limites do espaço de trabalho

Limites do espaço de trabalho podem ser definidos mais baixos do que (mas não mais altos do que) os limites da sua organização:

Limites de gastos: Limite os gastos mensais de um espaço de trabalho
Limites de taxa: Limite requisições por minuto, tokens de entrada por minuto ou tokens de saída por minuto

Você não pode definir limites no Espaço de Trabalho Padrão
Se não definido, os limites do espaço de trabalho correspondem aos limites da organização
Os limites em toda a organização sempre se aplicam, mesmo que os limites do espaço de trabalho somem mais

Para informações detalhadas sobre limites de taxa e como funcionam, consulte Limites de taxa.

Rastreamento de uso e custo

Rastreie uso e custos por espaço de trabalho usando a API de Uso e Custo:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Uso e custos atribuídos ao Espaço de Trabalho Padrão têm um valor null para workspace_id.

Casos de uso comuns

Separação de ambiente

Crie espaços de trabalho separados para desenvolvimento, staging e produção:

Espaço de Trabalho	Propósito
Desenvolvimento	Testes e experimentação com limites de taxa mais baixos
Staging	Testes pré-produção com limites semelhantes aos de produção
Produção	Tráfego ao vivo com limites de taxa completos e monitoramento

Isolamento de equipe ou departamento

Atribua espaços de trabalho a diferentes equipes para alocação de custos e controle de acesso:

Equipe de engenharia com acesso de desenvolvedor
Equipe de ciência de dados com suas próprias chaves de API
Equipe de suporte com acesso limitado para ferramentas de cliente

Organização baseada em projetos

Crie espaços de trabalho para projetos ou produtos específicos para rastrear uso e custos separadamente.

Melhores práticas

Planeje sua estrutura de espaço de trabalho
Considere como você organizará espaços de trabalho antes de criá-los. Pense sobre faturamento, controle de acesso e necessidades de rastreamento de uso.
Use nomes significativos
Nomeie espaços de trabalho claramente para indicar seu propósito (por exemplo, "Produção - Chatbot do Cliente", "Dev - Ferramentas Internas").
Defina limites apropriados
Configure limites de gastos e taxa para evitar custos inesperados e garantir distribuição justa de recursos.
Audite o acesso regularmente
Revise a associação do espaço de trabalho periodicamente para garantir que apenas usuários apropriados tenham acesso.
Monitore o uso
Use a API de Uso e Custo para rastrear consumo no nível do espaço de trabalho.

FAQ

Veja também

Was this page helpful?

Administração e monitoramento

Espaços de Trabalho

Organize chaves de API, gerencie o acesso da equipe e controle custos com espaços de trabalho.

Como funcionam os espaços de trabalho

Características principais:

Identificadores de espaço de trabalho usam o prefixo wrkspc_ (por exemplo, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Máximo de 100 espaços de trabalho por organização (espaços de trabalho arquivados não contam)
Espaço de Trabalho Padrão não tem ID e não aparece em endpoints de listagem
Chaves de API são limitadas a um único espaço de trabalho e podem acessar apenas recursos dentro desse espaço de trabalho

Funções e permissões do espaço de trabalho

Membros podem ter diferentes funções em cada espaço de trabalho, permitindo controle de acesso granular.

Função	Permissões
Usuário do Espaço de Trabalho	Usar apenas o Workbench
Desenvolvedor do Espaço de Trabalho	Criar e gerenciar chaves de API, usar a API
Administrador do Espaço de Trabalho	Controle total sobre configurações e membros do espaço de trabalho
Faturamento do Espaço de Trabalho	Visualizar informações de faturamento do espaço de trabalho (herdado da função de faturamento da organização)

Herança de funções

Administradores da organização recebem automaticamente acesso de Administrador do Espaço de Trabalho a todos os espaços de trabalho
Membros de faturamento da organização recebem automaticamente acesso de Faturamento do Espaço de Trabalho a todos os espaços de trabalho
Usuários e desenvolvedores da organização devem ser adicionados explicitamente a cada espaço de trabalho

A função Faturamento do Espaço de Trabalho não pode ser atribuída manualmente. É herdada por ter a função de faturamento da organização.

Gerenciando espaços de trabalho

Apenas administradores da organização podem criar espaços de trabalho. Usuários e desenvolvedores da organização devem ser adicionados aos espaços de trabalho por um administrador.

Via o Console

Crie e gerencie espaços de trabalho no Claude Console.

Criar um espaço de trabalho

Abrir configurações de espaço de trabalho
No Claude Console, vá para Configurações > Espaços de Trabalho.
Adicionar um novo espaço de trabalho
Clique em Adicionar Espaço de Trabalho.
Configurar o espaço de trabalho
Digite um nome de espaço de trabalho e selecione uma cor para identificação visual.
Criar o espaço de trabalho
Clique em Criar para finalizar.

Para alternar entre espaços de trabalho no Console, use o seletor Espaços de Trabalho no canto superior esquerdo.

Editar detalhes do espaço de trabalho

Para modificar o nome ou cor de um espaço de trabalho:

Selecione o espaço de trabalho da lista
Clique no menu de reticências (...) e escolha Editar detalhes
Atualize o nome ou cor e salve suas alterações

O Espaço de Trabalho Padrão não pode ser renomeado ou deletado.

Adicionar membros a um espaço de trabalho

Navegue até a aba Membros do espaço de trabalho
Clique em Adicionar ao Espaço de Trabalho
Selecione um membro da organização e atribua a ele uma função do espaço de trabalho
Confirme a adição

Para remover um membro, clique no ícone de lixeira ao lado do seu nome.

Administradores da organização e membros de faturamento não podem ser removidos dos espaços de trabalho enquanto mantêm essas funções organizacionais.

Definir limites do espaço de trabalho

Na aba Limites, você pode configurar:

Limites de taxa: Defina limites por nível de modelo para requisições por minuto, tokens de entrada ou tokens de saída
Notificações de gastos: Configure alertas quando os gastos atingem certos limites

Arquivar um espaço de trabalho

Para arquivar um espaço de trabalho, clique no menu de reticências (...) e selecione Arquivar. Arquivar:

Preserva dados históricos para relatórios
Desativa o espaço de trabalho e todas as chaves de API associadas
Não pode ser desfeito

Arquivar um espaço de trabalho revoga imediatamente todas as chaves de API nesse espaço de trabalho. Esta ação não pode ser desfeita.

Via a Admin API

Gerencie espaços de trabalho programaticamente usando a Admin API.

# Create a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# List workspaces
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archive a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Para detalhes completos de parâmetros e esquemas de resposta, consulte a referência da API de Espaços de Trabalho.

Gerenciando membros do espaço de trabalho

Adicione, atualize ou remova membros de um espaço de trabalho:

# Add a member to a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Update a member's role
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# Remove a member from a workspace
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Para detalhes completos de parâmetros, consulte a referência da API de Membros do Espaço de Trabalho.

Chaves de API e escopo de recursos

Chaves de API são limitadas a um espaço de trabalho específico. Quando você cria uma chave de API em um espaço de trabalho, ela pode acessar apenas recursos dentro desse espaço de trabalho.

Recursos limitados a espaços de trabalho incluem:

Arquivos criados via Files API
Lotes de Mensagens criados via Batch API
Skills criados via Skills API

A partir de 5 de fevereiro de 2026, caches de prompt também serão isolados por espaço de trabalho (aplica-se à Claude API e Azure apenas).

Para recuperar os IDs de espaço de trabalho da sua organização, use o endpoint Listar Espaços de Trabalho, ou encontre-os no Claude Console.

Limites do espaço de trabalho

Você pode definir limites de gastos e taxa personalizados para cada espaço de trabalho para proteger contra uso excessivo e garantir distribuição justa de recursos.

Definindo limites do espaço de trabalho

Limites do espaço de trabalho podem ser definidos mais baixos do que (mas não mais altos do que) os limites da sua organização:

Limites de gastos: Limite os gastos mensais de um espaço de trabalho
Limites de taxa: Limite requisições por minuto, tokens de entrada por minuto ou tokens de saída por minuto

Você não pode definir limites no Espaço de Trabalho Padrão
Se não definido, os limites do espaço de trabalho correspondem aos limites da organização
Os limites em toda a organização sempre se aplicam, mesmo que os limites do espaço de trabalho somem mais

Para informações detalhadas sobre limites de taxa e como funcionam, consulte Limites de taxa.

Rastreamento de uso e custo

Rastreie uso e custos por espaço de trabalho usando a API de Uso e Custo:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Uso e custos atribuídos ao Espaço de Trabalho Padrão têm um valor null para workspace_id.

Casos de uso comuns

Separação de ambiente

Crie espaços de trabalho separados para desenvolvimento, staging e produção:

Espaço de Trabalho	Propósito
Desenvolvimento	Testes e experimentação com limites de taxa mais baixos
Staging	Testes pré-produção com limites semelhantes aos de produção
Produção	Tráfego ao vivo com limites de taxa completos e monitoramento

Isolamento de equipe ou departamento

Atribua espaços de trabalho a diferentes equipes para alocação de custos e controle de acesso:

Equipe de engenharia com acesso de desenvolvedor
Equipe de ciência de dados com suas próprias chaves de API
Equipe de suporte com acesso limitado para ferramentas de cliente

Organização baseada em projetos

Crie espaços de trabalho para projetos ou produtos específicos para rastrear uso e custos separadamente.

Melhores práticas

Planeje sua estrutura de espaço de trabalho
Considere como você organizará espaços de trabalho antes de criá-los. Pense sobre faturamento, controle de acesso e necessidades de rastreamento de uso.
Use nomes significativos
Nomeie espaços de trabalho claramente para indicar seu propósito (por exemplo, "Produção - Chatbot do Cliente", "Dev - Ferramentas Internas").
Defina limites apropriados
Configure limites de gastos e taxa para evitar custos inesperados e garantir distribuição justa de recursos.
Audite o acesso regularmente
Revise a associação do espaço de trabalho periodicamente para garantir que apenas usuários apropriados tenham acesso.
Monitore o uso
Use a API de Uso e Custo para rastrear consumo no nível do espaço de trabalho.

FAQ

Veja também

Was this page helpful?

Como funcionam os espaços de trabalho

Funções e permissões do espaço de trabalho

Herança de funções

Gerenciando espaços de trabalho

Via o Console

Criar um espaço de trabalho

Editar detalhes do espaço de trabalho

Adicionar membros a um espaço de trabalho

Definir limites do espaço de trabalho

Arquivar um espaço de trabalho

Via a Admin API

Gerenciando membros do espaço de trabalho

Chaves de API e escopo de recursos

Limites do espaço de trabalho

Definindo limites do espaço de trabalho

Rastreamento de uso e custo

Casos de uso comuns

Separação de ambiente

Isolamento de equipe ou departamento

Organização baseada em projetos

Melhores práticas

FAQ

O que é o Espaço de Trabalho Padrão?

Existem limites em espaços de trabalho?

Como as funções da organização afetam o acesso ao espaço de trabalho?

Quais funções podem ser atribuídas em espaços de trabalho?

As funções do espaço de trabalho dos administradores ou membros de faturamento da organização podem ser alteradas?

O que acontece com o acesso ao espaço de trabalho quando as funções da organização mudam?

O que acontece com as chaves de API quando um usuário é removido de um espaço de trabalho?

Veja também

Como funcionam os espaços de trabalho

Funções e permissões do espaço de trabalho

Herança de funções

Gerenciando espaços de trabalho

Via o Console

Criar um espaço de trabalho

Editar detalhes do espaço de trabalho

Adicionar membros a um espaço de trabalho

Definir limites do espaço de trabalho

Arquivar um espaço de trabalho

Via a Admin API

Gerenciando membros do espaço de trabalho

Chaves de API e escopo de recursos

Limites do espaço de trabalho

Definindo limites do espaço de trabalho

Rastreamento de uso e custo

Casos de uso comuns

Separação de ambiente

Isolamento de equipe ou departamento

Organização baseada em projetos

Melhores práticas

FAQ

O que é o Espaço de Trabalho Padrão?

Existem limites em espaços de trabalho?

Como as funções da organização afetam o acesso ao espaço de trabalho?

Quais funções podem ser atribuídas em espaços de trabalho?

As funções do espaço de trabalho dos administradores ou membros de faturamento da organização podem ser alteradas?

O que acontece com o acesso ao espaço de trabalho quando as funções da organização mudam?

O que acontece com as chaves de API quando um usuário é removido de um espaço de trabalho?

Veja também