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.
Lo que ocurre siempre sin preguntar
Sección titulada «Lo que ocurre siempre sin preguntar»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.
Modos de permiso
Sección titulada «Modos de permiso»Pulse Shift+Tab para cambiar de modo. El modo actual se muestra en la línea de estado.
| Modo | Modificaciones de archivos | Comandos |
|---|---|---|
ask (por defecto) | Preguntar cada vez | Preguntar cada vez |
accept-edits | Ejecutar sin preguntar dentro del espacio de trabajo | Seguir preguntando |
plan | Rechazado | Rechazado |
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.
Respuesta a una solicitud de permiso
Sección titulada «Respuesta a una solicitud de permiso»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.
Reglas de permiso y denegación
Sección titulada «Reglas de permiso y denegación»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 ejemplolocal_mcp__github__*para cada herramienta de un servidor MCP local. - A
local_read_file(...)regla de denegación, o unadeny_readlista, 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.
Archivos de configuración y prioridad
Sección titulada «Archivos de configuración y prioridad»| Archivo | Ámbito de aplicación |
|---|---|
--allowed-tools indicador | Solo en esta ejecución |
$CONFIG/ai/projects/<id>.json | Sus respuestas guardadas para este proyecto («no volver a preguntar», /permissions) |
.champrep/settings.local.json | Usted, en este proyecto (añadido a .gitignore automáticamente) |
.champrep/settings.json | Todos los participantes en este proyecto (realice un commit para compartirlo) |
$CONFIG/ai/settings.json | Usted, 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.
Protección de secretos
Sección titulada «Protección de secretos»Estas restricciones las impone el CLIpropio sistema, no el modelo:
- Archivos bloqueados. El agente nunca lee, enumera el contenido ni envía
.envarchivos (excepto.env.example), claves privadas y certificados como*.pem,*.key,*.p12, yid_rsa*,.npmrc,.pypirc,.netrc, su~/.aws,~/.ssh, y~/.gnupgcarpetas, 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 registery las credenciales de MCP con/mcpen 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.
Confianza en los repositorios
Sección titulada «Confianza en los repositorios»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.
/trustmuestra el estado actual;/trust approvey/trust revokemodificarlo.
Las aprobaciones se almacenan en $CONFIG/ai/trusted-projects.json.
Puntos de control, diferencias y deshacer
Sección titulada «Puntos de control, diferencias y deshacer»Antes de cada edición, el agente guarda el estado anterior del archivo en su equipo.
| Comando | Efecto |
|---|---|
/diff | Mostrar todos los cambios realizados en los archivos durante esta sesión. |
/undo | Deshacer el último conjunto de cambios. |
/rewind | Seleccionar 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.
Acciones en los serviciosCHAMPREP
Sección titulada «Acciones en los serviciosCHAMPREP»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.