AdminOrganização

Workspaces

Organize chaves de API, gerencie o acesso da equipe e controle custos com workspaces.

Workspaces fornecem uma maneira de organizar o uso da API dentro de uma organização. Use workspaces para separar diferentes projetos, ambientes ou equipes, mantendo faturamento e administração centralizados.

Como os workspaces funcionam

Toda organização tem um Default Workspace que não pode ser renomeado, arquivado ou excluído. Quando você cria workspaces adicionais, pode atribuir chaves de API, membros e limites de recursos a cada um.

Características principais:

Identificadores de workspace usam o prefixo wrkspc_ (por exemplo, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Máximo de 100 workspaces por organização (workspaces arquivados não contam)
O Default Workspace não tem ID e não aparece nos endpoints de listagem
Chaves de API têm escopo limitado a um único workspace e só podem acessar recursos dentro desse workspace

Workspace do Claude Code

Quando um membro da sua organização faz login pela primeira vez no Claude Code com sua conta do Claude Console, a Anthropic cria automaticamente um workspace Claude Code na organização e adiciona esse membro a ele. Cada membro subsequente que fizer login no Claude Code é adicionado da mesma forma.

O workspace do Claude Code mantém o tráfego do Claude Code separado das suas outras cargas de trabalho da API:

O Claude Code gera uma chave de API por usuário neste workspace no momento do login. Você não pode criar chaves nele manualmente a partir do Console.
Uma chave do Claude Code para de funcionar se seu proprietário for removido do workspace ou da organização, diferentemente das chaves de workspace padrão.
O uso do Claude Code tem limite de taxa aplicado separadamente, e administradores podem limitar sua parcela dos limites da organização em Settings > Workspaces.
É o único workspace que suporta limites de gastos mensais por usuário.

Arquivar o workspace do Claude Code desativa o login no Claude Code por meio do faturamento do Console para toda a organização.

Funções e permissões de workspace

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

Função	Permissões
Workspace User	Usar apenas o Workbench
Workspace Limited Developer	Criar e gerenciar chaves de API, usar a API. Não pode acessar visualizações de rastreamento de sessão nem baixar arquivos.
Workspace Developer	Criar e gerenciar chaves de API, usar a API
Workspace Admin	Controle total sobre configurações e membros do workspace
Workspace Billing	Visualizar informações de faturamento do workspace (herdada da função de faturamento da organização)

Herança de funções

Administradores da organização recebem automaticamente acesso de Workspace Admin a todos os workspaces
Membros de faturamento da organização recebem automaticamente acesso de Workspace Billing a todos os workspaces
Usuários e desenvolvedores da organização devem ser adicionados explicitamente a cada workspace

A função Workspace Billing não pode ser atribuída manualmente. Ela é herdada por quem tem a função de faturamento da organização.

Gerenciando workspaces

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

Usando o Console

Crie e gerencie workspaces no Claude Console.

Criar um workspace

Abra as configurações de workspace
No Claude Console, vá para Settings > Workspaces.
Crie um workspace
Clique em Create workspace.
Configure o workspace
Insira um nome para o workspace e selecione uma cor para identificação visual.
Crie o workspace
Clique em Create para finalizar.

Para alternar entre workspaces no Console, use o seletor Workspaces no canto superior esquerdo.

Editar detalhes do workspace

Para modificar o nome ou a cor de um workspace:

Selecione o workspace na lista
Clique no menu de reticências (...) e escolha Edit details
Atualize o nome ou a cor e salve suas alterações

O Default Workspace não pode ser renomeado ou excluído.

Adicionar membros a um workspace

Navegue até a aba Members do workspace
Clique em Add to Workspace
Selecione um membro da organização e atribua a ele uma função de workspace
Confirme a adição

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

Administradores da organização e membros de faturamento não podem ser removidos de workspaces enquanto mantiverem essas funções na organização.

Definir limites do workspace

Na aba Limits, 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 atingirem determinados limites

Arquivar um workspace

Para arquivar um workspace, clique no menu de reticências (...) e selecione Archive. O arquivamento:

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

Arquivar um workspace revoga imediatamente todas as chaves de API nesse workspace. Essa ação não pode ser desfeita. Se você arquivar o workspace do Claude Code, os membros da sua organização não poderão mais fazer login no Claude Code por meio do faturamento do Console.

Usando a Admin API

Gerencie workspaces programaticamente usando a Admin API.

Os endpoints da Admin API exigem uma chave de Admin API (começando com sk-ant-admin...) que é diferente das chaves de API padrão. Consulte Criar uma chave de Admin API para saber como provisionar uma.

cURL

# Criar um 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"}'

# Listar 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"

# Arquivar um 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 Workspaces.

Gerenciando membros do workspace

Adicione, atualize ou remova membros de um workspace:

cURL

# Adicionar um membro a um 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"
  }'

