{"meta":{"title":"Uso de la CLI de GitHub Copilot","intro":"Obtenga información sobre cómo usar GitHub Copilot desde la línea de comandos.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/how-tos","title":"Procedimientos"},{"href":"/es/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/es/copilot/how-tos/copilot-cli/use-copilot-cli","title":"Utilice Copilot CLI"},{"href":"/es/copilot/how-tos/copilot-cli/use-copilot-cli/overview","title":"Visión general"}],"documentType":"article"},"body":"# Uso de la CLI de GitHub Copilot\n\nObtenga información sobre cómo usar GitHub Copilot desde la línea de comandos.\n\nLa interfaz de la línea de comandos (CLI) para GitHub Copilot permite usar Copilot directamente desde el terminal. Para obtener más información, vea [Acerca de GitHub Copilot CLI](/es/copilot/concepts/agents/copilot-cli/about-copilot-cli).\n\n## Prerrequisito\n\nInstalar Copilot CLI. Consulte [Instalación de la CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli).\n\n## Usar Copilot CLI\n\n1. En el terminal, accede a una carpeta que contenga el código con el que deseas trabajar.\n\n2. Escriba `copilot` para iniciar Copilot CLI.\n\nCopilot le pedirá que confirme que confía en los archivos de esta carpeta.\n\n> \\[!IMPORTANT]\n> Durante esta GitHub Copilot CLI sesión, Copilot puede intentar leer, modificar y ejecutar archivos en y debajo de esta carpeta. Solo debes continuar si confías en los archivos de esta ubicación. Para obtener más información acerca de los directorios de confianza, consulta [Acerca de GitHub Copilot CLI](/es/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories).\n\n1. Elija una de las siguientes opciones:\n\n**1. Sí, continuar**:\n\nCopilot solo puede trabajar con los archivos de esta ubicación para esta sesión.\n\n**2. Sí y recordar esta carpeta para futuras sesiones**:\n\nConfías en los archivos de esta carpeta para esta y futuras sesiones. No se le preguntará de nuevo cuando inicie Copilot CLI desde esta carpeta. Elija solo esta opción si está seguro de que siempre será seguro para Copilot trabajar con archivos en esta ubicación.\n\n**3. No, salir (Esc)**:\n\nFinalice la Copilot CLI sesión.\n\n1. Si no ha iniciado sesión actualmente en GitHub, se le pedirá que use el `/login` comando de barra diagonal. Escribe este comando y sigue las instrucciones en pantalla para autenticarte.\n\n2. Escribe un mensaje en la CLI.\n\n Puede ser una pregunta de chat simple o una solicitud para Copilot realizar una tarea específica, como corregir un error, agregar una característica a una aplicación existente o crear una nueva aplicación.\n\n Como alternativa a escribir, puede decir la indicación en voz alta. Consulte [Uso de la entrada de voz con la CLI de Copilot](/es/copilot/how-tos/copilot-cli/use-copilot-cli/voice-input).\n\n Para ver algunos ejemplos de mensajes, consulta [Acerca de GitHub Copilot CLI](/es/copilot/concepts/agents/copilot-cli/about-copilot-cli).\n\n3. Cuando Copilot quiera usar una herramienta que pueda modificar o ejecutar archivos,Por ejemplo, `touch`, `chmod`, `node`, o `sed` le pedirá que apruebe el uso de la herramienta.\n\n Elija una de las siguientes opciones:\n\n**1. Sí**:\n\nPermitir Copilot usar esta herramienta. La próxima vez Copilot que quiera usar esta herramienta, le pedirá que la apruebe de nuevo.\n\n**2. Sí, y aprobar HERRAMIENTA para el resto de la sesión en ejecución**:\n\nPermitir que Copilot use esta herramienta con cualquier opción, sin volver a preguntar, durante el resto de la sesión en curso. Las solicitudes de permisos en paralelo pendientes del mismo tipo se aprobarán automáticamente. Tendrás que volver a aprobar el comando en futuras sesiones.\n\nElegir esta opción es útil para muchas herramientas, como `chmod`, ya que evita que tenga que aprobar comandos similares repetidamente en la misma sesión. Sin embargo, tenga en cuenta las implicaciones de seguridad de esta opción. Por ejemplo, elegir esta opción para el comando `rm` permitiría Copilot eliminar cualquier archivo del directorio actual o sus subdirectorios sin pedir su aprobación.\n\n**3. No, e indique Copilot qué hacer de forma diferente (Esc)**:\n\nCopilot no ejecutará el comando . En su lugar, finaliza la operación actual y espera el siguiente mensaje. Puede indicarle Copilot que continúe la tarea, pero con un enfoque diferente.\n\nPor ejemplo, si solicita Copilot crear un script de Bash, pero no desea usar el script que Copilot sugiere, puede detener la operación actual y escribir un mensaje nuevo, como: `Continue the previous task but include usage instructions in the script`.\n\nAl rechazar una solicitud de permiso de herramienta, también puede proporcionar comentarios en línea de Copilot sobre el rechazo para que pueda adaptar su enfoque sin detenerse por completo.\n\n## Tips\n\nOptimice su experiencia con Copilot CLI con las siguientes sugerencias.\n\n### Detener una operación que se está ejecutando actualmente\n\nSi escribe un solicitud y, a continuación, decide que desea dejar Copilot de completar la tarea mientras todavía está \"Pensando\", presione Esc.\n\n### Utilizar el modo de planificación\n\nEl modo de planificación le permite colaborar con Copilot en un plan de implementación antes de escribir cualquier código. Pulse Mayús+Tab para entrar y salir del modo del plan.\n\n### Incluir un archivo específico en la indicación\n\nPara agregar un archivo específico a la indicación, usa `@` seguido de la ruta de acceso relativa al archivo. Por ejemplo: `Explain @config/ci/ci-required-checks.yml` o `Fix the bug in @src/app.js`. Esto añade el contenido del archivo a tu solicitud como contexto para Copilot.\n\nAl empezar a escribir una ruta de acceso de archivo, las rutas de acceso coincidentes se muestran debajo del cuadro de indicación. Usa las teclas de dirección para seleccionar una ruta de acceso y presiona la tecla Tab para completar la ruta de acceso en la indicación.\n\n### Adjuntar imágenes y ARCHIVOS PDF\n\nPuede adjuntar imágenes y ARCHIVOS PDF a las solicitudes al usar un modelo que admita la entrada de imagen.\n\nCopilot admite los siguientes tipos de archivo:\n\n* JPEG (`.jpg`, `.jpeg`)\n* PNG (`.png`)\n* GIF (`.gif`)\n* WEBP (`.webp`)\n* PDF (`.pdf`)\n* HEIC (`.heic`)\n* HEIF (`.heif`)\n\nLos datos adjuntos de imagen y PDF están disponibles en todos los Copilot planes y están habilitados de forma predeterminada, sin ninguna directiva necesaria para activar o desactivar la característica.\n\nPuede adjuntar un archivo de las maneras siguientes durante una sesión interactiva:\n\n* Haz referencia al archivo en tu indicación utilizando `@` seguido de la ruta al archivo.\n* Arrastre y coloque un archivo en la sesión interactiva.\n* Copie una imagen en el Portapapeles y péguela como datos adjuntos.\n\n### Trabajar con archivos en una ubicación diferente\n\nPara completar una tarea, Copilot puede que tenga que trabajar con archivos que están fuera del directorio de trabajo actual. Si un mensaje que ha escrito en una sesión interactiva requiere Copilot modificar un archivo fuera de la ubicación actual, se le pedirá que apruebe el acceso al directorio del archivo.\n\nTambién puedes agregar manualmente un directorio de confianza en cualquier momento mediante el comando de barra diagonal:\n\n```shell\n/add-dir /path/to/directory\n```\n\nSi todos los archivos con los que desea trabajar están en una ubicación diferente, puede cambiar el directorio de trabajo actual sin iniciar una nueva Copilot CLI sesión utilizando los comandos slash `/cwd` o `/cd`.\n\n```shell\n/cwd /path/to/directory\n```\n\n### Ejecución de comandos de shell\n\nPuede anteponer la entrada con `!` para ejecutar directamente comandos de shell, sin realizar una llamada al modelo.\n\n```shell\n!git clone https://github.com/github/copilot-cli\n```\n\n### Programa indicaciones para ejecutarlas más tarde\n\nPuede programar instrucciones para ejecutarlas en el futuro mediante los comandos de barra diagonal `/every` y `/after`. El comando `/every` programa una solicitud para que se ejecute repetidamente a intervalos especificados, mientras que el comando `/after` programa una solicitud de una sola vez para que se ejecute una vez tras un retraso especificado. Por ejemplo:\n\n```shell\n/every 1h Run frontend tests and report any failures\n```\n\nPara obtener más información, vea [Programación de indicaciones en GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/automate-copilot-cli/schedule-prompts).\n\n### Reanudar una sesión interactiva\n\nPuede usar la opción de línea de comandos `--resume` o el comando de barra diagonal `/resume` para seleccionar y reanudar una sesión interactiva de la CLI, lo que le permite continuar justo donde lo dejó, con el contexto guardado. Puede iniciar una Copilot cloud agent sesión en GitHuby, a continuación, usar GitHub Copilot CLI para llevar esa sesión al entorno local.\n\n> \\[!TIP]\n> Para reanudar rápidamente la sesión local cerrada más recientemente, escriba esto en el terminal:\n>\n> ```shell\n> copilot --continue\n> ```\n\n### Usar instrucciones personalizadas\n\nPuede mejorar el rendimiento de Copilot agregando instrucciones personalizadas al repositorio en el que estás trabajando. Las instrucciones personalizadas son descripciones de lenguaje natural guardadas en archivos Markdown en el repositorio. Se incluyen automáticamente en los mensajes que escribas mientras trabajas en ese repositorio. Esto ayuda a Copilot a comprender mejor el contexto de tu proyecto y a responder a tus indicaciones.\n\nCopilot CLI admite lo siguiente:\n\n* Instrucciones para todo el repositorio en el archivo `.github/copilot-instructions.md`.\n* Archivos de instrucciones específicas de la ruta de acceso: `.github/instructions/**/*.instructions.md`.\n* Archivos de agente como `AGENTS.md`.\n\nPara obtener más información, vea [Adición de instrucciones personalizadas para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions).\n\n### Utilice custom agents\n\nA custom agent es una versión especializada de Copilot.\nCustom agents ayudar a Copilot controlar flujos de trabajo únicos, convenciones de codificación concretas y casos de uso especializados.\n\nCopilot CLI incluye un grupo predeterminado de custom agents para tareas comunes:\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
AgenteDescription
ExplorarRealiza un análisis rápido de código base, lo que le permite formular preguntas sobre el código sin agregar al contexto principal.
tareaEjecuta comandos como pruebas y compilaciones, lo que proporciona resúmenes breves sobre éxito y salida completa en caso de error.
Uso generalControla tareas complejas y de varios pasos que requieren el conjunto de herramientas completo y el razonamiento de alta calidad, que se ejecutan en un contexto independiente para mantener la conversación principal claramente centrada.
Revisión de códigoRevisa los cambios con un enfoque en identificar solo problemas genuinos, minimizando el ruido.
InvestigaciónRealiza una investigación profunda en el código base, los repositorios pertinentes y la web, lo que genera un informe detallado con citas.
Pato de gomaActúa como crítico constructivo para proporcionar comentarios sobre algunas tareas no triviales. Usado automáticamente por Copilot CLI.
\n\nEl modelo de IA que utiliza la CLI puede delegar una tarea a un proceso de subagente secundario, que opera utilizando un custom agent con experiencia específica, si considera que esto permitirá completar el trabajo de manera más eficaz. El modelo puede igualmente optar por gestionar el trabajo directamente en el agente principal.\n\nAlgunas custom agents internas, como el agente de pato de goma, se consultan automáticamente a través de Copilot en su nombre en lugar de invocarlas directamente. No los verá como opciones independientes al ejecutar `/agent`, pero es posible que vea que Copilot los menciona mientras realiza una tarea.\n\nPuede definir su propio custom agents usando archivos Markdown, llamados agent profiles, que especifican qué experiencia debe tener el agente, qué herramientas puede usar y las instrucciones específicas sobre cómo debe responder.\n\nPuede definir custom agents en el nivel de usuario, repositorio o organización o empresa:\n\n| Tipo | Location | Ámbito |\n| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------- |\n| Nivel de usuario custom agent | directorio local `~/.copilot/agents` | Todos los proyectos |\n| Nivel de repositorio custom agent | | |\n| `.github/agents` directorio en los repositorios locales y remotos | Proyecto actual | |\n| Organización y nivel empresarial custom agent | Directorio `/agents` en el repositorio `.github-private` de una organización o empresa | Todos los proyectos de su organización y cuenta empresarial |\n\nEn el caso de conflictos de nomenclatura, un agente de nivel de sistema invalida un agente de nivel de repositorio y el agente de nivel de repositorio invalidaría un agente de nivel de organización.\n\nCustom agents se puede usar de tres maneras:\n\n* Utilizando el comando de barra diagonal en la interfaz interactiva de la CLI para seleccionar en la lista de custom agents disponibles:\n\n ```shell\n /agent\n ```\n\n* Llamando directamente a custom agent en una solicitud:\n\n ```shell\n Use the refactoring agent to refactor this code block\n ```\n\nCopilot deducirá automáticamente el agente que desea usar.\n\n* Especifique el custom agent que desea usar mediante la opción de línea de comandos. Por ejemplo:\n\n ```shell\n copilot --agent=refactor-agent --prompt \"Refactor this code block\"\n ```\n\nPara obtener más información, vea [Creación de agentes personalizados para Copilot cloud agent](/es/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).\n\n### Usar capacidades\n\nPuede crear aptitudes para mejorar la capacidad de Copilot realizar tareas especializadas con instrucciones, scripts y recursos.\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### Uso de enlaces\n\nPuede usar enlaces para ampliar y personalizar el comportamiento de Copilot CLI. Los enlaces permiten ejecutar comandos de shell personalizados automáticamente en puntos clave durante una sesión de la CLI.\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### Agregar un servidor MCP\n\nCopilot CLI viene con el GitHub servidor MCP ya configurado. Este servidor MCP permite interactuar con los recursos en GitHub.com, por ejemplo, permite fusionar pull requests desde la CLI.\n\nPara ampliar la funcionalidad disponible en Copilot CLI, puede agregar más servidores MCP.\n\nPara agregar un servidor HTTP remoto directamente desde el terminal sin iniciar una sesión interactiva, use:\n\n```shell copy\ncopilot mcp add --transport http SERVER-NAME URL\n```\n\nPor ejemplo:\n\n```shell copy\ncopilot mcp add --transport http sentry https://mcp.sentry.dev/mcp\n```\n\nPara obtener servidores locales y opciones adicionales, consulte [Adición de servidores MCP para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#using-the-copilot-mcp-add-subcommand).\n\nComo alternativa, agregue un servidor desde una sesión interactiva:\n\n1. Usa el siguiente comando de barra diagonal:\n\n ```shell\n /mcp add\n ```\n\n2. Rellena los detalles del servidor MCP que deseas agregar, con la tecla Tab para moverte entre los campos.\n\n3. Pulse Ctrl+S para guardar los detalles.\n\nLos detalles de los servidores MCP configurados se almacenan en el archivo `mcp-config.json`, que se encuentra, de forma predeterminada, en el directorio `~/.copilot`. Esta ubicación se puede cambiar estableciendo la variable de entorno `COPILOT_HOME`. Para obtener información sobre la estructura JSON de una definición de servidor, consulta [Configuración de servidores MCP para el repositorio](/es/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers).\n\n### Administración de contexto\n\nCopilot CLI proporciona varios comandos de barra diagonal para ayudarle a supervisar y administrar la ventana de contexto:\n\n* `/usage`: le permite ver las estadísticas de sesión, entre las que se incluyen:\n * Cantidad de GitHub AI Credits usada en la sesión actual\n * Duración de la sesión\n * Líneas totales de código editadas\n * Desglose del uso de tokens por modelo\n\n* `/context`: proporciona información general visual sobre el uso del token actual.\n\n* `/compact`: comprime manualmente el historial de conversaciones para liberar espacio de contexto.\n\nGitHub Copilot CLI comprime automáticamente el historial en segundo plano cuando la conversación se aproxima a 95% del límite de tokens, sin interrumpir el flujo de trabajo.\n\n### Habilitación de todos los permisos\n\nEn situaciones en las que confía en que Copilot se ejecute libremente, puede usar las banderas `--allow-all` o `--yolo` para habilitar todos los permisos a la vez.\n\n### Uso de espacio aislado\n\nPuede usar el espacio aislado para restringir lo que Copilot puede acceder. El espacio aislado local no ejecuta la CLI en un espacio aislado; en su lugar, los comandos y las herramientas que Copilot CLI se ejecutan en su nombre están restringidos, limitando su acceso al sistema de archivos, la red y las funcionalidades del sistema. Para habilitar el entorno de pruebas local, introduce `/sandbox enable` dentro de una sesión.\n\nComo alternativa, con el espacio aislado en la nube, toda Copilot CLI la sesión se ejecuta de forma remota en un entorno aislado. Para iniciar una Copilot CLI sesión en la nube, ejecute `copilot ‑‑cloud`. Para obtener más información, vea [Acerca de los espacios aislados locales y en la nube para GitHub Copilot](/es/copilot/concepts/about-cloud-and-local-sandboxes).\n\n### Alternar la visibilidad del razonamiento\n\nPresione Ctrl+T para mostrar u ocultar el proceso de razonamiento del modelo mientras genera una respuesta. Esta configuración persiste en las sesiones, lo que le permite observar cómo Copilot funciona a través de problemas complejos.\n\n### Configuración de las opciones\n\nPuede ver y cambiar la configuración personal Copilot CLI mediante el `/settings` comando de barra diagonal.\n\n* Ejecute `/settings` para abrir un editor de configuración interactivo, donde puede buscar una configuración por nombre y editarla. Para restaurar una configuración a su valor predeterminado, resalte en la lista de opciones y presione Ctrl+R.\n* Ejecute `/settings KEY VALUE` para cambiar un ajuste directamente en el cuadro del prompt de la CLI. KEY es el nombre de la configuración y VALUE es el valor que desea establecer. Esto también funciona en scripts y en sesiones de programación iniciadas con `-p`.\n* Ejecute `/settings show KEY` para mostrar el valor actual de una configuración como texto, sin abrir el editor.\n\nLa mayoría de los cambios de configuración surten efecto inmediatamente, sin necesidad de reiniciar Copilot CLI.\n\nPara obtener más información, vea [Cambio de la configuración con el \\`/settings\\` comando](/es/copilot/how-tos/copilot-cli/customize-copilot/change-settings). Para obtener la lista completa de la configuración disponible, consulte [directorio de configuración de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings).\n\n## Obtén más información\n\nPara obtener una lista completa de las opciones de línea de comandos y los comandos de barra diagonal que puede usar con Copilot CLI, realice una de las acciones siguientes:\n\n* Escribe `?` en el cuadro de indicación de una sesión interactiva.\n* Escribe `copilot help` en el terminal.\n\nPara obtener más información, use uno de los siguientes `copilot help` subcomandos en el terminal:\n\n* **Opciones de configuración**:\n\n `copilot help config`\n\n* **Variables de entorno** que afectan a Copilot CLI:\n\n `copilot help environment`\n\n* **Niveles de registro disponibles**:\n\n `copilot help logging`\n\n* **Permisos** para permitir o denegar el uso de la herramienta:\n\n `copilot help permissions`\n\n## Comentarios\n\nSi tienes algún comentario sobre los datos de GitHub Copilot CLI, háznoslo saber mediante el comando de barra diagonal `/feedback` en una sesión interactiva y eligiendo una de las opciones. Puedes completar una encuesta privada de comentarios, enviar un informe de errores o sugerir una nueva característica.\n\n## Pasos siguientes\n\nCopilot CLI puede funcionar como asistente conversacional, responder preguntas y ayudarle a escribir código de forma interactiva. Más allá del chat, Copilot CLI admite una gama de modos agente que permiten delegar tareas con mayor autonomía.\n\nPuede trabajar con agentes en Copilot CLI para apoyar un ciclo de vida completo de tareas, desde delegar el trabajo hasta revisar los resultados.\n\n* **Delegar tareas de forma autónoma**: ejecute Copilot CLI en modo Autopilot para completar tareas de varios pasos sin necesidad de aprobación en cada paso. Consulte [Delegación de tareas a Copilot](/es/copilot/how-tos/copilot-cli/use-copilot-cli/delegate-tasks-to-cca).\n* **Invocar agentes personalizados: invoque** agentes especializados adaptados a tareas específicas, como revisión de código, documentación o auditorías de seguridad. Consulte [Invocación de agentes personalizados](/es/copilot/how-tos/copilot-cli/use-copilot-cli/invoke-custom-agents).\n* **Dirigir a los agentes**: puede guiar y ajustar el comportamiento del agente durante la ejecución de la tarea para mantener el trabajo en curso. Consulte [Agentes de dirección en GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents).\n* **Solicitar una revisión de código**: use Copilot CLI para obtener una revisión con tecnología de inteligencia artificial de los cambios en el código. Consulte [Solicitud de una revisión de código con GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review).\n\n## Lectura adicional\n\n* [Procedimientos recomendados para la CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/cli-best-practices)\n* [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [directorio de configuración de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-config-dir-reference)\n* [Servidor ACP de CLI de Copilot](/es/copilot/reference/copilot-cli-reference/acp-server)"}