Prepare suas ferramentas, contas e limites de gastos

Objetivo: escolher um ambiente de aprendizagem, instalar somente as ferramentas exigidas por ele e comprovar que você consegue executar uma pequena verificação local antes de iniciar um agente. As orientações sobre produtos e os links oficiais foram verificados em 2026-09-08. Ofertas, preços, modelos e disponibilidade podem mudar; as páginas dos fornecedores indicadas nos links continuam sendo a referência oficial.

Os links externos de download, cadastro e documentação de produtos nesta página abrem em uma nova aba. Mantenha este guia aberto enquanto os segue. Os links internos das lições permanecem nesta aba. No site, use Copiar código em um bloco de comando ou prompt; em um arquivo Markdown, selecione e copie o conteúdo do bloco sem as crases. Nunca cole uma página inteira no terminal.

[!IMPORTANT] O primeiro laboratório local não exige cartão de crédito, Azure, Codespaces, um plano pago do Copilot nem um repositório publicado no GitHub. Uma conta do GitHub e acesso autorizado ao Copilot são necessários para as etapas com IA em uma sessão real, não para os testes locais determinísticos. Criar uma conta não conclui um laboratório.

1. Escolha um fluxo

Para trabalhar com o Copilot em uma sessão real, acrescente as verificações de conta e plano abaixo. Você não precisa dos dois editores nem de ambientes local e de nuvem ao mesmo tempo. Um editor no navegador não é automaticamente um runtime, e o Azure não é o serviço que cobra pelo Codespaces.

2. Crie sua conta pessoal do GitHub

1. Abra a página de cadastro do GitHub.
2. Para este workshop independente, use um endereço de e-mail pessoal que você controla e pretende manter. Essa é uma recomendação de aprendizagem, não uma regra do GitHub que proíbe endereços de trabalho. Não use uma conta emprestada nem contorne as políticas de contas gerenciadas do seu empregador.
3. Siga o fluxo de cadastro, escolha seu nome de usuário e conclua a verificação solicitada. Nunca compartilhe sua senha, seu código de verificação de e-mail ou seus códigos de recuperação com um instrutor ou agente.
4. Verifique seu e-mail seguindo a mensagem do GitHub. Se ela não chegar, confira a pasta de spam e o endereço informado antes de solicitar outra mensagem.
5. Ative a autenticação de dois fatores, de preferência com um aplicativo autenticador ou uma chave de segurança, e guarde os códigos de recuperação em um local privado.
6. Confirme que o menu do seu avatar mostra seu próprio nome de usuário. Use essa conta de forma consistente ao ativar o Copilot e entrar no cliente escolhido.

Ponto de verificação: você consegue entrar na conta, seu e-mail está verificado e você sabe como recuperar o acesso. Sua senha do GitHub não é uma credencial para a linha de comando do Git. Um repositório Git local e um repositório hospedado no GitHub são coisas diferentes; a publicação é opcional e está descrita no guia de downloads.

Ajuda oficial: criar uma conta, verificar o e-mail e configurar a autenticação de dois fatores.

3. Entenda o Copilot Free e os outros planos

GitHub Free é um plano de conta; Copilot Free é um plano de produto de IA. Entrar no GitHub não comprova que o Copilot está habilitado no editor ou na CLI. Comece pela opção gratuita se você atender aos critérios de elegibilidade e ela atender ao exercício.

Esses são preços de referência publicados, não uma cotação de compra. Impostos, elegibilidade, franquias e ofertas podem variar ou mudar. Uma licença da organização não é motivo para comprar uma segunda assinatura pessoal.

Os planos atuais usam GitHub AI Credits para o uso de IA com medição de consumo. Um crédito não equivale a uma pergunta: o consumo depende do modelo e dos tokens. Créditos incluídos e flex, modelos disponíveis, uso pago adicional e políticas organizacionais variam. Não reutilize tabelas antigas de solicitações premium para novas assinaturas; algumas assinaturas anuais existentes permanecem na cobrança legada explicitamente documentada. A documentação atual do Free não publica um valor numérico para a franquia de AI Credits nas páginas verificadas aqui, por isso este guia não inventa um.

1. Leia a comparação oficial dos planos e as opções de compra atuais.
2. Com sua conta pessoal conectada, siga as instruções de ativação do plano. Selecione Free se você atender aos critérios de elegibilidade; não selecione um período de avaliação de plano pago nem faça um upgrade apenas para acompanhar este workshop.
3. Revise os controles de uso e cobrança antes de habilitar uso pago adicional. Copilot, Codespaces e Azure têm franquias e controles separados.
4. Se sua conta for gerenciada, pergunte ao administrador sobre as restrições de acesso; não crie uma segunda conta para contornar políticas.

