AI
Taller técnico · Parte 1

LLM para Desarrollo
de Software

Cómo usar Claude Code y Claude de forma correcta, entender el costo de los tokens, comparar con otros LLM (incluidos los abiertos) y ver temas avanzados.

Julio 2026
Introducción

Objetivos del taller

1

Claude Code

Usar Claude Code de manera correcta y productiva en tareas reales de desarrollo.

2

Claude en general

Aplicar buenas prácticas al trabajar con Claude en general, más allá del código.

3

Tokens y costo

Entender qué es un token, cómo se traduce en costo, y ubicar a Claude frente a otros LLM.

4

Modelo y effort

Elegir con criterio el modelo y el nivel de esfuerzo (effort) según cada tarea.

Recorrido

Agenda del taller

Parte 1 · Claude y Claude Code

  • Qué es un LLM aplicado a software
  • Familia de modelos Claude
  • Instalación y flujo de Claude Code
  • Buenas prácticas y errores comunes

Parte 2 · Tokens, inteligencia y effort

  • Qué es un token y cómo se cobra
  • Intelligence Index (Artificial Analysis)
  • Niveles de reasoning effort
  • Cómo elegir modelo + effort

Parte 3 · Otros LLM (open weight)

  • Qué significa “open weight”
  • DeepSeek, Qwen, GLM y Kimi
  • Precio y cuándo conviene cada uno
  • ¿Se pueden usar en Claude Code?

Parte 4 · Temas avanzados

  • MCP: conectar herramientas externas
  • Subagentes y arquitectura multi-agente
  • Prompt caching y context editing
  • Seguridad: prompt injection
Fundamentos

¿Qué es un LLM?

Un modelo de lenguaje grande (LLM) es una red entrenada con enormes cantidades de texto y código, que predice el siguiente fragmento de texto (token) más probable dado el contexto.

L

Lee

Analiza archivos, historial de git, errores y documentación como contexto.

E

Escribe

Genera y edita código, tests, commits y documentación.

E

Ejecuta

Corre comandos, tests y builds a través de herramientas (tool use).

I

Itera

Lee el resultado de cada acción y ajusta el siguiente paso, en bucle.

Los modelos

Familia de modelos Claude

ModeloDescripciónPrecio (in/out por MTok)ContextoCuándo usarlo
Claude Fable 5Próxima generación de inteligencia para agentes de largo plazo$10 / $501M tokMáxima capacidad disponible
Claude Opus 4.8Codificación agéntica compleja y trabajo enterprise$5 / $251M tokTareas complejas, razonamiento profundo
Claude Sonnet 5Mejor combinación de velocidad e inteligencia$3 / $15*1M tokUso diario, default en Claude Code
Claude Haiku 4.5El modelo más rápido, inteligencia casi de frontera$1 / $5200K tokAlto volumen, baja latencia, subagentes

*Precio de lanzamiento de Sonnet 5: $2 / $10 hasta el 31 de agosto de 2026.

Claude Code

¿Qué es Claude Code?

Un entorno de codificación agéntico: a diferencia de un chatbot que responde y espera, Claude Code lee archivos, ejecuta comandos, hace cambios y resuelve problemas de forma autónoma mientras vos observás, redirigís o te alejás del teclado.

  • Disponible en terminal, VS Code, JetBrains, app de escritorio y navegador
  • Explora el repo, planifica cambios en varios archivos y los implementa
  • Corre tests, lee errores y vuelve a intentar sin supervisión constante
  • Se conecta a GitHub, MCP servers y otras herramientas del equipo

“Describís lo que querés y Claude figura cómo construirlo. Explora, planifica e implementa.”

Documentación oficial de Claude Code

Claude Code

Instalación y superficies disponibles

Terminal

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

VS Code

Extensión con diffs inline, @-menciones y revisión de planes.

Buscar “Claude Code” en Extensiones

Desktop app

Sesiones en paralelo, revisión visual de diffs, tareas programadas.

claude.ai → pestaña Code

Web

Sin instalación local. Tareas largas desde el navegador o iOS.

claude.ai/code

Claude Code

El flujo recomendado de trabajo

Separar la exploración y planificación de la implementación evita resolver el problema equivocado.

1

Explorar

Modo plan: Claude lee archivos y responde preguntas sin modificar nada.

2

Planificar

Pedile un plan de implementación detallado. Editalo con Ctrl+G si hace falta.

3

Implementar

