Procedimientos recomendados para la CLI de GitHub Copilot

Introducción

          CLI de GitHub Copilot es un asistente de programación mediante IA nativo del terminal que integra funcionalidades de agente directamente en el editor de comandos. 
          CLI de Copilot puede funcionar como un bot de chat, responder a sus preguntas, pero su verdadero poder reside en su capacidad de trabajar de forma autónoma como asociado de codificación, lo que le permite delegar tareas y supervisar su trabajo.

En este artículo se proporcionan sugerencias para sacar el máximo partido de CLI de Copilot, desde el uso eficaz de los distintos comandos de la CLI hasta administrar el acceso de la CLI a los archivos. Tenga en cuenta estas sugerencias como puntos de partida y, a continuación, experimente para averiguar lo que funciona mejor para los flujos de trabajo.

Nota:

          CLI de GitHub Copilot está evolucionando continuamente. Use el `/help` comando para ver la información más actualizada.

1. Personalización del entorno

Uso de archivos de instrucciones personalizados

          CLI de Copilot lee automáticamente las instrucciones de varias ubicaciones, lo que le permite definir estándares de toda la organización y convenciones específicas del repositorio.

          **Ubicaciones admitidas (en orden de detección):**

Ubicación	Ámbito
`~/.copilot/copilot-instructions.md`	Todas las sesiones (globales)
`.github/copilot-instructions.md`	Repositorio
`.github/instructions/*/.instructions.md`	Repositorio (modular)

          `AGENTS.md` (en la raíz de Git o en cwd)            | Repositorio            |

| Copilot.md, , GEMINI.md, CODEX.md | Repositorio |

Procedimiento recomendado

Las instrucciones del repositorio siempre tienen prioridad sobre las instrucciones globales. Úselo para aplicar convenciones de equipo. Por ejemplo, se trata de un archivo simple .github/copilot-instructions.md .

## Build Commands
- `npm run build` - Build the project
- `npm run test` - Run all tests
- `npm run lint:fix` - Fix linting issues

## Code Style
- Use TypeScript strict mode
- Prefer functional components over class components
- Always add JSDoc comments for public APIs

## Workflow
- Run `npm run lint:fix && npm test` after making changes
- Commit messages follow conventional commits format
- Create feature branches from `main`

Sugerencia

Mantenga las instrucciones concisas y accionables. Las instrucciones largas pueden diluir la eficacia.

Para más información, consulta Acerca de la personalización de las respuestas de GitHub Copilot.

Configuración de herramientas permitidas

Administre qué herramientas Copilot se pueden ejecutar sin pedir permiso. Cuando Copilot solicita permiso para una acción, normalmente puede elegir permitirlo solo esta vez o permitir que la herramienta se use para el resto de la sesión de la CLI.

Para restablecer las herramientas aprobadas anteriormente, use:

/reset-allowed-tools

También puede preconfigurar las herramientas permitidas a través de marcas de la CLI:

copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

          **Patrones de permisos comunes:**

* shell(git:*) : permitir todos los comandos de Git * shell(npm run:*) : permitir todos los scripts de npm * shell(npm run test:*) : permitir comandos de prueba de npm * write — Permitir escrituras de archivos

Selección del modelo preferido

Use /model para elegir entre los modelos disponibles en función de la complejidad de la tarea:

