# O que são modos de permissão em agentes de programação?

URL: https://agentvera.dev/pt/glossary/permission-modes/

Modos de permissão são as predefinições que determinam o que um agente de programação pode fazer sem perguntar a você: ler arquivos, editá-los, rodar comandos ou acessar a rede. O Claude Code chama de permission modes; o Codex combina uma política de aprovação com um modo de sandbox.

**Os modos de permissão do Claude Code.** Você alterna entre eles com Shift+Tab, começa num modo específico com claude --permission-mode ou define o padrão com permissions.defaultMode num arquivo de configurações.

- default (também chamado de Manual): pergunta antes da maioria das edições, comandos de shell e acessos à rede.
- acceptEdits: aprova edições de arquivos e comandos de arquivo comuns como mkdir, mv e cp dentro da pasta de trabalho.
- plan: o Claude pesquisa e propõe um plano, mas não pode alterar arquivos de código até você aprovar.
- auto: um modelo classificador revisa cada ação no seu lugar, então a maioria roda sem pergunta; depois de bloqueios repetidos, volta a perguntar. Versões recentes iniciam as sessões interativas em auto onde ele está disponível.
- dontAsk: recusa tudo o que normalmente pediria permissão; feito para CI e scripts fechados.
- bypassPermissions (a opção --dangerously-skip-permissions): pula as perguntas e as verificações de segurança; só para contêineres ou VMs isolados.

**Codex: política de aprovação e sandbox.** O Codex divide a questão em duas: quando perguntar a você (a política de aprovação) e até onde os comandos podem chegar tecnicamente (a sandbox, aplicada pelo sistema operacional com Seatbelt no macOS e bwrap com seccomp no Linux).

- Modos de sandbox: read-only, workspace-write (edições dentro do espaço de trabalho) e danger-full-access. O acesso à rede vem desligado.
- Políticas de aprovação: on-request pergunta quando o agente precisa sair da sandbox; never não pergunta nunca.
- A predefinição Auto (workspace-write com on-request) é a que o Codex usa numa pasta com controle de versão; /permissions troca de modo durante a sessão.
- approvals_reviewer = "auto_review" envia os pedidos de aprovação elegíveis para um agente revisor em vez de você.
- --yolo, abreviação de --dangerously-bypass-approvals-and-sandbox, desliga os dois; a OpenAI não recomenda.

**Por que isso importa em execuções sem supervisão.** Um agente deixado sozinho durante a noite ou na CI não pode esperar um clique: uma pergunta que ninguém responde o trava por horas, e pular todas as verificações deixa um único comando errado causar dano real. A resposta comum é tirar as perguntas e manter as proteções em outro lugar.

- Rode o agente numa sandbox, contêiner ou VM que só enxergue o projeto, não suas chaves SSH nem sua pasta pessoal.
- Aprove de antemão os comandos seguros com regras allow e bloqueie os destrutivos, como git push, rm -rf e deploys.
- Deixe o agente fazer commits numa branch, mas não push, e revise de manhã.
- Na CI, use as opções não interativas: dontAsk no Claude Code ou codex exec com sandbox definida explicitamente.

**Como escolher o modo.** Use plan para combinar a abordagem antes de uma mudança grande, default ou acceptEdits enquanto você está no teclado, e auto ou uma predefinição com sandbox para tarefas longas que você só confere de vez em quando. Deixe as opções de bypass para ambientes descartáveis. Nosso guia para rodar o Claude Code durante a noite mostra uma configuração completa.

**Onde o AgentVera se encaixa.** O AgentVera não substitui esses modos, trabalha junto com eles: a aprovação automática responde aos pedidos seguros do Claude Code, como leituras e testes, enquanto git push e rm sempre chegam até você (Pro e Team), os agentes em espera ficam numa fila de aprovações, e um agente Claude Code ou Codex pode rodar num contêiner Docker que só enxerga a pasta do projeto.

- **Qual modo de permissão é o mais seguro?** No Claude Code, plan, porque ele não pode editar arquivos de código até você aprovar o plano; no Codex, a sandbox read-only. O que a máquina expõe importa tanto quanto o modo, então o isolamento também ajuda.
- **O modo auto é o mesmo que bypassPermissions?** Não. No auto, um classificador continua revisando cada ação e pode bloqueá-la; bypassPermissions pula as verificações por completo.
- **Posso definir um modo padrão?** Sim. No Claude Code, defina permissions.defaultMode num arquivo de configurações. No Codex, defina sandbox_mode e approval_policy no config.toml ou passe --sandbox e --ask-for-approval.
- **Como deixar um agente trabalhando sozinho com segurança?** Dê a ele uma sandbox ou um contêiner, aprove de antemão só os comandos seguros, bloqueie push e deploys e revise a branch dele depois.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/
