9 Unidad 3: Claude Code — Tu JARVIS Potente

Author

Diego Saavedra García

10 🤖 Unidad 3: Claude Code — Tu JARVIS Potente

10.1 “Anthropic construyo JARVIS. Vos lo configuras.”

10.2 🎯 Objetivo

Al terminar esta unidad podrás:

✅ Instalar Claude Code en tu sistema
✅ Configurar Claude Code para tu flujo de trabajo
✅ Usar subagentes para tareas complejas
✅ Integrar con MCP y AGENTS.md
✅ Comparar con OpenCode y elegir según necesidad

10.3 🤖 ¿Qué es Claude Code?

10.3.1 En una frase

Claude Code es el agente de terminal oficial de Anthropic. Diseñado para integrarse profundamente con Claude.

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   CLAUDE CODE                                                                │
│   ═══════════                                                               │
│                                                                              │
│   ┌─────────────┐     ┌─────────────┐     ┌─────────────┐                 │
│   │   TU        │     │   CLAUDE    │     │   ANTHROPIC │                 │
│   │   TERMINAL   │────▶│   CODE      │────▶│   API        │                 │
│   │             │◀────│   (Agente)  │◀────│   (Claude)   │                 │
│   └─────────────┘     └─────────────┘     └─────────────┘                 │
│                                                                              │
│                           1M tokens de contexto                              │
│                           Subagentes nativos                                 │
│                           Integración MCP profunda                            │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

10.3.2 ¿Por qué Claude Code?

Característica	Claude Code	OpenCode
Modelo	Solo Claude	75+ modelos
Contexto	1M tokens	Según modelo
Subagentes	✅ Nativos	❌ No
Integración MCP	✅ Profunda	✅
Debugging	✅ Excelente	⚠️ Bueno
Precio	$20-200/mes	Gratis (BYO)

💡 Cuándo usar cada uno: - OpenCode: Flexibilidad, múltiples modelos, budget limitado - Claude Code: Proyectos complejos, debugging profundo, subagentes

10.4 🔧 Instalación de Claude Code

10.4.1 ⏱️ Timeline

Paso	Descripción	Tiempo	✓
1	Verificar prerrequisitos	2 min	⬜
2	Instalar Claude Code	5 min	⬜
3	Autenticar con Anthropic	5 min	⬜
4	Primera ejecución	2 min	⬜

10.4.2 Paso 1: Verificar Prerrequisitos

Tu tarea: Verificar que tienes Node.js.

Comando a ejecutar:

node --version

Resultado esperado:

v18.x.x o superior

10.4.3 Paso 2: Instalar Claude Code

10.4.3.1 Opción A: Con npm (Recomendado)

Hint: Paquete oficial de Anthropic

Comando parcial: npm install -g @

Completá el comando:

[ESCRIBE AQUÍ]

Resultado esperado:

added X packages in Ys

10.4.3.2 Opción B: Con curl

Comando parcial: curl -fsSL https://downloads.anthropic.com/

Completá:

[ESCRIBE AQUÍ]

10.4.4 Paso 3: Autenticar

Comando:

claude

Resultado esperado:

🔐 Please authenticate with Anthropic
Visit: https://auth.anthropic.com/

Abrí el link en tu navegador
Iniciá sesión con tu cuenta Anthropic
Autorizá el dispositivo
Volvé a la terminal

10.4.5 Paso 4: Verificar Instalación

Comando:

claude --version

Resultado esperado:

X.X.X

10.5 ⚙️ Configuración de Claude Code

10.5.1 Estructura de Archivos

~/.claude/
├── config.json           # Configuración principal
├── projects/            # Proyectos guardados
└── logs/                # Logs de sesiones

~/.config/claude-code/   # Alternativa (Linux)

10.5.2 El archivo config.json

Ubicación: ~/.claude/config.json

Comando para crear:

mkdir -p ~/.claude
touch ~/.claude/config.json