Modelo	Mejor para	Compromisos

          **Claude Opus 4.5** (valor predeterminado) | Arquitectura compleja, depuración difícil, refactorización matizada | Más capaz, pero usa más [solicitudes Premium](/copilot/concepts/billing/copilot-requests#model-multipliers) |

| Claude Sonnet 4.5 | Codificación diaria, la mayoría de las tareas rutinarias | Rápido, rentable, maneja la mayoría del trabajo bien | | GPT-5.2 Codex | Generación de código, revisión de código, implementaciones sencillas | Excelente para revisar el código generado por otros modelos |

          **Recommendations:**

* Opus 4.5 es ideal para tareas que requieren un razonamiento profundo, un diseño complejo del sistema, una investigación sutil de errores o una amplia comprensión del contexto. * Cambie a Sonnet 4.5 para tareas rutinarias en las que la velocidad y la rentabilidad sean importantes, controla la mayoría de la codificación diaria de forma eficaz. * Use Codex para la generación de código a gran escala y como recurso adicional para revisar el código producido por otros modelos.

Puede cambiar los modelos a mitad de sesión con /model a medida que cambia la complejidad de las tareas.

Si su organización o empresa ha configurado modelos personalizados con sus propias claves de API del proveedor llM, esos modelos también aparecen en /model la parte inferior de la lista.

Use su propio proveedor de modelos

Puede configurar CLI de Copilot para usar su propio proveedor de modelos en lugar de modelos hospedados en GitHub. Ejecute copilot help providers para obtener instrucciones de configuración completas.

          **Consideraciones clave:**

El modelo debe admitir llamadas a herramientas (invocación de funciones) y streaming. CLI de Copilot devuelve un error si falta alguna de las funcionalidades.
Para obtener los mejores resultados, use un modelo con una ventana de contexto de al menos 128 000 tokens.
Los subagentes integrados (/review, /task, /fleet) exploran y heredan automáticamente la configuración del proveedor.
Las estimaciones de costos de la solicitud Premium se ocultan al usar su propio proveedor. Todavía se muestra el uso de tokens (recuentos de entrada, salida y caché).

        `/delegate` solo funciona si también ha iniciado sesión en GitHub. Del lado del servidor de GitHub, transfiere la sesión a Copilot, no al proveedor.

Consulte Usar su propio proveedor de modelos.

2. Planear antes de codificar

Modo de plan

          **Los modelos logran mayores tasas de éxito cuando se da un plan concreto que seguir.** En el modo de plan, Copilot creará un plan de implementación estructurado antes de escribir cualquier código.

Presione Shift+Tab para alternar entre el modo normal y el modo planificación. En modo de plan, todas las solicitudes que escriba desencadenarán el flujo de trabajo del plan.

Como alternativa, puede usar el /plan comando en modo normal para lograr el mismo efecto.

          **Mensaje de ejemplo (desde el modo normal):**

/plan Add OAuth2 authentication with Google and GitHub providers

          **Qué ocurre:**

* Copilot analiza la solicitud y el código base. * Formula preguntas aclarantes para alinearse con los requisitos y el enfoque.

Crea un plan de implementación estructurado con casillas.
Guarda el plan en plan.md en la carpeta de sesión.

        **Espera la aprobación** antes de implementarla.

Puede presionar Ctrl+y para ver y editar el plan en el editor predeterminado para los archivos Markdown.

          **Salida del plan de ejemplo:**

# Implementation Plan: OAuth2 Authentication

## Overview
Add social authentication using OAuth2 with Google and GitHub providers.

## Tasks
- [ ] Install dependencies (passport, passport-google-oauth20, passport-github2)
- [ ] Create authentication routes in `/api/auth`
- [ ] Implement passport strategies for each provider
- [ ] Add session management middleware
- [ ] Create login/logout UI components
- [ ] Add environment variables for OAuth credentials
- [ ] Write integration tests

## Detailed Steps
1. **Dependencies**: Add to package.json...
2. **Routes**: Create `/api/auth/google` and `/api/auth/github`...

Cuándo usar el modo de plan

Scenario	¿Usar el modo de planificación?
Cambios complejos en varios archivos
Refactorización con muchos puntos de contacto
Nueva implementación de características
Correcciones rápidas de errores
Cambios de un solo archivo

Flujo de trabajo de explorar → planificar → codificar → confirmar

Para obtener mejores resultados en tareas complejas:

```
        **Explore**:
```
Read the authentication files but don't write code yet
```
        **Plan**:
```
/plan Implement password reset flow
```
        **Revisar**:
```
Comprobar el plan, sugerir modificaciones
```
        **Implementar**:
```
Proceed with the plan
```
        **Verificar**:
```
Run the tests and fix any failures
```
        **Confirmar**:
```
Commit these changes with a descriptive message

3. Aprovechar sesiones infinitas

Administración automática de ventanas de contexto

          CLI de Copilot incluye **sesiones infinitas**. No es necesario preocuparse por quedarse sin contexto. El sistema administra automáticamente el contexto a través de la compactación inteligente que resume el historial de conversaciones a la vez que conserva la información esencial.

          **Ubicación de almacenamiento de sesión:**

~/.copilot/session-state/{session-id}/
├── events.jsonl      # Full session history
├── workspace.yaml    # Metadata
├── plan.md           # Implementation plan (if created)
├── checkpoints/      # Compaction history
└── files/            # Persistent artifacts

Nota:

Si alguna vez necesita desencadenar manualmente la compactación, use /compact. Esto rara vez es necesario, ya que el sistema lo controla automáticamente.

Comandos de administración de sesión

Para ver información sobre la sesión actual de la CLI, escriba:

/session

Para ver una lista de los puntos de control de sesión, escriba:

/session checkpoints

Nota:

Se crea un punto de control cuando se compacta el contexto de sesión y permite ver el contexto de resumen que Copilot creó.

Para ver los detalles de un punto de control específico, escriba:

/session checkpoints NUMBER

donde NUMBER especifica el punto de control que desea mostrar.

Para ver cualquier archivo temporal que se haya creado durante la sesión actual—por ejemplo, artefactos creados por Copilot que no deberían guardarse en el repositorio—escriba:

/session files

Para ver el plan actual (si Copilot ha generado uno), escriba:

/session plan

Procedimiento recomendado: Mantener las sesiones centradas

Aunque las sesiones infinitas permiten el trabajo de larga duración, las sesiones centradas producen mejores resultados:

Use /clear o /new entre tareas no relacionadas.
Esto restablece el contexto y mejora la calidad de la respuesta.
Piense en ello como iniciar una conversación fresca con un compañero.

El comando `/context`

Visualice el uso del contexto actual con /context. Muestra un desglose de:

Tokens de sistema o herramientas
Tokens del historial de mensajes
Espacio libre disponible
Asignación de búfer

4. Delegar el trabajo eficazmente

El comando `/delegate`

          **Descargue el trabajo para ejecutarse en la nube mediante agente en la nube de Copilot.** Esto es especialmente eficaz para:

Tareas que se pueden ejecutar de forma asincrónica.
Cambios en otros repositorios.
Operaciones de larga duración para las que no quiere esperar.
```
        **Solicitud de ejemplo:**
```

/delegate Add dark mode support to the settings page

          **Qué ocurre:**

La solicitud se envía a agente en la nube de Copilot.
El agente crea una solicitud de incorporación de cambios que incluye las modificaciones.
Puede seguir trabajando localmente mientras funciona el agente en la nube.

Cuándo debe usarse `/delegate`

Utilice `/delegate`	Trabajar localmente
Tareas tangenciales	Trabajo en las funcionalidades principales
Actualizaciones de documentación	Depuración
Refactorización de módulos independientes	Exploración interactiva

5. Flujos de trabajo comunes

Familiarización con la base de código

Use CLI de Copilot como asociado de programación de pares al unirse a un nuevo proyecto. Por ejemplo, podría preguntar Copilot:

How is logging configured in this project?
What's the pattern for adding a new API endpoint?
Explain the authentication flow
Where are the database migrations?

Desarrollo mediante pruebas

Emparejar con CLI de Copilot para desarrollar pruebas.

Write failing tests for the user registration flow

        *Revise y apruebe las pruebas.*

Now implement code to make all tests pass
```
        *Revise la implementación.*
```
Commit with message "feat: add user registration"

Ayuda de revisión de código

/review Use Opus 4.5 and Codex 5.2 to review the changes in my current branch against `main`. Focus on potential bugs and security issues.

Operaciones de Git

          Copilot destaca en flujos de trabajo de Git.

What changes went into version `2.3.0`?
Create a PR for this branch with a detailed description
Rebase this branch against `main`
Resolve the merge conflicts in `package.json`

Investigación de errores

The `/api/users` endpoint returns 500 errors intermittently. Search the codebase and logs to identify the root cause.

Refactorización

/plan Migrate all class components to functional components with hooks

A continuación, responda a las preguntas que Copilot pregunta. Revise el plan que crea y pida Copilot que realice cambios si es necesario. Cuando esté satisfecho con el plan, puede preguntar: Implement this plan

6. Patrones avanzados

Trabajar con varios repositorios

          **
          CLI de Copilot proporciona flujos de trabajo de varios repositorios flexibles**: un diferenciador clave para los equipos que trabajan en microservicios, monorepos o proyectos relacionados.

          **Opción 1: Ejecutar desde un directorio primario**

# Navigate to a parent directory containing multiple repos
cd ~/projects
copilot

          Copilot ahora puede acceder y trabajar en todos los repositorios secundarios simultáneamente. Esto es ideal para:

Arquitecturas de microservicios
Realizar cambios coordinados en los repositorios relacionados

Refactorización de patrones compartidos entre proyectos

        **Opción 2: Usar `/add-dir` para expandir el acceso**

# Start in one repo, then add others (requires full paths)
copilot
/add-dir /Users/me/projects/backend-service
/add-dir /Users/me/projects/shared-libs
/add-dir /Users/me/projects/documentation

          **Ver y administrar directorios permitidos:**

/list-dirs

          **Flujo de trabajo de ejemplo: cambios de API coordinadas**

I need to update the user authentication API. The changes span:

- @/Users/me/projects/api-gateway (routing changes)
- @/Users/me/projects/auth-service (core logic)
- @/Users/me/projects/frontend (client updates)

Start by showing me the current auth flow across all three repos.

Esta funcionalidad de varios repositorios habilita:

Refactorizaciones transversales (actualizar un patrón compartido en todas partes)
Cambios de contrato de API con actualizaciones de cliente
Documentación que hace referencia a varios códigos base
Actualizaciones de dependencias en un monorepo

Uso de imágenes para el trabajo de la interfaz de usuario

          Copilot puede trabajar con referencias visuales. Basta **con arrastrar y colocar** imágenes directamente en la entrada de la CLI o hacer referencia a archivos de imagen:

Implement this design: @mockup.png
Match the layout and spacing exactly

Listas de comprobación para migraciones complejas

Para los cambios a gran escala:

Run the linter and write all errors to `migration-checklist.md` as a checklist.
Then fix each issue one by one, checking them off as you go.

Finalización de tareas autónomas

Cambie al modo Autopilot para permitir Copilot que funcione de forma autónoma en una tarea hasta que se complete. Esto es ideal para tareas de larga duración que no requieren supervisión constante. Para más información, consulta Permitir que la CLI de GitHub Copilot funcione de forma autónoma.

Opcionalmente, puede agilizar las tareas grandes mediante el comando de barra diagonal /fleet al comienzo de la instrucción para permitir a Copilot que desglose la tarea en subtareas paralelas que ejecutan los subagentes. Para más información, consulta Ejecución de tareas en paralelo con el /fleet comando.

7. Directrices del equipo

Configuración recomendada del repositorio

```
        **Crear `.github/copilot-instructions.md`** con:
```
- Comandos de compilación y prueba
- Directrices de estilo de código
- Comprobaciones necesarias antes de las confirmaciones
- Decisiones de arquitectura
```
        **Establecer convenciones** para:
```
- Cuándo usar /plan (características complejas, refactorización)
- Cuándo usar /delegate (trabajo tangencial)
- Procesos de revisión de código con asistencia de IA

Consideraciones de seguridad

        CLI de Copilot requiere aprobación explícita para operaciones potencialmente destructivas.

Revise todos los cambios propuestos antes de aceptarlos.
Use listas de permisos permitidas con criterio.
Nunca confirme secretos. Copilot está diseñado para evitar esto, pero siempre comprobarlo.

Medición de la productividad

Realice un seguimiento de las métricas como:

Tiempo desde el problema hasta el pull request
Número de iteraciones antes de la combinación
Ciclos de comentarios de revisión de código
Mejoras de cobertura de pruebas

Obtener ayuda

Desde la línea de comandos, puede mostrar ayuda mediante el comando : copilot -h.

Para obtener ayuda sobre varios temas, escriba:

copilot help TOPIC

donde TOPIC puede ser uno de: config, , commands``environment, , loggingo permissions.

Dentro de la CLI

Para obtener ayuda en la CLI, escriba:

/help

Para ver las estadísticas de uso, escriba:

/usage

Para enviar comentarios privados a GitHub acerca de CLI de Copilot, generar un informe de errores o enviar una solicitud de función, escriba:

/feedback

Ejercicios prácticos

Pruebe con el ejercicio Creación de aplicaciones con habilidades de CLI de Copilot para trabajar de forma práctica en la creación de una aplicación con CLI de Copilot.

Esto es lo que aprenderá:

Instalar CLI de Copilot
Uso de la plantilla de problema para crear un problema
Generación de una aplicación de calculadora de la CLI de Node.js
Expandir la funcionalidad de calculadora
Escribir pruebas unitarias para funciones de calculadora
Crea, revisa y combina tu pull request

Lectura adicional

        [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli)

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/use-copilot-cli)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)

        [
        Copilot planes y precios](https://github.com/features/copilot/plans)