# Atualizar a função de um membro
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"}'

# Remover um membro de um 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 Workspace Members.

Chaves de API e escopo de recursos

Chaves de API têm escopo limitado a um workspace específico. Quando você cria uma chave de API em um workspace, ela só pode acessar recursos dentro desse workspace.

Recursos com escopo limitado a workspaces incluem:

Arquivos criados por meio da Files API
Message Batches criados por meio da Batch API
Skills criadas por meio da Skills API

Alguns recursos não podem ser gerenciados com uma chave de API de workspace:

MCP tunnels são gerenciados com um token OAuth workspace:manage_tunnels obtido por meio de Workload Identity Federation, não com uma chave de API de workspace. Os túneis são criados em um workspace, e a lista MCP tunnels do Console e o seletor de servidor do Managed Agent mostram apenas os túneis do workspace atual; o limite de 10 túneis ativos se aplica a toda a organização. O gerenciamento de túneis requer uma função com permissões de gerenciamento de túneis; desenvolvedores da organização podem visualizá-los, mas não alterá-los.
Os próprios workspaces e os membros da organização são gerenciados no nível da organização por meio da Admin API, que requer uma chave de Admin API.

Caches de prompt também são isolados por workspace na Claude API, no Claude Platform on AWS e no Microsoft Foundry. No Amazon Bedrock e no Google Cloud, os caches de prompt são isolados por organização.

Para recuperar os IDs de workspace da sua organização, use o endpoint List Workspaces ou encontre-os no Claude Console.

Limites de workspace

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

Definindo limites de workspace

Os limites de workspace podem ser definidos abaixo (mas não acima) dos limites da sua organização:

Limites de gastos: Limite os gastos mensais de um workspace
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 Default Workspace
Se não forem definidos, os limites do workspace correspondem aos limites da organização
Os limites de toda a organização sempre se aplicam, mesmo que a soma dos limites dos workspaces seja maior

Para informações detalhadas sobre limites de taxa e como eles funcionam, consulte Limites de taxa. Você também pode ler seus limites de taxa atuais da organização e do workspace programaticamente com a Rate Limits API.

Rastreamento de uso e custos

Rastreie uso e custos por workspace usando a Usage and Cost API:

cURL

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: $ANTHROPIC_ADMIN_KEY"

Uso e custos atribuídos ao Default Workspace têm um valor null para workspace_id.

Casos de uso comuns

Separação de ambientes

Crie workspaces separados para desenvolvimento, staging e produção:

Workspace	Finalidade
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 por equipe ou departamento

Atribua workspaces 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 atendimento ao cliente

Organização baseada em projetos

Crie workspaces para projetos ou produtos específicos para rastrear uso e custos separadamente.

Melhores práticas

Planeje sua estrutura de workspaces
Considere como você organizará os workspaces antes de criá-los. Pense nas necessidades de faturamento, controle de acesso e rastreamento de uso.
Use nomes significativos
Nomeie os workspaces de forma clara para indicar sua finalidade (por exemplo, "Produção - Chatbot de Clientes", "Dev - Ferramentas Internas").
Defina limites apropriados
Configure limites de gastos e de taxa para evitar custos inesperados e garantir distribuição justa de recursos.
Audite o acesso regularmente
Revise a associação de membros aos workspaces periodicamente para garantir que apenas usuários apropriados tenham acesso.
Monitore o uso
Use a Usage and Cost API para rastrear o consumo no nível de workspace.

Perguntas frequentes

Veja também

Was this page helpful?

AdminOrganização

Workspaces

Organize chaves de API, gerencie o acesso da equipe e controle custos com workspaces.

Como os workspaces funcionam

Características principais:

