# Claude Code: Preguntas y Recursos del Meetup Santiago

¡Hola a todos!

Bienvenidos a esta nueva entrada donde recopilo las preguntas más frecuentes de la comunidad sobre Claude Code. Si alguna vez te has preguntado cómo empezar, cómo optimizar tu flujo de trabajo, o simplemente quieres saber qué diablos es MCP… ¡estás en el lugar correcto!

Este post nació como material de apoyo para el meetup de Claude Code en Santiago, pero decidí expandirlo para que sirva como referencia para cualquiera que quiera sacarle el máximo provecho a esta herramienta.

## ¿Qué encontrarás aquí?

- Primeros pasos con Claude Code
- Workflows y mejores prácticas
- Optimización de tokens y contexto
- Manejo de proyectos grandes
- Integraciones (Figma, MCP, GitHub)
- Seguridad y privacidad
- Novedades recientes
- Cursos gratuitos para seguir aprendiendo
- Preguntas para el meetup

¡Vamos a ello!

## 1. Primeros pasos

### ¿Cómo empezar a usar Claude Code?

La instalación es desde la terminal. Necesitas Node.js 18+ y una cuenta de Claude (Pro, Max, Team, Enterprise) o créditos en la API.

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

Al ejecutar `claude` por primera vez, se abre el proceso de autenticación. Después, navega a cualquier directorio de proyecto y ejecuta `claude` para empezar.

