Saltar a contenido

Instalar Claude Code

Tiempo estimado: 10-15 minutos.

Paso 1: Verifica tu licencia Enterprise

  1. Ve a claude.ai e inicia sesión con tu correo de IPA (@poverty-action.org)
  2. Si ves el logo de IPA o la indicación "Enterprise", estás cubierto
  3. Si no, contacta a support@poverty-action.org para solicitar tu seat

Paso 2: Elige cómo usar Claude Code

Claude Code se puede usar de tres formas. Todas funcionan con tu licencia Enterprise:

Forma Qué es Para quién
Aplicación de escritorio App para Windows/Mac. Interfaz visual, sin terminal. Recomendado para empezar
Terminal (CLI) Línea de comandos. Máxima flexibilidad y poder. Usuarios avanzados
Web (claude.ai/code) Desde el navegador, sin instalar nada. Para probar rápido

¿Cuál usar?

La aplicación de escritorio es la forma más sencilla de empezar. Tiene la misma capacidad que la terminal pero con una interfaz más amigable. El CD de IPA Colombia usa la terminal porque permite automatizar flujos más complejos, pero no es necesario para aprovechar Claude Code.

Antes de instalar: necesitas Git

Tanto la aplicación de escritorio como la terminal requieren Git en tu computador. Si no lo tienes, Claude Code te pedirá instalarlo al abrirlo.

  1. Descarga el instalador desde git-scm.com/downloads/win
  2. Ejecútalo y acepta todas las opciones por defecto (siguiente → siguiente → instalar)
  3. Si ya tenías Claude Code abierto, ciérralo y vuelve a abrirlo

La mayoría de Macs ya lo traen. Si Claude Code lo pide, abre Terminal, ejecuta git --version y macOS te ofrecerá instalar las Command Line Tools automáticamente.

No requiere cuenta de GitHub ni configuración adicional. La opción Web (Opción C) no necesita Git.

Opción A: Aplicación de escritorio (recomendada)

  1. Descárgala desde claude.ai/download (disponible para Windows y Mac)
  2. Instálala con las opciones por defecto
  3. Ábrela e inicia sesión con tu correo @poverty-action.org
  4. Salta al Paso 3

Opción B: Terminal (CLI)

Requiere Node.js (además de Git). Descárgalo desde nodejs.org (versión LTS) e instálalo con las opciones por defecto.

Luego abre una terminal:

Busca Terminal o PowerShell en el menú de inicio

Abre la app Terminal

Ejecuta:

npm install -g @anthropic-ai/claude-code

Verifica que se instaló:

claude --version

Opción C: Web

Ve a claude.ai/code e inicia sesión con tu correo de IPA. No necesitas instalar nada.

Paso 3: Crea tu workspace

Tu workspace es una carpeta en tu computador donde Claude Code guardará contexto y archivos. Puedes crearla donde quieras. Ejemplo:

Al abrir la app, te pedirá elegir una carpeta. Crea una carpeta Claude en tus Documentos y selecciónala.

mkdir -p ~/Documents/Claude
cd ~/Documents/Claude

Paso 4: Crea tu CLAUDE.md

El archivo CLAUDE.md es un archivo de texto que le da contexto a Claude sobre quién eres, qué haces y qué reglas seguir. Piensa en él como una "tarjeta de presentación permanente" que Claude lee cada vez que inicias una conversación. Es lo que hace que Claude te dé respuestas relevantes a tu trabajo en vez de respuestas genéricas.

Para crearlo: abre cualquier editor de texto (Notepad, TextEdit), escribe el contenido, y guárdalo en tu carpeta de workspace con el nombre exacto CLAUDE.md.

Puedes usar la plantilla CLAUDE.md starter como punto de partida. Lo mínimo es:

# Mi Workspace — Claude Code

## Quién soy
- Nombre: [Tu nombre]
- Rol: [Tu cargo], IPA Colombia
- Zona horaria: America/Bogota

## Mi trabajo principal
- [Responsabilidad 1]
- [Responsabilidad 2]
- [Responsabilidad 3]

## Reglas
- No incluir datos de participantes de investigación
- No incluir evaluaciones de desempeño sin aprobación MIST

Paso 5: Tu primera conversación

Abre la app y asegúrate de que tu workspace esté seleccionado. Claude leerá tu CLAUDE.md automáticamente.

cd ~/Documents/Claude
claude

La primera vez te pedirá autenticarte con tu cuenta de IPA.

Prueba algo concreto:

Ejemplos de prompts para empezar

  • "Tengo una reunión mañana con [aliado]. Ayúdame a preparar 5 talking points sobre [tema]."
  • "Necesito escribir un email a [persona] agradeciendo su participación en [evento]."
  • "Lee este documento y hazme un resumen ejecutivo de una página."

Problemas comunes

Problema Solución
No encuentro la app de escritorio Descárgala desde claude.ai/download
Claude Code me pide instalar Git Descarga Git desde git-scm.com/downloads/win (Windows) con opciones por defecto, cierra y reabre Claude Code. En Mac, ejecuta git --version en Terminal.
npm: command not found (solo terminal) Node.js no se instaló correctamente. Reinicia la terminal e intenta de nuevo.
claude: command not found (solo terminal) Ejecuta npm install -g @anthropic-ai/claude-code de nuevo.
Error de autenticación Verifica que estás usando tu correo @poverty-action.org.

Para problemas técnicos, la documentación oficial está en docs.anthropic.com.

Siguiente paso: Qué puedo y qué no puedo hacer