Um modo de permissão do Claude Code decide que ações o agente pode tomar sem parar para perguntar. Existem quatro: plan lê mas não altera nada, default pergunta antes de edições e comandos de acordo com as suas regras de permissão, acceptEdits aplica alterações a ficheiros sem perguntar mas continua a perguntar sobre comandos, e bypassPermissions não pergunta nada. Escolher um é uma declaração sobre o quanto confia no agente neste diretório.
Essa declaração torna-se mais complicada assim que a pessoa que escreve o pedido não é o proprietário da máquina. Este artigo explica os modos tal como o Claude Code os define e, em seguida, o que muda numa sala partilhada.
Os quatro modos
plan. O agente lê ficheiros, pesquisa, raciocina e produz um plano. Não edita nem executa nada. Este é o modo para "diz-me o que farias" e para permitir que alguém explore uma base de código que não deve conseguir alterar.
default. O agente pergunta antes de cada edição e de cada comando, a menos que as suas regras de permissão já permitam essa ferramenta ou padrão específico. Ideal para emparelhamento (pairing), onde está a acompanhar e cada prompt é uma decisão real.
acceptEdits. As alterações a ficheiros avançam sem um prompt; os comandos continuam a perguntar. Útil num repositório onde reverter uma má edição é simples e barato (está sob controlo de versões), mas executar o comando errado não é.
bypassPermissions. Nada pergunta. A recomendação da Anthropic é reservar este modo para ambientes efémeros em sandbox, porque uma instrução errada ou injetada é executada com toda a sua autoridade local.
A escala de plan a bypassPermissions e as quatro ações que pausam independentemente do modo quando o agente é partilhado.
Porque é que os modos dizem respeito a diretórios e não a pessoas
Um modo de permissão é definido para uma sessão, o que na prática significa para um diretório de trabalho. Essa é a unidade certa quando está sozinho: o repositório da documentação pode correr em acceptEdits, o repositório de infraestrutura em default, e uma experiência descartável em bypassPermissions.
Deixa de ser suficiente quando uma segunda pessoa pode enviar pedidos. O pedido dessa pessoa é executado com o modo da sua sessão. Um cofundador que só precisa de ler o código está agora a editá-lo porque configurou acceptEdits para si próprio na semana passada. Não existe uma dimensão por pessoa no próprio modo.
O que muda numa sala
Numa sala do muti, o agente continua a ter um modo de permissão do Claude Code, escolhido quando cria o agente para um diretório. Duas camadas assentam sobre ele.
Permissão por pessoa. Cada pedido de alguém que não seja o proprietário ou é aprovado pontualmente, ou está coberto por uma concessão permanente de "permitir sempre" dada a essa pessoa para esse agente. Pode revogar a concessão permanente a qualquer momento; os pedidos em fila dessa pessoa são cancelados.
Quatro ações que pausam sempre. Seja qual for o modo e a concessão, fazer push para um branch partilhado, apagar, gastar dinheiro e aceder a credenciais param sempre à espera do proprietário. Mesmo um agente em bypassPermissions pausa aqui quando o pedido veio de outra pessoa. A fundamentação está em quatro ações que um agente deve sempre pedir antes de fazer.
Um mapeamento prático
- Exploração para terceiros: crie o agente em
plan. Os convidados podem fazer perguntas, nada é alterado no disco. - Trabalho do dia a dia com pessoas em quem confia:
acceptEdits, com uma concessão permanente para essas pessoas. Os comandos continuam a perguntar; as quatro ações continuam a pausar. - A sua própria sandbox descartável:
bypassPermissionsserve perfeitamente porque não está mais ninguém na sala. No momento em que convidar alguém, reconsidere. - Qualquer coisa com credenciais de produção no diretório:
default, sem concessões permanentes, e um agente separado para as partes que não precisam dessas credenciais.
Perguntas frequentes
Uma sala sobrepõe-se ao modo do Claude Code? Não. O modo continua a governar o que o agente faz durante uma execução. A sala acrescenta quem pode iniciar uma execução e que ações pausam independentemente do modo.
Quem faz o pedido pode escolher o modo? Não. O proprietário escolhe-o por agente. Quem faz pedidos pode solicitar um comportamento de apenas leitura no seu pedido, e o proprietário pode responder a uma aprovação com "continuar em apenas leitura".
O bypassPermissions é alguma vez aceitável num agente partilhado? Apenas em diretórios onde nada de irreversível possa acontecer e, mesmo aí, as quatro ações pausam. Um artigo em separado aborda porque é que o bypassPermissions é seguro para si e perigoso para todos os outros.
E quanto ao Codex? O Codex tem as suas próprias definições de aprovação com uma estrutura semelhante. Numa sala, as concessões por pessoa e as quatro ações de pausa obrigatória aplicam-se da mesma forma.
Defina o modo para o diretório, defina a concessão para a pessoa e deixe as quatro ações perguntar. Este é todo o modelo. Dê uma sala ao seu agente para o ver na prática.
Publicado a