Prepara tus herramientas, cuentas y límites de gasto

Objetivo: elegir un entorno de aprendizaje, instalar solo las herramientas que requiere y demostrar que puedes ejecutar una pequeña comprobación local antes de iniciar un agente. Las indicaciones sobre productos y los enlaces oficiales se verificaron el 2026-09-08. Las ofertas, los precios, los modelos y la disponibilidad pueden cambiar; las páginas enlazadas de los proveedores siguen siendo la referencia oficial.

Los enlaces externos de descarga, registro y documentación de productos de esta página se abren en una pestaña nueva. Mantén esta guía abierta mientras los sigues. Los enlaces internos de las lecciones permanecen en esta pestaña. En el sitio, usa Copiar código en un bloque de comando o prompt; en un archivo Markdown, selecciona y copia el contenido del bloque sin las comillas invertidas. Nunca pegues una página entera en un terminal.

[!IMPORTANT] El primer laboratorio local no requiere tarjeta de crédito, Azure, Codespaces, un plan de pago de Copilot ni un repositorio publicado en GitHub. Se necesitan una cuenta de GitHub y acceso autorizado a Copilot para los pasos con IA en una sesión real, no para las pruebas locales deterministas. Crear una cuenta no completa un laboratorio.

1. Elige una ruta

Para trabajar con Copilot en una sesión real, añade las comprobaciones de cuenta y plan de abajo. No necesitas ambos editores ni entornos locales y en la nube a la vez. Un editor en el navegador no es automáticamente un entorno de ejecución, y Azure no es el servicio que factura Codespaces.

2. Crea tu cuenta personal de GitHub

1. Abre la página de registro de GitHub.
2. Para este taller independiente, usa una dirección de correo personal que controles y que preveas conservar. Es una recomendación de aprendizaje, no una regla de GitHub que prohíba las direcciones de trabajo. No uses una cuenta prestada ni eludas las políticas de cuentas administradas de tu empleador.
3. Sigue el proceso de registro, elige tu nombre de usuario y completa la verificación solicitada. Nunca compartas tu contraseña, tu código de verificación del correo ni tus códigos de recuperación con un instructor o agente.
4. Verifica tu correo siguiendo el mensaje de GitHub. Si no llega, comprueba la carpeta de correo no deseado y la dirección introducida antes de solicitar otro mensaje.
5. Activa la autenticación de dos factores, preferiblemente con una aplicación de autenticación o una llave de seguridad, y guarda los códigos de recuperación en un lugar privado.
6. Confirma que el menú de tu avatar muestra tu propio nombre de usuario. Usa esa cuenta de forma coherente al activar Copilot e iniciar sesión en el cliente elegido.

Punto de comprobación: puedes iniciar sesión, tu correo está verificado y sabes cómo recuperar el acceso. Tu contraseña de GitHub no es una credencial para la línea de comandos de Git. Un repositorio Git local y un repositorio alojado en GitHub son cosas distintas; la publicación es opcional y se explica en la guía de descargas.

Ayuda oficial: crear una cuenta, verificar el correo y configurar la autenticación de dos factores.

3. Entiende Copilot Free y los demás planes

GitHub Free es un plan de cuenta; Copilot Free es un plan de producto de IA. Iniciar sesión en GitHub no demuestra que Copilot esté habilitado en el editor o la CLI. Empieza con la opción gratuita si cumples los requisitos y cubre el ejercicio.

Estos son precios de referencia publicados, no una cotización de compra. Los impuestos, los requisitos de elegibilidad, las asignaciones y las ofertas pueden variar o cambiar. Una licencia de la organización no es motivo para comprar una segunda suscripción personal.

Los planes actuales usan GitHub AI Credits para el uso de IA medido por consumo. Un crédito no equivale a una pregunta: el consumo depende del modelo y de los tokens. Los créditos incluidos y flex, los modelos disponibles, el uso adicional de pago y las políticas de la organización varían. No reutilices tablas antiguas de solicitudes premium para las nuevas suscripciones; algunas suscripciones anuales existentes siguen con la facturación heredada explícitamente documentada. La documentación actual de Free no publica una asignación numérica de AI Credits en las páginas verificadas aquí, por lo que esta guía no inventa una.

