Skip to main content

Cambio de la configuración con el /settings comando

Ver y cambiar tu configuración personal de CLI de GitHub Copilot con el comando de barra /settings.

Puede usar el /settings comando de barra diagonal para ver y cambiar la configuración desde una sesión interactiva de la CLI. Este comando controla la configuración de nivel de usuario, como si CLI de Copilot se actualiza automáticamente, qué paleta de colores usa la interfaz, qué se muestra en el pie de página y muchas otras opciones.

Use /settings para:

  • Examinar y editar la configuración de forma interactiva : ejecute /settings por su cuenta para abrir un editor en el que se pueden buscar y mostrar cada configuración con una descripción y su valor actual.
  • Cambiar una configuración con un solo comando : ejecute /settings KEY VALUE para cambiar una configuración determinada sin abrir el editor.
  • Comprobar el valor de una configuración : ejecute /settings show KEY para mostrar el valor actual de una configuración.

También puede usar /config, que es un alias de /settings.

Los cambios realizados con /settings o /config se escriben en el archivo de configuración personal (de forma predeterminada, ~/.copilot/settings.json) y se conservan entre sesiones.

Apertura del editor de configuración

Para examinar y editar la configuración de forma interactiva, escriba el comando de barra diagonal sin argumentos:

Copilot prompt
/settings

El editor muestra cada configuración que puede cambiar y el valor actual de la configuración. A medida que se desplaza hacia arriba o hacia abajo por la lista, se muestra una breve descripción de la configuración resaltada en la parte inferior del editor. Esto le permite examinar y editar la configuración sin necesidad de conocer sus nombres exactos.

Para obtener más información sobre la configuración disponible, consulte directorio de configuración de la CLI de GitHub Copilot.

Mientras el editor está abierto, puede usar los siguientes métodos abreviados de teclado:

KeyAction
/ Muévete entre los ajustes.
/Busque y filtre la lista por el nombre o la descripción de una configuración.
EntrarActivar o desactivar un ajuste booleano, o editar otros tipos de valores.
Ctrl+RRestablezca la configuración resaltada a su valor predeterminado.
Ctrl+EAbra settings.json en el editor de terminal configurado para realizar cambios avanzados.
EscBorre la búsqueda actual o cierre el editor.

La mayoría de los cambios surten efecto inmediatamente; por ejemplo, al cambiar la paleta de colores se actualiza la interfaz en cuanto se selecciona un nuevo valor.

Cambiar un solo ajuste en línea

Si ya sabes qué configuración quieres cambiar, puedes configurarla directamente desde el indicador de la CLI, sin abrir el editor:

/settings KEY VALUE

Por ejemplo:

Copilot prompt
/settings autoUpdate off

Copilot escribe el valor y lo confirma, por ejemplo: Set autoUpdate = false.

Nota:

* La configuración booleana acepta on/off o .true/false Por ejemplo: /settings renderMarkdown on. * La configuración con un conjunto fijo de opciones acepta uno de esos valores. Por ejemplo, /settings theme dim o /settings banner never. * Las configuraciones anidadas usan una ruta en notación de puntos. Por ejemplo, /settings footer.showBranch off oculta la rama de Git en el pie de página.

Puede configurar las opciones que toman valores establecidos sin necesidad de recordar la clave o el valor exactos, simplemente mediante la navegación y las teclas Entrar . Por ejemplo, para evitar que el agente haga preguntas aclarando:

  1. Escriba /settings, sin presionar Entrar, para mostrar una lista de opciones.

  2. Use la tecla para bajar la lista hasta que apunte a /settings askUser Allow the agent to ask clarifying questionsy presione Entrar.

  3. Use la tecla para bajar la lista de opciones de esta configuración hasta que apunte a /settings askUser offy presione Entrar.

  4. Presione Entrar de nuevo para enviar el /settings askUser off comando.

    La CLI confirma el cambio: Set askUser = false.

Visualización de valores válidos para una configuración

Para mostrar los valores válidos disponibles para una configuración, escriba /settings KEY sin ningún valor. Por ejemplo, para ver los valores válidos para theme:

Copilot prompt
/settings theme

Visualización del valor actual de una configuración

Para mostrar el valor actual de una configuración, use show. Por ejemplo:

Copilot prompt
/settings show theme

Esto genera una línea como theme = high-contrast. El show formulario es útil para comprobar rápidamente un valor o para capturar la configuración en los registros.

Cambio de la configuración que requiere un reinicio

La mayoría de los ajustes se aplican de inmediato, pero algunos solo surten pleno efecto después de reiniciar CLI de Copilot; por ejemplo, experimental y los ajustes del proxy. Al cambiar una de estas opciones, Copilot indica que se necesita un reinicio y puede reiniciar la sesión automáticamente.

Configuración que no se puede cambiar desde la línea de comandos

No todas las configuraciones se pueden modificar mediante el método en línea /settings KEY VALUE:

  • La configuración confidencial de seguridad, como las que cambian la forma en que se almacenan las credenciales o que ejecutan un comando de shell, se excluyen deliberadamente, ya que voltearlas en una sola línea sin confirmación es arriesgada.
  • Los ajustes de lista y estructurados no se pueden establecer de forma inline. Escriba /settings y presione Ctrl+E para abrirlo settings.json en el editor de terminal configurado y, a continuación, edite la configuración allí.
  • Los ajustes gestionados por tu repositorio o tu organización se muestran como referencia, pero sus valores provienen de esas fuentes y prevalecen sobre tu valor personal. Cambiarlos en la configuración del usuario no tiene ningún efecto.

En cada uno de estos casos, Copilot explica por qué no se aplicó el cambio y le señala al lugar adecuado para hacerlo.

Comandos reemplazados por /settings

Algunos comandos de barra diagonal más antiguos se han plegado en /settings. Siguen funcionando, pero muestran un aviso que indica el comando equivalente /settings .

Ajustes que quizá quieras cambiar

Algunas opciones de configuración usadas habitualmente incluyen:

  • autoUpdate : descargue automáticamente las versiones actualizadas de la CLI.
  • theme — Paleta de colores (default, github, dim, high-contrasto colorblind).
  • renderMarkdown — Representar Markdown en el terminal.
  • banner : frecuencia con la que se muestra el banner de inicio (always, onceo never).
  • beep — Pitido cuando Copilot requiera tu atención.
  • includeCoAuthoredBy — Añade un Co-authored-by tráiler a los commits.
  • footer.showBranch : muestra la rama git actual en el pie de página.

Para obtener la lista completa de la configuración disponible y cómo se combinan los valores de usuario, repositorio y organización, consulte directorio de configuración de la CLI de GitHub Copilot.

Lectura adicional