Permissões e segurança do agente de IA
O agente apenas propõe ações. Toda edição de arquivo e execução de comando passa por uma verificação de permissão em sua máquina antes que qualquer coisa aconteça, e nada pode desativar essa verificação.
O que sempre ocorre sem solicitar confirmação
Seção intitulada “O que sempre ocorre sem solicitar confirmação”Ferramentas somente de leitura são executadas livremente dentro do espaço de trabalho: leitura de arquivos, listagem de diretórios, pesquisa e somente leitura git comandos como status, diff, e log. O espaço de trabalho é o diretório onde você iniciou o agente, além de qualquer diretório adicionado com --add-dir ou /add-dir. Caminhos fora dele, ..
Caracteres de escape e links que levam para fora do ambiente são recusados.
Modos de permissão
Seção intitulada “Modos de permissão”Pressione Shift+Tab para alternar entre os modos. O modo atual é exibido na linha de status.
| Modo | Edições de arquivo | Comandos |
|---|---|---|
ask (padrão) | Pergunta todas as vezes | Pergunta todas as vezes |
accept-edits | Executar sem perguntar dentro do espaço de trabalho | Continuar perguntando |
plan | Recusado | Recusado |
No plan No modo , o agente pesquisa e descreve as alterações em vez de realizá-las. /plan Altera para o modo de planejamento em caso de solicitação de planejamento.
Defina o modo inicial com --permission-mode, com /permissions mode MODE, ou com defaultMode em um arquivo de configurações. Não há modo que ignore todas as verificações de permissão.
Respondendo a uma solicitação de permissão
Seção intitulada “Respondendo a uma solicitação de permissão”Uma solicitação mostra exatamente o que acontecerá: o diff para uma edição, a linha de comando completa e o diretório de trabalho para um comando, ou o servidor e os argumentos para uma ferramenta MCP. Você pode escolher:
- Sim para executar uma vez.
- Sim, e não perguntar novamente para esse prefixo de comando ou padrão de arquivo neste projeto. A regra é salva em suas próprias configurações para este projeto, em
$CONFIG/ai/projects/, nunca dentro do repositório. - Não, e explique à IA o motivo, para que o agente possa se ajustar.
Algumas chamadas são sempre solicitadas, e nenhuma regra pode permiti-las: comandos que fazem referência a arquivos secretos ou armazenamentos de credenciais, alterações em .champrep/ ou
.git/ componentes internos e comandos que são complexos demais para serem analisados com segurança.
Regras de permissão e negação
Seção intitulada “Regras de permissão e negação”As regras têm o formato Tool ou Tool(pattern):
{ "permissions": { "allow": ["local_bash(npm test*)", "local_bash(go test ./...)", "local_edit_file(src/**)"], "deny": ["local_bash(git push*)", "local_bash(rm -rf*)", "local_read_file(secrets/**)"], "defaultMode": "ask" }}- Regras de comando tais como
local_bash(npm test*)correspondem à linha de comando. Comandos unidos por;,&&,||,|, ou as substituições são divididas, e todos parte deve ser permitida. - Regras de caminho tais como
local_edit_file(src/**)correspondem a caminhos relativos ao espaço de trabalho.*permanece dentro de uma pasta;**abrange pastas. - Nomes das ferramentas pode usar
*, por exemplolocal_mcp__github__*para todas as ferramentas de um servidor MCP local. - A
local_read_file(...)regra de negação, ou umadeny_readlista, também oculta esses arquivos de todas as ferramentas de leitura e pesquisa.
Gerencie regras sem editar arquivos:
/permissions/permissions allow local_bash(npm run lint*)/permissions deny local_bash(git push*)/permissions remove local_bash(npm run lint*)/permissions mode accept-edits/permissions allow, deny, e remove edite suas respostas salvas para este projeto (em $CONFIG/ai/projects/). Edite os demais arquivos diretamente.
Arquivos de configuração e prioridade
Seção intitulada “Arquivos de configuração e prioridade”| Arquivo | Escopo |
|---|---|
--allowed-tools sinalizador | Apenas nesta execução |
$CONFIG/ai/projects/<id>.json | Suas respostas salvas para este projeto (“não perguntar novamente”, /permissions) |
.champrep/settings.local.json | Você, neste projeto (adicionado a .gitignore automaticamente) |
.champrep/settings.json | Todos neste projeto (faça um commit para compartilhar) |
$CONFIG/ai/settings.json | O(a) senhor(a), em todos os projetos |
As entradas anteriores têm precedência. As regras de negação de qualquer arquivo sempre prevalecem. Suas respostas salvas são aplicadas imediatamente, pois ficam fora do repositório. Regras de permissão e defaultMode nos dois .champrep/ Os arquivos só entram em vigor depois que você conceder confiança ao projeto .champrep/ configuração (consulte
Confiança no repositório); as regras de negação neles contidas sempre se aplicam. Coloque as regras de permissão desejadas em qualquer lugar nas suas configurações de usuário. Os limites do seu plano se aplicam a todos os arquivos, e nada no ambiente local pode aumentá-los.
Executar champrep ai paths para verificar onde $CONFIG está em sua máquina.
Proteção de segredos
Seção intitulada “Proteção de segredos”Essas regras são aplicadas pelo próprioCLI sistema, e não pelo modelo:
- Arquivos bloqueados. O agente nunca lê, lista o conteúdo nem envia
.envarquivos (exceto.env.example), chaves privadas e certificados, tais como*.pem,*.key,*.p12, eid_rsa*,.npmrc,.pypirc,.netrc, seu~/.aws,~/.ssh, e~/.gnupgpastas, o keychain do sistema operacional e a própria configuração CLIdo . O modelo é informado de que o arquivo está bloqueado; ele nunca visualiza o conteúdo. - Ocultação. A saída da ferramenta é verificada antes de sair da sua máquina. Segredos de alta confiança, como chaves de acesso à nuvem, tokens de controle de código-fonte, chaves de provedores de pagamento, chaves de provedores de IA, blocos de chaves privadas e tokens de portador são substituídos por
[REDACTED:<kind>]. - Chaves coladas. Se uma solicitação contiver algo que pareça um segredo, ela não será enviada. Registre chaves de modelo com
/model registere credenciais do MCP com/mcpem vez disso. - Sem herança de credenciais. Os comandos executados pelo agente, os hooks e os servidores MCP locais nunca recebem suas credenciaisCHAMPREP ou
CHAMPREP_*variáveis.
Adicione seus próprios caminhos bloqueados com deny_read ou local_read_file(...) regras de negação. A lista integrada pode ser ampliada, mas nunca flexibilizada.
Confiança no repositório
Seção intitulada “Confiança no repositório”Um repositório pode incluir a configuração do agente em .champrep/: comandos personalizados, habilidades, agentes, ganchos, servidores MCP e configurações de projeto. Ao abrir um repositório desconhecido, nada disso deve ser executado; assim, esse conteúdo permanece inativo até que o senhor o aprove.
- Quando um projeto contém esse tipo de conteúdo, o agente pergunta uma vez se deve confiar nele e mostra o que ele contém.
- Se o conteúdo for alterado posteriormente, será solicitada sua aprovação novamente.
/trustmostra o estado atual;/trust approvee/trust revokealterá-lo.
As aprovações são armazenadas em $CONFIG/ai/trusted-projects.json.
Checkpoints, diff e undo
Seção intitulada “Checkpoints, diff e undo”Antes de cada edição, o agente salva o estado anterior do arquivo em sua máquina.
| Comando | Efeito |
|---|---|
/diff | Mostrar todas as alterações de arquivo realizadas nesta sessão. |
/undo | Reverter o último conjunto de alterações. |
/rewind | Selecione uma mensagem anterior e restaure os arquivos ao estado em que se encontravam antes dela. Esc O comando duas vezes também o abre. |
/rewind restaura apenas arquivos; a conversa em si permanece inalterada. Os pontos de verificação são excluídos quando a sessão termina, a menos que você inicie com
--keep-checkpoints. Alterações feitas por comandos de shell, por exemplo, um gerador de código executado por meio de local_bash, não são contabilizados; utilize git para esses casos.
Ações nos serviçosCHAMPREP
Seção intitulada “Ações nos serviçosCHAMPREP”Ações que alteram dados em seus serviçosCHAMPREP, como o envio de um e-mail, utilizam o mesmo fluxo de aprovação do aplicativo web. O agente exibe um cartão de aprovação, e o senhor escolhe Aprovar, Rejeitar, ou Decida mais tarde. Essas ações nunca são aprovadas automaticamente, independentemente do modo de permissão local. Em execuções sem interface gráfica , elas permanecem pendentes para que o senhor as aprove no aplicativo webCHAMPREP.
/services mostra quais CHAMPREPserviços a IA pode utilizar. Altere essa lista em suas configuraçõesCHAMPREP AI na web.