Identificadores de workspace usam o prefixo wrkspc_ (por exemplo, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
Máximo de 100 workspaces por organização (workspaces arquivados não contam)
O Default Workspace não tem ID e não aparece nos endpoints de listagem
Chaves de API têm escopo limitado a um único workspace e só podem acessar recursos dentro desse workspace

Workspace do Claude Code

O workspace do Claude Code mantém o tráfego do Claude Code separado das suas outras cargas de trabalho da API:

O Claude Code gera uma chave de API por usuário neste workspace no momento do login. Você não pode criar chaves nele manualmente a partir do Console.
Uma chave do Claude Code para de funcionar se seu proprietário for removido do workspace ou da organização, diferentemente das chaves de workspace padrão.
O uso do Claude Code tem limite de taxa aplicado separadamente, e administradores podem limitar sua parcela dos limites da organização em Settings > Workspaces.
É o único workspace que suporta limites de gastos mensais por usuário.

Arquivar o workspace do Claude Code desativa o login no Claude Code por meio do faturamento do Console para toda a organização.

Funções e permissões de workspace

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

Função	Permissões
Workspace User	Usar apenas o Workbench
Workspace Limited Developer	Criar e gerenciar chaves de API, usar a API. Não pode acessar visualizações de rastreamento de sessão nem baixar arquivos.
Workspace Developer	Criar e gerenciar chaves de API, usar a API
Workspace Admin	Controle total sobre configurações e membros do workspace
Workspace Billing	Visualizar informações de faturamento do workspace (herdada da função de faturamento da organização)

Herança de funções

Administradores da organização recebem automaticamente acesso de Workspace Admin a todos os workspaces
Membros de faturamento da organização recebem automaticamente acesso de Workspace Billing a todos os workspaces
Usuários e desenvolvedores da organização devem ser adicionados explicitamente a cada workspace

A função Workspace Billing não pode ser atribuída manualmente. Ela é herdada por quem tem a função de faturamento da organização.

Gerenciando workspaces

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

Usando o Console

Crie e gerencie workspaces no Claude Console.

Criar um workspace

Abra as configurações de workspace
No Claude Console, vá para Settings > Workspaces.
Crie um workspace
Clique em Create workspace.
Configure o workspace
Insira um nome para o workspace e selecione uma cor para identificação visual.
Crie o workspace
Clique em Create para finalizar.

Para alternar entre workspaces no Console, use o seletor Workspaces no canto superior esquerdo.

Editar detalhes do workspace

Para modificar o nome ou a cor de um workspace:

Selecione o workspace na lista
Clique no menu de reticências (...) e escolha Edit details
Atualize o nome ou a cor e salve suas alterações

O Default Workspace não pode ser renomeado ou excluído.

Adicionar membros a um workspace

Navegue até a aba Members do workspace
Clique em Add to Workspace
Selecione um membro da organização e atribua a ele uma função de workspace
Confirme a adição

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

Administradores da organização e membros de faturamento não podem ser removidos de workspaces enquanto mantiverem essas funções na organização.

Definir limites do workspace

Na aba Limits, 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 atingirem determinados limites

Arquivar um workspace

Para arquivar um workspace, clique no menu de reticências (...) e selecione Archive. O arquivamento:

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

Usando a Admin API

Gerencie workspaces programaticamente usando a Admin API.

cURL

# Criar um 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"}'

# Listar 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"

# Arquivar um 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 Workspaces.

Gerenciando membros do workspace

Adicione, atualize ou remova membros de um workspace:

cURL

# Adicionar um membro a um 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"
  }'

# Atualizar a função de um membro
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"}'

# Remover um membro de um 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 Workspace Members.

Chaves de API e escopo de recursos

Chaves de API têm escopo limitado a um workspace específico. Quando você cria uma chave de API em um workspace, ela só pode acessar recursos dentro desse workspace.

Recursos com escopo limitado a workspaces incluem:

Arquivos criados por meio da Files API
Message Batches criados por meio da Batch API
Skills criadas por meio da Skills API

Alguns recursos não podem ser gerenciados com uma chave de API de workspace:

MCP tunnels são gerenciados com um token OAuth workspace:manage_tunnels obtido por meio de Workload Identity Federation, não com uma chave de API de workspace. Os túneis são criados em um workspace, e a lista MCP tunnels do Console e o seletor de servidor do Managed Agent mostram apenas os túneis do workspace atual; o limite de 10 túneis ativos se aplica a toda a organização. O gerenciamento de túneis requer uma função com permissões de gerenciamento de túneis; desenvolvedores da organização podem visualizá-los, mas não alterá-los.
Os próprios workspaces e os membros da organização são gerenciados no nível da organização por meio da Admin API, que requer uma chave de Admin API.

Para recuperar os IDs de workspace da sua organização, use o endpoint List Workspaces ou encontre-os no Claude Console.

Limites de workspace

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

Definindo limites de workspace

Os limites de workspace podem ser definidos abaixo (mas não acima) dos limites da sua organização:

Limites de gastos: Limite os gastos mensais de um workspace
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 Default Workspace
Se não forem definidos, os limites do workspace correspondem aos limites da organização
Os limites de toda a organização sempre se aplicam, mesmo que a soma dos limites dos workspaces seja maior

Rastreamento de uso e custos

Rastreie uso e custos por workspace usando a Usage and Cost API:

cURL

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: $ANTHROPIC_ADMIN_KEY"