Salís del modo plan: Claude codea y verifica contra su propio plan.

4

Commitear

Pedile un commit con mensaje descriptivo y, si aplica, un PR.

Buenas prácticas

Dale contexto específico

Claude puede inferir intención, pero no puede leer tu mente. Cuanto más preciso el pedido, menos correcciones necesitás después.

AntesDespués
Ejemplo 1“agregá tests para foo.py”“escribí un test para foo.py que cubra el caso donde el usuario está deslogueado. Evitá mocks.”
Ejemplo 2“arreglá el bug de login”“los usuarios reportan que el login falla tras expirar la sesión. Revisá el flujo en src/auth/, especialmente el refresh de tokens. Escribí un test que reproduzca el bug y después arreglalo.”
Buenas prácticas

CLAUDE.md: memoria persistente del proyecto

Un archivo que Claude Code lee al empezar cada sesión. Ejecutá /init para generar uno a partir de tu repo, y refinalo con el tiempo.

✓ Incluir

  • Comandos de bash que Claude no puede adivinar
  • Reglas de estilo distintas al default del lenguaje
  • Instrucciones de testing y test runner preferido
  • Convenciones de branches y pull requests
  • Decisiones de arquitectura específicas del proyecto

✕ Evitar

  • Cosas que Claude ya puede inferir leyendo el código
  • Documentación larga de APIs (mejor linkearla)
  • Información que cambia con frecuencia
  • Descripciones archivo por archivo del repo
  • Prácticas obvias como “escribí código limpio”
Regla práctica: por cada línea preguntate “¿si la saco, Claude comete un error?”. Si no, sacala.
Buenas prácticas

Dale a Claude una forma de verificar su trabajo

Sin un check que pueda correr, “parece terminado” es la única señal disponible. Con un check, el ciclo se cierra solo: Claude trabaja, corre el check, lee el resultado e itera.

✓

Tests

Correr la suite y pedir que arregle lo que falle.

✓

Build / lint

Un exit code que indica éxito o error de forma objetiva.

✓

Captura de pantalla

Comparar el resultado visual contra un diseño de referencia.

✓

Subagente revisor

Una segunda pasada, en contexto limpio, que audite el diff.

Buenas prácticas

Gestioná el context window

El contexto de Claude guarda toda la conversación: cada mensaje, archivo leído y salida de comando. El rendimiento se degrada a medida que se llena.

/clearResetea el contexto entre tareas no relacionadas.
SubagentesInvestigan en un contexto separado y reportan un resumen.
/rewindRestaura conversación, código o ambos a un checkpoint anterior.
Regla de 2 correccionesSi corregiste lo mismo dos veces, hacé /clear y escribí un mejor prompt inicial.

Señales de que el contexto está saturado

  • Claude “olvida” instrucciones dadas antes
  • Empieza a cometer más errores
  • Repite pasos ya corregidos
  • Mezcla información de tareas distintas
Claude Code

Automatización y escalado

Modo no interactivo

claude -p "prompt"

Para CI, pre-commit hooks o scripts. Salida en JSON para parsear.

Hooks

Scripts en puntos del flujo

Acciones que deben pasar siempre, sin excepción (ej: lint tras cada edit).

Skills

SKILL.md en .claude/skills/

Empaquetan flujos repetibles que el equipo puede compartir e invocar.

Sesiones en paralelo

Worktrees / Agent teams

Varias instancias de Claude trabajando en partes distintas a la vez.

Buenas prácticas

Errores comunes a evitar

PatrónQué pasaCómo arreglarlo
Sesión “cajón de sastre”Empezás una tarea, pedís algo no relacionado, volvés: contexto lleno de ruido./clear entre tareas no relacionadas.
Corregir una y otra vezClaude se equivoca, corregís, sigue mal: contexto contaminado con intentos fallidos.Tras 2 correcciones fallidas: /clear y un prompt inicial mejor.
CLAUDE.md sobrecargadoSi es muy largo, Claude ignora la mitad porque las reglas importantes se pierden.Podarlo sin piedad; convertir en hooks lo que sea posible.
Confiar sin verificarUna implementación que parece correcta pero no cubre casos borde.Siempre dar una forma de verificar: tests, scripts, capturas.
Exploración infinita“Investigá esto” sin acotar: Claude lee cientos de archivos.Acotar el alcance o delegar en un subagente.
Claude en general

Buenas prácticas de prompting

Los mismos principios aplican fuera de Claude Code: en claude.ai, la API o cualquier integración.

