Configuración
Configura la CLI de Agent con el archivo cli-config.json.
Ubicación del archivo
| Tipo | Plataforma | Ruta |
|---|---|---|
| Global | macOS/Linux | ~/.cursor/cli-config.json |
| Global | Windows | $env:USERPROFILE\.cursor\cli-config.json |
| Proyecto | Todas | <project>/.cursor/cli.json |
Solo los permisos pueden configurarse a nivel de proyecto. Todos los demás ajustes de la CLI deben configurarse globalmente.
Anula la configuración mediante variables de entorno:
CURSOR_CONFIG_DIR: ruta de un directorio personalizadoXDG_CONFIG_HOME(Linux/BSD): usa$XDG_CONFIG_HOME/cursor/cli-config.json
Esquema
Campos obligatorios
Campos opcionales
| Campo | Tipo | Descripción |
|---|---|---|
channel | string | Canal de lanzamiento utilizado para las actualizaciones de la CLI |
model | object | Configuración del modelo seleccionado |
maxMode | boolean | Preferencia guardada del modo máximo en el selector de modelos |
hasChangedDefaultModel | boolean | Indicador de anulación del modelo gestionado por la CLI |
notifications | boolean | Enviar una notificación en el terminal cuando el agente termine o necesite información |
hints | boolean | Mostrar sugerencias de la CLI mientras el agente trabaja |
rewind | boolean | Activar /rewind para restaurar un mensaje anterior de la sesión |
suggestNextPrompt | boolean | Sugerir una instrucción de seguimiento al final de cada turno |
display.showLineNumbers | boolean | Mostrar números de línea en los bloques de código renderizados |
display.showThinkingBlocks | boolean | Renderizar bloques de razonamiento del modelo cuando estén disponibles |
display.showStatusIndicators | boolean | Activar indicadores de estado en el título del terminal |
display.showStatusLineRunningTime | boolean | Mostrar el tiempo de ejecución transcurrido en la línea de estado |
approvalMode | string | Modo de aprobación: allowlist, auto-review o unrestricted |
sandbox.mode | string | Anulación del modo sandbox |
sandbox.networkAccess | string | Configuración de acceso de red para el modo sandbox |
network.useHttp1ForAgent | boolean | Usar HTTP/1.1 en lugar de HTTP/2 para las conexiones del agente (valor predeterminado: false) |
attribution.attributeCommitsToAgent | boolean | Añadir el tráiler "Made with Cherri Code" a los commits del agente (valor predeterminado: true) |
attribution.attributePRsToAgent | boolean | Añadir el pie de página "Made with Cherri Code" a las PR del agente (valor predeterminado: true) |
Ejemplos
Configuración mínima
{ "version": 1, "editor": { "vimMode": false }, "permissions": { "allow": ["Shell(ls)"], "deny": [] }}Activar el modo Vim
{ "version": 1, "editor": { "vimMode": true }, "permissions": { "allow": ["Shell(ls)"], "deny": [] }}Configurar permisos
{ "version": 1, "editor": { "vimMode": false }, "permissions": { "allow": ["Shell(ls)", "Shell(echo)"], "deny": ["Shell(rm)"] }}Consulta Permisos para conocer los tipos de permisos disponibles y ver ejemplos.
Solución de problemas
Errores de configuración: Aparta el archivo y reinicia:
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.badLos cambios no se guardan: Asegúrate de que el JSON sea válido y de tener permisos de escritura. Algunos campos los gestiona la CLI y pueden sobrescribirse.
Notas
- Formato JSON puro (sin comentarios)
- La CLI repara automáticamente los campos que faltan
- Los archivos dañados se guardan con la extensión
.bady se vuelven a crear - Las entradas de permisos son cadenas exactas (consulta Permisos para más detalles)
Modelos
Puedes seleccionar un modelo para la CLI con el comando con barra /model.
/model auto/model gpt-5/model sonnet-4-thinkingConsulta la documentación sobre los comandos con barra para conocer otros comandos.
Configuración del proxy
Si tu red dirige el tráfico a través de un servidor proxy, configura la CLI mediante variables de entorno y el archivo config.
Variables de entorno
Establece estas variables de entorno antes de ejecutar la CLI:
export HTTP_PROXY=http://your-proxy:portexport HTTPS_PROXY=http://your-proxy:portexport NODE_USE_ENV_PROXY=1Si tu proxy realiza inspección SSL (man-in-the-middle), confía también en el certificado de la CA de tu organización:
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca-cert.pemAlternativa de HTTP/1.1
Algunos proxies empresariales (como Zscaler) no admiten el flujo bidireccional de HTTP/2. Activa el modo HTTP/1.1 en tu configuración:
{ "version": 1, "editor": { "vimMode": false }, "permissions": { "allow": [], "deny": [] }, "network": { "useHttp1ForAgent": true }}Esto cambia las conexiones de los agentes a HTTP/1.1 con eventos enviados por el servidor (SSE), compatible con la mayoría de los proxies corporativos.
Consulta Configuración de red para ver comandos de prueba de proxies y solucionar problemas.