1. Lee la comparación oficial de planes y las opciones de compra actuales.
2. Con tu cuenta personal iniciada, sigue las instrucciones de activación del plan. Selecciona Free si cumples los requisitos; no selecciones un periodo de prueba de un plan de pago ni cambies a un plan superior solo para seguir este taller.
3. Revisa los controles de uso y facturación antes de habilitar uso adicional de pago. Copilot, Codespaces y Azure tienen asignaciones y controles separados.
4. Si tu cuenta está administrada, pregunta al administrador por las restricciones de acceso; no crees una segunda cuenta para eludir las políticas.

Copilot CLI está disponible con todos los planes de Copilot, incluido Free, sujeto a los límites de uso y a las políticas aplicables. Eso no hace que todos los modelos, las operaciones del agente en la nube ni las integraciones con IDE estén disponibles universalmente. Si se agota una asignación, registra el impedimento, continúa con las pruebas locales y retoma los pasos con IA cuando haya acceso; no es obligatorio cambiar a un plan superior.

Los estudiantes que cumplan los requisitos pueden consultar Copilot Student. La verificación y la activación son pasos separados; no supongas que un correo académico por sí solo concede el beneficio. Consulta también la facturación individual de IA y la facturación para organizaciones.

4. Instala VS Code Stable o Insiders

Las ediciones pueden ejecutarse en paralelo. Insiders no es un plan de pago de Copilot ni concede permisos adicionales a la cuenta. No supongas que instalar extensiones o iniciar sesión en una edición prepara la otra: comprueba la edición y el perfil que realmente usas. Stable e Insiders usan servicios de sincronización de configuración (Settings Sync) distintos de forma predeterminada; compartirlos es una decisión explícita.

1. Elige tu sistema operativo y procesador en la página de descarga y sigue el instalador. En macOS, mueve la aplicación a Aplicaciones.
2. Abre el editor seleccionado. Usa File > Open Folder (Archivo > Abrir carpeta) para abrir solo el espacio de trabajo de aprendizaje extraído, no toda tu carpeta personal.
3. Revisa los archivos antes de conceder Confianza del área de trabajo (Workspace Trust). Conceder confianza habilita la ejecución; no afirma que el código descargado sea seguro.
4. Abre la entrada Copilot/Chat en esa edición y sigue el proceso de inicio de sesión de GitHub. Revisa el acceso solicitado y confirma el nombre de usuario previsto. Si se solicita una extensión, usa la del editor oficial GitHub.
5. Si el comando de terminal no está disponible en macOS, abre la Paleta de comandos y ejecuta Shell Command: Install ‘code’ command in PATH, o el comando correspondiente de Insiders. Después, vuelve a abrir el terminal.

Para Stable, ejecuta esto en el terminal:

code --version

Para usar Insiders en su lugar:

code-insiders --version

Tras extraer un kit, entra en el espacio de trabajo indicado en su guía de primera ejecución y usa uno de estos comandos, no ambos:

code .

code-insiders .

Punto de comprobación: la edición prevista abre la carpeta prevista. Una solicitud inocua y de solo lectura funciona en Copilot si estás realizando los pasos en una sesión real. Usa Empieza aquí para la primera sesión guiada de Ask, Plan y Agent. No deduzcas que una funcionalidad en versión preliminar existe en Stable solo porque apareció en una demostración de Insiders.

Ayuda oficial: configuración del editor, configuración de Copilot, comandos de terminal y sincronización de configuración (Settings Sync).

5. Instala solo el entorno de ejecución del laboratorio elegido

Las 14 aventuras y el primer laboratorio práctico usan Node 24 para sus comprobaciones locales. Para otro kit práctico, lee su guía de primera ejecución antes de instalar un segundo lenguaje. No se necesita una instalación global de un framework de pruebas para el primer ejercicio de Node.