Sé claro y específico

Detallá formato, tono, audiencia y restricciones en vez de dar por sentado que Claude las adivina.

Dale ejemplos

Mostrar 2-3 ejemplos de entrada/salida deseada mejora mucho la consistencia.

Pedí razonamiento paso a paso

Para tareas complejas, pedir que piense antes de responder mejora la calidad.

Usá etiquetas XML

Estructurar el prompt con <contexto>, <tarea>, <formato> ayuda a Claude a separar partes.

Especificá extensión y formato

Indicá si querés una lista, una tabla, un párrafo o una extensión máxima.

Iterá el prompt

Tratalo como código: probá, ajustá, y guardá lo que funciona para reusar.

Parte 2

Tokens, inteligencia
y reasoning effort

Cómo se mide y se cobra el uso de un modelo, con datos de Artificial Analysis y de la documentación oficial de Claude.

Tokens

¿Qué es un token?

La unidad mínima de texto que procesa un modelo: no es una palabra ni una letra, sino un fragmento intermedio.

  • En inglés, 1 token ≈ 4 caracteres ≈ ¾ de palabra
  • El input (tu prompt + archivos + historial) y el output (la respuesta) se miden en tokens
  • El “thinking” o razonamiento extendido también consume y se cobra como tokens de salida
  • Los precios de la API se publican en USD por millón de tokens (MTok)
Ejemplo rápido

“Claude Code lee archivos”

≈ 6-7 tokens

Un repo completo leído como contexto puede sumar decenas o cientos de miles de tokens fácilmente.

Costo

Precio de los modelos Claude

Dólares por millón de tokens (API). El output siempre cuesta más que el input.

Input ($/MTok)Output ($/MTok)
Haiku 4.5$1 / $5
Sonnet 5$3 / $15
Opus 4.8$5 / $25
Fable 5$10 / $50
Fuente: platform.claude.com/docs — Pricing (jul. 2026). Sonnet 5 tiene precio de lanzamiento $2/$10 hasta el 31 ago.
Inteligencia

Artificial Analysis Intelligence Index

Índice compuesto (0-100) que promedia 9 evaluaciones en 4 categorías con igual peso: agentes, coding, capacidad general y razonamiento científico.

Claude Fable 5fallback60
GPT-5.6 Solmax59
Grok 4.5high54
GLM-5.2max51
Gemini 3.5 Flash50
MiniMax-M344
DeepSeek V4 Promax44
Kimi K2.644
Muse Spark43
Nemotron 3 Ultra38
Inteligencia y costo

Costo por tarea en el Intelligence Index

Costo promedio ponderado por tarea (input + output + thinking). Más inteligencia suele implicar más tokens generados, no solo precio por token más alto.

DeepSeek V4 Promax$0.04
gpt-oss 120bhigh$0.06
MiniMax-M3$0.12
Nemotron 3 Ultra$0.24
Grok 4.5high$0.31
Kimi K2.6$0.35
GLM-5.2max$0.37
Gemini 3.5 Flash$0.59
GPT-5.6 Solmax$1.04
Claude Fable 5fallback$2.75
Reasoning effort

Niveles de effort en Claude

El parámetro effort controla cuántos tokens usa Claude para responder: pensamiento, texto y llamadas a herramientas.

NivelQué haceCaso de uso típico
lowMáxima eficiencia; ahorro de tokens notable con algo de reducción de capacidad.Tareas simples, alto volumen o subagentes.
mediumEnfoque equilibrado, ahorro moderado de tokens.Tareas agénticas que buscan balance costo/velocidad.
high (default)Capacidad alta. Es el comportamiento si no se cambia el parámetro.Razonamiento complejo, coding difícil, tareas agénticas.
xhighCapacidad extendida para trabajo de largo horizonte.Coding y agentes de más de 30 min, presupuestos de millones de tokens.
maxMáxima capacidad posible, sin límite de gasto de tokens.Problemas realmente de frontera.
Reasoning effort

Más effort = más tokens, más costo, más turnos

Turnos relativos de Claude Sonnet 5 en GDPval-AA

Con effort Max usó ~6x más turnos que con effort Low (niveles intermedios interpolados a modo ilustrativo).

Low1x
Medium1,8x
Highdefault2,8x
Xhigh4,2x
Max6x

23x

más tokens usa un modelo con reasoning effort alto que con effort mínimo (GPT-5, medido por Artificial Analysis).