Uso e custos atribuídos ao Default Workspace têm um valor null para workspace_id.

Casos de uso comuns

Separação de ambientes

Crie workspaces separados para desenvolvimento, staging e produção:

Workspace	Finalidade
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 por equipe ou departamento

Atribua workspaces 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 atendimento ao cliente

Organização baseada em projetos

Crie workspaces para projetos ou produtos específicos para rastrear uso e custos separadamente.

Melhores práticas

Planeje sua estrutura de workspaces
Considere como você organizará os workspaces antes de criá-los. Pense nas necessidades de faturamento, controle de acesso e rastreamento de uso.
Use nomes significativos
Nomeie os workspaces de forma clara para indicar sua finalidade (por exemplo, "Produção - Chatbot de Clientes", "Dev - Ferramentas Internas").
Defina limites apropriados
Configure limites de gastos e de taxa para evitar custos inesperados e garantir distribuição justa de recursos.
Audite o acesso regularmente
Revise a associação de membros aos workspaces periodicamente para garantir que apenas usuários apropriados tenham acesso.
Monitore o uso
Use a Usage and Cost API para rastrear o consumo no nível de workspace.

Perguntas frequentes

Veja também

Was this page helpful?

Como os workspaces funcionam

Workspace do Claude Code

Funções e permissões de workspace

Herança de funções

Gerenciando workspaces

Usando o Console

Criar um workspace

Editar detalhes do workspace

Adicionar membros a um workspace

Definir limites do workspace

Arquivar um workspace

Usando a Admin API

Gerenciando membros do workspace

Chaves de API e escopo de recursos

Limites de workspace

Definindo limites de workspace

Rastreamento de uso e custos

Casos de uso comuns

Separação de ambientes

Isolamento por equipe ou departamento

Organização baseada em projetos

Melhores práticas

Perguntas frequentes

O que é o Default Workspace?

O que é o workspace do Claude Code?

Existem limites para workspaces?

Como as funções da organização afetam o acesso aos workspaces?

Quais funções podem ser atribuídas em workspaces?

As funções de workspace de administradores ou membros de faturamento da organização podem ser alteradas?

O que acontece com o acesso aos workspaces quando as funções da organização mudam?

O que acontece com as chaves de API quando um usuário é removido de um workspace?

Veja também

Como os workspaces funcionam

Workspace do Claude Code

Funções e permissões de workspace

Herança de funções

Gerenciando workspaces

Usando o Console

Criar um workspace

Editar detalhes do workspace

Adicionar membros a um workspace

Definir limites do workspace

Arquivar um workspace

Usando a Admin API

Gerenciando membros do workspace

Chaves de API e escopo de recursos

Limites de workspace

Definindo limites de workspace

Rastreamento de uso e custos

Casos de uso comuns

Separação de ambientes

Isolamento por equipe ou departamento

Organização baseada em projetos

Melhores práticas

Perguntas frequentes

O que é o Default Workspace?

O que é o workspace do Claude Code?

Existem limites para workspaces?

Como as funções da organização afetam o acesso aos workspaces?

Quais funções podem ser atribuídas em workspaces?

As funções de workspace de administradores ou membros de faturamento da organização podem ser alteradas?

O que acontece com o acesso aos workspaces quando as funções da organização mudam?

O que acontece com as chaves de API quando um usuário é removido de um workspace?

Veja também

Como os workspaces funcionam

Workspace do Claude Code

Funções e permissões de workspace

Herança de funções

Gerenciando workspaces

Usando o Console

Criar um workspace

Editar detalhes do workspace

Adicionar membros a um workspace

Definir limites do workspace

Arquivar um workspace

Usando a Admin API

Gerenciando membros do workspace

Chaves de API e escopo de recursos

Limites de workspace

Definindo limites de workspace

Rastreamento de uso e custos

Casos de uso comuns

Separação de ambientes

Isolamento por equipe ou departamento

Organização baseada em projetos

Melhores práticas

Perguntas frequentes

Veja também

Como os workspaces funcionam

Workspace do Claude Code

Funções e permissões de workspace

Herança de funções

Gerenciando workspaces

Usando o Console

Criar um workspace

Editar detalhes do workspace

Adicionar membros a um workspace

Definir limites do workspace

Arquivar um workspace

Usando a Admin API

Gerenciando membros do workspace

Chaves de API e escopo de recursos

Limites de workspace

Definindo limites de workspace

Rastreamento de uso e custos

Casos de uso comuns

Separação de ambientes

Isolamento por equipe ou departamento

Organização baseada em projetos

Melhores práticas

Perguntas frequentes

Veja também