Tutorial · Windows 10 e 11 · ~10 minutos

Como conectar o GitHub no seu PC pelo terminal

No fim, o seu computador fica logado no GitHub e o Claude consegue baixar, salvar e enviar projetos por você. As imagens abaixo mostram como cada tela vai aparecer.

Antes de começar

Ter uma conta no GitHub. Se não tiver, crie em github.com/signup.
Estar logado no GitHub no navegador (Chrome ou Edge). Abra github.com e confira se aparece a sua foto no canto superior direito.
Estar no seu usuário do Windows, com internet.
Se o GitHub pedir código no celular (verificação em duas etapas), deixe o celular por perto.

Para colar um comando no terminal: clique em Copiar aqui, vá no terminal, clique com o botão direito (ou Ctrl+V) e aperte Enter.

Abra o PowerShell

Aperte a tecla ⊞ Windows, digite PowerShell e clique no resultado.

🔍 PowerShell

Melhor correspondência

Windows PowerShell
Aplicativo

clique aqui

Vai abrir uma janela azul (ou preta) com texto. É ali que você cola os comandos.

Instale o Git

Cole este comando e aperte Enter:

winget install --id Git.Git -e --source winget

Se perguntar algo sobre termos, digite S (ou Y) e Enter. Se uma janela pedir permissão do Windows, clique em Sim.

Windows PowerShell— ▢ ✕

PS C:\Users\voce> winget install --id Git.Git -e --source winget Encontrado Git [Git.Git] Versão 2.47.1 Baixando https://github.com/git-for-windows/... ██████████████████████████████ 65.2 MB / 65.2 MB Instalado com êxitoespere aparecer isso

Instale o GitHub CLI

É o programa que faz o login. Cole e aperte Enter:

winget install --id GitHub.cli -e --source winget

Espere aparecer Instalado com êxito de novo.

Feche e abra o PowerShell de novo

Clique no ✕ da janela e repita o passo 1. Sem isso, o Windows ainda não "enxerga" o que foi instalado.

Comece o login

gh auth login

Vão aparecer 4 perguntas. Use as setas ↑ ↓ do teclado para escolher e Enter para confirmar. Escolha exatamente o que está marcado:

Windows PowerShell— ▢ ✕

PS C:\Users\voce> gh auth login ? Where do you use GitHub? > GitHub.com1 · Enter Other ? What is your preferred protocol for Git operations? > HTTPS2 · Enter SSH ? Authenticate Git with your GitHub credentials? (Y/n) Y3 · Y e Enter ? How would you like to authenticate GitHub CLI? > Login with a web browser4 · Enter Paste an authentication token ! First copy your one-time code: A1B2-C3D4anote este código Press Enter to open https://github.com/login/device in your browser...

Anote o código de 8 letras e números que aparecer (o seu vai ser diferente do exemplo). Depois aperte Enter: o navegador abre sozinho. Não feche o PowerShell.

Autorize no navegador

Na página que abriu, digite o código que você anotou e clique em Continue.

🔒 github.com/login/device

Device Activation

Enter the code displayed on your device

A1B2–C3D4

Continue

Na tela seguinte, clique no botão verde Authorize github. Se pedir senha ou código do celular, confirme.

🔒 github.com/login/device/select_account

Authorize GitHub CLI

GitHub CLI by github wants to access your account

Authorize github

clique aqui

Vai aparecer "Congratulations, you're all set!". Pode fechar a aba e voltar pro PowerShell.

Confira sempre se o endereço é github.com/login/device. Nunca digite esse código em outro site nem mande para ninguém.

Confira se deu certo

O PowerShell já deve mostrar ✓ Logged in as seu-usuário. Para ter certeza, rode:

gh auth status

Windows PowerShell— ▢ ✕

PS C:\Users\voce> gh auth status github.com ✓ Logged in to github.com account seu-usuario (keyring)deu certo - Active account: true - Git operations protocol: https

Coloque seu nome e e-mail no Git

Troque o texto entre aspas pelo seu nome e pelo mesmo e-mail da conta do GitHub. Rode um comando de cada vez:

git config --global user.name "Seu Nome"

git config --global user.email "seu@email.com"

Esses comandos não mostram nada quando dão certo. É normal.

Pronto. Avise o Claude

Abra o Claude Code e escreva:

confira se o GitHub está conectado neste computador

Ele roda o gh auth status e confirma. A partir daí, já consegue baixar e enviar projetos.

Deu erro? Os mais comuns

"winget não é reconhecido como comando"

Abra a Microsoft Store, procure Instalador de Aplicativo (App Installer), clique em Atualizar ou Obter. Depois feche e abra o PowerShell e tente de novo.

"gh não é reconhecido" ou "git não é reconhecido"

Você não fechou o PowerShell depois de instalar (passo 4). Feche, abra de novo e repita o comando. Se continuar, reinicie o computador.

O navegador não abriu sozinho

Abra o Chrome ou Edge e digite o endereço github.com/login/device. Continue do passo 6.

O código expirou ou deu "code expired"

O código vale por 15 minutos. Volte ao PowerShell e rode de novo:

gh auth login

A página pediu para fazer login no GitHub

Você não estava logado no navegador. Faça login com a sua conta e digite o código de novo.