O Copilot CLI está disponível em todos os planos do Copilot, incluindo o Free, sujeito a limites de uso e às políticas aplicáveis. Isso não torna todos os modelos, operações do agente de nuvem ou integrações com IDEs universalmente disponíveis. Se uma franquia se esgotar, registre o impedimento, continue com os testes locais e retome as etapas com IA quando o acesso estiver disponível; fazer upgrade não é obrigatório.

Estudantes elegíveis podem conferir o Copilot Student. Verificação e ativação são etapas separadas; não presuma que apenas um e-mail acadêmico concede o benefício. Veja também a cobrança individual de IA e a cobrança para organizações.

4. Instale o VS Code Stable ou o Insiders

As edições podem ser executadas lado a lado. O Insiders não é um plano pago do Copilot e não concede permissões extras à conta. Não presuma que instalar extensões ou entrar na conta em uma edição prepara a outra: confira a edição e o perfil que você realmente usa. Stable e Insiders usam serviços diferentes de sincronização de configurações (Settings Sync) por padrão; compartilhá-los é uma escolha explícita.

1. Escolha seu sistema operacional e processador na página de download e siga o instalador. No macOS, mova o aplicativo para Aplicativos.
2. Abra o editor selecionado. Use File > Open Folder (Arquivo > Abrir Pasta) para abrir somente o espaço de trabalho de aprendizagem extraído, não toda a sua pasta pessoal.
3. Revise os arquivos antes de conceder Confiança no Espaço de Trabalho (Workspace Trust). Conceder confiança permite a execução; isso não significa que o código baixado seja seguro.
4. Abra a entrada Copilot/Chat nessa edição e siga o fluxo de entrada do GitHub. Revise o acesso solicitado e confirme o nome de usuário pretendido. Se uma extensão for solicitada, use a do publicador oficial GitHub.
5. Se o comando de terminal não estiver disponível no macOS, abra a Paleta de Comandos e execute Shell Command: Install ‘code’ command in PATH ou o comando correspondente do Insiders. Depois, reabra o terminal.

Para o Stable, execute isto no terminal:

code --version

Para usar o Insiders:

code-insiders --version

Após extrair um kit, entre no espaço de trabalho indicado no guia de primeira execução e use um destes comandos, não ambos:

code .

code-insiders .

Ponto de verificação: a edição pretendida abre a pasta pretendida. Uma solicitação inofensiva e somente de leitura funciona no Copilot se você estiver realizando as etapas em uma sessão real. Use Comece aqui para a primeira sessão guiada de Ask, Plan e Agent. Não conclua que um recurso em versão prévia existe no Stable apenas porque apareceu em uma demonstração do Insiders.

Ajuda oficial: configuração do editor, configuração do Copilot, comandos de terminal e sincronização de configurações (Settings Sync).

5. Instale somente o runtime do laboratório selecionado

Todas as 14 aventuras e o primeiro laboratório prático usam Node 24 nas verificações locais. Para outro kit prático, leia o guia de primeira execução antes de instalar uma segunda linguagem. Não é necessário instalar globalmente um framework de testes para o primeiro exercício de Node.

Após instalar o Node, reabra o terminal e execute:

node --version
npm --version

A versão do Node deve começar com v24.. Uma verificação de versão comprova que o executável foi encontrado; a verificação inicial do laboratório é a próxima etapa. Ao usar o Git, execute também:

git --version

Somente para um kit de C#:

dotnet --list-sdks

Confirme que um SDK do .NET 10 compatível aparece na lista. Somente para Python, selecione o mesmo interpretador no VS Code e no terminal e siga as instruções de ambiente virtual do laboratório de configuração de Python. No Windows, py pode ser o inicializador instalado em vez de python. Não instale pacotes em um ambiente global sem relação com o exercício.

6. Instale o Copilot CLI independente

O Copilot CLI usa o comando copilot. O GitHub CLI usa gh. São produtos diferentes. A antiga extensão gh copilot não é o caminho de instalação ensinado aqui. Escolha um dos instaladores abaixo; não instale todas as variantes. O caminho via npm exige Node 22 ou posterior; este currículo já usa Node 24. Esse requisito de Node pertence ao instalador npm, não a todos os instaladores nativos.

macOS

Se o Homebrew já estiver disponível, use o comando do guia oficial de instalação:

brew install --cask copilot-cli

Se você não usa Homebrew, o caminho via npm abaixo é uma alternativa após instalar o Node. Você não precisa instalar um gerenciador de pacotes apenas para seguir esse caminho.

Windows

Use PowerShell 6 ou posterior; uma instalação atual do PowerShell 7 é uma escolha adequada. Windows PowerShell 5.1 e PowerShell 7 são instalações diferentes. Consulte a instalação do PowerShell, se necessário. Verifique o shell que você abriu:

$PSVersionTable.PSVersion

Com o WinGet disponível:

