Pular para o conteúdo
Documentation

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.

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.

Pressione Shift+Tab para alternar entre os modos. O modo atual é exibido na linha de status.

ModoEdições de arquivoComandos
ask (padrão)Pergunta todas as vezesPergunta todas as vezes
accept-editsExecutar sem perguntar dentro do espaço de trabalhoContinuar perguntando
planRecusadoRecusado

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.

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.

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 exemplo local_mcp__github__* para todas as ferramentas de um servidor MCP local.
  • A local_read_file(...) regra de negação, ou uma deny_read lista, 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.

ArquivoEscopo
--allowed-tools sinalizadorApenas nesta execução
$CONFIG/ai/projects/<id>.jsonSuas respostas salvas para este projeto (“não perguntar novamente”, /permissions)
.champrep/settings.local.jsonVocê, neste projeto (adicionado a .gitignore automaticamente)
.champrep/settings.jsonTodos neste projeto (faça um commit para compartilhar)
$CONFIG/ai/settings.jsonO(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.

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 .env arquivos (exceto .env.example), chaves privadas e certificados, tais como *.pem, *.key, *.p12, e id_rsa*, .npmrc, .pypirc, .netrc, seu ~/.aws, ~/.ssh, e ~/.gnupg pastas, 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 register e credenciais do MCP com /mcp em 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.

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.
  • /trust mostra o estado atual; /trust approve e /trust revoke alterá-lo.

As aprovações são armazenadas em $CONFIG/ai/trusted-projects.json.

Antes de cada edição, o agente salva o estado anterior do arquivo em sua máquina.

ComandoEfeito
/diffMostrar todas as alterações de arquivo realizadas nesta sessão.
/undoReverter o último conjunto de alterações.
/rewindSelecione 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 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.