Después de instalar Node, vuelve a abrir el terminal y ejecuta:

node --version
npm --version

La versión de Node debe empezar por v24.. Una comprobación de versión demuestra que se encuentra el ejecutable; la comprobación inicial del laboratorio es el siguiente paso. Si usas Git, ejecuta también:

git --version

Solo para un kit de C#:

dotnet --list-sdks

Confirma que aparece un SDK de .NET 10 compatible. Solo para Python, selecciona el mismo intérprete en VS Code y en el terminal, y sigue las instrucciones de entorno virtual del laboratorio de configuración de Python. En Windows, py puede ser el lanzador instalado en lugar de python. No instales paquetes en un entorno global ajeno al ejercicio.

6. Instala Copilot CLI independiente

Copilot CLI usa el comando copilot. GitHub CLI usa gh. Son productos diferentes. La antigua extensión gh copilot no es la ruta de instalación que se enseña aquí. Elige un instalador de los siguientes; no instales todas las variantes. La ruta de npm requiere Node 22 o posterior; este currículo ya usa Node 24. Ese requisito de Node corresponde al instalador de npm, no a todos los instaladores nativos.

macOS

Si ya tienes Homebrew disponible, usa el comando de la guía oficial de instalación:

brew install --cask copilot-cli

Si no usas Homebrew, la ruta de npm de abajo es una alternativa una vez instalado Node. No necesitas instalar un gestor de paquetes solo para seguir esta ruta.

Windows

Usa PowerShell 6 o posterior; una instalación actual de PowerShell 7 es una opción adecuada. Windows PowerShell 5.1 y PowerShell 7 son instalaciones distintas. Consulta la instalación de PowerShell si lo necesitas. Comprueba el shell que abriste:

$PSVersionTable.PSVersion

Con WinGet disponible:

winget install GitHub.Copilot

Vuelve a abrir PowerShell para que reconozca el PATH actualizado. Si WinGet no está disponible, sigue la ruta de instalación aprobada para tu equipo o usa npm con Node.

Linux, o npm en macOS/Windows

Con Node disponible, esta es la instalación multiplataforma mediante npm:

npm install -g @github/copilot

Si la instalación informa de un error de permisos, usa una instalación de Node bajo el control de tu usuario o el método aprobado por tu administrador. No lo resuelvas ejecutando descargas arbitrarias como administrador.

Como alternativa en macOS/Linux, descarga el instalador oficial sin ejecutarlo inmediatamente:

curl -fsSL https://gh.io/copilot-install -o copilot-install.sh

Abre el archivo descargado en un editor, verifica la fuente oficial y revisa sus descargas y rutas de instalación. Solo si apruebas ese archivo exacto, ejecuta:

bash ./copilot-install.sh

Verifica, autentícate y empieza de forma segura

En un terminal nuevo:

copilot --version

Después, entra en el espacio de trabajo previsto del kit extraído e inicia:

copilot

Dentro de la sesión interactiva de Copilot, no en el shell del sistema operativo:

/login

Sigue el proceso del navegador o de código de dispositivo que muestre tu sesión, usando la cuenta de GitHub prevista. No pegues tokens en archivos de la lección ni en prompts. Después de autenticarte, consulta la ayuda de la sesión:

/help

Usa un prompt de solo lectura antes de permitir cambios:

Inspect this learning workspace and identify its starter files and existing tests.
Do not edit files, install packages, access secrets, publish code or run commands yet.
State the working directory, the proposed verification command and what it proves.

Punto de comprobación: tienes la versión de la CLI, la cuenta y el espacio de trabajo previstos, y una explicación que puedes contrastar con archivos reales. Revisa cada solicitud de permiso; no habilites la aprobación general para un ejercicio de formación. Después, sigue el flujo de trabajo de la CLI desde el kit extraído. Ask, Plan y Agent describen responsabilidades aquí; la CLI no tiene por qué presentar los mismos botones, roles o traspasos entre agentes que VS Code.

Ayuda oficial: instalación de la CLI, autenticación de la CLI y referencia actual de comandos.

