Ir al contenido
Documentation

Permisos y seguridad del agente de IA

El agente solo propone acciones. Cada edición de archivo y cada comando se somete a una comprobación de permisos en su equipo antes de que ocurra nada, y nada puede desactivar dicha comprobación.

Las herramientas de solo lectura se ejecutan libremente dentro del espacio de trabajo: lectura de archivos, listado de directorios, búsquedas y solo lectura git Comandos como status, diff, y log. El espacio de trabajo es el directorio en el que inició el agente, más cualquier directorio añadido con --add-dir o /add-dir. Rutas fuera de él, .. Se rechazan los caracteres de escape y los enlaces que conducen fuera de él.

Pulse Shift+Tab para cambiar de modo. El modo actual se muestra en la línea de estado.

ModoModificaciones de archivosComandos
ask (por defecto)Preguntar cada vezPreguntar cada vez
accept-editsEjecutar sin preguntar dentro del espacio de trabajoSeguir preguntando
planRechazadoRechazado

En plan En este modo, el agente investiga y describe los cambios en lugar de realizarlos . /plan Cambia al modo de planificación para una solicitud de planificación.

Configure el modo de inicio con --permission-mode, con /permissions mode MODE, o con defaultMode en un archivo de configuración. No existe ningún modo que omita todas las comprobaciones de permisos.

Una ventana de solicitud muestra exactamente lo que va a suceder: la diferencia para una edición, la línea de comandos completa y el directorio de trabajo para un comando, o el servidor y los argumentos para una herramienta MCP. Puede elegir:

  • Sí para ejecutarlo una vez.
  • Sí, y no volver a preguntar para ese prefijo de comando o patrón de archivo en este proyecto. La regla se guarda en su propia configuración para este proyecto, en $CONFIG/ai/projects/, nunca dentro del repositorio.
  • No, y explique a la IA por qué, para que el agente pueda adaptarse.

Algunas llamadas siempre se solicitan, y ninguna regla puede permitirlas: comandos que hacen referencia a archivos secretos o almacenes de credenciales, cambios en .champrep/ o .git/ elementos internos y comandos que son demasiado complejos para analizarlos de forma segura.

Las reglas tienen el siguiente formato Tool o 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"
}
}
  • Reglas de comando como local_bash(npm test*) coinciden con la línea de comandos. Los comandos unidos con ;, &&, ||, |, o las sustituciones se dividen, y cada La parte debe estar permitida.
  • Reglas de ruta como local_edit_file(src/**) coinciden con las rutas relativas al espacio de trabajo. * permanece dentro de una carpeta; ** atraviesa carpetas.
  • Nombres de herramientas puede utilizar *, por ejemplo local_mcp__github__* para cada herramienta de un servidor MCP local.
  • A local_read_file(...) regla de denegación, o una deny_read lista, también oculta esos archivos a todas las herramientas de lectura y búsqueda.

Gestione las reglas sin editar archivos:

/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, y remove edite sus respuestas guardadas para este proyecto (en $CONFIG/ai/projects/). Edite los demás archivos directamente.

ArchivoÁmbito de aplicación
--allowed-tools indicadorSolo en esta ejecución
$CONFIG/ai/projects/<id>.jsonSus respuestas guardadas para este proyecto («no volver a preguntar», /permissions)
.champrep/settings.local.jsonUsted, en este proyecto (añadido a .gitignore automáticamente)
.champrep/settings.jsonTodos los participantes en este proyecto (realice un commit para compartirlo)
$CONFIG/ai/settings.jsonUsted, en cada proyecto

Las entradas anteriores tienen prioridad. Las reglas de denegación de cualquier archivo siempre prevalecen. Sus respuestas guardadas se aplican de inmediato, ya que residen fuera del repositorio. Reglas de permiso y defaultMode en los dos .champrep/ Los archivos solo surten efecto una vez que haya confiado en el proyecto .champrep/ Configuración (véase Confianza en los repositorios); las reglas de denegación que contengan siempre se aplican. Incluya las reglas de permiso que desee en cualquier parte de su configuración de usuario. Los límites de su plan se aplican a todos los archivos, y ningún elemento local puede aumentarlos.

Ejecutar champrep ai paths para ver dónde $CONFIG se encuentra en su equipo.

Estas restricciones las impone el CLIpropio sistema, no el modelo:

  • Archivos bloqueados. El agente nunca lee, enumera el contenido ni envía .env archivos (excepto .env.example), claves privadas y certificados como *.pem, *.key, *.p12, y id_rsa*, .npmrc, .pypirc, .netrc, su ~/.aws, ~/.ssh, y ~/.gnupg carpetas, el llavero del sistema operativo y la propia configuración CLIde . Al modelo se le indica que el archivo está bloqueado; nunca ve el contenido.
  • Censura. La salida de las herramientas se analiza antes de que salga de su equipo. Los secretos de alta confidencialidad, como las claves de acceso a la nube, los tokens de control de código fuente, las claves de proveedores de pago, las claves de proveedores de IA, los bloques de claves privadas y los tokens de portador se sustituyen por [REDACTED:<kind>].
  • Claves pegadas. Si una solicitud contiene algo que parezca un secreto, no se envía. Registre las claves de modelo con /model register y las credenciales de MCP con /mcp en su lugar.
  • No hay herencia de credenciales. Los comandos que ejecuta el agente, los hooks y los servidores MCP locales nunca reciben sus credencialesCHAMPREP ni CHAMPREP_* variables.

Añada sus propias rutas bloqueadas con deny_read o local_read_file(...) Reglas de denegación. La lista integrada puede ampliarse, pero nunca relajarse.

Un repositorio puede incluir la configuración del agente en .champrep/: comandos personalizados, habilidades, agentes, hooks, servidores MCP y ajustes de proyecto. Al abrir un repositorio desconocido no debe ejecutarse nada de ello, por lo que este contenido permanece inactivo hasta que usted lo apruebe.

  • Cuando un proyecto contiene este tipo de contenido, el agente le pregunta una vez si desea confiar en él y le muestra lo que contiene.
  • Si el contenido cambia posteriormente, se le volverá a solicitar su autorización.
  • /trust muestra el estado actual; /trust approve y /trust revoke modificarlo.

Las aprobaciones se almacenan en $CONFIG/ai/trusted-projects.json.

Antes de cada edición, el agente guarda el estado anterior del archivo en su equipo.

ComandoEfecto
/diffMostrar todos los cambios realizados en los archivos durante esta sesión.
/undoDeshacer el último conjunto de cambios.
/rewindSeleccionar un mensaje anterior y restaurar los archivos a su estado anterior a ese mensaje. Esc «twice» también lo abre.

/rewind solo restaura archivos; la conversación en sí no se modifica. Los puntos de control se eliminan al finalizar la sesión, a menos que se inicie con --keep-checkpoints. Los cambios realizados mediante comandos de shell, por ejemplo, un generador de código ejecutado a través de local_bash, no se contabilizan; utilice git para ellos.

Las acciones que modifican datos en sus serviciosCHAMPREP, como el envío de un correo electrónico, siguen el mismo flujo de aprobación que la aplicación web. El agente muestra una tarjeta de aprobación, y usted elige Aprobar, Rechazo, o Decidir más adelante. Estas acciones nunca se aprueban automáticamente, sea cual sea el modo de permiso local. En las ejecuciones sin interfaz gráfica , permanecen pendientes de su aprobación en la aplicación webCHAMPREP.

/services muestra qué CHAMPREPservicios puede utilizar la IA. Modifique esa lista en su configuraciónCHAMPREP AI en la web.