🐙 GitHub y repositorios
Lleva tu repositorio local a la nube: crea repos, configura SSH, usa la CLI de gh en la terminal, abre PRs y escribe un README que impresione. GitHub es tu escaparate profesional.
🏗️ Crear repositorio
Web vs. gh CLI — dos caminos hacia el mismo destino
Mediante gh CLI (recomendado)
$ gh repo create meu-projeto --public --clone
$ gh repo create meu-projeto --private --add-readme
$ gh repo create # modo interativo (pergunta tudo)Conectar un repo local existente con GitHub
$ git remote add origin git@github.com:user/repo.git
$ git push -u origin main
$ git remote -v # confirma remote configurado✓ Repo público: ideal para portafolio
- ✓Indexado en Google y en la búsqueda de GitHub
- ✓GitHub Pages gratis e ilimitado
- ✓Los colaboradores externos pueden ayudar
🔒 Repo privado: para proyectos internos
- →Código no expuesto públicamente
- →Los colaboradores necesitan una invitación
- →GitHub Pages requiere un plan de pago (excepto para organizaciones)
📡 Remote y push
Sincronizar lo local con GitHub — el ciclo que repetirás todos los días
Push envía, pull recibe — GitHub es el punto central de sincronización.
$ git push -u origin main # primeiro push + configura tracking
$ git push # pushes seguintes (tracking já configurado)
$ git pull # baixa + mescla mudanças remotas
$ git fetch # baixa SEM mesclar (mais seguro)
$ git remote -v # lista remotes configurados
$ git remote set-url origin URL # muda a URL do remote💡 push --force-with-lease: la forma segura
Nunca uses git push --force en una rama compartida — destruye el trabajo de los demás. Usa --force-with-lease: solo obliga a hacerlo si nadie hizo push antes que tú.
🔑 SSH vs HTTPS
Autentícate una vez y trabaja para siempre sin escribir la contraseña
SSH — recomendado para el uso diario
- ✓Par de claves: la pública queda en GitHub y la privada en tu computadora
- ✓Sin tener que escribir la contraseña en cada push/pull
- ✓URL:
git@github.com:user/repo.git - ✓Funciona perfectamente con Claude Code en automatización
HTTPS — más sencillo de configurar
- →Token personal (PAT) en lugar de contraseña
- →URL:
https://github.com/user/repo.git - →Credential helper almacena en caché el token
- →Más fácil de usar detrás de firewalls corporativos
# 1. Gerar chave
$ ssh-keygen -t ed25519 -C "seu@email.com"
# pressione Enter para aceitar o caminho padrão (~/.ssh/id_ed25519)
# 2. Copiar a chave pública
$ cat ~/.ssh/id_ed25519.pub
# copie todo o output e cole em GitHub → Settings → SSH keys → New SSH key
# 3. Testar conexão
$ ssh -T git@github.com
Hi usuario! You've successfully authenticated, but GitHub does not provide shell access.
# 4. Mudar remote existente de HTTPS para SSH
$ git remote set-url origin git@github.com:user/repo.git⚡ gh CLI
GitHub en la terminal: crea repos, PRs, releases y mucho más sin abrir el navegador
🤖 Claude Code usa gh ampliamente
Al pedirle a Claude Code que cree PRs, verifique CI/CD, haga releases o abra issues, usa gh entre bastidores. Entender los comandos permite auditar lo que se hizo y personalizar el comportamiento.
# Autenticação
$ gh auth login # autentica com GitHub
$ gh auth status # verifica autenticação
# Repositórios
$ gh repo create nome --public --clone # cria e clona
$ gh repo view # detalhes do repo atual
$ gh repo clone user/repo # clona repo
# Pull Requests
$ gh pr create --title "feat: X" --body "Descrição"
$ gh pr list # lista PRs abertos
$ gh pr merge --squash --delete-branch # merge com squash
# Issues
$ gh issue create --title "Bug: X" --label bug
$ gh issue list --label "good first issue"
# Releases
$ gh release create v1.0.0 --generate-notes
$ gh release list
# GitHub Actions / CI
$ gh run list # lista execuções recentes
$ gh run watch # monitora execução em tempo real⚡ Instalar gh CLI
# macOS: brew install gh
# Ubuntu/Debian: sudo apt install gh
# Windows: winget install GitHub.cli
🔀 Pull Requests
Colaboración estructurada — revisión antes del merge
Crear branch + commit + push
git checkout -b feature/nova-funcao
git add . && git commit -m "feat: adiciona nova funcão"
git push -u origin feature/nova-funcaoAbrir el PR mediante la CLI gh
gh pr create \
--title "feat: adiciona nova funcão" \
--body "## O que faz\n- Item 1\n\n## Como testar\n- Passo 1" \
--base mainRevisar, aprobar y fusionar
gh pr review --approve # aprovar
gh pr merge --squash --delete-branch # merge com squash
gh pr checks # verificar CI📖 README eficaz
La primera impresión del proyecto: la diferencia entre que lo ignoren y que le den una estrella
# 🚀 Nome do Projeto
> Uma linha descrevendo o que faz e para quem.
## ✨ O que faz
Lista rápida com os principais benefícios.
## 🛠️ Tecnologias
- Lista de tecnologias usadas
## 🚀 Como usar
```bash
git clone ...
npm install
npm start
```
## 📸 Preview
[screenshot ou GIF aqui]
## 📄 Licença
MIT — veja LICENSE para detalhes.✓ README que funciona
- ✓Primera frase: explica el proyecto en 10 segundos
- ✓Screenshot o GIF en la parte visible sin desplazarse
- ✓Instalación en menos de 3 comandos
- ✓Insignias visuales de estado, licencia y versión
✗ README que aleja
- ✗README vacío o «TODO»
- ✗Sin instrucciones de instalación
- ✗Bloques de texto sin formato
- ✗No actualizado después de los cambios en el proyecto
🤖 Claude Code genera un README
Pide: "Analiza este proyecto y genera un README.md completo con badges, instalación, uso y ejemplos reales." Claude lee el código y genera documentación precisa en segundos.
🎯 Resumen del módulo
Qué aprendiste
- ✓Crear un repositorio mediante gh CLI o la web
- ✓Configurar remote y hacer push/pull
- ✓SSH con ed25519 — autenticación sin contraseña
- ✓gh CLI: repos, PRs, issues, releases
- ✓Flujo completo de Pull Request
- ✓README estructurado que impresiona
Siguiente módulo
Con el repositorio en GitHub, el siguiente paso es publicarlo gratis con GitHub Pages y hacer que tu proyecto esté accesible para todo el mundo en minutos.
Módulo 6.3 — GitHub Pages→