winget install GitHub.Copilot

Reabra o PowerShell para que ele reconheça o PATH atualizado. Se o WinGet não estiver disponível, siga o caminho de instalação aprovado para sua máquina ou use npm com Node.

Linux ou npm no macOS/Windows

Com o Node disponível, esta é a instalação multiplataforma via npm:

npm install -g @github/copilot

Se a instalação informar um erro de permissão, use uma instalação de Node sob controle do seu usuário ou o método aprovado pelo administrador. Não resolva o problema executando downloads arbitrários como administrador.

Como alternativa no macOS/Linux, baixe o instalador oficial sem executá-lo imediatamente:

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

Abra o arquivo baixado em um editor, confirme a origem oficial e revise os downloads e os caminhos de instalação que ele usa. Somente se você aprovar esse arquivo exato, execute:

bash ./copilot-install.sh

Verifique, autentique-se e comece com segurança

Em um novo terminal:

copilot --version

Depois, entre no espaço de trabalho pretendido do kit extraído e inicie:

copilot

Dentro da sessão interativa do Copilot, não no shell do sistema operacional:

/login

Siga o fluxo pelo navegador ou por código de dispositivo mostrado na sessão, usando a conta do GitHub pretendida. Não cole tokens em arquivos da lição nem em prompts. Após a autenticação, consulte a ajuda da sessão:

/help

Use um prompt somente de leitura antes de permitir alterações:

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.

Ponto de verificação: você tem a versão da CLI, a conta e o espaço de trabalho pretendidos e uma explicação que pode conferir nos arquivos reais. Revise cada solicitação de permissão; não habilite aprovação irrestrita para um exercício de treinamento. Depois, siga o fluxo via CLI no kit extraído. Ask, Plan e Agent descrevem responsabilidades aqui; a CLI não precisa apresentar os mesmos botões, papéis ou transferências entre agentes do VS Code.

Ajuda oficial: instalação da CLI, autenticação da CLI e referência atual dos comandos.

7. Use um Codespace em vez de um runtime local, se for útil

Um GitHub Codespace é um ambiente de desenvolvimento hospedado: um contêiner Linux em uma máquina virtual com arquivos, ferramentas e um terminal. Você pode usar sua interface web do VS Code ou se conectar pelo VS Code para desktop. O código é executado remotamente, não no seu notebook. Você ainda precisa de autorização do Copilot para as etapas com IA em uma sessão real.

Codespaces não é github.dev. O editor leve acessado ao pressionar . em um repositório do GitHub não oferece capacidade de computação nem um terminal integrado para compilar e executar estes laboratórios. Sua documentação atualmente o classifica como versão prévia pública.

Confira a cota antes de criar o ambiente

Horas de núcleo multiplicam o tempo de execução pelo número de núcleos da máquina: 120 horas de núcleo podem significar até 60 horas de execução em uma máquina com 2 núcleos, antes de considerar outros usos ou limites de armazenamento. GB-mês mede o armazenamento ao longo do tempo; não é apenas uma franquia de tamanho de disco. Ambientes pagos por organizações e suas políticas podem ser diferentes.

1. Leia sobre a cobrança atual do Codespaces e confira quem pagará. Sem uma forma de pagamento válida, o uso é bloqueado após o esgotamento da franquia incluída.
2. Se o uso pago estiver habilitado, revise o orçamento e a configuração Stop usage when budget limit is reached (Interromper o uso ao atingir o limite do orçamento). Um alerta de orçamento, por si só, não interrompe os gastos.
3. Revise a configuração do contêiner e o script de configuração deste repositório antes de criar um Codespace. O provisionamento baixa ferramentas e consome recursos; um ZIP local é mais simples se essas ferramentas já estiverem instaladas.

Crie e execute um exercício isolado

1. Abra o repositório do currículo no GitHub.

2. Selecione Code > Codespaces, confira o aviso sobre quem pagará e escolha as opções de criação. Verifique a branch e o tamanho da máquina; use uma máquina pequena disponível e adequada ao exercício selecionado.

3. Crie o Codespace e aguarde o término da configuração. Se a configuração falhar, leia o erro informado; não considere pronto um ambiente criado pela metade.

4. No terminal desse ambiente, a partir da raiz do checkout do currículo, prepare somente o primeiro projeto de exercício em um diretório ainda não utilizado, fora desse checkout:

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

5. Abra /workspaces/aca-01-interface como a pasta no editor e inicie um novo terminal nela. O comando de preparação cria uma cópia do projeto de exercício, não um ZIP baixado, portanto não cria KIT-VERIFY.cjs.

6. Execute os testes existentes:

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

7. Espere que 2 testes da verificação inicial passem. Registre seu resultado real e continue a investigação e a alteração em Comece aqui. Se o destino já existir, preserve-o e escolha outro nome ainda não utilizado; a ferramenta de preparação se recusa deliberadamente a sobrescrevê-lo.