10.5.3 Explicación de Cada Setting

10.5.3.1 1. Modelo

{
  "model": "claude-opus-4-6-20250501"
}

Modelo	Contexto	Mejor Para
`claude-opus-4-6-20250501`	1M tokens	Arquitectura, debugging complejo
`claude-sonnet-4-6-20250501`	200K tokens	Desarrollo diario
`claude-haiku-4-5-20250501`	200K tokens	Tareas rápidas

10.5.3.2 2. Modo de Agente

{
  "agent": {
    "mode": "all"
  }
}

Modo	Significado
`"all"`	Puede ejecutar cualquier acción
`"edit"`	Solo edición de archivos
`"read"`	Solo lectura

10.5.3.3 3. Configuración de Contexto

{
  "context": {
    "maxTokens": 100000,
    "includePatterns": ["src/**/*.ts"],
    "excludePatterns": ["node_modules/**"]
  }
}

Setting	Qué hace
`maxTokens`	Límite de contexto
`includePatterns`	Archivos a incluir
`excludePatterns`	Archivos a excluir

10.5.3.4 4. Permisos de Bash

{
  "permissions": {
    "allow": ["git *", "npm *", "mkdir *"],
    "deny": ["rm -rf *", "sudo *"],
    "ask": ["git push", "git commit"]
  }
}

10.5.3.5 5. AGENTS.md

{
  "agentsMd": "~/.claude/AGENTS.md"
}

Claude Code busca automáticamente AGENTS.md en: 1. ./AGENTS.md (proyecto actual) 2. ~/.claude/AGENTS.md (global)

10.6 🎭 AGENTS.md para Claude Code

10.6.1 Template Específico para Claude Code

# AGENTS.md — [Tu Nombre]

## Mi Perfil
[Tu descripción como desarrollador]

## Reglas de Seguridad
1. Nunca ejecutar comandos destructivos
2. Siempre verificar antes de git push
3. No revelar información sensible

## Estilo de Código
- Lenguaje: [tu lenguaje]
- Nomenclatura: [tu convención]
- Tests: [tu approach]

## Preferencias de Claude
- Explicaciones: [detalladas, concisas]
- Código: [comentado, minimalista]
- Errores: [cómo manejarlos]

10.7 🔄 Subagentes: Tu Equipo de JARVIS

10.7.1 ¿Qué son los Subagentes?

Los subagentes son instancias de Claude que trabajan en paralelo para vos.

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   VOS (Tony)                                                               │
│       │                                                                     │
│       │ "Ejecutá 3 tareas en paralelo"                                      │
│       ▼                                                                     │
│   ┌─────────────────────────────────────────────────────────────────┐      │
│   │                    CLAUDE PRINCIPAL                               │      │
│   │                    (Coordinador)                                 │      │
│   └────────────────┬──────────────────┬────────────────────────────┘      │
│                    │                  │                   │                  │
│        ┌───────────▼───┐   ┌─────────▼────┐   ┌───────▼──────┐           │
│        │ SUBAGENTE 1   │   │ SUBAGENTE 2  │   │ SUBAGENTE 3  │           │
│        │ Testing       │   │ Documentation│   │ Security     │           │
│        └───────┬───────┘   └──────┬───────┘   └───────┬──────┘           │
│                │                  │                   │                    │
│                ▼                  ▼                   ▼                    │
│        ┌──────────────┐   ┌──────────────┐   ┌──────────────┐            │
│        │ 45 tests     │   │ API docs     │   │ 0 vulns      │            │
│        │ passing      │   │ generated    │   │ found        │            │
│        └──────────────┘   └──────────────┘   └──────────────┘            │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

10.7.2 Cómo Lanzar Subagentes

En tu conversación con Claude:

> Necesito que hagas 3 cosas:
> 1. Escribas tests para auth.py
> 2. Documente la API en README.md
> 3. Revises seguridad del login
> 
> Podés usar subagentes para las 3 en paralelo.

