🌐 Cross-Platform e Integraciones

VS Code — La Integración Más Madura

A Fuente: code.claude.com/docs/en/vscode

Instalación

# Método 1: VS Code Marketplace
Ctrl+Shift+X → buscar "Claude Code" → Install

# Método 2: Claude Code detecta IDE automáticamente
claude --ide    # si VS Code es el único IDE activo, se conecta solo

Features de la integración

JetBrains — 7+ IDEs Cubiertos

A Fuente: code.claude.com/docs/en/jetbrains · Plugin: JetBrains Marketplace

Instalación

Settings → Plugins → Marketplace → buscar "Claude Code" → Install

IDEs soportados:
  IntelliJ IDEA, PyCharm, WebStorm, GoLand,
  Rider, CLion, PhpStorm

VS Code vs JetBrains — Comparativa

GitHub Actions — Action Oficial

A Repositorio: anthropics/claude-code-action · Fuente: code.claude.com/docs/en/github-actions

Ejecuta el runtime completo de Claude Code dentro de un GitHub Actions runner — sin instalación local, con acceso a archivos del repo, historial git y contexto de diffs.

Setup rápido

# Desde Claude Code en terminal:
/install-github-app
# → Guía para configurar GitHub App y secrets

# Agregar a GitHub Secrets del repositorio:
ANTHROPIC_API_KEY = sk-ant-...  (NUNCA en el YAML)

Caso 1 — Revisión automática de PRs

# .github/workflows/claude-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

permissions:
  contents: read
  pull-requests: write

jobs:
  review:
    runs-on: ubuntu-latest
    timeout-minutes: 15           # ← SIEMPRE definir timeout
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0           # para git diff completo

      - name: Claude Code Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          max_budget_usd: "2.00"   # ← SIEMPRE definir presupuesto
          task: |
            Revisa este PR siguiendo las reglas de CLAUDE.md.
            CRITICAL: credenciales, SQL injection, XSS
            WARNING: funciones >50 líneas, tests sin assertions
            Comenta directamente en el diff con severidad.
          github_token: ${{ secrets.GITHUB_TOKEN }}

Caso 2 — Mantenimiento programado (cron)

# .github/workflows/claude-maintenance.yml
name: Mantenimiento Semanal
on:
  schedule:
    - cron: '0 9 * * MON'         # Lunes 9:00 UTC
  workflow_dispatch:               # Disparable manualmente

permissions:
  contents: write
  pull-requests: write

jobs:
  maintenance:
    runs-on: ubuntu-latest
    timeout-minutes: 30
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          max_budget_usd: "5.00"
          create_pr: true
          task: |
            1. Actualiza dependencias con vulnerabilidades de seguridad
            2. Elimina imports no usados (ruff --select F401)
            3. Regenera el changelog si hay commits nuevos sin documentar
            Crea un PR con todos los cambios. Nunca push directo a main.
          github_token: ${{ secrets.GITHUB_TOKEN }}

Casos reales en producción

AWS Bedrock — Enterprise en AWS

A Claude es el único modelo frontier disponible en los 3 grandes clouds: AWS Bedrock, Google Vertex AI, y Microsoft Azure.

Configuración para Bedrock

# Variables de entorno
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=mi-perfil-enterprise

# Modelo específico de Bedrock
export ANTHROPIC_MODEL=anthropic.claude-sonnet-4-6-20251001-v1:0

# Iniciar Claude Code — usa Bedrock automáticamente
claude

GitHub Actions con Bedrock (OIDC — sin credenciales estáticas)

- name: Configurar credenciales AWS via OIDC
  uses: aws-actions/configure-aws-credentials@v4
  with:
    role-to-assume: arn:aws:iam::123456789:role/ClaudeCodeRole
    aws-region: us-east-1

- name: Claude Code en Bedrock
  uses: anthropics/claude-code-action@v1
  with:
    use_bedrock: true
    aws_region: us-east-1
    task: "Revisa el PR ${{ github.event.pull_request.number }}"
    github_token: ${{ secrets.GITHUB_TOKEN }}

Comparativa de backends cloud

Google Vertex AI y Azure Foundry

Vertex AI (Google Cloud)

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-central1
export ANTHROPIC_VERTEX_PROJECT_ID=mi-proyecto-gcp

# Auth via Application Default Credentials
gcloud auth application-default login
claude  # usa Vertex automáticamente

Caso real: Banco con Bedrock para contratos legales

Docker Headless — Claude Code en Contenedores

B Para pipelines de automatización que corren en containers sin sesión interactiva.

Dockerfile base para Claude Code headless

FROM ubuntu:22.04

RUN apt-get update && apt-get install -y \
    curl git nodejs npm python3 python3-pip \
    && rm -rf /var/lib/apt/lists/*

# Instalar Claude Code CLI
RUN npm install -g @anthropic-ai/claude-code

# Configurar para headless
ENV CLAUDE_CODE_SIMPLE=1
ENV CLAUDE_CODE_SKIP_PROMPT_HISTORY=1

WORKDIR /workspace
COPY . .

CMD ["claude", "-p", "--output-format", "json", \
     "--dangerously-skip-permissions", \
     "Ejecuta las pruebas y reporta resultados"]

El flag --bare para CI de alta velocidad

# --bare: salta auto-discovery de hooks/skills/plugins/MCP/CLAUDE.md
# Solo Bash + file tools, mínimo overhead, arranque más rápido

claude --bare -p "query"

# Para scripts donde cada milisegundo cuenta:
claude --bare -p --output-format json "Analiza esto" | jq '.result'

Niveles de permiso en CI (de más a menos restrictivo)

Anti-patrones en CI

Remote Control — Control desde Cualquier Dispositivo

A Fuente: code.claude.com/docs/en/remote-control · Controla Claude Code en tu máquina desde claude.ai web o app móvil.

Iniciar Remote Control

# Opción 1: Sesión interactiva con Remote Control habilitado
claude --remote-control "Mi Proyecto API"
claude --rc "Mi Proyecto"   # alias --rc

# Opción 2: Modo servidor (sin interfaz local — 24/7)
claude remote-control --name "Servidor de Dev"

# Con prefijo de nombre de sesión personalizado
claude remote-control --remote-control-session-name-prefix "dev-box"
# → Genera nombres como: dev-box-graceful-unicorn

claude.ai/code — Sin instalación local

# Crear sesión en la nube desde el terminal
claude --remote "Fix el bug de autenticación"

# Teleportar sesión web a tu terminal local
claude --teleport    # se conecta a la sesión web más reciente

Comparativa: local vs. web vs. remote control

Background agents con supervisión remota

# Patrón: lanzar agente en background en el servidor,
# supervisar desde móvil via Remote Control

# En el servidor:
claude --bg --rc "Implementa el feature X según specs en JIRA-1234"

# El agente:
# 1. Corre autónomamente en el servidor
# 2. Crea worktrees y trabaja en las tareas
# 3. Tú lo supervisas desde claude.ai en el móvil
# 4. Cuando termina: PR automático en GitHub
# 5. Recibes notificación vía Remote Control

# Monitorear desde otro terminal:
claude agents                    # lista de agentes en background
claude logs <id>               # ver output en tiempo real
claude attach <id>             # adjuntarse a la sesión

✅ Checklist de Producción — Haz clic para marcar