Para o fluxo pelo desktop, instale a extensão oficial GitHub Codespaces e siga as instruções para conectar-se com o VS Code. O acesso à CLI, as extensões e as sessões autenticadas devem ser verificados dentro do ambiente remoto, não presumidos a partir do seu notebook.

Pare ou exclua de forma deliberada

Na sua lista de Codespaces, use o menu do ambiente:

• Stop codespace (Parar codespace) interrompe a computação, mas preserva os arquivos; o armazenamento continua sendo contabilizado.
• Delete (Excluir) remove o ambiente. Primeiro, após revisar os arquivos, salve, exporte ou faça commit e push do trabalho para seu repositório autorizado. A exclusão não anula o uso já consumido.
• Apenas fechar a aba do navegador não para o Codespace.

Ajuda oficial: o que é Codespaces, a diferença em relação ao github.dev, etapas de criação, orçamentos, como parar e como excluir.

8. Conta pessoal gratuita do Azure: opcional, com condições

[!CAUTION] Não crie recursos do Azure para passar em um laboratório local. O crédito do Azure não paga uma assinatura do Copilot nem o GitHub Codespaces. O agente de nuvem do GitHub também não é um requisito para criar uma assinatura do Azure.

A oferta de conta gratuita do Azure anuncia US$200 em crédito nos primeiros 30 dias, para novos clientes elegíveis. Isso não é R$200, não é dinheiro pago a você nem um benefício incondicional para todas as contas existentes. Normalmente, apenas um benefício de conta gratuita está disponível por novo cliente.

1. Abra a oferta oficial de conta gratuita do Azure e leia as condições de elegibilidade e de país/região.
2. Se você atender aos critérios de elegibilidade e quiser esse fluxo opcional de nuvem, selecione o cadastro de conta gratuita; não escolha por engano uma contratação de pagamento conforme o uso. Use uma conta pessoal da Microsoft ou a opção compatível de entrada pelo GitHub com um e-mail que você controla.
3. Conclua as verificações de identidade. A oferta solicita telefone e cartão de crédito/débito não pré-pago onde houver suporte; Brasil e Hong Kong exigem cartão de crédito para essa oferta. Pode aparecer uma autorização temporária equivalente a US$1. Use dados corretos; não informe um cartão de pagamento em um chat ou repositório.
4. Confira a oferta real da assinatura, o crédito restante e a validade no portal antes de implantar qualquer coisa. Se o benefício não aparecer, pare e consulte o fornecedor em vez de presumir que há crédito.
5. Mantenha o limite de gastos da conta gratuita. A Microsoft informa que não cobra dessa conta gratuita a menos que você escolha explicitamente migrar para o pagamento conforme o uso. Quando o crédito ou os 30 dias terminam, os serviços são desabilitados, a menos que você opte pelo upgrade; isto não é uma instrução para fazer upgrade.
6. Se posteriormente optar pelo pagamento conforme o uso, revise os custos primeiro. O limite de gastos do crédito gratuito não está disponível no pagamento conforme o uso; alertas de orçamento não são um teto rígido. Pare ou exclua somente seus próprios recursos do exercício, após salvar o trabalho necessário.

Alguns itens, incluindo determinados produtos do Marketplace e suporte, estão excluídos. Confira os termos da oferta, o funcionamento do limite de gastos e o que muda com o upgrade.

Estudantes elegíveis podem, como alternativa, consultar o Azure for Students: a oferta publicada é de US$100 por 12 meses sem cartão de crédito, com requisitos próprios de idade, instituição, matrícula e região. Sua elegibilidade não é a mesma do GitHub Education. Nenhum dos benefícios estudantis é garantido por este currículo.

9. Checklist final de preparação e solução de problemas

• Selecionei um ambiente e sei onde os arquivos ficam e os processos são executados.
• Verifiquei minha própria conta do GitHub e o plano do Copilot pretendido para trabalhar com IA em uma sessão real.
• Meu runtime selecionado é encontrado no terminal usado para o laboratório.
• Baixei um kit correspondente, extraí seu conteúdo em uma nova pasta e li as instruções sobre o espaço de trabalho e a verificação inicial esperada.
• Consigo distinguir um comando de terminal de um prompt do Copilot ou de um comando de barra.
• Sei que uma falha intencional do projeto inicial é diferente da falta de ferramentas.
• Revisei as cotas de nuvem opcionais que vou usar e sei como parar e remover meu trabalho.
• Registrei um resultado local real, não uma mensagem de sucesso copiada.

Continue para sua primeira alteração local verificada ou escolha um ZIP de aventura ou laboratório prático. As lições completas incluem investigação, planejamento, implementação, um caso negativo, evidências e restauração segura.