7. Usa un Codespace en lugar de un entorno de ejecución local, si te resulta útil

Un GitHub Codespace es un entorno de desarrollo alojado: un contenedor Linux en una máquina virtual con archivos, herramientas y un terminal. Puedes usar su interfaz web de VS Code o conectarte desde VS Code de escritorio. El código se ejecuta de forma remota, no en tu portátil. Sigues necesitando autorización de Copilot para los pasos con IA en una sesión real.

Codespaces no es github.dev. El editor ligero al que accedes al pulsar . en un repositorio de GitHub no proporciona capacidad de cómputo ni un terminal integrado para compilar y ejecutar estos laboratorios. Su documentación lo clasifica actualmente como versión preliminar pública.

Comprueba la cuota antes de crear el entorno

Las horas de núcleo multiplican el tiempo de ejecución por los núcleos de la máquina: 120 horas de núcleo pueden equivaler a hasta 60 horas de ejecución en una máquina de 2 núcleos, antes de considerar otros usos o límites de almacenamiento. GB-mes mide el almacenamiento a lo largo del tiempo; no es simplemente una asignación de tamaño de disco. Los entornos pagados por organizaciones y sus políticas pueden ser distintos.

1. Lee sobre la facturación actual de Codespaces y comprueba quién pagará. Sin un método de pago válido, el uso se bloquea cuando se agota la asignación incluida.
2. Si el uso de pago está habilitado, revisa el presupuesto y la opción Stop usage when budget limit is reached (Detener el uso al alcanzar el límite del presupuesto). Una alerta de presupuesto por sí sola no detiene el gasto.
3. Revisa la configuración del contenedor y el script de configuración de este repositorio antes de crear un Codespace. El aprovisionamiento descarga herramientas y consume recursos; un ZIP local es más sencillo si esas herramientas ya están instaladas.

Crea y ejecuta un ejercicio aislado

1. Abre el repositorio del currículo en GitHub.

2. Selecciona Code > Codespaces, revisa el aviso sobre quién pagará y elige las opciones de creación. Comprueba la rama y el tamaño de la máquina; usa una máquina pequeña disponible que sea adecuada para el ejercicio elegido.

3. Crea el Codespace y espera a que termine la configuración. Si falla, lee el error indicado; no consideres listo un entorno creado a medias.

4. En su terminal, desde la raíz del checkout del currículo, prepara solo el primer proyecto de ejercicio en un directorio sin usar fuera de ese checkout:

   node scripts/prepare-hands-on.js --lab 01-interface --destination /workspaces/aca-01-interface
   

5. Abre /workspaces/aca-01-interface como carpeta en el editor e inicia un terminal nuevo allí. El comando de preparación crea una copia del proyecto de ejercicio, no un ZIP descargado, por lo que no crea KIT-VERIFY.cjs.

6. Ejecuta las pruebas existentes:

   node --test --test-concurrency=1 greeting.test.mjs
   

7. Se espera que pasen 2 pruebas de la comprobación inicial. Registra tu resultado real y continúa la investigación y el cambio en Empieza aquí. Si el destino ya existe, consérvalo y elige otro nombre sin usar; la herramienta de preparación se niega deliberadamente a sobrescribirlo.

Para la ruta de escritorio, instala la extensión oficial GitHub Codespaces y sigue las instrucciones para conectarte con VS Code. El acceso a la CLI, las extensiones y las sesiones autenticadas deben comprobarse dentro del entorno remoto, no deducirse a partir de tu portátil.

Detén o elimina de forma deliberada

En tu lista de Codespaces, usa el menú del entorno:

• Stop codespace (Detener codespace) detiene el cómputo, pero conserva los archivos; el almacenamiento sigue contabilizándose.
• Delete (Eliminar) borra el entorno. Primero, tras revisar los archivos, guarda, exporta o haz commit y push del trabajo a tu repositorio autorizado. La eliminación no anula el uso ya consumido.
• Cerrar la pestaña del navegador no detiene el Codespace.

