Claude Code:
De 0 a 100

curl -fsSL https://claude.ai/install.sh | bash

# Verificar instalación
claude --version
# claude 1.x.x  ✓

# Diagnóstico completo
claude doctor
# ✓ Installation type: native
# ✓ Auto-updates: enabled

irm https://claude.ai/install.ps1 | iex
claude --version

wsl --install -d Ubuntu
# Reinicia el PC, luego dentro de Ubuntu:
curl -fsSL https://claude.ai/install.sh | bash

# NUNCA uses sudo con este comando
npm install -g @anthropic-ai/claude-code

# Si ves "command not found":
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

claude
# Abriendo navegador para autenticación...
# ✓ Autenticado como tu@email.com

# Para CI/CD sin navegador:
export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
claude

/help        # Lista todos los comandos
/status      # Modelo activo, permisos, MCPs
/doctor      # Diagnóstico del entorno
/init        # Genera CLAUDE.md para el proyecto
Ctrl+C       # Interrumpir tarea en curso
Ctrl+D       # Salir

# TaskFlow — CLAUDE.md

## Stack técnico
- Frontend: React 18 + TypeScript + Tailwind CSS
- Backend: Node.js 20 + Express + PostgreSQL
- Tests: Jest + React Testing Library

## Comandos esenciales
- npm run dev         → Frontend en localhost:3000
- npm run server      → Backend en localhost:4000
- npm test            → Todos los tests

## Reglas de código
- TypeScript strict mode — siempre
- No usar `any` en TypeScript
- No hardcodear URLs — usar variables de entorno
- No commitear .env

> /plan

> Quiero añadir autenticación con Google OAuth.
  Necesito botón en login, callback endpoint,
  guardar usuario nuevo en DB.

Claude propone:
  1. npm install passport passport-google-oauth20
  2. Crear /server/config/passport.js
  3. Añadir GET /auth/google y /auth/google/callback
  4. Migración: campo googleId en users
  5. Actualizar LoginButton.tsx

¿Apruebo el plan? > sí

# SESIÓN
/help              # Lista todos los comandos
/status            # Modelo activo, permisos, MCPs
/doctor            # Diagnóstico — úsalo cuando algo falla
/init              # Genera CLAUDE.md

# CONTEXTO
/clear             # Limpia historial
/compact           # Resume sin perder el hilo
@archivo.js        # Incluye archivo en contexto
--continue         # Retoma sesión anterior

# MODO NO INTERACTIVO
claude -p "tarea"                     # Ejecuta y sale
claude -p "tarea" --max-budget-usd 2  # Limita gasto
claude -w feature/rama                # Crea worktree

/compact           # Compacta sin perder el hilo
/clear             # Limpia historial completo
claude --continue  # Retoma sesión anterior

# Referenciar solo lo necesario con @
> @src/routes/auth.js
  La función validateToken no maneja TokenExpiredError...

---
name: code-reviewer
description: Revisor experto. Úsalo tras implementar cambios.
tools: Read, Grep, Glob, Bash
model: sonnet
---

Para cada archivo modificado evalúa:
1. Seguridad: inputs sin validar, tokens hardcodeados
2. Rendimiento: queries N+1, bucles innecesarios
3. Tests: cobertura para cambios críticos

Formato — cita archivo + línea:
🔴 CRÍTICO — [problema] → [solución]
🟡 MEJORA  — [problema] → [sugerencia]
✅ OK      — [qué está bien]

claude mcp add --transport stdio github -- npx -y @modelcontextprotocol/server-github

# Token en: https://github.com/settings/tokens/new
# Luego puedes hacer desde Claude Code:
> Lista los últimos 5 PRs abiertos
> Crea un PR de feature/auth a main
> Comenta en el issue #42 que el bug está resuelto

# Terminal 1 — desarrollando una feature
git worktree add ../proyecto-feature-pagos feature/pagos
cd ../proyecto-feature-pagos && claude

# Terminal 2 — bug urgente en paralelo
git worktree add ../proyecto-hotfix hotfix/login-bug
cd ../proyecto-hotfix && claude

# Atajo directo de Claude Code
claude -w feature/nueva-funcionalidad

# Limpiar al terminar
git worktree remove ../proyecto-hotfix

import os, anthropic
from dotenv import load_dotenv

load_dotenv()
client = anthropic.Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))

def call_claude(prompt: str, max_tokens: int = 800) -> str:
    response = client.messages.create(
        model="claude-haiku-4-5-20251001",
        max_tokens=max_tokens,
        messages=[{"role": "user", "content": prompt}]
    )
    return response.content[0].text

from playwright.sync_api import sync_playwright
import time, re

def scrape_google_maps(query="clinica dental Madrid", max_results=10):
    results = []
    with sync_playwright() as p:
        browser = p.chromium.launch(headless=False)
        page = browser.new_page()
        page.goto("https://www.google.com/maps")
        page.locator("input#searchboxinput").fill(query)
        page.keyboard.press("Enter")
        time.sleep(4)

        # Scroll para cargar más resultados
        panel = page.locator("div[role='feed']").first
        for _ in range(5):
            panel.evaluate("el => el.scrollTop += 1500")
            time.sleep(1.5)

        for listing in page.locator("div[role='article']").all()[:max_results]:
            try:
                name = listing.locator("h3").inner_text(timeout=2000).strip()
                listing.click()
                time.sleep(2.5)
                rating_el = page.locator("span[aria-label*='estrellas']").first
                raw = rating_el.get_attribute("aria-label") or ""
                m = re.search(r"(\d[,\.]\d)", raw)
                rating = m.group(1).replace(",", ".") if m else ""
                results.append({"name": name, "rating": rating})
                print(f"✓ {name} — {rating}⭐")
            except: continue
        browser.close()
    return results

from core import call_claude

def generate_message(data: dict) -> str:
    problems = []
    if "baja" in data.get("reputation_problem", ""):
        problems.append(f"rating de {data['rating']} estrellas")
    if data.get("reviews_count", 999) < 50:
        problems.append(f"solo {data['reviews_count']} reseñas")
    if not data.get("has_website"):
        problems.append("no tienen página web")

    prompt = f"""
    Eres experto en marketing dental en España.
    Escribe un email de captación (máx 120 palabras).
    Tono: directo, usa 'vosotros', no parecer spam.
    Objetivo: conseguir una llamada de 10 min.
    Clínica: {data['name']}
    Problemas: {chr(10).join(f'- {p}' for p in problems)}
    """
    return call_claude(prompt, max_tokens=400)

from tools.maps_scraper import scrape_google_maps
from tools.reviews import analyze_reviews
from agents.messaging import generate_message

if __name__ == "__main__":
    clinics = scrape_google_maps("clinica dental Santiago de Compostela")
    for clinic in clinics:
        review = analyze_reviews(clinic)
        if not review.get("is_lead"): continue
        msg = generate_message({**clinic, **review})
        print(f"\n{clinic['name']}\n{msg}")

# Ejecutar:
# source venv/bin/activate && python main.py