Misma idea en todos los proveedores: más esfuerzo de razonamiento = más tokens generados = más costo y más latencia.
Fuentes: Artificial Analysis — artículo Claude Sonnet 5 (jun. 2026) y GPT-5 Benchmarks and Analysis.
Guía práctica

Cómo elegir modelo y effort

Tipo de tareaModelo sugeridoEffort sugerido
Subagentes, clasificación, lookups rápidosClaude Haiku 4.5low
Chat y coding del día a díaClaude Sonnet 5high (default)
Coding agéntico complejo, refactors grandesClaude Opus 4.8xhigh
Tareas de máxima capacidad / fronteraClaude Fable 5high – max
Regla general: empezá en el nivel default de cada modelo, medí con tus propios casos y solo subí el effort cuando los resultados muestren margen de mejora real.
Parte 3

Otros LLM: el panorama
open-weight

DeepSeek, Qwen, GLM y Kimi: qué son, qué tan abiertos son realmente, y cuándo conviene elegir uno sobre Claude.

Otros LLM

¿Qué significa “abierto” en un LLM?

“Open weight” no es lo mismo que “open source”: normalmente se publican los parámetros entrenados, pero no siempre el código ni los datos de entrenamiento.

DimensiónModelos abiertos (DeepSeek, Qwen, GLM, Kimi…)Modelos cerrados (Claude, GPT, Gemini)
Acceso a los pesosDescargables (ej. Hugging Face)No se publican
Self-hostingPosible, con tu propia infraestructuraNo, solo vía API del proveedor
Fine-tuning propioPosible sobre los pesos originalesLimitado a lo que ofrezca el proveedor
Costo por tokenGeneralmente más bajoGeneralmente más alto
Soporte y actualizacionesA tu cargo (o de quien te hostee)Incluido por el proveedor
Licencia típicaMIT / Apache 2.0 (la mayoría)Términos de servicio comerciales
Otros LLM

Panorama de modelos abiertos

ModeloEmpresaLicenciaParámetros (activos)ContextoFortaleza
DeepSeek V4 ProDeepSeekMIT1.6T (49B)1M / 384K outCoding y razonamiento a muy bajo costo
Qwen3-CoderAlibabaApache 2.0480B (35B)256K+Coding agéntico
GLM-5.2Zhipu / Z.aiMIT745B (40B)1M / 128K outCoding y tareas agénticas
Kimi K2.6Moonshot AIMIT modificada*1T (32B)262KCoding de largo horizonte, “agent swarm”

*Kimi K2.6 usa MIT con una cláusula: si tu producto supera 100M de usuarios activos mensuales o USD 20M/mes de ingresos, tenés que mostrar “Kimi K2” en la interfaz. Por debajo de eso, funciona como MIT estándar.

Dato curioso: Alibaba dejó de publicar pesos de su modelo más nuevo (Qwen3.6-Max-Preview), rompiendo con su tradición de abrir todo.
Fuentes: documentación oficial de cada proveedor y OpenRouter (jul. 2026)
Otros LLM

Precio por token: abiertos vs Claude

Dólares por millón de tokens, precio oficial de lista de cada proveedor. Los proveedores externos (OpenRouter, etc.) suelen ofrecer tarifas distintas.

Input ($/MTok)Output ($/MTok)
DeepSeek V4 Pro$0.435 / $0.87
Kimi K2.6$0.60 / $2.50
GLM-5.2$1.40 / $4.40
Claude Sonnet 5$3 / $15
Claude Opus 4.8$5 / $25
Fuentes: API oficiales de DeepSeek, Moonshot AI (Kimi) y Z.ai (GLM); platform.claude.com/docs (jul. 2026)
Otros LLM

Cuándo conviene cada opción

Modelos abiertos

  • Control total de tus datos: podés self-hostear on-prem o en tu propia nube
  • Costo por token mucho menor, sobre todo a gran volumen
  • Podés fine-tunear el modelo sobre tus propios datos
  • Sin dependencia de un solo proveedor comercial

Claude

  • Cero infraestructura propia que mantener o escalar
  • Herramientas maduras: Claude Code, MCP, computer use
  • Soporte, SLA y actualizaciones incluidas por Anthropic
  • Controles de seguridad y cumplimiento a nivel empresarial
Otros LLM

¿Se pueden usar en Claude Code?

Respuesta corta: no de forma nativa. Claude Code está construido y optimizado específicamente para los modelos Claude.

