Claude Code en la terminal (CLI): cuándo rinde más que el editor

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Homebrew (macOS): no se actualiza solo, usa brew upgrade claude-code
brew install --cask claude-code

# Con npm (requiere Node.js 22+): también funciona
npm install -g @anthropic-ai/claude-code

# Verifica la instalación
claude --version

# Primer arranque: se abre la autorización en el navegador
claude

cd mi-proyecto/
claude
# Se abre un chat completo dentro de la terminal

# Hace la pregunta y muestra la respuesta de inmediato
claude -p "Escribe una función en Python que calcule el IVA"

# Elegimos el modelo
claude -p --model haiku "Necesito una respuesta rápida"

# Limitamos el presupuesto
claude -p --max-budget-usd 0.10 "Revisa este código"

# Analizamos un archivo
cat server.log | claude -p "Encuentra los errores y explica sus causas"

# Analizamos código
cat app.py | claude -p "Encuentra posibles bugs en este código"

# Analizamos la salida de otro comando
git diff HEAD~3 | claude -p "Escribe un changelog para estos cambios"

# Datos desde un JSON
curl -s api.example.com/data.json | claude -p "Encuentra anomalías en los datos"

# Claude lee el archivo y responde la pregunta
claude -p "¿Qué hace este código?" < main.py

# Varios archivos a través de un archivo temporal
cat requirements.txt Dockerfile > /tmp/context.txt
claude -p "¿Hay conflictos de versiones?" < /tmp/context.txt

#!/usr/bin/env bash
# daily-code-review.sh: corre cada mañana a las 09:00

cd ~/proyecto/

# Reunimos los cambios de ayer
CHANGES=$(git log --since="1 day ago" --oneline)

if [ -z "$CHANGES" ]; then
  echo "No hubo cambios"
  exit 0
fi

# Se los mandamos a Claude para que los analice
SUMMARY=$(echo "$CHANGES" | claude -p "
Analiza estos commits de git de ayer.
Destaca: los cambios principales, los posibles riesgos y qué conviene probar.
Formato: viñetas breves, no más de 200 palabras.
")

# Enviamos el resumen a un chat de Telegram (puedes cambiarlo por Slack, correo u otro canal)
curl -s -X POST "https://api.telegram.org/bot${BOT_TOKEN}/sendMessage" \
  --data-urlencode "chat_id=${CHAT_ID}" \
  --data-urlencode "text=📊 Resumen de ayer:\n${SUMMARY}"

#!/usr/bin/env bash
# generate-docs.sh

for file in src/**/*.py; do
  echo "Documentando: $file"
  
  # Generamos un docstring para cada función
  # (trabaja en una rama de git aparte y revisa git diff: el modelo puede agregar texto de más)
  DOCS=$(cat "$file" | claude -p "
  Agrega docstrings detallados a todas las funciones de este archivo de Python.
  Formato: Google Style. Devuelve solo el código con los docstrings agregados.
  ")
  
  # Sobrescribimos el archivo
  echo "$DOCS" > "$file"
done

echo "¡Documentación actualizada!"

#!/usr/bin/env bash
# pre-commit-review.sh (puedes agregarlo en .git/hooks/pre-commit)

STAGED=$(git diff --cached)

if [ -z "$STAGED" ]; then
  exit 0
fi

REVIEW=$(echo "$STAGED" | claude -p "
Eres un revisor de código con experiencia.
Revisa estos cambios en busca de: bugs, problemas de seguridad y malas prácticas.
Si todo está bien, responde PASS.
Si hay problemas, enuméralos brevemente.
")

echo "$REVIEW"

# Si Claude encontró problemas, bloqueamos el commit
if [[ "$REVIEW" != *"PASS"* ]]; then
  echo "❌ La revisión de código encontró problemas. Corrígelos e inténtalo de nuevo."
  exit 1
fi

echo "✅ Revisión de código aprobada"
exit 0

# Creamos una carpeta aparte para la nueva función
git worktree add ../proyecto-feature-X feature/new-payment

# En la carpeta principal: el trabajo actual
cd ~/proyecto/
claude  # Trabajamos en la rama principal

# En la carpeta de al lado: otro Claude
cd ~/proyecto-feature-X/
claude  # El segundo Claude trabaja en la función por su cuenta

# Banderas principales
claude -p "petición"                        # Print mode (sin modo interactivo)
claude -p --model haiku                     # Elegir modelo por alias (sonnet, opus, haiku, fable) o por nombre completo
claude -p --max-budget-usd 0.50             # Tope de costo (solo en print mode)
claude -p --max-turns 3                     # Tope de pasos del agente
claude -p --tools ""                        # Desactivar todas las herramientas integradas (seguridad)
claude -p --output-format json              # Salida en JSON

# Trabajo con el contexto
claude --add-dir ../lib                     # Dar acceso a una carpeta adicional
claude --append-system-prompt "Responde en español"  # Agregar una regla al prompt de sistema (las instrucciones base para la IA)

# Modo autónomo
claude --dangerously-skip-permissions       # Saltar las confirmaciones (para CI)
# ¡Úsalo solo en entornos aislados (Docker, GitHub Actions)!
# Lista completa de banderas: https://code.claude.com/docs/en/cli-reference

# .github/workflows/ai-review.yml
name: AI Code Review

on: [pull_request]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0
      
      - name: Install Claude Code CLI
        run: npm install -g @anthropic-ai/claude-code
      
      - name: Get PR diff
        run: git diff origin/main...HEAD > /tmp/pr-diff.txt
      
      - name: AI Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          # --tools "": el texto del PR no es de confianza (prompt injection), así que Claude solo lee el diff y responde, sin herramientas
          REVIEW=$(cat /tmp/pr-diff.txt | claude -p \
            --tools "" \
            --max-budget-usd 1.00 \
            "Revisa este PR en busca de bugs y problemas de seguridad. Sé breve.")
          echo "## AI Code Review" >> $GITHUB_STEP_SUMMARY
          echo "$REVIEW" >> $GITHUB_STEP_SUMMARY