**Recursos:**
- [Quickstart oficial](https://code.claude.com/docs/en/quickstart)
- [Guía de instalación](https://code.claude.com/docs/en/setup)

### ¿Y si soy principiante en programación?

Claude Code tiene un modo llamado **Learning** que convierte la experiencia en colaborativa. En lugar de solo generar código, Claude te pide que implementes pequeñas piezas tú mismo, marcándolas con `TODO(human)`.

Para activarlo: `/output-style learning`

También existe el modo **Explanatory** que agrega "Insights" educativos mientras trabaja, explicando decisiones de implementación y patrones del codebase.

**Recursos:**
- [Output styles](https://code.claude.com/docs/en/output-styles)

## 2. Workflows y mejores prácticas

### ¿Cómo estructurar flujos de desarrollo end-to-end?

La clave está en usar Claude Code para tareas donde pueda iterar contra un objetivo claro: tests, mocks visuales, o especificaciones.

**Flujo sugerido (TDD):**
1. Pedir a Claude que escriba tests basados en inputs/outputs esperados
2. Verificar que los tests fallen
3. Pedir que implemente el código sin modificar los tests
4. Iterar hasta que todos los tests pasen
5. Commit cuando estés satisfecho

**Para trabajo visual (Figma → Código):**
1. Dar a Claude acceso a screenshots (via MCP Puppeteer o manualmente)
2. Pasar el mock visual (imagen o path)
3. Pedir que implemente, tome screenshots, e itere hasta que coincida

**Recursos:**
- [Best practices for agentic coding](https://www.anthropic.com/engineering/claude-code-best-practices)

**Tips rápidos:**
- **Prompt suggestions:** Claude ahora sugiere prompts mientras escribes. Presiona `Tab` para aceptar o `Enter` para enviar
- **Cambiar modelo:** `Alt+P` (Linux/Windows) u `Option+P` (macOS) para cambiar de modelo mientras escribes
- **Thinking mode:** Viene activado por defecto para Opus 4.5. Configúralo en `/config`

### ¿Cómo configurar contexto por proyecto?

Hay dos formas principales de darle contexto persistente a Claude Code:

**1. CLAUDE.md** — El archivo de memoria del proyecto. Claude lo lee automáticamente al iniciar sesión. Puedes incluir convenciones de código, estructura del proyecto, comandos comunes e instrucciones de resumen para `/compact`.

```markdown
# Proyecto X

## Stack
- React 18 + TypeScript
- PostgreSQL + Prisma

## Convenciones
- Usar functional components
- Tests con Vitest
- Commits en español

## Comandos útiles
- `npm run dev` - desarrollo
- `npm run test` - tests
```

**2. `.claude/rules/`** — Directorio para reglas modulares del proyecto. Útil cuando tienes muchas convenciones y quieres organizarlas en archivos separados (ej: `frontend.md`, `testing.md`, `api.md`). Claude carga todas las reglas automáticamente. Más info en [memory docs](https://code.claude.com/docs/en/memory).

También puedes crear **slash commands** personalizados en `.claude/commands/`:

```bash
echo "Analiza el performance de este código y sugiere 3 optimizaciones:" > .claude/commands/optimize.md
```

Después usas `/project:optimize` en Claude Code.

**Recursos:**
- [Common workflows](https://code.claude.com/docs/en/common-workflows)
- [Slash commands](https://code.claude.com/docs/en/slash-commands)

## 3. Optimización de tokens y contexto

### ¿Cómo evitar perder contexto en sesiones largas?

El problema principal es que cuando el contexto se llena, Claude Code hace un resumen automático (compaction) y puede perder detalles importantes.

**Estrategias:**

1. **Usar `/compact` manualmente** antes de que se llene, con instrucciones específicas:
   ```
   /compact Enfócate en los cambios de código y resultados de tests
   ```

2. **Configurar instrucciones de resumen en CLAUDE.md:**
   ```markdown
   # Summary instructions
   Cuando uses compact, enfócate en:
   - Output de tests
   - Cambios de código
   - Decisiones de arquitectura
   ```

3. **Dividir tareas complejas** en sesiones más pequeñas y enfocadas

4. **Usar subagents** para tareas específicas (cada uno tiene su propio contexto)

5. **Limpiar entre tareas:** `/clear` reinicia el contexto

**Gestión de sesiones:**

- **Named sessions:** Usa `/rename` para nombrar tus sesiones y `/resume <n>` desde la terminal (`claude --resume <n>`) para reanudarlas después
- **`/stats`:** Muestra estadísticas interesantes de tu uso (modelo favorito, gráfico de uso, streak)

### ¿Cuánto cuesta usar Claude Code?

Depende del tipo de suscripción:

| Plan | Precio | Claude Code incluido |
|------|--------|---------------------|
| **Pro** | $20/mes | Sí, con límites de uso |
| **Max** | $100/mes o $200/mes | Sí, con más uso incluido |
| **Team** | $30/usuario/mes | Sí, con seats premium |
| **API** | Pay-as-you-go | Pago por tokens consumidos |

Para usuarios de **API/Console**, el costo promedio reportado es ~$6/desarrollador/día, pero varía según el modelo usado (Opus es más caro que Sonnet/Haiku) y la intensidad de uso.

Usa `/cost` para ver estadísticas de uso de la sesión actual (solo aplica para usuarios de API).

**Recursos:**
- [Manage costs](https://code.claude.com/docs/en/costs)

## 4. Proyectos grandes y código legacy

### ¿Cómo maneja Claude repositorios con múltiples servicios?

Claude Code usa **agentic search** para entender la estructura del proyecto. No requiere que selecciones archivos manualmente — analiza dependencias y estructura de forma autónoma.

Para proyectos muy grandes, puedes trabajar en paralelo usando **git worktrees**:

```bash
git worktree add ../project-feature-a -b feature-a
cd ../project-feature-a
claude
```

Cada worktree tiene su propio estado de archivos aislado, permitiendo múltiples instancias de Claude Code trabajando en paralelo sin interferir.

**Background agents:** Claude Code ahora soporta agentes que corren en segundo plano mientras tú sigues trabajando en otras cosas. Ideal para tareas largas como refactoring o generación de tests.

### ¿Cómo hacer reverse engineering y documentar sistemas existentes?

1. Navega al proyecto y ejecuta `claude`
2. Pregunta: "Explícame este codebase" o "¿Cuál es la arquitectura de este proyecto?"
3. Claude analizará archivos y proporcionará un resumen

Para documentación continua, el equipo de Security de Anthropic recomienda usar Claude para ingerir múltiples fuentes de documentación, crear runbooks en markdown, y guardar estos documentos condensados como contexto para debugging.

### ¿Cómo busca Claude en el codebase?

Claude Code usa **búsqueda agéntica**, no es puramente semántica ni puramente léxica. Claude decide qué archivos examinar basándose en la tarea, ejecuta búsquedas, y profundiza según necesite.

Internamente usa `ripgrep` para búsquedas de texto. Si tienes problemas con búsquedas, instala ripgrep en tu sistema:

```bash
# macOS
brew install ripgrep

# Ubuntu/Debian
sudo apt install ripgrep
```

## 5. Integraciones

### ¿Cómo funciona la integración con Figma?

Hay varias formas:

1. **Copiar/pegar imágenes:** Arrastra un screenshot del diseño directamente a Claude Code
2. **Path de archivo:** "Implementa el diseño en /path/to/mock.png"
3. **MCP con Figma:** Conecta el servidor MCP de Figma para acceso directo a tus archivos de diseño

El workflow recomendado:
1. Alimentar archivos de Figma a Claude Code
2. Configurar loops autónomos donde Claude escribe código, corre tests, e itera
3. Revisar soluciones antes de refinamientos finales

**Recursos:**
- [Connectors directory](https://claude.ai/directory)
- [How Anthropic teams use Claude Code](https://www.anthropic.com/news/how-anthropic-teams-use-claude-code)

### ¿Qué es MCP y cómo se usa?

**Model Context Protocol (MCP)** es un estándar abierto para conectar aplicaciones de IA con sistemas externos. Piensa en MCP como un puerto USB-C para aplicaciones de IA.

Con MCP puedes conectar Claude Code a issue trackers (Jira, Linear, GitHub), bases de datos (PostgreSQL), herramientas de diseño (Figma), servicios de comunicación (Slack, Gmail), y cientos más.

**Configuración básica:**
```bash
# Agregar un servidor MCP
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Listar servidores configurados
claude mcp list

# Ver estado
/mcp
```

**Recursos:**
- [MCP en Claude Code](https://code.claude.com/docs/en/mcp)
- [MCP Overview](https://modelcontextprotocol.io)

### ¿Qué otras integraciones hay disponibles?

**Claude in Chrome (Beta):** Una extensión que te permite controlar tu browser directamente desde Claude Code. Claude puede leer, hacer click y navegar websites junto contigo. Útil para workflows de testing visual y scraping.

Ver más en: [claude.ai/chrome](https://claude.ai/chrome)

**Claude Code in Slack:** Lanzado en diciembre 2025, permite delegar tareas de coding directamente desde threads de Slack. Claude analiza mensajes recientes para determinar el repo correcto, postea actualizaciones de progreso, y comparte links para revisar PRs.

Esto representa un shift importante: los coding assistants están migrando de IDEs hacia herramientas de colaboración donde ya ocurre la comunicación del equipo.

## 6. Seguridad y privacidad

### ¿Cómo se protege la información privada?

**Safeguards de Claude Code:**

1. **Sistema de permisos:** Por defecto es read-only. Pide permiso antes de modificar archivos o ejecutar comandos
2. **Detección de inyección de comandos:** Comandos bash sospechosos requieren aprobación manual
3. **Verificación de confianza:** Primera ejecución en un codebase y nuevos servidores MCP requieren verificación
4. **Blocklist de comandos:** Bloquea comandos riesgosos como `curl` y `wget` por defecto

**Sandboxing:**

Claude Code incluye sandboxing a nivel de OS que proporciona aislamiento de filesystem (solo lectura/escritura en el directorio de trabajo) y aislamiento de red (acceso a internet solo a través de proxy controlado).

Para activar: `/sandbox`

**Privacidad de datos:**

- Los datos se encriptan en tránsito y en reposo
- Por defecto, empleados de Anthropic no pueden acceder a tus conversaciones
- Puedes desactivar el uso de tus datos para entrenamiento en Privacy Settings
- Chats en modo Incognito no se usan para mejorar modelos

**Recursos:**
- [Security](https://code.claude.com/docs/en/security)
- [Claude Code Sandboxing](https://www.anthropic.com/engineering/claude-code-sandboxing)
- [Privacy Center](https://privacy.anthropic.com)

### ¿El código que genera Claude sigue buenas prácticas de seguridad?

Claude está entrenado para seguir buenas prácticas, pero como con cualquier herramienta:

1. **Siempre revisa el código** antes de ejecutar o hacer commit
2. **Usa el sistema de permisos**, no actives "Accept all" para todo
3. **Considera usar VMs** para scripts que interactúan con servicios externos
4. **En producción**, implementa hooks de validación y testing automatizado

## 7. Futuro de Claude Code

### ¿Qué viene próximamente?

Basado en los anuncios recientes:

- **Claude Agent SDK:** El SDK de Claude Code se está expandiendo para construir agentes de propósito general, no solo coding
- **Mejoras en MCP:** Expansión continua del ecosistema de integraciones
- **Claude Code Web:** Ya disponible como research preview — ejecución en sandbox aislado en la nube, sin necesidad de CLI local
- **Tool Search Tool:** Descubrimiento dinámico de herramientas para reducir uso de contexto

### ¿Usaron Claude Code para construir Claude Code?

Sí. Anthropic usa Claude Code extensivamente en su desarrollo interno. El equipo de Product Engineering lo describe como su "first stop" para cualquier tarea de programación.

## 8. Claude vs Competencia

### ¿Por qué elegir Claude Code sobre otras herramientas?

**Diferenciadores clave:**

1. **Terminal-first:** No es otro IDE ni chat window. Trabaja donde ya trabajas
2. **Agnóstico:** No impone workflows específicos. Flexible, scriptable, componible
3. **Unix philosophy:** Diseñado para ser compuesto con otras herramientas
4. **MCP:** Estándar abierto para integraciones (no lock-in)
5. **Transparencia:** Siempre pide permiso, muestra su razonamiento

**Modelos disponibles:**
- Opus 4.5 (más inteligente)
- Sonnet 4.5 (balance)
- Haiku 4.5 (más rápido)

## 9. Novedades: Agent Skills (18 dic 2025)

### ¿Hay planes para mejorar el versionado de skills?

¡Justo ayer Anthropic anunció varias mejoras!

1. **Agent Skills es ahora un estándar abierto** — La especificación está disponible en [agentskills.io](https://agentskills.io), permitiendo portabilidad entre plataformas (incluso fuera de Claude)

2. **Nuevo endpoint `/v1/skills`** — Control programático para versionado y gestión de skills custom. Puedes referenciar "latest" durante desarrollo y fijar versiones específicas para producción

3. **Gestión organizacional** — Administradores de Team y Enterprise pueden gestionar skills desde una ubicación central

4. **Directorio de skills de partners** — Skills preconstruidos de Atlassian (Jira, Trello), Figma, Canva, Stripe, Notion, Zapier y más

5. **Quick-create flow** — Crear skills describiendo lo que quieres en lenguaje natural

**Recursos:**
- [Agent Skills Announcement](https://www.anthropic.com/news/skills)
- [Agent Skills Open Standard](https://agentskills.io)

## 10. Cursos gratuitos para seguir aprendiendo

Si quieres profundizar más en Claude Code, estos cursos gratuitos son un excelente punto de partida:

### Claude Code in Action (Anthropic Academy)
El curso oficial de Anthropic. Cubre desde la arquitectura de coding assistants hasta integraciones avanzadas con MCP y GitHub.

**Lo que aprenderás:**
- Arquitectura de Claude Code y sistema de herramientas
- Gestión de contexto y recursos del proyecto
- Custom commands y automatizaciones
- Integración con GitHub workflows
- Hooks y el SDK de Claude Code

**Prerrequisitos:** Familiaridad con terminal y Git básico

Ver más en: [anthropic.skilljar.com/claude-code-in-action](https://anthropic.skilljar.com/claude-code-in-action)

### Claude Code: Software Engineering with Generative AI Agents (Coursera)

Curso de Vanderbilt University impartido por Dr. Jules White. Este es más extenso (~5 horas) y va desde cero hasta workflows avanzados con múltiples agentes en paralelo.

**Lo que aprenderás:**
- Patrón "Best of N" para generar múltiples versiones de features
- CLAUDE.md files para contexto persistente
- Git worktrees con múltiples instancias de Claude
- Subagents trabajando en paralelo
- Prompting multimodal (de boceto a código)

**Prerrequisitos:** Experiencia básica en desarrollo de software y Git

Ver más en: [coursera.org/learn/claude-code](https://www.coursera.org/learn/claude-code)

### Claude Code: A Highly Agentic Coding Assistant (DeepLearning.AI)

Curso corto (~2 horas) de Anthropic en colaboración con DeepLearning.AI. Muy práctico, con tres proyectos hands-on.

**Proyectos incluidos:**
- Explorar y desarrollar el codebase de un RAG chatbot
- Refactorizar un Jupyter notebook de e-commerce y convertirlo en dashboard
- Crear una web app desde un mockup de Figma

**Lo que aprenderás:**
- CLAUDE.md y gestión de contexto
- Testing, debugging y refactoring
- Git worktrees para desarrollo paralelo
- GitHub integration y hooks
- MCP servers (Playwright, Figma)

**Prerrequisitos:** Familiaridad con Python y Git

Ver más en: [deeplearning.ai/short-courses/claude-code-a-highly-agentic-coding-assistant](https://www.deeplearning.ai/short-courses/claude-code-a-highly-agentic-coding-assistant/)

## 11. Preguntas para el Meetup

Las siguientes preguntas serán respondidas durante el meetup y este post se actualizará con las respuestas:

- ¿Cómo anticipa Anthropic la evolución de agentic systems en mercados con infraestructura fragmentada (LatAm)?
- ¿Cuál será el impacto en el trabajo de ingenieros a mediano/largo plazo?
- ¿Habrá programas de internship para latinoamericanos?
- ¿Cómo se proyecta Claude Code a futuro?
- ¿Cómo ven el desarrollo de software en 5-10 años?
- ¿Cuándo habrá más uso de tokens por semana?

## Recursos adicionales

**Documentación oficial:**
- [Claude Code Overview](https://code.claude.com/docs/en/overview)
- [Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices)
- [Common Workflows](https://code.claude.com/docs/en/common-workflows)

**Directorio de herramientas:**
- [claude.ai/directory](https://claude.ai/directory)

**Comunidad:**
- [Discord - Claude Developers](https://discord.com/invite/6PPFFzqPDZ)
- [GitHub - Claude Code](https://github.com/anthropics/claude-code)

*Post actualizado: 19 de diciembre del 2025*

*¿Tienes más preguntas? Déjalas en los comentarios y las agregaremos al post.*