/start-0-7.es

description: "Lesson command"
chapter: "courses/aiagent/lesson02-setup/ch01-environment"
duration: "~15 min"
prerequisites: ["Node.js 18 o superior instalado", "Familiarizado con operaciones de terminal"]
level: "beginner"
tags: ["setup", "claude-code", "cli"]
nonInteractiveMode: incompatible

Lección 0-7: Configuración de Claude Code

Verificar progreso de configuración

**Ejecución automática por IA:** Ejecute `uv run python tools/setup_progress.py show` para mostrar el progreso actual de la configuración.

---

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Instalar Claude Code, completar la autenticación e inicialización del proyecto. Comprender cómo usar los comandos slash y los skills | | Duración | ~15 min | | Requisitos previos | Node.js 18 o superior instalado; familiarizado con operaciones de terminal | | Página del curso | Consulte [Página principal del curso](https://ai-agent.camp/es/course/module-0) en paralelo |

> **Consejo**: Si la IA deja de responder, escriba "por favor continua" o "se detuvo" para reanudar.

---

Qué es Claude Code?

Claude Code es la herramienta CLI oficial de Anthropic. Puede llamar a Claude directamente desde la terminal para editar código, manipular archivos y ejecutar comandos usando lenguaje natural.

Diferencias con Cursor:

• **Cursor**: Usar IA dentro de un editor GUI (chat y edición en línea)
• **Claude Code**: Usar IA desde la terminal (basado en CLI, adecuado para automatización)

Puede tomar las lecciones de este currículo con cualquiera de las dos herramientas.

---

Step 1: Instalación

Instale Claude Code globalmente via npm.

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

Después de la instalación, verifique la versión:

claude --version

**Configuración de AskQuestion:**

{
  "title": "Step 1: Instalacion",
  "questions": [{
    "id": "install_status",
    "prompt": "Cual es el estado de su instalacion de Claude Code?",
    "options": [
      {"id": "not_installed", "label": "Instalar ahora (ejecutar el comando anterior)"},
      {"id": "already_installed", "label": "Ya esta instalado"},
      {"id": "error", "label": "Obtuve un error durante la instalacion"}
    ]
  }]
}

(not_installed -> Ejecutar `npm install -g @anthropic-ai/claude-code` y verificar el resultado) (already_installed -> Ir al Step 2) (error -> Verificar si Node.js es 18+ con `node --version`. Guiar para limpiar cache de npm con `npm cache clean --force`)

---

Step 2: Autenticación (Inicio de sesión OAuth)

Claude Code inicia automáticamente el flujo de autenticación en el primer inicio. Ejecutar el siguiente comando abrirá su navegador:

claude

Inicie sesión en su cuenta de Anthropic en el navegador y complete la autenticación.

> **Nota**: Se requiere un plan Claude Pro / Max / Team / Enterprise. El plan gratuito no es compatible. > > **Para autenticar con clave API**: Ejecute `source ./.env` primero (si `ANTHROPIC_API_KEY` está configurada en `.env`), luego inicie `claude`. > > **Para re-autenticar dentro de una sesión**: Escriba `/login` en el chat de Claude Code.

**Configuración de AskQuestion:**

{
  "title": "Step 2: Autenticacion",
  "questions": [{
    "id": "auth_status",
    "prompt": "Cual es el estado de su autenticacion?",
    "options": [
      {"id": "run_auth", "label": "Iniciar autenticacion (ejecutar claude)"},
      {"id": "already_authed", "label": "Ya estoy autenticado"},
      {"id": "api_key", "label": "Quiero autenticar con clave API"},
      {"id": "error", "label": "Obtuve un error durante la autenticacion"}
    ]
  }]
}

(run_auth -> Ejecutar `claude`. El navegador se abre en el primer inicio y comienza el flujo de autenticación) (already_authed -> Ir al Step 3) (api_key -> Guiar para configurar `ANTHROPIC_API_KEY=sk-ant-...` en `.env`, ejecutar `source ./.env`, luego iniciar `claude`) (error -> Verificar estado con `claude auth status` y guiar solución de problemas. Dentro de una sesión, re-autenticar con `/login`)

---

Step 3: Inicialización del proyecto

Inicie `claude` en la raíz del repositorio ai-agent-camp:

cd /path/to/ai-agent-camp
claude

En el primer inicio, Claude Code automáticamente:

1. Lee `CLAUDE.md` para entender la configuración del proyecto 2. Reconoce los comandos bajo `.claude/commands/` 3. Reconoce los skills bajo `skills/`

---

Step 4: Cómo usar los comandos slash

En Claude Code, puede invocar lecciones y utilidades con **`/nombre-del-comando`**.

Cómo iniciar una lección

/start-0-1    -> Verificacion de configuracion del entorno
/start-0-7    -> Esta leccion (Configuracion de Claude Code)
/start-1-1    -> Introduccion a generacion de banners

Comandos de utilidad

/check-setup  -> Verificacion integral del entorno
/overview     -> Vista general del proyecto

> **Consejo**: En Cursor, se ejecutan comandos desde Cmd+Shift+P -> Paleta de Comandos, pero en Claude Code simplemente escriba `/nombre-del-comando` directamente en el chat.

**Configuración de AskQuestion:**

{
  "title": "Step 4: Verificacion de comandos",
  "questions": [{
    "id": "command_check",
    "prompt": "Probemos un comando slash",
    "options": [
      {"id": "try_check", "label": "Probar /check-setup"},
      {"id": "understood", "label": "Entendido, continuar"},
      {"id": "more_info", "label": "Quiero saber mas"}
    ]
  }]
}

(try_check -> Ejecutar el contenido de `/check-setup`) (understood -> Ir al Step 5) (more_info -> Mostrar la lista de archivos bajo `.claude/commands/lesson/` y describir cada comando)

---

Step 5: Comprender el sistema de skills

Los **skills** de Claude Code son modulos especializados para ejecutar tareas específicas. Se almacenan bajo `skills/`.

Diferencias entre skills y comandos slash

| Función | Mecanismo | Ejemplos | |---------|-----------|---------| | **Comandos slash** (`/command`) | Ejecutan archivos en `.claude/c