{"meta":{"title":"directorio de configuración de la CLI de GitHub Copilot","intro":"Busque información sobre el ~/.copilot directorio, donde Copilot CLI almacena la configuración, los datos de sesión y las personalizaciones.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/reference","title":"Referencia"},{"href":"/es/copilot/reference/copilot-cli-reference","title":"Referencia Copilot CLI"},{"href":"/es/copilot/reference/copilot-cli-reference/cli-config-dir-reference","title":"Directorio de configuración de la CLI"}],"documentType":"article"},"body":"# directorio de configuración de la CLI de GitHub Copilot\n\nBusque información sobre el ~/.copilot directorio, donde Copilot CLI almacena la configuración, los datos de sesión y las personalizaciones.\n\nCopilot CLI almacena su configuración, historial de sesión, registros y personalizaciones en un único directorio de la máquina. De forma predeterminada, este directorio es `~/.copilot` (es decir, `$HOME/.copilot`).\n\nEn este artículo se describe el contenido de este directorio y cómo se pueden usar.\n\n## Introducción al directorio\n\nEl `~/.copilot` directorio contiene los siguientes elementos de nivel superior.\n\n| Camino | Tipo | Descripción |\n| ------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- |\n| `agents/` | Directorio | Definiciones de agente personalizado personal |\n| `config.json` | Archivo | Estado de la aplicación administrada automáticamente (autenticación, complementos instalados y otros datos internos) |\n| `copilot-instructions.md` | Archivo | Instrucciones personalizadas personales (aplicadas a todas las sesiones) |\n| `extensions/` | Directorio | Extensiones personales cargadas por la CLI |\n| `hooks/` | Directorio | Scripts de enlace de nivel de usuario |\n| `ide/` | Directorio | Estado de integración del IDE |\n| `installed-plugins/` | Directorio | Archivos de complemento instalados |\n| `instructions/` | Directorio | Archivos personales adicionales `*.instructions.md` |\n| `logs/` | Directorio | Archivos de registro de sesión |\n| `lsp-config.json` | Archivo | Definiciones de servidor LSP de nivel de usuario |\n| `mcp-config.json` | Archivo | Definiciones de servidor MCP de nivel de usuario |\n| `mcp-oauth-config/` | Directorio | Almacenamiento de reserva del token de OAuth y del registro de MCP |\n| `mcp-secrets/` | Directorio | Almacenamiento e índice de reserva local para marcadores de posición secretos de MCP |\n| `permissions-config.json` | Archivo | Herramientas guardadas y permisos de directorio por proyecto |\n| `plugin-data/` | Directorio | Datos persistentes para complementos instalados |\n| `session-state/` | Directorio | Historial de sesiones y datos del área de trabajo |\n| `command-history-state/` | Directorio | Datos del historial de comandos |\n| `session-store.db` | Archivo | Base de datos de SQLite para datos entre sesiones |\n| `settings.json` | Archivo | Las opciones de configuración personal |\n| `skills/` | Directorio | Definiciones de aptitudes personalizadas personales |\n\n> \\[!NOTE]\n> No todos estos elementos aparecen inmediatamente. Algunas se crean a petición la primera vez que se usa una característica determinada; por ejemplo, `installed-plugins/` solo aparece después de instalar el primer complemento.\n\n## Archivos editables por el usuario\n\nLos siguientes archivos están diseñados para que los edite directamente o se administren mediante comandos de la CLI.\n\n### `settings.json`\n\nEste es el archivo de configuración principal de Copilot CLI. Dentro de una sesión, puede usar el comando interactivo `/settings` para cambiar valores específicos o ejecutar `/settings KEY VALUE` para establecer un único valor. Consulte [Cambio de la configuración con el \\`/settings\\` comando](/es/copilot/how-tos/copilot-cli/customize-copilot/change-settings). Como alternativa, puede editar el `settings.json` archivo directamente en un editor de texto. El archivo admite JSON con comentarios (JSONC).\n\nDe forma predeterminada, este archivo se encuentra en el `~/.copilot` directorio , que es el directorio de configuración de nivel de usuario. Contiene valores predeterminados globales de nivel de usuario para todos los repositorios. Puede cambiar la ubicación de este directorio estableciendo la `COPILOT_HOME` variable de entorno en otra ruta de acceso.\n\n> \\[!NOTE]\n> La configuración editable del usuario se almacenó originalmente en `config.json`. Se han movido a `settings.json`. Cualquier configuración de usuario presente en `config.json` el inicio se migra automáticamente a `settings.json`.\n\nSi `settings.json` no se puede leer, analizar o validar, Copilot CLI ignora los valores no válidos (los valores `config.json` reconocidos se siguen combinando) y muestra una advertencia al iniciar en la línea de tiempo que remite a la pestaña **Problemas** del comando `/settings`. Abra esa pestaña para ver el error específico y, a continuación, corrija el problema notificado para restaurar la configuración afectada.\n\nSi `settings.json` contiene una clave de nivel superior que no es una configuración reconocida (por ejemplo, un error tipográfico), Copilot CLI la enumera en la pestaña **Problemas** del `/settings` comando en lugar de en la escala de tiempo o en stderr. La etiqueta de la pestaña muestra un número (por ejemplo, `Problems (2)`) cuando alguno de los ámbitos de configuración presenta un problema.\n`$schema` se tolera y nunca se notifica.\n\nSi `~/.copilot/settings.json` es un enlace simbólico —por ejemplo, para sincronizar la configuración mediante un repositorio de dotfiles—, las operaciones de escritura del comando `/settings` siguen el enlace simbólico y actualizan su destino en lugar de reemplazar el enlace simbólico por un archivo regular.\n\nPara obtener la lista completa de opciones y cómo interactúan con la configuración de nivel de repositorio, consulte [Configuración de archivos](#configuration-file-settings) de configuración más adelante en este artículo.\n\n> \\[!TIP]\n> Ejecute `copilot help config` en el terminal para obtener una referencia rápida.\n\n### `copilot-instructions.md`\n\nInstrucciones personalizadas personales que se aplican a todas las sesiones, independientemente del proyecto en el que trabaje. Este archivo funciona de la misma manera que un nivel `copilot-instructions.md` de repositorio, pero se aplica globalmente.\n\nPara obtener más información, vea [Agregar instrucciones personalizadas del repositorio para GitHub Copilot](/es/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions).\n\n### `instructions/`\n\nAlmacene aquí archivos de instrucciones personales adicionales como archivos `*.instructions.md`. Estos se cargan junto con `copilot-instructions.md` y se aplican a todas las sesiones. Puede organizar las instrucciones por tema, por ejemplo, `~/.copilot/instructions/code-style.instructions.md`.\n\n### `mcp-config.json`\n\nDefine los servidores MCP (Protocolo de contexto de modelo) disponibles en el nivel de usuario. Estos servidores están disponibles en todas las sesiones, independientemente del directorio del proyecto en el que esté. Las configuraciones de MCP a nivel de proyecto (en `.mcp.json` o `.github/mcp.json`) tienen prioridad sobre las definiciones a nivel de usuario cuando los nombres de los servidores entran en conflicto.\n\nPara obtener más información, vea [Adición de servidores MCP para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).\n\n### `lsp-config.json`\n\nDefine los servidores del Protocolo de servidor de lenguaje (LSP) disponibles en el nivel de usuario. Estos servidores proporcionan inteligencia de lenguaje (diagnósticos, finalizaciones, etc.) al agente. Administre este archivo mediante el `/lsp` comando de barra diagonal o edítelo directamente.\n\nPara obtener más información, vea [Adición de servidores LSP para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/set-up-copilot-cli/add-lsp-servers).\n\n### `agents/`\n\nAlmacene las definiciones de agentes personalizados personales aquí como `.agent.md` archivos. Los agentes colocados en este directorio están disponibles en todas las sesiones. Los agentes a nivel de proyecto (en `.github/agents/`) tienen prioridad sobre los agentes personales si comparten el mismo nombre.\n\nPara obtener más información, vea [Creación y uso de agentes personalizados para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli).\n\n### `skills/`\n\nAlmacene las definiciones de aptitudes personalizadas personales aquí. Cada aptitud reside en un subdirectorio que contiene un `SKILL.md` archivo, por ejemplo, `~/.copilot/skills/my-skill/SKILL.md`. Las habilidades personales están disponibles en todas tus sesiones. Las habilidades a nivel de proyecto tienen prioridad sobre las habilidades personales si comparten el mismo nombre.\n\nPara obtener más información, vea [Adición de habilidades de agente para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/add-skills).\n\n### `hooks/`\n\nAlmacene los scripts de enlace de nivel de usuario aquí. Estos enlaces se aplican a todas las sesiones. También puede definir hooks directamente en su archivo de configuración de usuario (`~/.copilot/settings.json`) utilizando la clave `hooks`. Los enlaces de nivel de repositorio (en `.github/hooks/`) se cargan junto con enlaces de nivel de usuario.\n\nPara obtener más información, vea [Uso de enlaces con GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/use-hooks).\n\n### `extensions/`\n\nAlmacene los archivos de extensión de nivel de usuario aquí. Las extensiones de este directorio están disponibles en todas las sesiones.\n\nPuede crear archivos en este directorio manualmente o generar la estructura base de una extensión y, a continuación, editar el archivo generado.\n\n## Archivos administrados automáticamente\n\nLa CLI administra los siguientes elementos. Por lo general, no debe editarlos manualmente.\n\n### `config.json`\n\nAlmacena el estado interno de la aplicación administrado automáticamente por la CLI, incluidos los datos de autenticación, los metadatos del complemento instalado y otra información en tiempo de ejecución. Normalmente, no es necesario editar este archivo.\n\n> \\[!NOTE]\n> Versiones anteriores de Copilot CLI almacenaban tanto la configuración de usuario como el estado de la aplicación en `config.json`. La configuración editable del usuario ahora se encuentra en `settings.json`. Cualquier configuración de usuario en `config.json` al inicio se migra automáticamente a `settings.json`. Los campos de estado de la aplicación, como `loggedInUsers`, `installedPlugins`, `firstLaunchAt`y `staff`, permanecen en `config.json` y no se migran.\n\n### `permissions-config.json`\n\nAlmacena las decisiones de permisos de directorio y herramienta guardadas, organizadas por ubicación del proyecto. Al aprobar una herramienta o conceder acceso a un directorio para la ubicación actual, la CLI registra la decisión aquí para que no se le solicite de nuevo en el mismo repositorio o directorio.\n\n> \\[!NOTE]\n> Si desea restablecer los permisos de un proyecto, puede eliminar la entrada pertinente de este archivo. Sin embargo, la edición del archivo mientras se ejecuta una sesión puede provocar un comportamiento inesperado. La interfaz de línea de comandos elimina automáticamente las entradas cuya ruta ya no existe en el disco.\n\n#### Ubicación del archivo\n\nCopilot CLI resuelve el archivo desde el directorio de configuración.\n\n| Priority | Source | Archivo usado |\n| -------- | ------------------------ | --------------------------------------- |\n| 1 | `--config-dir=DIRECTORY` | `DIRECTORY/permissions-config.json` |\n| 2 | `COPILOT_HOME` | `$COPILOT_HOME/permissions-config.json` |\n| 3 | Default | `~/.copilot/permissions-config.json` |\n\nLa CLI usa solo el primer directorio de configuración aplicable en este orden. Tampoco se carga `permissions-config.json` desde las ubicaciones de prioridad inferior.\n\nLa `--config-dir` opción es una opción heredada. Se prefiere `COPILOT_HOME` cuando necesite cambiar el directorio de configuración.\n\nEn Windows, el archivo predeterminado suele ser:\n\n```text\nC:\\Users\\YOUR-USER\\.copilot\\permissions-config.json\n```\n\nLas compilaciones anteriores usaban un archivo sin extensión denominado `permissions-config`. Si `permissions-config.json` no existe, pero el archivo sin extensión sí, la CLI sigue respetando el archivo heredado. Usa `permissions-config.json` para nuevas ediciones.\n\nLas ubicaciones de configuración basadas en XDG anteriores se migran a `~/.copilot` durante el inicio si no se ha establecido `COPILOT_HOME`.\n\n#### Claves de ubicación\n\nEl objeto de nivel superior `locations` tiene como clave una ruta de acceso absoluta.\n\n* Para un repositorio de Git, utilice la raíz de Git que se usa para delimitar los permisos.\n* Los árboles de trabajo enlazados apuntan a la raíz del repositorio principal, por lo que comparten permisos con el árbol de trabajo principal.\n* Los submódulos usan su propio directorio de trabajo.\n* Para un directorio que no está en un repositorio de Git, use el directorio de trabajo actual normalizado.\n\nLa clave debe coincidir con la ubicación donde Copilot CLI se ejecuta. Si la clave no coincide, no se aplicarán las aprobaciones guardadas.\n\nLa CLI carga las aprobaciones de la ubicación coincidente cuando se inicia una sesión y cuando cambia el directorio de trabajo activo.\n\n#### Schema\n\nEl archivo debe contener un objeto JSON.\n\n| Campo | Tipo | Obligatorio | Default | Valores permitidos | Descripción |\n| -------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------------------------------- | ------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `locations` | Objeto | No | `{}` | Claves de ruta de acceso absolutas | Mapa de claves de ubicación a aprobaciones guardadas. |\n| `locations.` | Objeto | No | `{}` | Cualquier clave de ubicación absoluta | Aprobaciones guardadas para un repositorio o directorio. |\n| `locations..tool_approvals` | Array | No | `[]` | Objetos de aprobación | Herramientas aprobadas para esta ubicación. |\n| `locations..allowed_directories` | Matriz de cadenas | No | `[]` | Rutas absolutas de directorio | Directorios adicionales a los que puede acceder la puerta de ruta de acceso para esta ubicación. Cada directorio debe existir cuando la CLI aplique la configuración. |\n| `locations..tool_approvals[].kind` | String | Sí | Ninguno | | |\n| `commands`, `read`, `write`, `mcp`, `mcp-sampling`, `memory`, `custom-tool`, `extension-management``extension-permission-access` | Selecciona el tipo de aprobación. | | | | |\n| `commandIdentifiers` | Matriz de cadenas | Sí, para `commands` | Ninguno | Identificadores de comandos | Identificadores de comandos shell para aprobar. |\n| `serverName` | String | Sí, para `mcp` y `mcp-sampling` | Ninguno | Nombre del servidor MCP | Servidor MCP para aprobar. |\n| `toolName` | Cadena o `null` | Sí, para `mcp` | Ninguno | Nombre de la herramienta MCP, o `null` | Herramienta MCP para aprobar. Use `null` para aprobar todas las herramientas del servidor. |\n| `toolName` | String | Sí, para `custom-tool` | Ninguno | Nombre de la herramienta personalizada | Herramienta personalizada para aprobar por nombre exacto. |\n| `operation` | String | No, para `extension-management` | Omitido | Nombre de la operación de extensión | Operación de administración de extensiones pendiente de aprobación. Omita este campo para aprobar todas las operaciones de administración de extensiones. |\n| `extensionName` | String | Sí, para `extension-permission-access` | Ninguno | Nombre de la extensión | Extensión cuyo acceso a las funcionalidades controladas por permisos se aprueba. |\n\n`permissions-config.json` no admite reglas de denegación, reglas de \"preguntar\", modos predeterminados, reglas de dirección URL, filtrado de herramientas o directiva compartida local del repositorio. Para esos comportamientos, use opciones de línea de comandos como `--deny-tool`, `--available-tools`, `--excluded-tools`, `--allow-url`y `--deny-url`. Las reglas de dirección URL guardadas se almacenan en `settings.json`, no en `permissions-config.json`.\n\nLos campos desconocidos no forman parte del esquema. La CLI puede omitirlas, y las operaciones de escritura posteriores pueden eliminarlas.\n\n#### Tipos de aprobación\n\nCada elemento de `tool_approvals` debe ser uno de los siguientes objetos.\n\n| `kind` | Campos obligatorios | Campos opcionales | Meaning |\n| ----------------------------- | -------------------- | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `commands` | `commandIdentifiers` | Ninguno | Aprueba los identificadores de comandos shell coincidentes. |\n| `read` | Ninguno | Ninguno | Aprueba solicitudes de herramientas de lectura. Las sesiones interactivas de la CLI ya aprueban las lecturas automáticamente, por lo que esto suele ser innecesario. |\n| `write` | Ninguno | Ninguno | Aprueba solicitudes de herramienta de creación y modificación de archivos. Un mensaje de solicitud de ruta puede seguir aplicándose a rutas fuera de los directorios permitidos. |\n| `mcp` | | | |\n| `serverName`, `toolName` | Ninguno | Aprueba una herramienta MCP o cada herramienta del servidor cuando `toolName` es `null`. | |\n| `mcp-sampling` | `serverName` | Ninguno | Aprueba las solicitudes de muestreo de MCP para un servidor. |\n| `memory` | Ninguno | Ninguno | Aprueba las solicitudes de escritura en memoria y de voto. |\n| `custom-tool` | `toolName` | Ninguno | Aprueba una herramienta personalizada según el nombre exacto. |\n| `extension-management` | Ninguno | `operation` | Aprueba la gestión de extensiones. Si `operation` se omite, todas las operaciones de administración de extensiones coinciden. |\n| `extension-permission-access` | `extensionName` | Ninguno | Aprueba el acceso de una extensión a las funcionalidades controladas por permisos. |\n\nPara las aprobaciones de MCP, `serverName` debe coincidir exactamente con el nombre del servidor MCP configurado. Usa el nombre original del servidor de tu configuración de MCP, no un prefijo depurado del nombre de la herramienta.\n\n#### Coincidencia de comandos de Shell\n\n`permissions-config.json` no admite expresiones regulares ni patrones globales generales. Los valores de cadena coinciden literalmente, excepto si un `:*` al final de un valor `commandIdentifiers` de shell coincide con el texto que precede a `:*`, ya sea por sí solo o seguido de un espacio y más texto. Una simple `*` no tiene ningún significado especial, por lo que `git*` no coincide con `git status`.\n\n| Pattern | Coincidencias | No coincide |\n| --------------------------------------- | -------------- | -------------------- |\n| `git status` | `git status` | `git status --short` |\n| `git:*` | | |\n| `git`, , `git status`, `git push` | `gitea` | |\n| `gh pr:*` | | |\n| `gh pr`, , `gh pr view`, `gh pr create` | `gh repo view` | |\n\n#### Coincidencia de directorios\n\nLas entradas de `allowed_directories` permiten a Copilot CLI acceder a rutas dentro de esos directorios sin una solicitud de ruta independiente. No aprueban el funcionamiento de la herramienta en sí. Por ejemplo, la edición de un archivo en un directorio permitido todavía puede requerir una `write` aprobación.\n\nCada `allowed_directories` entrada debe ser un directorio absoluto, no vacío y accesible. La CLI resuelve vínculos simbólicos antes de comparar rutas de acceso, bloquea las rutas de acceso de red UNC a menos que sean rutas de acceso locales de longitud extendida, compara las rutas de acceso sin distinción entre mayúsculas y minúsculas en Windows y compara las rutas de acceso con distinción entre mayúsculas y minúsculas en otras plataformas. Si no se puede aplicar una entrada, la CLI registra una advertencia y omite esa entrada.\n\n#### Ejemplos\n\nPermita todos los subcomandos de Git y acceda a un directorio local adicional:\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\"git:*\"]\n }\n ],\n \"allowed_directories\": [\"C:\\\\src\\\\shared-docs\"]\n }\n }\n}\n```\n\nPermita comandos seleccionados y siga pidiendo confirmación antes de escribir en archivos:\n\n```json copy\n{\n \"locations\": {\n \"/Users/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"commands\",\n \"commandIdentifiers\": [\n \"git status\",\n \"git diff\",\n \"git log\",\n \"npm test\",\n \"npm run build\"\n ]\n }\n ]\n }\n }\n}\n```\n\nAprobar operaciones de escritura en archivos y un servidor MCP para un repositorio:\n\n```json copy\n{\n \"locations\": {\n \"/home/YOUR-USER/src/my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"write\"\n },\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": null\n }\n ]\n }\n }\n}\n```\n\nApruebe una herramienta MCP, escrituras de memoria y acceso a permisos de extensión:\n\n```json copy\n{\n \"locations\": {\n \"C:\\\\src\\\\my-repo\": {\n \"tool_approvals\": [\n {\n \"kind\": \"mcp\",\n \"serverName\": \"github-mcp-server\",\n \"toolName\": \"search_code\"\n },\n {\n \"kind\": \"memory\"\n },\n {\n \"kind\": \"extension-permission-access\",\n \"extensionName\": \"my-extension\"\n }\n ]\n }\n }\n}\n```\n\n### `session-state/`\n\nContiene datos del historial de sesión, organizados por identificador de sesión en subdirectorios. Cada directorio de sesión almacena un registro de eventos (`events.jsonl`) y artefactos del área de trabajo (planes, puntos de control, archivos de seguimiento). Estos datos habilitan el reanudación de sesión (`--resume` o `--continue`).\n\nAl eliminar archivos de este directorio solo se quitan las copias locales. Si ha sincronizado sesiones con su GitHub cuenta, los datos sincronizados se almacenan por separado y no se ven afectados por la eliminación del archivo local. Puede eliminar u ocultar sesiones sincronizadas de GitHub.com. Para obtener más información, vea [Acerca de los datos de sesión de GitHub Copilot CLI](/es/copilot/concepts/agents/copilot-cli/chronicle#managing-your-session-data).\n\n### `command-history-state/`\n\nContiene los datos del historial de comandos usados para la búsqueda inversa (Ctrl+R) y la navegación por el historial en la interfaz interactiva. Este directorio se administra automáticamente y no se debe editar.\n\n### `session-store.db`\n\nUna base de datos de SQLite usada por la CLI para datos entre sesiones, como la indexación y la búsqueda de puntos de comprobación. Este archivo se administra automáticamente y no se debe editar.\n\nSi elimina este archivo, puede volver a generarlo mediante el `/chronicle reindex` comando . La reindexación también sincroniza los datos de sesión con su cuenta.\n\n### `logs/`\n\nContiene archivos de registro para las sesiones de la CLI. Cada sesión crea un archivo de registro denominado `process-{timestamp}-{pid}.log`. \\*\\*\\\nEstos archivos son útiles para depurar problemas.\n\nLa CLI también puede crear registros específicos de la extensión en `logs/extensions/`.\n\nEsto es independiente de `~/.copilot/extensions/`, que almacena el código de extensión creado por el usuario.\n\n> \\[!TIP]\n> Para buscar el archivo de registro de la sesión actual, escriba `/session` en una sesión interactiva. La salida incluye la ruta de acceso completa al archivo de registro, junto con otros detalles de la sesión, como el identificador de sesión, la duración y el directorio de trabajo.\n\n### `installed-plugins/`\n\nContiene los archivos de los complementos que ha instalado. Los complementos instalados desde marketplace se almacenan en `installed-plugins/{marketplace-name}/{plugin-name}/`. Los complementos instalados directamente se almacenan en `installed-plugins/_direct/`. Administre complementos mediante los `copilot plugin` comandos en lugar de editar este directorio directamente.\n\nPara obtener más información, vea [Referencia del plugin CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference).\n\n### `plugin-data/`\n\nContiene datos persistentes para complementos instalados, organizados por marketplace y nombre del complemento. Los propios complementos administran estos datos y no se deben editar manualmente.\n\n### `ide/`\n\nContiene archivos de bloqueo y estado para las integraciones del IDE (por ejemplo, cuando Copilot CLI se conecta a Visual Studio Code). Este directorio se administra automáticamente.\n\n### `mcp-oauth-config/`\n\nContiene archivos de reserva de token de OAuth, registro y PKCE de MCP cuando el almacenamiento basado en llavero no está disponible. Este directorio se administra automáticamente.\n\n### `mcp-secrets/`\n\nContiene almacenamiento de archivos de reserva y un índice para los marcadores de posición secretos de MCP cuando el almacenamiento basado en llavero no está disponible. Este directorio se administra automáticamente.\n\n## Cambio de la ubicación del directorio de configuración\n\nPara invalidar la ubicación predeterminada `~/.copilot` , establezca la `COPILOT_HOME` variable de entorno en la ruta de acceso del directorio que desea usar.\n\n```bash copy\nexport COPILOT_HOME=/path/to/my/copilot-config\n```\n\n### Cosas que se deben tener en cuenta\n\n* `COPILOT_HOME` reemplaza la ruta de acceso `~/.copilot` completa. El valor que establezca debe ser la ruta de acceso completa al directorio que desea usar para los archivos de configuración y subdirectorios.\n* Cambiar el directorio significa que la configuración existente, el historial de sesión, los complementos instalados y los permisos guardados no se encontrarán en la nueva ubicación. Copie o mueva el contenido de `~/.copilot` a la nueva ubicación si desea conservarlos.\n* El **directorio de caché** (que se usa para cachés de Marketplace, paquetes de actualización automática y otros datos efímeros) sigue las convenciones de la plataforma y no se ve afectada por `COPILOT_HOME`. Se encuentra en:\n\n * **macOS**: `~/Library/Caches/copilot`\n * **Linux**: `$XDG_CACHE_HOME/copilot` o `~/.cache/copilot`\n * **Windows**:`%LOCALAPPDATA%/copilot`\n\n Para invalidar el directorio de caché por separado, establezca `COPILOT_CACHE_HOME`.\n\n## Lo que puede eliminar de forma segura\n\n| Elemento | ¿Es seguro eliminarlo? | Efecto |\n| ------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `agents/`, , `skills/`, `hooks/` | No se recomienda | Perderá las personalizaciones personales. Haga una copia de seguridad primero. |\n| `config.json` | Con precaución | Restablece el estado de la aplicación, incluida la autenticación. Tendrá que volver a autenticarse y la CLI volverá a detectar el estado interno en el próximo inicio. |\n| `copilot-instructions.md`, `instructions/` | No se recomienda | Perderá sus instrucciones personalizadas personales. Haga una copia de seguridad primero. |\n| `extensions/` | No se recomienda | Perderá sus extensiones personales. Haga una copia de seguridad primero. |\n| `installed-plugins/` | No se recomienda | Use `copilot plugin uninstall` en su lugar, para asegurarse de que los metadatos del plugin permanezcan precisos en `config.json`. |\n| `logs/` | Sí | Los archivos de registro se vuelven a crear cada sesión. Eliminarlos no tiene ningún impacto funcional. |\n| `lsp-config.json` | No se recomienda | Perderá las definiciones de servidor LSP de nivel de usuario. Haga una copia de seguridad primero. |\n| `mcp-config.json` | No se recomienda | Perderá las definiciones de servidor MCP de nivel de usuario. Haga una copia de seguridad primero. |\n| `mcp-oauth-config/` | Con precaución | Borra el estado alternativo local de OAuth de MCP. Es posible que tenga que volver a autenticar servidores MCP. |\n| `mcp-secrets/` | Con precaución | Borra el estado de reserva de secretos y las asignaciones de MCP local. Es posible que los servidores MCP respaldados por secretos necesiten reconfiguración. |\n| `permissions-config.json` | Con precaución | Restablece todos los permisos guardados. La CLI le pedirá de nuevo las aprobaciones de herramientas y directorios. |\n| `plugin-data/` | Sí | Los datos persistentes del complemento se vuelven a crear según sea necesario. |\n| `session-state/` | Con precaución | Al eliminar, se quita el historial de sesiones. Ya no podrá reanudar las sesiones anteriores. |\n| `command-history-state/` | Con precaución | Al eliminar se quita el historial de comandos. Ya no podrá buscar comandos anteriores con Ctrl+R. |\n| `session-store.db` | Con precaución | Al eliminar, se quitan los datos entre sesiones. El archivo se vuelve a crear automáticamente. |\n| `settings.json` | Con precaución | Restablece todas las preferencias de usuario a los valores predeterminados. Tendrá que volver a configurar la configuración. |\n\n## Configuración del archivo de configuración\n\nLa configuración se aplica en este orden (las posteriores prevalecen sobre las anteriores):\n\n\n\n1. Valores predeterminados integrados\n2. Ajustes administrados de la gestión de dispositivos móviles (MDM)\n3. Configuración del usuario (`~/.copilot/settings.json`)\n4. Configuración del repositorio (`.github/copilot/settings.json`)\n5. Configuración local (`.github/copilot/settings.local.json`)\n6. Variables de entorno\n7. Marcas de línea de comandos\n\n\n\nLa configuración administrada de MDM se carga en el inicio y se combina con la configuración de usuario como línea base de directiva. Para la mayoría de las claves, la configuración de usuario puede invalidar esa línea base. Para `permissions.disableBypassPermissionsMode`, un valor MDM de `\"disable\"` siempre gana. Para obtener más información, consulte [Configuración administrada de MDM](#mdm-managed-settings).\n\n| Scope | Location | propósito |\n| ----------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Usuario | `~/.copilot/settings.json` | Valores predeterminados globales para todos los repositorios. Use la variable de `COPILOT_HOME` entorno para especificar una ruta de acceso alternativa. |\n| Repositorio | `.github/copilot/settings.json` | Configuración del repositorio compartido (registrada en el repositorio). |\n| Local | `.github/copilot/settings.local.json` | Excepciones personales (agregue esto a `.gitignore`). |\n\nLa CLI también lee `.claude/settings.json` y `.claude/settings.local.json` para el subconjunto compartido entre herramientas de la configuración del repositorio (como `companyAnnouncements`, `disableAllHooks`, `enabledPlugins`, `extraKnownMarketplaces`y `hooks`).\n\n### Configuración del usuario (`~/.copilot/settings.json`)\n\nEsta configuración se aplica en todas las sesiones y repositorios. Puede usar el `/settings` comando de barra diagonal para ejecutar un cuadro de diálogo interactivo o usar comandos de barra diagonal específicos para actualizar valores individuales o editar este archivo directamente.\n\n| Key | Tipo | Default | Descripción |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `allowedUrls` | `string[]` | `[]` | Direcciones URL o dominios permitidos sin preguntar. Admite direcciones URL exactas, patrones de dominio y subdominios comodín (por ejemplo, `\"*.github.com\"`). |\n| `askUser` | `boolean` | `true` | Permita al agente formular preguntas aclarando. |\n| `false` Establézcalo en para una operación totalmente autónoma. También se puede establecer con `--no-ask-user`. | | | |\n| `autoUpdate` | `boolean` | `true` | Descargue automáticamente las actualizaciones de la CLI y actualice los complementos de primera entidad al principio de cada sesión. |\n| `autoUpdatesChannel` | | | |\n| `\"stable\"` | | | |\n| \\| | | | |\n| `\"prerelease\"` | | | |\n| `\"stable\"` | Canal de actualización. Establézcalo en `\"prerelease\"` para recibir actualizaciones de versión preliminar. | | |\n| `banner` | | | |\n| `\"always\"` | | | |\n| \\| | | | |\n| `\"once\"` | | | |\n| \\| | | | |\n| `\"never\"` | | | |\n| `\"once\"` | Frecuencia de visualización de banner animado. | | |\n| `bashEnv` | `boolean` | `false` | Habilitar la `BASH_ENV` compatibilidad con las shells Bash. También se puede establecer con `--bash-env` o `--no-bash-env`. |\n| `beep` | `boolean` | `true` | Reproduce un pitido audible cuando se requiere atención. |\n| `beepOnSchedule` | `boolean` | `true` | Reproduzca un pitido audible cuando finalice una ejecución programada `/every` o `/after`. |\n| `builtInAgents.rubberDuck` | `boolean` | `true` | Habilite el subagente de pato de goma que proporciona comentarios antagónicos sobre los planes del agente. |\n| `builtInAgents.rubberDuckAutoInvoke` | `boolean` | `false` | Incluya petición proactiva para la invocación automática de pato de goma. Configure en `true` para activar recordatorios adicionales de pato de goma durante los turnos del agente. |\n| `colorMode` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Alias en desuso para `theme`. Prefiere `theme`. | | |\n| `commandHistoryMaxSize` | `number` | `50` | Número máximo de comandos recientes retenidos para el historial de entrada y la búsqueda inversa. Debe ser un entero entre `1` y `1000`. |\n| `compactPaste` | `boolean` | `true` | Comprima los pegados largos (más de 10 líneas) en tokens compactos. |\n| `companyAnnouncements` | `string[]` | `[]` | Mensajes personalizados mostrados aleatoriamente durante el inicio. Se selecciona un mensaje aleatoriamente cada vez que se inicia la CLI. Útil para anuncios o recordatorios de equipo. |\n| `continueOnAutoMode` | `boolean` | `false` | Cambie automáticamente al modo automático cuando la velocidad esté limitada. Cuando `true`, los errores de límite de velocidad elegibles activan un cambio automático al modo automático y un reintento. No se aplica a los límites de velocidad globales ni a los proveedores BYOK. |\n| `copyOnSelect` | `boolean` | | |\n| `true` (macOS), `false` (otro) | Copie automáticamente el texto seleccionado por el mouse en el Portapapeles del sistema. | | |\n| `customAgents.defaultLocalOnly` | `boolean` | `false` | Use solo agentes personalizados locales (sin organización remota ni agentes empresariales). |\n| `deniedUrls` | `string[]` | `[]` | Direcciones URL o dominios que siempre se bloquean. Las reglas de denegación tienen prioridad sobre las reglas de permiso. |\n| `disableAllHooks` | `boolean` | `false` | Deshabilite todos los ganchos (tanto a nivel de repositorio como de usuario). |\n| `disabledMcpServers` | `string[]` | `[]` | Nombres de servidor MCP que se van a deshabilitar. Los servidores enumerados están configurados pero no iniciados. |\n| `disabledSkills` | `string[]` | `[]` | Nombres de habilidades que se deben desactivar. Las habilidades listadas se descubren pero no se cargan. |\n| `dynamicRetrieval` | `{ skills?: boolean }` | anular | Control por categoría de la recuperación dinámica de instrucciones basada en embeddings. Establezca `skills` en `false` para deshabilitar la recuperación de habilidades. |\n| `effortLevel` | `string` | `\"medium\"` | Nivel de esfuerzo de razonamiento para el pensamiento extendido: `\"low\"`, `\"medium\"`, `\"high\"`o `\"xhigh\"`. Los niveles superiores usan más recursos de computación. |\n| `enabledMcpServers` | `string[]` | `[]` | Habilite los servidores MCP integrados que están deshabilitados de forma predeterminada. |\n| `enabledPlugins` | `Record` | `{}` | Instalación automática del complemento declarativo. Las claves son especificaciones del complemento; los valores son `true` (habilitados) o `false` (deshabilitados). |\n| `experimental` | `boolean` | `false` | Habilite las características experimentales. También se puede habilitar con la opción de línea de comandos `--experimental` o el comando de barra `/experimental`. |\n| `extraKnownMarketplaces` | `Record` | `{}` | Marketplaces de complementos adicionales. Cada clave es un nombre de Marketplace; el valor especifica el requerido `source` (`\"directory\"`, `\"git\"`, o `\"github\"`). Establezca `autoUpdate: true` en una entrada para incluir los complementos instalados de ese marketplace en la actualización automática al iniciar la sesión, igual que los complementos propios. Esta opción de activación solo se aplica a las sesiones interactivas y `-p`; las sesiones de SDK y de servidor no se actualizan automáticamente. La activación se respeta cuando se establece en tus propios ajustes de usuario o en los ajustes gestionados (MDM/servidor). En caso de conflicto de nombres, tiene prioridad una tienda integrada de primera parte; después, una entrada administrada (que sustituye por completo la entrada del usuario con el mismo nombre, por lo que una entrada administrada sin `\"autoUpdate\": true` elimina la adhesión voluntaria del usuario); y, por último, la propia entrada del usuario. |\n| `footer` | `object` | — | Controla qué elementos aparecen en la línea de estado. Las subclaves incluyen `showModelEffort`, `showDirectory`, `showBranch`, `showContextWindow`, `showQuota`, `showAgent`, `showAiUsed`, `showCodeChanges`, `showUsername`, `showSandbox`, `showYolo` y `showCustom` (todas `boolean`). Administrado por el comando slash `/statusline`. |\n| `hooks` | `object` | — | Definiciones de hooks a nivel de usuario en línea, indexadas por nombre de evento. Usa el mismo esquema que los archivos `.github/hooks/*.json`. Consulte [Uso de enlaces con GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). |\n| `ide.autoConnect` | `boolean` | `true` | Conéctese automáticamente a un área de trabajo del IDE al iniciarse. Cuando `false`, aún puedes conectarte manualmente utilizando el comando `/ide`. |\n| `ide.openDiffOnEdit` | `boolean` | `true` | Abra las diferencias de edición de archivos en el IDE conectado para su aprobación. Cuando `false`, las aprobaciones de edición de archivos solo se muestran en el terminal. |\n| `includeCoAuthoredBy` | `boolean` | `true` | Agregue un finalizador `Co-authored-by` a las confirmaciones de Git realizadas por el agente. |\n| `keepAlive` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| \\| | | | |\n| `\"busy\"` | | | |\n| `\"off\"` | Modo Keep-alive aplicado al inicio de la CLI. | | |\n| `\"on\"` siempre impide que el sistema entre en suspensión, `\"busy\"` impide que entre en suspensión solo mientras el agente está ejecutándose, y `\"off\"` desactiva la función de keep-alive. También se puede configurar con el comando de `/keep-alive` barra diagonal. | | | |\n| `logLevel` | | | |\n| `\"none\"` | | | |\n| \\| | | | |\n| `\"error\"` | | | |\n| \\| | | | |\n| `\"warning\"` | | | |\n| \\| | | | |\n| `\"info\"` | | | |\n| \\| | | | |\n| `\"debug\"` | | | |\n| \\| | | | |\n| `\"all\"` | | | |\n| \\| | | | |\n| `\"default\"` | | | |\n| `\"default\"` | Nivel de detalle de registro. | | |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| — | Estrategia de resolución de conflictos para `/pr fix conflicts`. Cuando se establece en `\"rebase\"`, los conflictos se resuelven rebasando a la rama base. Cuando se establece en `\"merge\"`, la rama base se combina en la rama de características. Si no está configurado, se muestra un cuadro de diálogo del selector. | | |\n| `model` | `string` | varies | Modelo de IA que se va a usar. Establézcalo en `\"auto\"` para permitir seleccionar Copilot automáticamente el mejor modelo disponible. Administrado por el comando slash `/model`. |\n| `mouse` | `boolean` | `true` | Habilite la compatibilidad con el mouse. También se puede establecer con `--mouse` o `--no-mouse`. |\n| `permissions.disableBypassPermissionsMode` | `string` | — | Configúrelo como `\"disable\"` para suprimir todas las marcas «allow-all» (`--allow-all-tools`, `--allow-all-paths`, `--allow-all-urls`, `--allow-all`, `--yolo`) durante el arranque, de modo que no puedan usarse para conceder permisos elevados. Establézcalo en `\"allow-auto-only\"` para mantener bloqueado el permiso completo mientras sigue permitiendo `/allow-all auto` (aprobación automática asistida por LLM). Consulte [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options). |\n| `pinnedPrompts` | `boolean` | `true` | Fija la solicitud del usuario de la sección actual justo debajo de la barra superior al desplazarse por la cronología, para que siga quedando claro a qué solicitud pertenece el resultado visible. Solo la interfaz de usuario de la CLI: no tiene ningún efecto en las solicitudes enviadas al modelo. |\n| `powershellFlags` | `string[]` | `[\"-NoProfile\", \"-NoLogo\"]` | Marcas pasadas a PowerShell en el inicio. En Windows, la CLI prefiere PowerShell 7+ (`pwsh`) y vuelve a Windows PowerShell (`powershell.exe`) cuando `pwsh` no está disponible. Solo para Windows. |\n| `proxyKerberosServicePrincipal` | `string` | anular | Nombre principal de servicio (SPN) para la autenticación de proxy Kerberos/Negotiate, que reemplaza al `HTTP/` derivado. |\n| `proxyUrl` | `string` | anular | Dirección URL de proxy para solicitudes HTTP(S) (por ejemplo, `http://proxy.corp.example:3128`). Sobrescrito por las variables de entorno `HTTP_PROXY` o `HTTPS_PROXY` (cualquier combinación de mayúsculas y minúsculas). |\n| `remote` | | | |\n| `\"on\"` | | | |\n| \\| | | | |\n| `\"off\"` | | | |\n| `\"on\"` | Controla la sincronización de sesiones y el acceso remoto. Establézcalo en `\"off\"` para mantener los datos de sesión localmente y deshabilitar el control remoto. También se puede establecer con `--remote` o `--no-remote`. | | |\n| `renderHexColors` | `boolean` | `true` | Mostrar códigos de color hexadecimales de seis dígitos escritos como código insertado (por ejemplo, `` `#FF0000` ``) como muestras de color. |\n| `renderMarkdown` | `boolean` | `true` | Representar Markdown en la salida del terminal. |\n| `remoteExport` | `boolean` | `true` | Exportar sesiones de forma remota cuando esté disponible la sincronización de sesiones. Establézcalo en `false` para no participar en la exportación remota de forma predeterminada. El ajuste `remoteSessions`, cuando se establece en `true`, o el indicador `--remote`, sigue habilitando la exportación y el direccionamiento independientemente de este ajuste. |\n| `respectGitignore` | `boolean` | `true` | Excluya los archivos ignorados por git del selector de menciones de archivos `@`. Cuando `false`, el selector incluye archivos excluidos normalmente por `.gitignore`. |\n| `sandbox.allowBypass` | `boolean` | `true` | Permitir que los comandos en entorno aislado soliciten una excepción para operaciones específicas (muestra una solicitud de permiso), para que herramientas como `grep` y `glob` sigan funcionando cuando el entorno aislado las bloquearía de otro modo. Configúrelo en `false` para excluirse. |\n| `sandbox.enabled` | `boolean` | `false` | Restrinja los comandos de shell, los servidores MCP/LSP y las herramientas de archivos o web integrados a un entorno de espacio aislado con acceso limitado al sistema de archivos y a la red. Habilite desde el `/sandbox` cuadro de diálogo o con `/sandbox enable`. |\n| `sandbox.auth.git` | `boolean` | `true` | Inserte las credenciales de Git en el espacio aislado para que los comandos que se ejecutan en él puedan autenticarse con Git. Establézcalo en `false` para no participar. Se ha cambiado el nombre de `sandbox.gitAuth`; la clave anterior no tiene ninguna migración y se omite dondequiera que aparezca. |\n| `sandbox.auth.gh` | `boolean` | `true` | Inserte las credenciales GitHub CLI (`gh`) en el espacio aislado para que los comandos que se ejecuten en él puedan autenticarse con GitHub CLI. Establézcalo en `false` para no participar. Se ha cambiado el nombre de `sandbox.ghAuth`; la clave anterior no tiene ninguna migración y se omite dondequiera que aparezca. |\n| `sandbox.userPolicy.network.allowLocalNetwork` | `boolean` | `true` | Permitir que los comandos aislados puedan acceder a direcciones de red locales (por ejemplo, servidores de desarrollo locales). Configúrelo en `false` para excluirse. |\n| `sandbox.userPolicy.network.proxy` | `object` | anular | Redirigir el tráfico de red aislado a través de un proxy HTTP. Campos: `url` (obligatorio), `username` (opcional), `password` (opcional). Configúrelo desde la `/sandbox` pestaña **Red** del cuadro de diálogo, que enmascara el campo contraseña. La propia contraseña se almacena en el llavero del sistema operativo en lugar de en `settings.json`, por lo que no se puede editar mediante `/settings`. En Linux y macOS, el proxy es cooperativo (no se aplica estrictamente); Windows lo aplica. |\n| `sandbox.userPolicy.deniedPaths` | `string[]` | `[]` | Rutas a las que se deniega el acceso a los comandos aislados. En Windows, el backend de aislamiento ProcessContainer no puede aplicar reglas de denegación por ruta, por lo que las entradas no tienen efecto; por tanto, no confíe en `deniedPaths` para proteger un directorio confidencial en Windows. |\n| `sandbox.userPolicy.seatbelt.keychainAccess` | `boolean` | `false` | Solo macOS. Conceder a los comandos del espacio aislado acceso a la cadena de claves del sistema. También se puede alternar desde el cuadro de diálogo `/sandbox`. |\n| `screenReader` | `boolean` | `false` | Habilite las optimizaciones del lector de pantalla. |\n| `scrollbar` | `boolean` | `true` | Mostrar la barra de desplazamiento en vistas desplazables. Establézcalo en `false` para ocultarlo y use el ancho completo del terminal. |\n| `shellShortcut` | `boolean` | `true` | Permite que un `$` solo en el símbolo del sistema, seguido de Intro, abra un shell interactivo con origen en el directorio de trabajo de la sesión (solo se activa en una sesión local, de confianza e inactiva en un TTY real). Solo con ámbito de usuario o de administración; no se puede anular a nivel de repositorio. |\n| `showTimestamps` | `boolean` | `true` | Mostrar marcas de tiempo `HH:mm` atenuadas junto a los mensajes de usuario en la cronología. |\n| `showTipsOnStartup` | `boolean` | `true` | Muestra una sugerencia de comandos aleatoria cuando se inicia la CLI. |\n| `skillDirectories` | `string[]` | `[]` | Directorios adicionales para buscar definiciones de aptitud personalizadas (además de `~/.copilot/skills/`). |\n| `statusLine` | `object` | — | Visualización de línea de estado personalizada. |\n| `type`: debe ser `\"command\"`. | | | |\n| `command`: ruta a un script ejecutable que recibe el JSON de la sesión en stdin e imprime el contenido del estado en stdout. | | | |\n| `padding`: número opcional de espacios de relleno a la izquierda. | | | |\n| `refreshInterval`: número entero opcional de segundos (`1`–`2147483`) para volver a ejecutar el comando según un temporizador en lugar de hacerlo solo cuando se produzcan eventos; si se omite, solo se actualizará cuando cambie el estado de la sesión. Si el comando no se puede iniciar, finaliza con un código de salida distinto de cero o no logra recibir el JSON de estado por stdin, la CLI registra una advertencia una vez por cada episodio continuo de fallo y deja la línea de estado en blanco en lugar de fallar en silencio. Ejecute con `--log-level all` para ver los detalles del error subyacente. | | | |\n| `stayInAutopilot` | `boolean` | `true` | Permanece en modo Autopilot después de que se complete cada tarea. Al activarlo, la siguiente indicación que introduzcas después de que finalice una tarea también se procesa en modo Autopilot. Para obtener más información, vea [Permitir que la CLI de GitHub Copilot funcione de forma autónoma](/es/copilot/concepts/agents/copilot-cli/autopilot#staying-in-autopilot-mode-between-tasks). |\n| `storeTokenPlaintext` | `boolean` | `false` | Permitir que los tokens de autenticación se almacenen en texto sin formato en `config.json` cuando no haya ninguna cadena de claves del sistema disponible. |\n| `stream` | `boolean` | `true` | Habilite las respuestas de streaming. |\n| `streamerMode` | `boolean` | `false` | Ocultar los nombres de los modelos en versión preliminar, los detalles de las solicitudes, las marcas de tiempo de los prompts y el aviso de actualización disponible. Útil al realizar demostraciones de Copilot CLI o al compartir pantalla. |\n| `subagents.agents` | `object` | `{}` | Configuración del modelo por agente, con clave por nombre del agente. Cada valor es un objeto con campos opcionales `model` (string), `effortLevel` (string) y `contextTier` (`\"default\"`, `\"long_context\"`o `\"inherit\"`). Establezca cualquier campo en `\"inherit\"` para usar el valor de la sesión principal en el momento del envío. Use el `/subagents` comando de barra diagonal para configurar estas opciones de forma interactiva. |\n| `subagents.disabledSubagents` | `string[]` | `[]` | Nombres de agente para evitar que se envíen. Solo el `rubber-duck` agente no se puede deshabilitar a través de esta configuración. Todos los demás agentes integrados, incluidos `explore`, `task`, `code-review`, `general-purpose`, `research`y `security-review`, se pueden deshabilitar. |\n| `subagents.maxConcurrency` | `number` | basado en planes | Número máximo de subagentes concurrentes para esta sesión. Solo se aplica a los usuarios con facturación por uso; se ignora en todos los demás planes. Limitado en `32`. Consulte [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits). |\n| `subagents.maxDepth` | `number` | `6` | Profundidad máxima de anidamiento de subagentes. Solo se aplica a los usuarios con facturación por uso; se ignora en todos los demás planes. Limitado en `256`. Consulte [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#subagent-limits). |\n| `tabs.enabled` | `boolean` | `true` | Mostrar la barra de pestañas de inicio. Establézcalo en `false` para ocultarlo por completo. |\n| `tabs.hide` | `string[]` | `[]` | Identificadores de las pestañas que se deben ocultar. Valores aceptados: `\"copilot\"`, `\"agents\"`, `\"issues\"`, `\"pull-requests\"`, `\"gists\"` (sin distinguir entre mayúsculas y minúsculas). |\n| `tabs.sort` | `string[]` | `[]` | Orden en el que se muestran las pestañas. Las pestañas no enumeradas mantienen su orden relativo predeterminado después de los enumerados. Se omiten los identificadores desconocidos. |\n| `terminalProgress` | `boolean` | `true` | Emitir indicadores de progreso del terminal OSC 9;4 mientras el agente trabaja. Los terminales admitidos incluyen Terminal Windows, iTerm2, Ghostty y ConEmu. |\n| `theme` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"github\"` | | | |\n| \\| | | | |\n| `\"dim\"` | | | |\n| \\| | | | |\n| `\"high-contrast\"` | | | |\n| \\| | | | |\n| `\"colorblind\"` | | | |\n| `\"github\"` | Paleta de colores para la salida del terminal. Gestionado por los comandos con barra `/settings` y `/theme`. | | |\n| `colorMode` es un alias en desuso para esta configuración. | | | |\n| `toolSearch` | `boolean` | dependiente del modelo y de la función | Controla la búsqueda de herramientas (carga diferida de herramientas). Establezca `toolSearch: false` para desactivar la búsqueda de herramientas. |\n| `updateTerminalTitle` | `boolean` | `true` | Muestra la intención actual en la pestaña de terminal o el título de la ventana. |\n| `worktreeBaseRef` | | | |\n| `\"head\"` | | | |\n| \\| | | | |\n| `\"defaultBranch\"` | | | |\n| `\"head\"` | Punto de partida para nuevos worktrees creados por `/worktree`, `/worktree new` y `--worktree`. | | |\n| `\"defaultBranch\"` comienza desde la rama predeterminada remota en lugar de la desprotección actual. | | | |\n\n> \\[!TIP]\n> Ejecute `copilot help sandbox` para obtener la referencia completa del entorno aislado, incluidos los hosts compatibles y todas las claves de configuración de `sandbox`.\n\nEl cuadro de diálogo `/sandbox` agrupa `git`, `gh` y el acceso al llavero en una pestaña **Auth** específica, y muestra la ruta `settings.json` donde se almacena la configuración actual del entorno aislado. Presione Ctrl+E en el cuadro de diálogo `/sandbox` para guardar los cambios pendientes y abrir `settings.json` en su editor (`COPILOT_EDITOR`, `VISUAL` o `EDITOR`), igual que con el mismo atajo en `/settings`. El cuadro de diálogo vuelve a cargar su estado desde el disco después de editar y guardar el archivo.\n\nEl aislamiento está impulsado por [Microsoft eXecution Container (MXC)](https://github.com/microsoft/mxc), que proporciona mecanismos de contención específicos de la plataforma.\nCopilot CLIusa Seatbelt en macOS, Bubblewrap en Linux y ProcessContainer en Windows.\n\n### Configuración del repositorio (`.github/copilot/settings.json`)\n\nLa configuración del repositorio se aplica a todos los usuarios que trabajan en el repositorio. Se incorporan en el repositorio y se comparten con colaboradores.\n\n> \\[!NOTE]\n> Las claves relacionadas con los complementos del archivo de configuración del repositorio (`enabledPlugins` y `extraKnownMarketplaces`) también son leídas por Copilot cloud agent, no solo por Copilot CLI. Esto le permite habilitar los mismos complementos para ambos clientes desde un único archivo. Para obtener más información sobre los complementos, consulte [Información sobre GitHub Copilot complementos](/es/copilot/concepts/agents/about-plugins).\n\nSolo se admiten las claves enumeradas en la tabla siguiente en el nivel de repositorio. Cualquier otra clave, incluidas las claves válidas en el archivo de configuración de usuario, se omiten silenciosamente. Cada clave admitida tiene una directiva de combinación direccional que mantiene la invalidación segura y cerrada en caso de error.\n\n| Key | Tipo | Comportamiento de fusión | Descripción |\n| ------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `companyAnnouncements` | `string[]` | Reemplazado: el repositorio tiene prioridad | Mensajes mostrados aleatoriamente durante el inicio. |\n| `contextTier` | | | |\n| `\"default\"` | | | |\n| \\| | | | |\n| `\"long_context\"` | | | |\n| Reemplazado: el repositorio tiene prioridad | Fije el nivel de contexto predeterminado. | | |\n| `deniedUrls` | `string[]` | Unión: el repositorio puede agregar entradas, nunca quitar | Direcciones URL o dominios bloqueados. |\n| `disableAllHooks` | `boolean` | El repositorio tiene prioridad | Deshabilite todos los ganchos. |\n| `disabledMcpServers` | `string[]` | Unión: el repositorio puede agregar entradas, nunca quitar | Servidores MCP configurados pero no iniciados. |\n| `disabledSkills` | `string[]` | Unión: el repositorio puede agregar entradas, nunca quitar | Habilidades descubiertas pero no cargadas. |\n| `effortLevel` | `string` | Reemplazado: el repositorio tiene prioridad | Ancle el esfuerzo de razonamiento predeterminado. |\n| `enabledPlugins` | `Record` | Combinado: el repositorio invalida al usuario para la misma clave. | Instalación automática del complemento declarativo. |\n| `extraKnownMarketplaces` | `Record` | Combinado: el repositorio invalida al usuario para la misma clave. | Mercados de plugins disponibles en este repositorio. El `source` de cada entrada es obligatorio. Un `autoUpdate: true` en una entrada se acepta a nivel de repositorio, pero actualmente se ignora: la activación de las actualizaciones automáticas solo se respeta cuando se establece en la configuración del propio usuario o en la configuración administrada (MDM/servidor). |\n| `hooks` | `object` | Combinado: el repositorio invalida al usuario para la misma clave. | Definiciones de hooks limitadas a este repositorio. Consulte [Uso de enlaces con GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/use-hooks). |\n| `includeCoAuthoredBy` | `boolean` | Reemplazado: el repositorio tiene prioridad | Añadir un tráiler `Co-authored-by` a los commits. |\n| `mergeStrategy` | | | |\n| `\"rebase\"` | | | |\n| \\| | | | |\n| `\"merge\"` | | | |\n| Reemplazado: el repositorio tiene prioridad | Estrategia de resolución de conflictos para `/pr fix conflicts`. | | |\n| `model` | `string` | Reemplazado: el repositorio tiene prioridad | Fije el modelo predeterminado para este repositorio. |\n| `respectGitignore` | `boolean` | Solo restricción: el repositorio puede habilitar, nunca deshabilitar | Excluya los archivos ignorados por git del selector de menciones de archivos `@`. |\n\nLas invalidaciones de `model`, `effortLevel` y `contextTier` solo se aplican cuando el directorio de trabajo es [de confianza](/es/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools).\n\nUn complemento habilitado solo a través del `enabledPlugins` de un repositorio queda limitado a ese repositorio: se instala automáticamente y se activa en el repositorio que lo declara, pero permanece deshabilitado globalmente, por lo que nunca se activa en proyectos no relacionados. Al salir del repositorio, o si el repositorio deshabilita el complemento, se desmantela su servidor MCP y se desactivan sus agentes y habilidades para la sesión.\n\n### Lista de modelos permitidos a nivel de repositorio (`.github/allowed_models.txt`)\n\nRestringir qué modelos integrados puede usar un repositorio con una lista de permitidos de texto sin formato en `.github/allowed_models.txt`, resuelta desde la raíz del repositorio del directorio de trabajo actual (o el propio directorio de trabajo fuera de un repositorio).\n\nCada línea es un patrón global que coincide con los identificadores de modelo o una `fallback:` directiva que asigna un nombre al modelo que se va a usar cuando no se permite el modelo configurado o solicitado:\n\n```text\n# .github/allowed_models.txt\nfallback: gpt-5.2\ngpt-5.2\ngpt-5.4\nclaude-sonnet-*\n```\n\n| Rule | Descripción |\n| -------------------- | --------------------------------------------------------------------------------------------------------- |\n| `*` | Permitir todos los modelos (valor predeterminado cuando no hay ningún archivo presente). |\n| `MODEL-ID` | Permite un identificador de modelo exacto. |\n| `GLOB-PATTERN` | Permitir los identificadores de modelo que coincidan con el patrón glob (por ejemplo, `claude-sonnet-*`). |\n| `fallback: MODEL-ID` | Obligatorio una sola vez. El modelo usa Copilot cuando el modelo activo no está permitido. |\n| `#` | Línea de comentario. |\n\nLos patrones negados (`!pattern`) no se admiten, el modelo alternativo debe ser un identificador exacto (no un glob) y el propio modelo alternativo debe coincidir con alguno de los patrones glob configurados.\nCopilot CLI vuelve a evaluar la directiva en `/cd` y rechaza un archivo no válido con un error antes de ejecutarse.\n\nLa lista de permitidos se aplica solo a los modelos integrados de Copilot. No se pueden filtrar los modelos personalizados agregados mediante el método Bring Your Own API Keys (BYOK). Los modelos BYOK permanecen enumerados y seleccionables independientemente de los patrones que configure, y la `fallback:` directiva nunca se aplica a ellos. Para obtener más información, vea [Habilitación de modelos personalizados para GitHub Copilot en la empresa](/es/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models) y [Habilitación de modelos personalizados para GitHub Copilot en su organización](/es/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models).\n\n### Configuración local (`.github/copilot/settings.local.json`)\n\nCrear `.github/copilot/settings.local.json` en el repositorio para anulaciones personales que no deben confirmarse. Agregue este archivo a `.gitignore`.\n\nEl archivo de configuración local usa el mismo esquema que el archivo de configuración del repositorio (`.github/copilot/settings.json`) y tiene prioridad sobre él.\n\n## Configuración administrada de MDM\n\nLos administradores de TI pueden aplicar una directiva de referencia mediante la configuración administrada de Administración de dispositivos móviles (MDM), en lugar de requerir una configuración por usuario. Estos ajustes establecen valores predeterminados a nivel de dispositivo para las claves admitidas y se cargan antes que la configuración del usuario.\n\nCopilot CLI también carga la configuración administrada por el servidor en el inicio, además de MDM. La configuración administrada por dispositivo (MDM) y administrada por servidor se resuelve **por clave**: el valor de MDM prevalece para cualquier clave que establezca, y el valor del servidor rellena las claves que MDM deja sin establecer. Esto permite a una organización establecer alguna directiva a través de MDM (por ejemplo, `permissions`) al mismo tiempo que recibe otros valores predeterminados administrados (por ejemplo, `model`) del servidor.\n\nLas sesiones de ejecución prolongada vuelven a capturar y volver a aplicar la configuración administrada cada hora, por lo que los cambios de directiva (por ejemplo, una organización que habilita `permissions.disableBypassPermissionsMode`) surten efecto sin reiniciar la sesión.\n\n### Orígenes de los ajustes administrados por MDM\n\nCopilot CLI lee las configuraciones administradas desde ubicaciones basadas en archivos o MDM específicas de la plataforma.\n\n| Plataforma | Tipo de origen | Location |\n| ---------- | -------------- | ------------------------------------------------------------------ |\n| macOS | MDM plist | `com.github.copilot` |\n| macOS | Archivo | `/Library/Application Support/GitHubCopilot/managed-settings.json` |\n| Windows | Registro MDM | `HKLM\\SOFTWARE\\Policies\\GitHubCopilot` |\n| Windows | Archivo | `%ProgramFiles%\\GitHubCopilot\\managed-settings.json` |\n| Linux | Archivo | `/etc/github-copilot/managed-settings.json` |\n\n> \\[!NOTE]\n> En sistemas POSIX, Copilot CLI rechaza las configuraciones administradas basadas en archivos que sean enlaces simbólicos, que no pertenezcan al usuario root o que tengan permisos de escritura para todos.\n\n### Formato de archivo\n\nEscriba la configuración gestionada basada en archivos en formato JSON.\n\n```json\n{\n \"model\": \"auto\",\n \"permissions\": {\n \"disableBypassPermissionsMode\": \"disable\"\n }\n}\n```\n\n> \\[!NOTE]\n> `model` es una clave de nivel superior. Configuraciones anteriores que la anidadon como `permissions.model` siguen funcionando, el entorno de ejecución vuelve a esa ubicación cuando la clave de nivel `model` superior está ausente, pero escribe nuevas configuraciones con `model` en el nivel superior.\n\n### Teclas compatibles\n\nSolo se admiten las siguientes claves en la configuración administrada de MDM.\n\n| Key | Descripción |\n| --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `allowedMcpServers` | Lista de servidores MCP permitidos que los usuarios pueden cargar, que coinciden con `serverUrl`, `serverCommand` o `serverName`. Los servidores propios de confianza (por ejemplo, como el servidor MCP integrado GitHub) siempre están exentos. Dejar esta clave sin definir permite todos los servidores distintos de los predeterminados; un array vacío no permite ninguno. Consulte [Lista de permitidos y denegados del servidor MCP administrado](#managed-mcp-server-allowdeny-list). |\n| `deniedMcpServers` | Lista de denegación de servidores MCP que no deben cargarse nunca, identificados de la misma forma que `allowedMcpServers`. Un servidor no predeterminado coincidente se bloquea independientemente de la lista de permitidos: la denegación siempre gana. Consulte [Lista de permitidos y denegados del servidor MCP administrado](#managed-mcp-server-allowdeny-list). |\n| `enabledPlugins` | Habilitación o deshabilitación de complementos específicos |\n| `extraKnownMarketplaces` | Añadir mercados de complementos de confianza |\n| `forceRemoteSettingsRefresh` | Requerir una nueva obtención de la configuración gestionada por el servidor al iniciar, incluso cuando exista una directiva reciente almacenada en caché. La entrada almacenada en caché todavía se mantiene como reserva si se produce un error en la captura. El valor del dispositivo (MDM) tiene prioridad sobre un valor de servidor almacenado en caché. |\n| `model` | Establezca un modelo predeterminado para todos los usuarios (sobrescrito por la bandera `--model` o por un modelo de sesión reanudada) |\n| `permissions` | Establezca permisos administrados, incluidos `disableBypassPermissionsMode` y `deny` / `ask` / `allow` matrices de reglas. Consulte [Reglas de permisos administrados](#managed-permission-rules). |\n| `policyHelper` | Registre un archivo ejecutable que proporciona la capa de configuración administrada de prioridad más baja. Campos: `path` (obligatorio), más los opcionales `args`, `timeoutMs` y `refreshIntervalMs`. Si un dispositivo (MDM) y una directiva de servidor registran un `policyHelper`, el registro del dispositivo gana. |\n| `remoteControl` | Controlar si las sesiones de este dispositivo se pueden controlar desde otros dispositivos. |\n| `mode` es `\"enabled\"`, `\"disabled\"`o `\"requireSSO\"` (requiere `githubDotComOrganizations` cuando se establece). | |\n| `shellShortcut` | Forzar la habilitación o deshabilitación del acceso directo del shell interactivo `$` para todos los usuarios. Un valor administrado siempre invalida la configuración propia `shellShortcut` del usuario. |\n| `strictKnownMarketplaces` | Restricción de complementos a marketplaces conocidos |\n| `telemetry` | Aplicar la configuración de exportación base de OpenTelemetry: `enabled`, `endpoint`, `protocol`, `headers`, `resourceAttributes`, `captureContent`, `lockCaptureContent` y `serviceName`. Consulte [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring). |\n\n> \\[!NOTE]\n> `policyHelper.path` acepta una ruta de acceso absoluta, una ruta relativa al directorio personal (`~/...`) o un nombre de programa simple resuelto a partir de `PATH`. Se rechazan otras formas relacionadas. El registro se acepta y se valida, pero el entorno de ejecución todavía no invoca la función auxiliar; la ejecución de la función auxiliar estará disponible en una versión futura.\n\n> \\[!NOTE]\n> Cuando `remoteControl.mode` es `\"requireSSO\"`, enumere las organizaciones permitidas en `remoteControl.githubDotComOrganizations`. El cliente debe estar autorizado para SSO en al menos una de las organizaciones de la lista GitHub.com; ya no es necesario que lo esté para todas ellas.\n\n> \\[!NOTE]\n> Establezca `\"disable\"` en `permissions.disableBypassPermissionsMode` en los ajustes administrados de MDM para aplicar la restricción a nivel de dispositivo. Los cambios de cuenta no pueden anular esta directiva. Configúrelo como `\"allow-auto-only\"` para bloquear la elevación completa a allow-all y seguir permitiendo `/permissions assisted` (aprobación de permisos asistida por LLM). Si se establece un valor no reconocido, la CLI registra el problema y se `\"disable\"` aplica como un valor predeterminado de cierre por error, por lo que una directiva administrada con formato incorrecto sigue restringiendo las opciones allow-all en lugar de permitirlas de forma silenciosa. Consulte [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#restricting-the---allow-all-options).\n\n> \\[!NOTE]\n> La mayoría de las claves administradas bloquean toda la fila: el valor administrado invalida silenciosamente una edición local en la siguiente carga.\n> `enabledPlugins` y `extraKnownMarketplaces` son la excepción: la capa administrada fusiona estos mapas con tus propias entradas, campo a campo, en lugar de reemplazarlos por completo. Esto significa que el bloqueo se aplica **por entrada**, no a toda la clave: un complemento o marketplace anclado por una directiva administrada no se puede volver a habilitar, deshabilitar o volver a seleccionar localmente, pero otras entradas del mismo mapa permanecen totalmente controladas por el usuario.\n\n### Reglas de permisos administrados\n\nInserte `deny`, `ask` y `allow` listas de reglas bajo la clave gestionada `permissions` para aplicar una directiva de permisos para todos los usuarios, independientemente de `permissions.disableBypassPermissionsMode`.\n\n```json\n{\n \"permissions\": {\n \"deny\": [\"Shell(rm -rf *)\", \"Domain(*.evil.example)\"],\n \"ask\": [\"Shell(git push *)\"],\n \"allow\": [\"Read(**)\"]\n }\n}\n```\n\n| Familia de reglas | Coincidencias |\n| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `Bash(...)`, `Shell(...)` | Comandos de Shell. Usa ` *` (por ejemplo, `git push *`) para hacer coincidir un prefijo de comando; de lo contrario, la regla coincide exactamente con el texto. |\n| `PowerShell(...)` | Los comandos de PowerShell coinciden de la misma manera que `Shell(...)`. |\n| `Read(...)` | Rutas de acceso de lectura y vista de archivos. Admite patrones globales: `/` para la raíz del área de trabajo, `~/` para el directorio principal y `./` para el directorio de trabajo actual. |\n| `Edit(...)`, `Write(...)` | Las rutas para escribir/editar archivos se han hecho coincidir de la misma manera que `Read(...)`. |\n| `Domain(...)` | Nombres de host de URL, que coinciden como [reglas de URL](/es/copilot/reference/copilot-cli-reference/cli-command-reference#tool-permission-patterns). |\n\nLas reglas de las fuentes administradas se combinan con una precedencia fija: denegar siempre prevalece; luego, preguntar; y después, permitir. Si una regla `deny` coincide, la solicitud se bloquea aunque también coincida una regla `allow`.\n`deny` y `ask` se unifican entre todas las fuentes administradas (servidor, MDM).\n`allow` requiere que cada origen que declare una lista `allow` admita la operación: una intersección, no una unión. Cuando cualquiera de `deny`, `ask` o `allow` está configurado, una operación que no coincide con ninguno de ellos pasa a ser `ask` de forma predeterminada en lugar de continuar silenciosamente.\n\n## Lista de permitidos o denegados del servidor MCP administrado\n\nLos administradores pueden controlar los servidores MCP directamente a través de la configuración administrada de MDM, independientemente de la [lista de permitidos de MCP empresarial](/es/copilot/reference/copilot-cli-reference/cli-command-reference#enterprise-mcp-allowlist).\n\nEstablezca `allowedMcpServers` o `deniedMcpServers` en un origen de configuración administrada:\n\n```json\n{\n \"allowedMcpServers\": [\n { \"serverUrl\": \"https://mcp.example.com/*\" },\n { \"serverCommand\": [\"npx\", \"-y\", \"@example/mcp-server\"] }\n ],\n \"deniedMcpServers\": [\n { \"serverName\": \"untrusted-server\" }\n ]\n}\n```\n\nCada entrada identifica un servidor por medio de exactamente uno de los siguientes criterios de coincidencia.\n\n| Comparador | Coincidencias | Notas |\n| --------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `serverUrl` | Un servidor remoto (HTTP/SSE) por dirección URL | Admite comodines `*`; el esquema y el host coinciden sin distinguir entre mayúsculas y minúsculas, y la ruta de acceso distingue entre mayúsculas y minúsculas. Las referencias `${VAR}` se expanden antes de buscar coincidencias. |\n| `serverCommand` | Un servidor stdio por su comando y argumentos exactos, en orden | Las referencias `${VAR}` se expanden antes de buscar coincidencias. |\n| `serverName` | Un servidor según su etiqueta asignada | Las entradas de la lista de permitidos están restringidas a `[A-Za-z0-9_-]+` (sin caracteres comodín); las entradas de la lista de denegación aceptan cualquier cadena no vacía. |\n\nReglas:\n\n* **Los servidores propios de confianza** (por ejemplo, el GitHub servidor MCP integrado) siempre están exentos de ambas listas.\n* **Dejar sin establecer `allowedMcpServers`** permite todos los servidores no predeterminados; una **matriz vacía** los bloquea todos (deny-all).\n* **No establecido o vacío `deniedMcpServers`** no bloquea nada.\n* **La denegación siempre prevalece**: un servidor que coincide con `deniedMcpServers` se bloquea aunque también coincida con `allowedMcpServers`.\n* En el caso de los servidores remotos, una coincidencia debe proceder de una entrada `serverUrl`; `serverName` solo cuenta cuando no existen entradas `serverUrl`. En el caso de los servidores stdio, una coincidencia debe provenir de una entrada `serverCommand`; `serverName` solo cuenta cuando no existen entradas `serverCommand`.\n\n## Lectura adicional\n\n* [GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli)\n* [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [Referencia programática de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [Referencia del plugin CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference)\n* [Referencia de enlaces de GitHub Copilot](/es/copilot/reference/hooks-reference)"}