El soporte “de terceros” de Claude Code (Terminal y VS Code) es para exponer los propios modelos Claude a través de Amazon Bedrock, Google Vertex AI, u otro endpoint compatible con la API de Anthropic, no para correr DeepSeek, Qwen o GLM dentro de Claude Code.

Si tu equipo quiere trabajar con un modelo abierto en un flujo agéntico, lo normal es usar la CLI o el plan de coding propio de ese proveedor (por ejemplo, el GLM Coding Plan de Z.ai o el CLI de Kimi), u otra herramienta agnóstica de modelo, no Claude Code.

Parte 4

Temas avanzados

MCP, subagentes, prompt caching y seguridad, para llevar Claude Code más allá del uso básico.

Temas avanzados

MCP: conectar Claude con tus herramientas

Model Context Protocol es un estándar abierto para conectar modelos con datos y herramientas externas: el mismo servidor MCP funciona con distintos clientes.

Claude

⇄

Servidor MCP

⇄

Google Drive

Jira / Linear

Slack

Figma

Bases de datos

Herramientas internas

Instalación: claude mcp add. Fuente: code.claude.com/docs — MCP
Temas avanzados

Subagentes: arquitectura y casos de uso

Corren en su propio contexto, con su propio set de herramientas permitidas, sin ensuciar la conversación principal.

.claude/agents/security-reviewer.md--- name: security-reviewer description: Revisa código en busca de vulnerabilidades de seguridad tools: Read, Grep, Glob, Bash model: opus --- Sos un ingeniero de seguridad senior. Revisá el código en busca de: - Inyección (SQL, XSS, comandos) - Fallas de autenticación - Secretos o credenciales expuestas

Investigador

Explora el codebase en contexto separado y devuelve un resumen.

Revisor adversarial

Audita un diff en contexto limpio, sin el sesgo de haberlo escrito.

Generador de tests

Se especializa en cubrir casos borde sin distraer la sesión principal.

Experto de dominio

Conoce las convenciones de un módulo específico del repo.

Temas avanzados

Prompt caching y context editing

Reutilizar el contexto ya procesado (CLAUDE.md, codebase, ejemplos) evita pagarlo entero en cada turno.

ModeloPrecio base inputEscritura en cachéLectura en caché (hit)
Claude Sonnet 5$3 / MTok$3.75 / MTok (+25%)$0.30 / MTok (−90%)
Claude Opus 4.8$5 / MTok$6.25 / MTok (+25%)$0.50 / MTok (−90%)
La caché tiene un TTL de 5 minutos. Conviene cuando reutilizás el mismo prefijo grande (CLAUDE.md, un codebase completo, ejemplos few-shot) en varios turnos seguidos.

Context editing

Recorta o resume automáticamente resultados viejos de herramientas para que no acumulen espacio en el contexto sin aportar valor a la tarea actual. Complementa a /clear y /compact.

Temas avanzados

Seguridad: prompt injection en agentes

Instrucciones maliciosas escondidas en contenido que el agente lee (una página web, un email, un issue) que el modelo puede confundir con órdenes legítimas del usuario.

Por qué importa más ahora

Un chatbot que solo devuelve texto tiene impacto limitado si lo engañan. Un agente con acceso a herramientas, que puede escribir archivos, mandar mensajes o ejecutar comandos, puede convertir esas instrucciones en acciones reales.

Cómo mitigarlo

  • Tratar todo contenido externo como dato, nunca como instrucción
  • Mínimo privilegio: solo las herramientas y permisos que la tarea necesita
  • Confirmación explícita antes de acciones irreversibles o sensibles
  • Revisar y loguear qué hizo el agente, no solo qué te reportó
Cierre

Resumen del taller

✓Claude Code funciona mejor con un flujo de explorar → planificar → implementar → commitear
✓El contexto es el recurso más importante: gestionalo con /clear, subagentes y CLAUDE.md podado
✓Siempre dale a Claude una forma de verificar su propio trabajo
✓Un token es la unidad de medida y de costo; input y output se cobran distinto
✓El effort controla el trade-off entre calidad, tokens, costo y latencia
✓DeepSeek, Qwen, GLM y Kimi son alternativas abiertas reales: más baratas, pero con la infraestructura a tu cargo
✓MCP y los subagentes extienden a Claude más allá del chat: herramientas externas y trabajo en paralelo
✓El prompt caching y tratar el contenido externo como dato (no instrucción) son higiene básica de producción
Gracias

Preguntas y recursos