Ayuda oficial: qué es Codespaces, la diferencia respecto a github.dev, pasos de creación, presupuestos, cómo detener y cómo eliminar.

8. Cuenta personal gratuita de Azure: opcional, con condiciones

[!CAUTION] No crees recursos de Azure para superar un laboratorio local. El crédito de Azure no paga una suscripción de Copilot ni GitHub Codespaces. El agente en la nube de GitHub tampoco es un requisito para crear una suscripción de Azure.

La oferta de cuenta gratuita de Azure anuncia US$200 de crédito durante los primeros 30 días, para nuevos clientes que cumplan los requisitos. No son R$200, no es dinero que se te abone ni un beneficio incondicional para todas las cuentas existentes. Normalmente solo hay un beneficio de cuenta gratuita por nuevo cliente.

1. Abre la oferta oficial de cuenta gratuita de Azure y lee las condiciones de elegibilidad y de país o región.
2. Si cumples los requisitos y quieres esta ruta opcional en la nube, selecciona el registro de cuenta gratuita, no una contratación de pago por uso por error. Usa una cuenta personal de Microsoft o la opción compatible de inicio de sesión con GitHub con un correo que controles.
3. Completa las comprobaciones de identidad. La oferta solicita un teléfono y una tarjeta de crédito/débito no prepago donde se admita; Brasil y Hong Kong requieren una tarjeta de crédito para esta oferta. Puede aparecer una autorización temporal equivalente a US$1. Usa datos exactos; no introduzcas una tarjeta de pago en un chat o repositorio.
4. Comprueba la oferta real de la suscripción, el crédito restante y el vencimiento en el portal antes de implementar nada. Si no aparece el beneficio, detente y consulta al proveedor en lugar de suponer que hay crédito.
5. Mantén el límite de gasto de la cuenta gratuita. Microsoft indica que no cobra por esta cuenta gratuita a menos que elijas explícitamente cambiar a pago por uso. Cuando se agota el crédito o terminan los 30 días, los servicios se deshabilitan salvo que decidas cambiar de modalidad; esto no es una instrucción para hacerlo.
6. Si más adelante eliges pago por uso, revisa primero los costes. El límite de gasto del crédito gratuito no está disponible en pago por uso; las alertas de presupuesto no son un tope rígido. Detén o elimina únicamente tus propios recursos del ejercicio después de guardar el trabajo necesario.

Algunos elementos, incluidos ciertos productos de Marketplace y el soporte, están excluidos. Consulta los términos de la oferta, el funcionamiento del límite de gasto y qué cambia al pasar a otra modalidad.

Los estudiantes que cumplan los requisitos pueden consultar, como alternativa, Azure for Students: la oferta publicada es de US$100 durante 12 meses sin tarjeta de crédito, con requisitos propios de edad, institución, matrícula y región. Su elegibilidad no es la misma que la de GitHub Education. Este currículo no garantiza ninguno de los beneficios estudiantiles.

9. Lista final de preparación y solución de problemas

• Elegí un entorno y sé dónde se encuentran los archivos y dónde se ejecutan los procesos.
• Verifiqué mi propia cuenta de GitHub y el plan de Copilot previsto para trabajar con IA en una sesión real.
• El entorno de ejecución elegido se encuentra en el terminal usado para el laboratorio.
• Descargué un kit adecuado, lo extraje en una carpeta nueva y leí sus instrucciones sobre el espacio de trabajo y la comprobación inicial esperada.
• Puedo distinguir un comando de terminal de un prompt de Copilot o un comando de barra.
• Sé que un fallo intencional del proyecto inicial es distinto de la falta de herramientas.
• Revisé las cuotas opcionales de la nube que vaya a usar y sé cómo detener y eliminar mi trabajo.
• Registré un resultado local real, no un mensaje de éxito copiado.

Continúa con tu primer cambio local verificado o elige un ZIP de aventura o laboratorio práctico. Las lecciones completas incluyen investigación, planificación, implementación, un caso negativo, evidencia y restablecimiento seguro.