Modos de execução e permissões
Entenda os diferentes modos de execução e quando usá-los
O Verdent for VS Code oferece múltiplos modos de execução que controlam como a IA interage com seus arquivos e executa comandos. Cada modo oferece diferentes compensações entre controle, velocidade e segurança.
O que você vai aprender
- Como cada modo de execução funciona e quando usá-lo
- Modelos de permissão e considerações de segurança
- Comparação de modos e estratégias para alternar entre eles
- Think Hard Mode para tarefas de raciocínio complexo
Principais modos disponíveis
Manual Accept Mode
Modo padrão com solicitações de permissão para cada operação protegida. Máximo controle e supervisão.
Auto-Run Mode
Operações de arquivo automáticas, permissão necessária para comandos. Equilibra velocidade e segurança.
Skip Permission Mode
Autonomia total para ambientes isolados. Sem prompts de permissão para nada.
Plan Mode
Modo de planejamento somente leitura. Revise o plano completo antes de a execução começar.
Modos de execução
O Manual Accept Mode é o modo de execução padrão que oferece controle sobre modificações de arquivos e execução de comandos.
Operações automáticas:
- Leitura de arquivos e análise de código
- Navegação por diretórios
Requer permissão:
- Edição de arquivos (criar, modificar, excluir)
- Execução de comandos (comandos de terminal, testes, builds)
Quando o Verdent precisa realizar uma operação protegida, ele mostra qual ação deseja executar e qual arquivo/comando está envolvido. Você pode aceitar ou rejeitar cada operação.
Importante: Cada permissão é apenas para aquela operação específica. O Manual Accept Mode requer aprovação para cada operação protegida ao longo da sessão.
Quando usar
- Aprendendo as capacidades e os padrões de fluxo de trabalho do Verdent
- Trabalhando em bases de código desconhecidas que exigem supervisão cuidadosa
- Mudanças críticas em código de produção ou áreas sensíveis à segurança
- Requisitos de conformidade que precisam de trilhas de aprovação explícitas
Ativação
O Manual Accept Mode está ativo por padrão. Para voltar a ele:
Abra o menu de permissões
Clique no botão "Switch Permission" na caixa de entrada
Selecione Manual Accept Mode
Escolha "Manual Accept Mode" no menu suspenso
Confirme a ativação
O botão exibe "Manual" para confirmar que o modo está ativo
Considerações de segurança
Vantagens:
- Aprovação no primeiro uso por tipo de ferramenta (edições de arquivo, comandos, ferramentas)
- Visibilidade completa antes de conceder acesso
- Máximo controle e transparência
Limitações:
- Após a primeira aprovação de um tipo de ferramenta, os usos seguintes prosseguem sem prompts
- A aprovação é por tipo de ferramenta, não por operação
- Inicie novas sessões ao trabalhar em código crítico para redefinir as aprovações de ferramentas
O Auto-Run Mode aprova automaticamente operações de arquivo e exige permissão para comandos. Isso reduz os prompts de permissão para o trabalho rotineiro com arquivos, mantendo a segurança em operações arriscadas.
Automático:
- Leitura, edição, criação e exclusão de arquivos dentro do espaço de trabalho
- Mover, renomear e organizar arquivos dentro do espaço de trabalho
- Operações de busca e navegação em arquivos
Requer permissão:
- Qualquer comando que envolva caminhos fora do espaço de trabalho atual
- Comandos bash perigosos:
rm -rf,git commit,git push, etc. - Execução de comandos (terminal, scripts, builds)
- Instalação de pacotes e modificações no sistema
Quando usar
| Use Auto-Run para | Não use para |
|---|---|
| Bases de código confiáveis com controle de versão | Bases de código desconhecidas |
| Prototipagem e experimentação rápidas | Código crítico de produção |
| Refatoração de múltiplos arquivos (15+ arquivos = 15 prompts economizados) | Sem rede de segurança de controle de versão |
| Desenvolvimento focado minimizando interrupções | Requisitos de conformidade |
Ativação
Abra o menu de permissões
Clique no botão "Switch Permission" que mostra o modo atual
Selecione Auto-Run Mode
Escolha "Auto-Run Mode" no menu suspenso
Confirme a ativação
O botão exibe "Auto" para confirmar que o modo está ativo
Persiste entre sessões e reinicializações do VS Code. Aplica-se globalmente a todos os espaços de trabalho.
Exemplo de fluxo de trabalho
Construindo um endpoint POST /api/tasks:
- Ative o Auto-Run Mode
- Envie: "Crie um endpoint POST /api/tasks que valide se a categoria existe e salve no banco de dados"
- O Verdent lê 5+ arquivos e modifica 3 arquivos automaticamente (sem prompts)
- Revise as mudanças no painel Source Control
- Solicite testes: "Execute os testes para o API de tarefas"
- Prompt de permissão para o comando
npm test- Aceite - Adicione validação: "Adicione validação para títulos vazios"
- O Verdent edita automaticamente (sem prompt)
- Solicite os testes novamente - Prompt de permissão - Aceite
- Revise os diffs, faça commit das mudanças
Resultado: 3 prompts de comando, 0 prompts de arquivo. O Manual Accept exigiria 4 prompts de arquivo adicionais.
Considerações de segurança
Vantagens:
- Mudanças imediatamente visíveis no VS Code
- Limitadas ao espaço de trabalho (não podem afetar arquivos do sistema)
- O Git oferece segurança de reversão
Riscos:
- Nenhuma supervisão das operações de arquivo
- Escopo inesperado ("Renomear User para Account" pode modificar dezenas de arquivos)
- Exclusão de arquivos possível durante limpezas
- Pode modificar arquivos sensíveis se solicitado
Mitigação:
- Use prompts claros e específicos
- Revise o painel Source Control após as conclusões
- Faça commits com frequência para criar checkpoints limpos
- Use o Plan Mode primeiro para operações complexas
- Configure o .gitignore para proteger arquivos sensíveis
O Skip Permission Mode ignora todos os prompts de permissão, permitindo autonomia completa. Use somente em ambientes isolados e descartáveis.
Todas as operações automáticas:
- Operações de arquivo
- Execução de comandos
- Instalação de pacotes
- Operações em nível de sistema
Este modo remove todas as proteções de segurança. Use somente em ambientes completamente isolados e descartáveis, onde os erros não tenham consequências. Nunca use em produção ou em qualquer base de código com a qual você se importe.
Quando usar
| Use Skip Permission para | NUNCA use para |
|---|---|
| Pipelines de CI/CD automatizados em containers isolados | Ambientes de produção |
| Containers de desenvolvimento descartáveis (excluídos após a experimentação) | Ambientes de desenvolvimento com código importante |
| Ambientes sandbox sem conexões de produção | Qualquer base de código com a qual você se importe |
| Fluxos de trabalho scriptados onde a aprovação humana anula o propósito | Repositórios compartilhados |
| Ambientes com dados sensíveis |
Ativação
Abra o menu de permissões
Clique no botão "Switch Permission"
Selecione Skip Permission Mode
Escolha "Skip Permission Mode" no menu suspenso
Confirme a ativação
O botão exibe "Skip" para confirmar que o modo está ativo
Verificação de segurança antes de ativar:
- Este é um container ou VM descartável?
- Este ambiente pode ser excluído sem consequências?
- Existe algum código de produção ou importante aqui?
Se a resposta for "não" para as duas primeiras ou "sim" para a terceira, NÃO ative.
Avisos de segurança
TODAS as proteções de segurança removidas:
- Comandos executam imediatamente com permissões de sistema
- Arquivos podem ser modificados ou excluídos sem aviso
- Operações de banco de dados e operações Git (incluindo force push) prosseguem sem aprovação
- Pode instalar pacotes maliciosos ou expor credenciais
Seguro somente quando:
- O ambiente é completamente descartável
- Não existe código ou dado importante
- Não há conexão com sistemas de produção
- Você aceita que tudo pode ser destruído
Plan Mode
O Plan Mode é um modo de interação somente leitura no qual o Verdent analisa o código, cria planos detalhados e faz perguntas de esclarecimento, mas não pode modificar arquivos nem executar comandos até que você aprove.
Como funciona
- Análise - Lê os arquivos automaticamente
- Planejamento - Cria um plano estruturado com lista de tarefas
- Esclarecimento - Faz perguntas para eliminar incertezas
- Aprovação - Você revisa e decide prosseguir
- Execução - Alterna para o seu modo de permissão para executar
O plano mostra os arquivos a modificar, as etapas de implementação, as dependências e a estratégia de verificação.
Quando usar
- Mudanças complexas em múltiplos arquivos (entender o escopo antes de se comprometer)
- Bases de código desconhecidas (exploração segura sem risco)
- Decisões arquiteturais (revisar a abordagem antes da implementação)
- Evitar a fadiga do Manual Accept (revisar uma vez em vez de 50 prompts individuais)
- Mudanças de produção de alto risco (visibilidade completa antes da execução)
Ativação
Abra o menu de modos
Clique no botão "Switch Mode" na caixa de entrada
Selecione Plan Mode
Escolha "Plan Mode" no menu suspenso
Confirme a ativação
O indicador de modo muda para "Plan" para confirmar que o modo está ativo
Quando ativo, o Verdent analisa e cria planos, mas não modifica arquivos nem executa comandos até que você aprove. Após a aprovação, alterna para o seu modo de permissão padrão (Manual Accept ou Auto-Run).
Considerações de segurança
Vantagens:
- Risco zero de execução durante o planejamento
- Visibilidade completa antes de se comprometer
- O esclarecimento interativo elimina incertezas
- Seguro para análise de produção
Limitações:
- A aprovação não garante a correção (planos podem ter erros lógicos)
- A segurança da execução depende do modo de permissão escolhido após a aprovação
- A qualidade do plano depende da clareza do prompt
Boas práticas:
- Revise os planos em busca de erros lógicos ou mal-entendidos
- Faça perguntas de acompanhamento se algo não estiver claro
- Refine os prompts antes de aprovar a execução
- Considere qual modo de permissão executará (Manual Accept para supervisão, Auto-Run para velocidade)
Think Hard Mode
O Think Hard Mode aloca o máximo de recursos computacionais para tarefas de raciocínio complexo. O modelo explora múltiplas abordagens e oferece soluções mais completas.
Características:
- Tempo de raciocínio estendido
- Análise mais profunda de múltiplas abordagens de solução
- Melhor tratamento de lógica complexa, casos extremos e decisões arquiteturais
- Maior custo em créditos por solicitação
Quando usar
| Use o Think Hard Mode para | Não use para |
|---|---|
| Decisões arquiteturais complexas com múltiplas compensações | Tarefas simples e diretas |
| Depuração sofisticada com múltiplas causas potenciais | Solicitações sensíveis ao tempo |
| Design de algoritmos que exigem análise de otimização | Orçamento de créditos limitado |
| Lógica de negócios crítica em que a correção é primordial | Quando o modo padrão é suficiente |
| Otimização de desempenho de gargalos complexos |
Ativação
Use o botão da interface para ativação por solicitação:
Ative o Think Hard
Clique no botão/alternância "Think Hard" na caixa de entrada
Envie seu prompt
Digite e envie sua solicitação
Apenas uma solicitação
Aplica-se somente àquela solicitação específica - não é persistente
Funciona com todos os provedores de IA. Não é persistente - você deve ativar a cada vez para solicitações que exijam raciocínio profundo.
Inclua palavras-chave de raciocínio no seu prompt:
Think: Design the optimal database schema for this multi-tenant SaaS applicationOu para o máximo de raciocínio:
Ultrathink: Analyze the trade-offs between different authentication approaches"Think" e "ultrathink" são capacidades específicas do modelo Claude. Essas palavras-chave ativam um raciocínio mais profundo nos modelos Claude (Sonnet, Opus), mas podem não funcionar com outros provedores de IA (GPT-5, MiniMax).
Ativação apenas por solicitação - não é persistente como o Manual Accept ou o Auto-Run.
Comparação de modos
| Modo | Controle | Velocidade | Melhor para | Evite quando |
|---|---|---|---|---|
| Manual Accept | Máximo | Mais lento | Aprendizado, código desconhecido, mudanças críticas | Projetos confiáveis, iteração rápida |
| Auto-Run | Moderado | Rápido | Bases de código confiáveis, prototipagem, trabalho com múltiplos arquivos | Código desconhecido, sem controle de versão |
| Skip Permission | Nenhum | Mais rápido | CI/CD, containers descartáveis, sandboxes | Produção, código importante |
| Plan Mode | Revisão primeiro | N/A | Mudanças complexas, decisões arquiteturais | Tarefas simples |
| Think Hard | Por solicitação | Mais lento | Raciocínio complexo, algoritmos, lógica crítica | Tarefas simples, sensíveis ao tempo |
Quando usar cada modo
| Cenário | Manual Accept | Auto-Run | Skip Permission | Plan Mode |
|---|---|---|---|---|
| Aprendendo o Verdent | ✓ | |||
| Base de código desconhecida | ✓ | ✓ | ||
| Base de código confiável com Git | ✓ | |||
| Código crítico/de produção | ✓ | ✓ | ||
| Prototipagem rápida | ✓ | |||
| Refatoração de múltiplos arquivos | ✓ | |||
| Planejamento arquitetural complexo | ✓ | |||
| Pipelines de CI/CD (isolados) | ✓ | |||
| Containers descartáveis | ✓ | |||
| Requisitos de conformidade | ✓ |
Boas práticas de segurança
Hierarquia de segurança (do mais seguro ao menos seguro)
Entender a classificação de segurança de cada modo ajuda você a escolher de forma adequada para diferentes níveis de risco.
- Plan Mode - Somente leitura até a aprovação. Risco zero de execução durante o planejamento.
- Manual Accept Mode - Controle por operação com aprovação no primeiro uso por tipo de ferramenta.
- Auto-Run Mode - Autonomia de arquivos com aprovação de comandos. Rede de segurança do Git necessária.
- Skip Permission Mode - Autonomia total. Apenas para ambientes isolados.
Combine seu modo ao nível de risco: código crítico usa os modos mais seguros (Plan, Manual Accept), código confiável usa modos mais rápidos (Auto-Run), ambientes descartáveis usam o modo mais rápido (Skip Permission).
Boas práticas gerais
Práticas essenciais que se aplicam independentemente do modo de execução que você estiver usando.
Para todos os modos:
- Use controle de versão - Inicialize o Git antes de usar modos permissivos, faça commits com frequência, revise os diffs antes de fazer commit
- Escreva prompts claros - Seja específico quanto ao escopo, especifique os limites de arquivos explicitamente, use @-menções para contexto
- Revise antes de fazer commit - Verifique o painel Source Control após as conclusões, revise todos os diffs com cuidado, teste as mudanças
- Inicie sessões novas - Limpe o contexto entre tarefas importantes, redefina as aprovações de ferramentas para trabalhos sensíveis, evite contaminação de contexto
- Combine o modo ao risco - Código crítico → Manual Accept ou Plan Mode, código confiável → Auto-Run, experimentos → Auto-Run com Git, descartável → apenas Skip Permission
Lembretes de segurança:
- Nunca faça commit de arquivos sensíveis (.env, credenciais)
- Configure o .gitignore antes de usar o Auto-Run
- Revise as permissões de comando com cuidado
- Use o Plan Mode para mudanças que afetem a segurança
- Sessões novas redefinem as aprovações de ferramentas no Manual Accept
Progressive Permission Model
Entender como o sistema de permissões do Verdent funciona ajuda você a usá-lo de forma eficaz.
Como funciona:
- Primeiro uso - O sistema solicita permissão quando você usa pela primeira vez cada tipo de ferramenta (edições de arquivo, execuções de comando, uso de ferramentas)
- Usos seguintes - Após a aprovação inicial, aquele tipo de ferramenta prossegue sem prompts pelo restante da sessão
- Nova sessão - Iniciar uma nova sessão redefine todas as aprovações, permitindo que você comece do zero
Princípio principal: Este modelo equilibra segurança com produtividade. Você revisa e aprova os tipos de ferramenta uma vez e, então, trabalha com eficiência dentro desse contexto de aprovação. Para trabalhos sensíveis, inicie uma nova sessão para redefinir as aprovações.
Para redefinir as aprovações: Inicie uma nova sessão