Claudewill:

Entendido. Lanzando 3 subagentes en paralelo...
[Subagente 1] Escribiendo tests...
[Subagente 2] Generando documentación...
[Subagente 3] Escaneando vulnerabilidades...

10.8 🔗 Integración con MCP

10.8.1 Configuración MCP

Claude Code soporta MCP nativamente. Configurá en ~/.claude/config.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp-server"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    }
  }
}

10.9 🧪 Lab: Tu Primera Sesión con Claude Code

10.9.1 Objetivo

Ejecutar Claude Code con subagentes.

10.9.2 ⏱️ Timeline

Paso	Descripción	Tiempo	✓
1	Instalar Claude Code	5 min	⬜
2	Crear config.json	5 min	⬜
3	Crear AGENTS.md	10 min	⬜
4	Sesión con subagentes	15 min	⬜

10.9.3 Escenario

Tony tiene 3 misiones simultáneas. Necesita un equipo de JARSIS trabajando en paralelo.

10.9.4 Paso 1: Crear config.json

Archivo: ~/.claude/config.json

{
  "model": "claude-sonnet-4-6-20250501",
  "agent": {
    "mode": "all"
  },
  "context": {
    "maxTokens": 100000,
    "includePatterns": ["**/*.ts", "**/*.js"],
    "excludePatterns": ["node_modules/**", ".git/**"]
  },
  "permissions": {
    "allow": ["git status", "git diff", "npm *", "mkdir *"],
    "deny": ["rm -rf *", "sudo *"],
    "ask": ["git push", "git commit"]
  }
}

10.9.5 Paso 2: Crear AGENTS.md

mkdir -p ~/.claude
touch ~/.claude/AGENTS.md

# AGENTS.md

## Quién Soy
[Tu nombre], desarrollador [tu rol].

## Reglas
1. Tests primero, código después
2. Explicar antes de implementar
3. Verificar antes de commit

## Preferencias
- Lenguaje: TypeScript
- Estilo: código limpio, comentarios en español

10.9.6 Paso 3: Tu Primera Sesión

Comando:

claude

Tu mensaje:

> Soy nuevo con Claude Code. Leé mi AGENTS.md 
> y confirmame qué reglas encontraste.
> Después explicame cómo funcionan los subagentes.

10.10 📊 Comparación: Claude Code vs OpenCode

Aspecto	Claude Code	OpenCode
Modelos	Solo Claude	75+
Precio	$20-200/mes	Gratis (BYO)
Contexto	1M tokens (Opus)	Según modelo
Subagentes	✅ Nativos	❌ No
Debugging	✅ Excelente	⚠️ Bueno
MCP	✅ Profunda	✅
AGENTS.md	✅	✅
Open Source	❌	✅ MIT

10.10.1 Cuándo usar cada uno:

Situación	Herramienta
Budget limitado	OpenCode
Proyecto complejo	Claude Code
Necesitás subagentes	Claude Code
Múltiples modelos	OpenCode
Debugging profundo	Claude Code
Privacidad total	OpenCode

10.11 ✅ Checklist Final

Habilidad	✓
Claude Code instalado	⬜
config.json creado	⬜
AGENTS.md configurado	⬜
Sesión iniciada	⬜
Subagentes entendidos	⬜

10.12 🏆 Logro

“Commander” desbloqueado:

+100 XP
Capacidad de orquestar subagentes
Debugging avanzado disponible

10.13 🔗 Siguiente

¿Listo para la siguiente herramienta?

→ Unidad 4: Gemini CLI — Tu JARVIS Gratis

