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. Ao criar workspaces adicionais, você 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.

Funções e permissões de workspace

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

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

Gerenciando workspaces

Usando o Console

Crie e gerencie workspaces no Claude Console.

Criar um workspace

Editar detalhes do workspace

Para modificar o nome ou a cor de um workspace:

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

Adicionar membros a um workspace

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

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

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.

# 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:

# 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 de workspace incluem:

• Arquivos criados através da Files API
• Message Batches criados através da Batch API
• Skills criadas através da Skills API

Alguns recursos são gerenciados no nível da organização e não podem ser gerenciados com uma chave de API de workspace:

• MCP tunnels são gerenciados com um token OAuth com escopo de organização (org:manage_tunnels) obtido através de Workload Identity Federation, não com uma chave de API de workspace, e 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. 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.
• Os próprios workspaces e os membros da organização são gerenciados através da Admin API, que requer uma chave de Admin API.

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

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

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

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

Perguntas frequentes

Veja também

• Admin API
• Referência da Admin API
• Limites de taxa
• Usage and Cost API