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.

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
• Guía de instalación

¿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

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

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.

# 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.

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

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
• 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:

   # 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:

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

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:

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:

# 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
• 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:

# 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
• MCP Overview

¿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

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
• Claude Code Sandboxing
• Privacy Center

¿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, 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
• Agent Skills Open Standard

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

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

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

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
• Claude Code Best Practices
• Common Workflows

Directorio de herramientas:

• claude.ai/directory

Comunidad:

• Discord - Claude Developers
• GitHub - Claude Code

Post actualizado: 19 de diciembre del 2025

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