--- title: "Unidad 3: Claude Code — Tu JARVIS Potente" author: "Diego Saavedra García" description: "Instalación, configuración y dominio de Claude Code - El agente nativo de Anthropic" --- # 🤖 Unidad 3: Claude Code — Tu JARVIS Potente ## "Anthropic construyo JARVIS. Vos lo configuras." --- ## 🎯 Objetivo Al terminar esta unidad podrás: - ✅ **Instalar** Claude Code en tu sistema - ✅ **Configurar** Claude Code para tu flujo de trabajo - ✅ **Usar** subagentes para tareas complejas - ✅ **Integrar** con MCP y AGENTS.md - ✅ **Comparar** con OpenCode y elegir según necesidad --- ## 🤖 ¿Qué es Claude Code? ### En una frase **Claude Code es el agente de terminal oficial de Anthropic. Diseñado para integrarse profundamente con Claude.** ``` ┌──────────────────────────────────────────────────────────────────────────────┐ │ │ │ CLAUDE CODE │ │ ═══════════ │ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ TU │ │ CLAUDE │ │ ANTHROPIC │ │ │ │ TERMINAL │────▶│ CODE │────▶│ API │ │ │ │ │◀────│ (Agente) │◀────│ (Claude) │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ 1M tokens de contexto │ │ Subagentes nativos │ │ Integración MCP profunda │ │ │ └──────────────────────────────────────────────────────────────────────────────┘ ``` ### ¿Por qué Claude Code? | Característica | Claude Code | OpenCode | |----------------|-------------|----------| | **Modelo** | Solo Claude | 75+ modelos | | **Contexto** | 1M tokens | Según modelo | | **Subagentes** | ✅ Nativos | ❌ No | | **Integración MCP** | ✅ Profunda | ✅ | | **Debugging** | ✅ Excelente | ⚠️ Bueno | | **Precio** | $20-200/mes | Gratis (BYO) | > 💡 **Cuándo usar cada uno:** > - **OpenCode:** Flexibilidad, múltiples modelos, budget limitado > - **Claude Code:** Proyectos complejos, debugging profundo, subagentes --- ## 🔧 Instalación de Claude Code ### ⏱️ Timeline | Paso | Descripción | Tiempo | ✓ | |------|-------------|--------|---| | 1 | Verificar prerrequisitos | 2 min | ⬜ | | 2 | Instalar Claude Code | 5 min | ⬜ | | 3 | Autenticar con Anthropic | 5 min | ⬜ | | 4 | Primera ejecución | 2 min | ⬜ | --- ### Paso 1: Verificar Prerrequisitos **Tu tarea:** Verificar que tienes Node.js. **Comando a ejecutar:** ``` node --version ``` **Resultado esperado:** ``` v18.x.x o superior ``` --- ### Paso 2: Instalar Claude Code #### Opción A: Con npm (Recomendado) **Hint:** Paquete oficial de Anthropic **Comando parcial:** `npm install -g @` **Completá el comando:** ``` [ESCRIBE AQUÍ] ``` **Resultado esperado:** ``` added X packages in Ys ``` --- #### Opción B: Con curl **Comando parcial:** `curl -fsSL https://downloads.anthropic.com/` **Completá:** ``` [ESCRIBE AQUÍ] ``` --- ### Paso 3: Autenticar **Comando:** ```bash claude ``` **Resultado esperado:** ``` 🔐 Please authenticate with Anthropic Visit: https://auth.anthropic.com/ ``` 1. Abrí el link en tu navegador 2. Iniciá sesión con tu cuenta Anthropic 3. Autorizá el dispositivo 4. Volvé a la terminal --- ### Paso 4: Verificar Instalación **Comando:** ``` claude --version ``` **Resultado esperado:** ``` X.X.X ``` --- ## ⚙️ Configuración de Claude Code ### Estructura de Archivos ``` ~/.claude/ ├── config.json # Configuración principal ├── projects/ # Proyectos guardados └── logs/ # Logs de sesiones ~/.config/claude-code/ # Alternativa (Linux) ``` --- ### El archivo config.json **Ubicación:** `~/.claude/config.json` **Comando para crear:** ```bash mkdir -p ~/.claude touch ~/.claude/config.json ``` --- ### Explicación de Cada Setting #### 1. Modelo ```json { "model": "claude-opus-4-6-20250501" } ``` | Modelo | Contexto | Mejor Para | |--------|----------|------------| | `claude-opus-4-6-20250501` | 1M tokens | Arquitectura, debugging complejo | | `claude-sonnet-4-6-20250501` | 200K tokens | Desarrollo diario | | `claude-haiku-4-5-20250501` | 200K tokens | Tareas rápidas | --- #### 2. Modo de Agente ```json { "agent": { "mode": "all" } } ``` | Modo | Significado | |------|-------------| | `"all"` | Puede ejecutar cualquier acción | | `"edit"` | Solo edición de archivos | | `"read"` | Solo lectura | --- #### 3. Configuración de Contexto ```json { "context": { "maxTokens": 100000, "includePatterns": ["src/**/*.ts"], "excludePatterns": ["node_modules/**"] } } ``` | Setting | Qué hace | |---------|----------| | `maxTokens` | Límite de contexto | | `includePatterns` | Archivos a incluir | | `excludePatterns` | Archivos a excluir | --- #### 4. Permisos de Bash ```json { "permissions": { "allow": ["git *", "npm *", "mkdir *"], "deny": ["rm -rf *", "sudo *"], "ask": ["git push", "git commit"] } } ``` --- #### 5. AGENTS.md ```json { "agentsMd": "~/.claude/AGENTS.md" } ``` Claude Code busca automáticamente `AGENTS.md` en: 1. `./AGENTS.md` (proyecto actual) 2. `~/.claude/AGENTS.md` (global) --- ## 🎭 AGENTS.md para Claude Code ### Template Específico para Claude Code ```markdown # AGENTS.md — [Tu Nombre] ## Mi Perfil [Tu descripción como desarrollador] ## Reglas de Seguridad 1. Nunca ejecutar comandos destructivos 2. Siempre verificar antes de git push 3. No revelar información sensible ## Estilo de Código - Lenguaje: [tu lenguaje] - Nomenclatura: [tu convención] - Tests: [tu approach] ## Preferencias de Claude - Explicaciones: [detalladas, concisas] - Código: [comentado, minimalista] - Errores: [cómo manejarlos] ``` --- ## 🔄 Subagentes: Tu Equipo de JARVIS ### ¿Qué son los Subagentes? **Los subagentes son instancias de Claude que trabajan en paralelo para vos.** ``` ┌──────────────────────────────────────────────────────────────────────────────┐ │ │ │ VOS (Tony) │ │ │ │ │ │ "Ejecutá 3 tareas en paralelo" │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────────────┐ │ │ │ CLAUDE PRINCIPAL │ │ │ │ (Coordinador) │ │ │ └────────────────┬──────────────────┬────────────────────────────┘ │ │ │ │ │ │ │ ┌───────────▼───┐ ┌─────────▼────┐ ┌───────▼──────┐ │ │ │ SUBAGENTE 1 │ │ SUBAGENTE 2 │ │ SUBAGENTE 3 │ │ │ │ Testing │ │ Documentation│ │ Security │ │ │ └───────┬───────┘ └──────┬───────┘ └───────┬──────┘ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 45 tests │ │ API docs │ │ 0 vulns │ │ │ │ passing │ │ generated │ │ found │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ │ └──────────────────────────────────────────────────────────────────────────────┘ ``` --- ### Cómo Lanzar Subagentes **En tu conversación con Claude:** ``` > Necesito que hagas 3 cosas: > 1. Escribas tests para auth.py > 2. Documente la API en README.md > 3. Revises seguridad del login > > Podés usar subagentes para las 3 en paralelo. ``` **Claudewill:** ``` Entendido. Lanzando 3 subagentes en paralelo... [Subagente 1] Escribiendo tests... [Subagente 2] Generando documentación... [Subagente 3] Escaneando vulnerabilidades... ``` --- ## 🔗 Integración con MCP ### Configuración MCP Claude Code soporta MCP nativamente. Configurá en `~/.claude/config.json`: ```json { "mcpServers": { "context7": { "command": "npx", "args": ["-y", "@context7/mcp-server"] }, "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] }, "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"] } } } ``` --- ## 🧪 Lab: Tu Primera Sesión con Claude Code ### Objetivo Ejecutar Claude Code con subagentes. ### ⏱️ Timeline | Paso | Descripción | Tiempo | ✓ | |------|-------------|--------|---| | 1 | Instalar Claude Code | 5 min | ⬜ | | 2 | Crear config.json | 5 min | ⬜ | | 3 | Crear AGENTS.md | 10 min | ⬜ | | 4 | Sesión con subagentes | 15 min | ⬜ | --- ### Escenario Tony tiene 3 misiones simultáneas. Necesita un equipo de JARSIS trabajando en paralelo. --- ### Paso 1: Crear config.json **Archivo:** `~/.claude/config.json` ```json { "model": "claude-sonnet-4-6-20250501", "agent": { "mode": "all" }, "context": { "maxTokens": 100000, "includePatterns": ["**/*.ts", "**/*.js"], "excludePatterns": ["node_modules/**", ".git/**"] }, "permissions": { "allow": ["git status", "git diff", "npm *", "mkdir *"], "deny": ["rm -rf *", "sudo *"], "ask": ["git push", "git commit"] } } ``` --- ### Paso 2: Crear AGENTS.md ```bash mkdir -p ~/.claude touch ~/.claude/AGENTS.md ``` ```markdown # AGENTS.md ## Quién Soy [Tu nombre], desarrollador [tu rol]. ## Reglas 1. Tests primero, código después 2. Explicar antes de implementar 3. Verificar antes de commit ## Preferencias - Lenguaje: TypeScript - Estilo: código limpio, comentarios en español ``` --- ### Paso 3: Tu Primera Sesión **Comando:** ```bash claude ``` **Tu mensaje:** ``` > Soy nuevo con Claude Code. Leé mi AGENTS.md > y confirmame qué reglas encontraste. > Después explicame cómo funcionan los subagentes. ``` --- ## 📊 Comparación: Claude Code vs OpenCode | Aspecto | Claude Code | OpenCode | |---------|-------------|----------| | **Modelos** | Solo Claude | 75+ | | **Precio** | $20-200/mes | Gratis (BYO) | | **Contexto** | 1M tokens (Opus) | Según modelo | | **Subagentes** | ✅ Nativos | ❌ No | | **Debugging** | ✅ Excelente | ⚠️ Bueno | | **MCP** | ✅ Profunda | ✅ | | **AGENTS.md** | ✅ | ✅ | | **Open Source** | ❌ | ✅ MIT | ### Cuándo usar cada uno: | Situación | Herramienta | |-----------|-------------| | Budget limitado | OpenCode | | Proyecto complejo | Claude Code | | Necesitás subagentes | Claude Code | | Múltiples modelos | OpenCode | | Debugging profundo | Claude Code | | Privacidad total | OpenCode | --- ## ✅ Checklist Final | Habilidad | ✓ | |-----------|---| | Claude Code instalado | ⬜ | | config.json creado | ⬜ | | AGENTS.md configurado | ⬜ | | Sesión iniciada | ⬜ | | Subagentes entendidos | ⬜ | --- ## 🏆 Logro **"Commander"** desbloqueado: - +100 XP - Capacidad de orquestar subagentes - Debugging avanzado disponible --- ## 🔗 Siguiente **¿Listo para la siguiente herramienta?** [→ Unidad 4: Gemini CLI — Tu JARVIS Gratis](../contenido/unidad4-gemini-cli.qmd)