Guías de Entorno de Desarrollo¶
Esta sección contiene guías detalladas para configurar tu entorno de desarrollo según tu rol tecnológico. Cada guía especifica las herramientas, SDKs y configuraciones necesarias para que Claude Code pueda trabajar de forma efectiva en tu máquina.
¿Por qué son importantes estas guías?¶
Claude Code es un asistente de programación basado en IA que interactúa directamente con tu sistema de archivos, ejecuta comandos y trabaja con tus herramientas de desarrollo. Para que pueda:
- Compilar y ejecutar tu código
- Ejecutar tests automatizados
- Conectar a bases de datos y analizar datos
- Desplegar aplicaciones a diferentes entornos
- Depurar problemas en tiempo real
- Gestionar dependencias y paquetes
...necesita que tengas instaladas las herramientas correctas en tu máquina.
Guías por Rol¶
Desarrollo de Software¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| Backend Developer | Desarrollo de APIs, servicios y lógica de negocio | .NET, Python, Node.js, Go, Java |
| Frontend Developer | Interfaces de usuario y aplicaciones web | React, Vue, Angular, Next.js |
| Full Stack Developer | Desarrollo completo de aplicaciones | Combinación Backend + Frontend |
| Mobile Developer | Aplicaciones móviles nativas y multiplataforma | iOS, Android, Flutter, React Native |
Infraestructura y Operaciones¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| DevOps Engineer | CI/CD, automatización e infraestructura | Docker, Kubernetes, Terraform, Ansible |
| Cloud Architect | Arquitecturas cloud y servicios gestionados | AWS, Azure, GCP |
| SRE / Platform Engineer | Observabilidad, fiabilidad y plataformas | Prometheus, Grafana, ELK, OpenTelemetry |
Datos y Bases de Datos¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| Data Engineer | Pipelines de datos y ETL | Python, Spark, Airflow, dbt |
| DBA / Database Admin | Administración y optimización de BD | PostgreSQL, MySQL, MongoDB, Redis |
| Data Scientist | Análisis de datos y ML | Python, Jupyter, TensorFlow, PyTorch |
Calidad y Seguridad¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| QA Engineer | Testing automatizado y calidad | Playwright, Cypress, Jest, Selenium |
| Security Engineer | Seguridad de aplicaciones e infraestructura | OWASP, Trivy, SonarQube, Vault |
Tecnologías Emergentes¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| AI / Machine Learning | Desarrollo de modelos, LLMs y MLOps | PyTorch, TensorFlow, Hugging Face, Ollama |
| Blockchain / Web3 | Smart contracts y aplicaciones descentralizadas | Solidity, Hardhat, Foundry, ethers.js |
| IoT / Embedded | Sistemas embebidos y hardware | Arduino, ESP32, Raspberry Pi, Zephyr |
| Game Development | Desarrollo de videojuegos | Unity, Unreal Engine, Godot, Bevy |
Automatización y Scripting¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| Scripting / Automatización | Scripts de sistema y automatización | Bash, PowerShell, Python, Make |
| Low-Code / No-Code | Plataformas de desarrollo visual | n8n, Zapier, Retool, Supabase |
Plataformas Enterprise¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| Enterprise Platforms | Desarrollo en plataformas corporativas | Salesforce, SAP, Microsoft 365, ServiceNow |
Lenguajes y Documentación¶
| Rol | Descripción | Tecnologías Principales |
|---|---|---|
| Lenguajes Especializados | Lenguajes funcionales y de nicho | Elixir, Scala, R, Julia, Haskell, F# |
| Technical Writing | Documentación técnica y generadores | MkDocs, Docusaurus, LaTeX, Mermaid |
Configuración Base Común¶
Independientemente de tu rol, necesitarás estas herramientas base:
Sistema Operativo¶
- Windows 10/11 Pro o Enterprise (para Hyper-V/WSL2)
- WSL2 con Ubuntu 22.04+ (recomendado)
- Windows Terminal
- PowerShell 7+
- macOS 12+ (Monterey o superior)
- Homebrew como gestor de paquetes
- Terminal o iTerm2
- Ubuntu 22.04+ / Fedora 38+ / Debian 12+
- Terminal nativa
Herramientas Esenciales¶
# Git - Control de versiones (OBLIGATORIO)
git --version # Debe mostrar 2.40+
# Editor de código
code --version # VS Code recomendado
# Terminal mejorada (Windows)
winget install Microsoft.WindowsTerminal
# Gestor de paquetes (macOS)
brew --version
Configuración de Git¶
# Configuración básica
git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"
git config --global init.defaultBranch main
git config --global core.autocrlf input # Linux/macOS
git config --global core.autocrlf true # Windows
# Credenciales (Windows)
git config --global credential.helper manager
# Credenciales (macOS)
git config --global credential.helper osxkeychain
# SSH Key (recomendado)
ssh-keygen -t ed25519 -C "tu@email.com"
Variables de Entorno¶
Claude Code necesita acceso a ciertas variables de entorno para trabajar correctamente:
# Añadir al PATH las herramientas de desarrollo
# Windows (PowerShell - añadir a $PROFILE)
$env:PATH += ";C:\Program Files\PostgreSQL\16\bin"
$env:PATH += ";C:\Program Files\nodejs"
# Linux/macOS (añadir a ~/.bashrc o ~/.zshrc)
export PATH="$PATH:/usr/local/bin"
export PATH="$PATH:$HOME/.local/bin"
Verificación del Entorno¶
Cada guía incluye un script de verificación que puedes ejecutar para comprobar que tienes todo instalado correctamente:
# Ejemplo: verificar entorno Backend .NET
./verify-environment.ps1 --role backend-dotnet
# Ejemplo: verificar entorno DevOps
./verify-environment.sh --role devops
Recomendaciones Generales¶
1. Mantén las herramientas actualizadas¶
Claude Code funciona mejor con versiones recientes de las herramientas. Actualiza regularmente:
# Windows (winget)
winget upgrade --all
# macOS (Homebrew)
brew update && brew upgrade
# Linux (apt)
sudo apt update && sudo apt upgrade
2. Usa versiones LTS cuando sea posible¶
Para evitar problemas de compatibilidad, usa versiones LTS (Long Term Support):
- Node.js: versión LTS actual (20.x, 22.x)
- .NET: versión LTS (8.x)
- Python: versión estable (3.11+, 3.12+)
- Java: versión LTS (17, 21)
3. Configura gestores de versiones¶
Para trabajar con múltiples versiones de un mismo runtime:
- Node.js: nvm (Node Version Manager)
- Python: pyenv
- Java: SDKMAN
- Ruby: rbenv
- .NET: dotnet SDK side-by-side
4. Documenta tu entorno¶
Mantén un archivo .tool-versions o similar en tus proyectos:
Soporte¶
Si tienes problemas configurando tu entorno:
- Revisa la guía específica de tu rol
- Ejecuta el script de verificación
- Consulta la sección de troubleshooting de cada guía
- Contacta con el equipo de plataforma