1. Qué es y qué problema resuelve

Claude es una familia de modelos de lenguaje desarrollada por Anthropic y, a la vez, el nombre de las aplicaciones con las que se usan esos modelos ^[1]. Conviene separar desde el principio tres capas, porque casi todas las confusiones vienen de mezclarlas:

El problema que resuelve es amplio: redactar y revisar textos, analizar documentos y datos, programar, investigar con fuentes y, cada vez más, ejecutar tareas de varios pasos por su cuenta. Este tutorial recorre esas capacidades una a una; esta primera lección te da el mapa.

Los modelos actuales

A 25 de octubre de 2026 la gama actual tiene cuatro modelos ^[1]:

Los cuatro aceptan texto e imágenes, son multilingües, usan herramientas, tienen una ventana de contexto de 1M de tokens (aproximadamente 555.000 palabras) y una salida máxima de 128K tokens en la API ^[1]. La recomendación oficial cuando no sabes cuál elegir es empezar por Opus 5.5 y subir a Fable 5.1 solo si Opus 5.5, incluso con esfuerzo alto, no llega ^[1].

Hay modelos anteriores aún disponibles (por ejemplo Opus 5, Sonnet 5 o Haiku 4.5) y otros retirados. La página de deprecaciones indica las fechas de retirada de cada uno ^[2].

Las superficies

• Web: claude.ai en el navegador ^[3].
• Escritorio: Claude Desktop para Mac y Windows ^[3].
• Móvil: app para iOS y Android ^[3].
• Claude Code: agente de programación en la terminal, en IDE como VS Code o JetBrains, en el escritorio y en la web (módulo C) ^[4].
• API: acceso programático para integrar Claude en tus aplicaciones, por ejemplo un backend Spring Boot (módulo E) ^[5].

Los planes

Precios en dólares de EE. UU., sin impuestos, tal como aparecen en la página oficial el 25-10-2026; Anthropic avisa de que precios y planes pueden cambiar ^[6]:

La API se paga aparte, por millón de tokens, y no está incluida en las suscripciones de las apps ^[7]. Los precios de la API están en su propia página ^[8].

2. Cuándo usarla y cuándo NO

Usa este mapa cada vez que una función "no aparece": casi siempre es una cuestión de superficie (por ejemplo, algo que solo existe en escritorio) o de plan (algo que no está en Free).

Elige superficie según la tarea:

• Conversar, redactar o analizar un documento puntual: web o escritorio.
• Trabajar sobre un repositorio de código (Spring Boot, Android): Claude Code.
• Integrar Claude en una aplicación propia o procesar miles de registros: API.
• Consultas rápidas o dictado fuera de la oficina: móvil.

Cuándo NO conviene:

• No uses la suscripción de la app como si fuera la API: son productos distintos y la clave de API se contrata en Console ^[7].
• No elijas el modelo más potente "por si acaso". Más esfuerzo y razonamiento consumen más uso y agotan antes los límites ^[9].
• No tomes este tutorial como fuente de precios o límites definitivos: cambian con frecuencia. Comprueba siempre la página enlazada y la fecha de verificación de la lección.

3. Tutorial paso a paso

Paso 1: entra en Claude

1. Abre claude.ai en el navegador o instala la app de escritorio o la del móvil ^[3].
2. La ayuda indica que debes estar en un país admitido y ser mayor de 18 años ^[3].
3. Escribe una pregunta en la caja de mensaje y envíala. El botón + y la tecla / abren más opciones ^[3].

Paso 2: comprueba y cambia el modelo

1. Pulsa el nombre del modelo junto al botón de enviar.
2. Elige otro modelo de la lista o pulsa More models para ver más.
3. El cambio se aplica desde la siguiente respuesta; puedes hacerlo a mitad de conversación ^[9].

Paso 3: ajusta el esfuerzo

1. Con el menú del modelo abierto, entra en Effort.
2. Elige entre Low, Medium, High, Extra high o Max. El recomendado para cada modelo aparece marcado como Default ^[9].
3. Regla práctica de la propia ayuda: Low y Medium alargan tu cupo; los valores por defecto sirven para el día a día; Max es el más lento ^[9].

En Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1 y Opus 5 el razonamiento ("Thinking") no se puede desactivar en la app ^[9]. Lo verás en detalle en la lección 03.

Paso 4: entiende tus dos límites

Hay dos límites distintos ^[10]:

• Límite de uso: cuánto puedes usar Claude en el tiempo. En los planes de pago hay un límite por sesión que se reinicia cada cinco horas y límites semanales. claude.ai, Claude Code y Claude Desktop comparten el mismo cupo.
• Límite de longitud: cuánto cabe en una conversación (la ventana de contexto). En los planes de pago, los modelos más recientes admiten hasta 1M de tokens y otros 500K o 200K.

Puedes ver tu consumo en Settings > Usage ^[7].

Paso 5: decide tu plan

Usa la tabla del apartado 1 y estas preguntas:

1. ¿Necesitas Claude Code o Proyectos? Entonces, como mínimo, Pro ^[6].
2. ¿Vas a trabajar con datos de tu organización y necesitas administración centralizada? Valora Team o Enterprise y revisa la lección 32.
3. ¿Vas a integrar Claude en una aplicación? Necesitas una cuenta de la API, aparte de cualquier plan.

4. Ejemplo práctico

Contexto: una oficina técnica municipal de ingeniería civil quiere empezar a usar Claude en tres frentes. Así se reparte el trabajo entre modelos y superficies:

Plan: para probar, una persona con Pro cubre la primera y la tercera tarea. La segunda necesita una cuenta de API con su propia facturación. Si después se extiende a todo el departamento con documentación interna, la decisión pasa a Team o Enterprise (lecciones 07 y 32).

Coste: en vez de copiar aquí cifras que caducan, el criterio es comparar en la página de precios de la API el coste por millón de tokens de Haiku 5.5 frente a Opus 5.5 antes de lanzar el procesamiento masivo ^[8].

5. Errores frecuentes y límites conocidos

• Confundir el modelo con la app. "Claude" puede ser la app o el modelo. Cuando algo falle, pregúntate primero en qué capa estás.
• Confundir límite de uso con límite de longitud. Un chat puede llenarse de contexto aunque te quede cupo, y al revés ^[10].
• Pensar que la ventana se amplía. El tamaño de la ventana de tu plan no se puede aumentar; los Proyectos ayudan porque cargan solo lo relevante ^[10].
• Usar siempre esfuerzo Max. Consume más y responde más despacio ^[9].
• Esperar Fable en todos los planes. Fable 5 y 5.1 están en los planes de pago; en Pro y Team Standard se usan con créditos de uso desde el principio ^[11].
• Cambio automático de modelo con Fable. Si un mensaje activa ciertos clasificadores de seguridad, la app lo repite con Opus y mantiene Opus durante esa conversación ^[12].
• Modelos del plan Free. No hay una lista oficial de qué modelos están disponibles en Free: No verificado (NV20).
• Ventana de contexto en Team. Un artículo de ayuda menciona 200K y otro hasta 1M en planes de pago; está registrado como contradicción abierta en research/CONTRADICCIONES.md (A1-18).

6. Ejercicio práctico

Enunciado: prepara una ficha de una página titulada "Mi configuración de Claude" para tu puesto de trabajo.

1. Escribe qué plan tienes (o cuál te correspondería) y por qué.
2. Abre claude.ai, comprueba qué modelo está seleccionado por defecto y qué nivel de esfuerzo aparece como Default.
3. Elige tres tareas reales de tu semana (por ejemplo, revisar un pliego, depurar un servicio Spring Boot, actualizar una hoja de mediciones) y asigna a cada una superficie y modelo con una justificación de una línea.
4. Consulta Settings > Usage y anota cuándo se reinicia tu límite semanal.

Criterio de éxito:

• La ficha distingue explícitamente modelo, superficie y plan.
• Cada una de las tres tareas tiene superficie, modelo y justificación, y al menos una usa un modelo distinto de Opus 5.5 con motivo.
• Has anotado el modelo y el esfuerzo por defecto que ves en tu cuenta.
• Has anotado cuándo se reinicia tu límite semanal.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Models overview (se abre en una pestaña nueva) oficial api-models-overview · consultada el 2026-10-25
2. Model deprecations (se abre en una pestaña nueva) oficial api-model-deprecations · consultada el 2026-10-25
3. Get started with Claude (se abre en una pestaña nueva) oficial sup-get-started-with-claude · consultada el 2026-10-25
4. Claude Code overview (se abre en una pestaña nueva) oficial cc-overview · consultada el 2026-10-25
5. Get started with Claude (API) (se abre en una pestaña nueva) oficial api-get-started · consultada el 2026-10-25
6. Plans & Pricing (se abre en una pestaña nueva) oficial complementaria claude-pricing · consultada el 2026-10-25
7. What is the Pro plan? (se abre en una pestaña nueva) oficial sup-what-is-the-pro-plan · consultada el 2026-10-25
8. Pricing (Claude API) (se abre en una pestaña nueva) oficial api-pricing · consultada el 2026-10-25
9. Change the model, effort, and thinking settings (se abre en una pestaña nueva) oficial sup-change-the-model-effort-and-thinking-setting · consultada el 2026-10-25
10. How do usage and length limits work? (se abre en una pestaña nueva) oficial sup-how-do-usage-and-length-limits-work · consultada el 2026-10-25
11. Claude Fable models on your plan (se abre en una pestaña nueva) oficial sup-claude-fable-models-on-your-plan · consultada el 2026-10-25
12. Why Claude switched models in your conversation with Fable 5 or Fable 5.1 (se abre en una pestaña nueva) oficial sup-why-claude-switched-models-in-your-conversat · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Un prompt es el texto con el que le pides algo a Claude: la instrucción, el contexto, los datos y, si hace falta, ejemplos. El prompt engineering es el oficio de escribirlo para obtener el resultado que buscas a la primera, o con pocas iteraciones.

El problema que resuelve es muy concreto: Claude no conoce tu oficina, tus normas internas ni el formato que espera tu jefe de servicio. La guía oficial lo resume con una imagen: trata a Claude como a un empleado brillante pero recién llegado, que no conoce vuestras normas ni vuestra forma de trabajar ^[1]. Cuanto más preciso seas, mejor resultado.

La referencia viva es la página "Prompting best practices" de la documentación de Anthropic, que reúne en un solo sitio claridad, ejemplos, XML, rol, razonamiento y encadenamiento, con apartados por modelo ^[1]. Aunque está en la documentación de la API, sus técnicas son de redacción y en este tutorial las aplicamos también al chat.

2. Cuándo usarla y cuándo NO

Úsala siempre que:

• El resultado tenga un formato concreto (un informe con apartados fijos, una tabla, un JSON).
• La tarea dependa de documentos largos (pliegos, normativa, memorias).
• Vayas a repetir la misma tarea muchas veces: merece la pena pulir un prompt reutilizable.

Antes de optimizar, define el éxito. La documentación pide tres cosas previas: criterios de éxito claros, una forma empírica de comprobarlos y un primer borrador del prompt ^[2].

Cuándo NO es la solución:

• No todo fallo se arregla con el prompt. A veces conviene cambiar de modelo, por calidad, coste o latencia ^[2].
• Si necesitas información actual o verificable, el prompt no basta: hace falta búsqueda web, documentos aportados o Research (lecciones 03 y 11).
• Si Claude no tiene un dato, ningún prompt lo inventa con seguridad. Las técnicas reducen las alucinaciones pero no las eliminan; la información crítica siempre se valida ^[3].

3. Tutorial paso a paso

Técnica 1: sé claro y directo

• Di exactamente qué quieres, con formato y restricciones.
• Si el orden importa, usa pasos numerados.
• Si quieres más de lo mínimo, pídelo de forma explícita ^[1].

Prueba del colega: enseña tu prompt a un compañero que no conozca la tarea. Si él se confundiría, Claude también ^[1].

Menos eficaz:
Resume este informe.

Más eficaz:
Resume el informe adjunto de inspección de puentes para el concejal de Obras.
Extensión máxima: 200 palabras. Estructura:
1. Estado general (una frase).
2. Tres deficiencias más graves, ordenadas por urgencia.
3. Actuaciones recomendadas y plazo indicado en el informe.
No añadas valoraciones que no estén en el documento.

Técnica 2: explica el porqué

Dar el motivo de una instrucción ayuda a Claude a generalizar ^[1].

Menos eficaz:
No uses siglas.

Más eficaz:
El texto se publicará en la sede electrónica y lo leerán vecinos sin formación técnica,
así que escribe las siglas desarrolladas la primera vez que aparezcan.

Técnica 3: da ejemplos (few-shot)

Los ejemplos son una de las formas más fiables de fijar formato, tono y estructura. Deben ser relevantes, variados y estructurados dentro de etiquetas <example> (varios, dentro de <examples>). La guía recomienda de 3 a 5 ejemplos ^[1].

Clasifica cada aviso ciudadano en una categoría: PAVIMENTO, ALUMBRADO, SEÑALIZACIÓN u OTROS.
Responde solo con la categoría.

<examples>
<example>Aviso: "Hay un socavón en la calle Mayor frente al número 12" → PAVIMENTO</example>
<example>Aviso: "La farola de la plaza lleva tres noches apagada" → ALUMBRADO</example>
<example>Aviso: "Falta la señal de stop en el cruce del polígono" → SEÑALIZACIÓN</example>
<example>Aviso: "Ruido de obras un domingo" → OTROS</example>
</examples>

Aviso: "La tapa de la arqueta está hundida y los coches dan un golpe"

Técnica 4: estructura con etiquetas XML

Cuando el prompt mezcla instrucciones, contexto, ejemplos y datos, envuelve cada parte en su etiqueta (<instructions>, <context>, <input>). Usa nombres coherentes y anida cuando haya jerarquía, por ejemplo <documents> con varios <document index="n"> ^[1].

Técnica 5: asigna un rol

Fijar un rol orienta el comportamiento y el tono; en la API se pone en el prompt de sistema y basta una frase ^[1]. En la app, el equivalente estable son las instrucciones de un Proyecto (lección 04).

Eres un técnico de administración local especializado en contratación de obras públicas.

Técnica 6: documentos largos arriba, pregunta al final

Con documentos o datos de más de unos 20.000 tokens ^[1]:

1. Coloca los documentos al principio del prompt y la pregunta e instrucciones al final. La guía indica mejoras de calidad de hasta un 30 % en sus pruebas, sobre todo con varios documentos.
2. Envuelve cada documento en <document> con subetiquetas <source> y <document_content>.
3. Pide que extraiga primero las citas relevantes y que trabaje a partir de ellas.

Técnica 7: controla el formato de salida

• Di lo que quieres, no lo que no quieres: en lugar de "no uses markdown", pide "responde en párrafos de prosa continua" ^[1].
• Puedes indicar el formato con etiquetas, por ejemplo pedir que la respuesta vaya dentro de <informe>.

Técnica 8: reduce las alucinaciones

La documentación oficial propone ^[3]:

• Permitir explícitamente que Claude diga "no lo sé".
• Pedir citas literales antes de responder y retirar cualquier afirmación que no tenga cita que la respalde.
• Restringir la respuesta a los documentos aportados.

Plantilla reutilizable

<documents>
<document index="1">
<source>{{NOMBRE_DEL_ARCHIVO}}</source>
<document_content>
{{PEGA_AQUÍ_EL_TEXTO}}
</document_content>
</document>
</documents>

<context>
Quién leerá el resultado, para qué se usará y cualquier norma interna aplicable.
</context>

<instructions>
1. Extrae en <citas> los fragmentos literales del documento que necesites.
2. A partir solo de esas citas, redacta {{EL_ENTREGABLE}}.
3. Si el documento no contiene un dato, escribe "No consta en el documento" en lugar de suponerlo.
</instructions>

Formato de salida: {{FORMATO_EXACTO}}.

4. Ejemplo práctico

Caso: documentación técnica de administración pública. Necesitas un borrador del apartado "Justificación de la necesidad" para el expediente de contratación de una obra de renovación de alumbrado, a partir de un informe técnico previo de 40 páginas.

Primer intento (flojo):

Escríbeme la justificación de la necesidad para el contrato de alumbrado.

Resultado típico: un texto genérico, con datos que no están en tu informe y sin el tono administrativo esperado.

Prompt mejorado:

<documents>
<document index="1">
<source>informe_tecnico_alumbrado_barrio_norte.pdf</source>
<document_content>
[texto del informe]
</document_content>
</document>
</documents>

<context>
Redacto un expediente de contratación de obra en un ayuntamiento. El texto lo revisará
la Secretaría y debe tener tono administrativo formal, en tercera persona.
</context>

<instructions>
1. Extrae en <citas> los datos del informe sobre estado actual de las instalaciones,
   consumos, incidencias y riesgos.
2. Con esas citas, redacta el apartado "Justificación de la necesidad" en 3 o 4 párrafos.
3. Cada dato numérico debe proceder de una cita. Si falta un dato que el apartado
   necesitaría, indícalo al final en una lista "Datos pendientes".
4. No cites normativa que no aparezca en el informe.
</instructions>

Por qué funciona: documento arriba y tarea abajo, citas primero, permiso explícito para decir que algo falta y contexto sobre quién lo leerá. Todas son técnicas de la guía oficial ^{[1] [3]}.

Revisión humana obligatoria: el texto resultante es un borrador. Las citas normativas, las cifras y la coherencia con el resto del expediente las verifica quien firma.

5. Errores frecuentes y límites conocidos

• Prompts vagos que obligan a adivinar. Si quieres un resultado más completo de lo estrictamente pedido, dilo de forma explícita en lugar de esperar que Claude lo deduzca ^[1].
• Instrucciones solo en negativo. "No hagas X" funciona peor que describir lo que sí quieres ^[1].
• Pregunta antes que documentos. Con textos largos, poner la pregunta al final mejora la calidad ^[1].
• Ejemplos todos iguales. Claude puede copiar patrones no deseados; varía los ejemplos e incluye casos límite ^[1].
• Tutoriales antiguos. El tutorial interactivo de GitHub se escribió para Claude 3; si choca con la guía actual, manda la guía actual ^[2].
• Prefill en la API. Escribir el inicio de la respuesta del asistente en el último turno ya no se admite desde los modelos 4.6 y devuelve error 400; se sustituye por instrucciones claras o salidas estructuradas ^[1]. Lo verás en la lección 28.
• Creer que el prompt elimina las alucinaciones. Las reduce; no las elimina ^[3].

6. Ejercicio práctico

Enunciado: elige una tarea de documentación que hagas a menudo (un informe de inspección, una respuesta a una reclamación vecinal, la descripción de un endpoint de tu API Spring Boot o las instrucciones de uso de una hoja de mediciones con macros).

1. Escribe primero tu prompt "de siempre" y guarda la respuesta.
2. Reescríbelo aplicando al menos cinco técnicas de esta lección, partiendo de la plantilla reutilizable.
3. Ejecuta los dos prompts sobre el mismo documento y compara.
4. Pasa la prueba del colega: dale el prompt nuevo a un compañero y pregúntale si sabría hacer la tarea solo con él.

Criterio de éxito:

• El prompt nuevo separa documentos, contexto e instrucciones con etiquetas XML.
• Incluye el motivo de al menos una instrucción y el formato de salida exacto.
• Pide citas del documento y permite responder "No consta en el documento".
• La respuesta nueva no contiene ningún dato que no esté en el documento (compruébalo a mano).
• Un compañero entiende la tarea leyendo solo el prompt.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Prompting best practices (se abre en una pestaña nueva) oficial api-claude-prompting-best-practices · consultada el 2026-10-25
2. Prompt engineering overview (se abre en una pestaña nueva) oficial api-prompt-engineering-overview · consultada el 2026-10-25
3. Reduce hallucinations (se abre en una pestaña nueva) oficial api-reduce-hallucinations · consultada el 2026-10-25

1. Qué es y qué problema resuelve

El chat es la puerta de entrada a Claude: escribes, adjuntas archivos y recibes respuestas. Detrás de esa sencillez hay cuatro mecanismos que conviene dominar porque cambian mucho el resultado:

1. Archivos adjuntos: Claude trabaja sobre tus documentos en lugar de sobre lo que recuerda.
2. Búsqueda web: consulta información actual y la cita ^[1].
3. Esfuerzo y razonamiento: cuánto "piensa" el modelo antes de responder ^[2].
4. Gestión de la conversación: cuándo seguir, cuándo empezar de cero y cómo se comporta el chat al llenarse ^[3].

Resuelve el problema más habitual de quien empieza: respuestas genéricas o desactualizadas porque Claude no tenía ni tus documentos ni acceso a fuentes actuales.

Interfaz nueva. Anthropic está unificando el chat y Claude Cowork en una sola experiencia. En ella no tienes que elegir modo: Claude decide si responde o emprende una tarea larga, y algunos interruptores desaparecen ^[4]. El despliegue es gradual, así que es posible que veas una u otra interfaz. Esta lección indica las diferencias cuando las hay.

2. Cuándo usarla y cuándo NO

La ayuda oficial distingue tres herramientas ^[5]:

Cuándo NO:

• No actives la búsqueda web si la respuesta está en tus documentos: gasta cupo y puede mezclar fuentes ajenas ^[3].
• No subas datos personales o confidenciales sin revisar antes la lección 07 y las normas de tu organización.
• No sigas una conversación eterna: cuando un chat se alarga, la ayuda recomienda empezar uno nuevo ^[3].

3. Tutorial paso a paso

A. Adjuntar archivos

1. Pulsa + en la esquina inferior izquierda de la caja de mensaje.
2. Elige Add files or photos, selecciona los archivos y pulsa Open. También puedes arrastrarlos o pegar una imagen desde el portapapeles ^[6].

Formatos admitidos ^[6]:

• Documentos: PDF, DOCX, CSV, TXT, HTML, ODT, RTF, EPUB, JSON y XLSX.
• Imágenes: JPEG, PNG, GIF y WebP.
• Para subir XLSX hay que activar antes la ejecución de código y creación de archivos.

Límites en un chat ^[6]:

Cómo lee los PDF ^[6]:

• Hasta 100 páginas: texto y elementos visuales (planos, gráficos, tablas como imagen).
• De 101 a 1000 páginas: solo texto.
• Más de 1000 páginas: error "Uploaded file is too large".

Contradicción conocida. Con la creación de archivos activada, otro artículo fija 30 MB por archivo para subir y descargar ^[7]. La ayuda no aclara qué límite se aplica en cada caso (registrado en research/CONTRADICCIONES.md, A3-39). Si un archivo grande falla, prueba a dividirlo.

B. Activar la ejecución de código y creación de archivos

Es necesaria para subir XLSX y para que Claude cree archivos y artefactos. Se activa en Settings > Capabilities con la opción "Cloud code execution and file creation", que en el diseño nuevo se llama "Create and edit files". En Team y Enterprise la activa un propietario en Organization settings > Capabilities ^[8].

C. Usar la búsqueda web

Interfaz clásica:

1. Pulsa + abajo a la izquierda.
2. Elige Web search y comprueba que aparece la marca de verificación. Púlsalo otra vez para desactivarla ^[1].

Interfaz nueva: no hay interruptor; Claude busca cuando le resulta útil ^[1].

Team y Enterprise: un Owner o Primary Owner debe activarla antes para toda la organización en Organization settings > Capabilities ^[1].

Las respuestas con búsqueda incluyen citas para que puedas comprobar las fuentes ^[1]. Ábrelas: la ayuda recomienda no tomar a Claude como única fuente de verdad ^[9].

D. Ajustar esfuerzo y razonamiento

1. Pulsa el nombre del modelo junto al botón de enviar.
2. En Effort, elige Low, Medium, High, Extra high o Max.
3. Pasa el cursor por Effort y usa el interruptor Thinking (también rotulado "Extended") para activar o desactivar el razonamiento. En modelos sin selector de esfuerzo, el interruptor se llama Extended ^[2].

Esfuerzo y razonamiento son ajustes separados y se combinan libremente. En Haiku 5.5, Sonnet 5.5, Opus 5.5, Fable 5.1 y Opus 5 el razonamiento no se puede desactivar ^[2].

E. Gestionar conversaciones

• Renombrar o borrar: botón ⋮ junto a la conversación en la barra lateral o en "Chats and tasks". Para borrar varias, usa Select o Select all ^[10].
• Editar un mensaje anterior crea otra versión de la conversación ^[8]: útil para probar una variante del prompt sin perder la original. Ojo: en la experiencia unificada de chat y Cowork no se puede ramificar una conversación ^[4].
• Cuando el chat se llena: con la ejecución de código activada, Claude resume los mensajes antiguos para poder seguir y muestra el aviso "organizing its thoughts". El historial completo se conserva ^[3].

4. Ejemplo práctico

Caso: revisión de una hoja de mediciones con macros y de su pliego, en una oficina técnica municipal.

Situación de partida: tienes mediciones_reurbanizacion.xlsm (con macros VBA que calculan partidas) y el pliego de prescripciones técnicas en PDF de 240 páginas.

1. El .xlsm no está en la lista de formatos admitidos, que solo menciona XLSX ^[6]. Si se puede subir o abrir un .xlsm es un punto No verificado (NV29). Opción segura:
   • Guarda una copia como .xlsx (las macros se pierden en la copia, no en tu original) para que Claude analice los datos.
   • Copia el código VBA desde el editor de Visual Basic y pégalo como texto en el chat para revisarlo por separado.
2. El PDF de 240 páginas se leerá solo como texto ^[6]. Si necesitas que interprete un plano o una tabla escaneada, extrae esas páginas a un PDF de 100 páginas o menos.
3. Prompt (técnicas de la lección 02):

Adjunto la hoja de mediciones (copia .xlsx sin macros), el código VBA de sus macros
y el pliego de prescripciones técnicas.

<instructions>
1. Comprueba si las unidades de obra de la hoja coinciden con las definidas en el pliego.
   Lista las discrepancias en una tabla: código de partida, unidad en la hoja,
   unidad en el pliego, cita literal del pliego.
2. Revisa el código VBA y explica en lenguaje llano qué calcula cada macro.
   Señala cualquier fórmula que pueda dar resultados erróneos.
3. Si algo no puedes comprobar con los archivos, dilo en lugar de suponerlo.
</instructions>

4. Búsqueda web: desactívala (o no la pidas) en esta tarea: la respuesta está en tus documentos.
5. Esfuerzo: sube a High para la revisión del VBA; para el resumen final basta el esfuerzo por defecto.
6. Verificación: comprueba a mano dos o tres discrepancias de la tabla contra el pliego antes de comunicarlas.

5. Errores frecuentes y límites conocidos

• Subir XLSX sin activar la ejecución de código. El archivo no se acepta ^[6].
• Esperar que lea planos en PDF largos. A partir de 101 páginas solo se procesa el texto ^[6].
• Confundir los límites de archivos del chat con los de Proyectos. En Proyectos el máximo es de 30 MB por archivo y solo se extrae texto, salvo en PDF multimodales ^[6].
• Buscar el interruptor de búsqueda web en la interfaz nueva. No existe; Claude decide ^[1].
• No poder usar la búsqueda en una cuenta de empresa. En Team y Enterprise depende de que la active un propietario ^[1].
• Gastar cupo de más. El esfuerzo alto, el razonamiento, los conectores y la búsqueda consumen más; bájalos en tareas rutinarias ^[3].
• Fiarse de las citas sin abrirlas. Claude puede equivocarse o dar citas que suenan bien sin base real ^[9].
• Macros VBA y .xlsm. Ni la subida de .xlsm (No verificado (NV29)) ni que Claude conserve macros al crear archivos están documentados.

6. Ejercicio práctico

Enunciado: con un documento técnico real tuyo (un informe, un pliego o una hoja de cálculo sin datos personales):

1. Activa la ejecución de código y creación de archivos si no lo está.
2. Sube el documento y pide un resumen estructurado con citas literales.
3. Haz una pregunta que requiera información actual (por ejemplo, la versión vigente de una norma técnica que cite el documento) con la búsqueda web activa, y abre al menos dos de las citas.
4. Repite una pregunta de razonamiento difícil sobre el documento con esfuerzo Low y con esfuerzo High, y compara.
5. Renombra la conversación con un nombre que puedas encontrar después.

Criterio de éxito:

• El documento se ha subido sin errores y conoces su límite aplicable (chat o proyecto, páginas del PDF).
• El resumen contiene citas literales que has comprobado en el original.
• Has abierto y revisado al menos dos fuentes de la búsqueda web.
• Has anotado una diferencia concreta entre la respuesta con esfuerzo Low y con esfuerzo High.
• La conversación tiene un nombre descriptivo.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Enable and use web search (se abre en una pestaña nueva) oficial sup-enable-and-use-web-search · consultada el 2026-10-25
2. Change the model, effort, and thinking settings (se abre en una pestaña nueva) oficial sup-change-the-model-effort-and-thinking-setting · consultada el 2026-10-25
3. How do usage and length limits work? (se abre en una pestaña nueva) oficial sup-how-do-usage-and-length-limits-work · consultada el 2026-10-25
4. Claude Cowork and chat are one Claude (se abre en una pestaña nueva) oficial sup-cowork-onechat · consultada el 2026-10-25
5. When should I use web search, extended thinking, and Research? (se abre en una pestaña nueva) oficial sup-when-should-i-use-web-search-extended-thinki · consultada el 2026-10-25
6. Upload files to Claude (se abre en una pestaña nueva) oficial sup-upload-files-to-claude · consultada el 2026-10-25
7. Create and edit files with Claude (se abre en una pestaña nueva) oficial sup-create-and-edit-files-with-claude · consultada el 2026-10-25
8. What are artifacts and how do I use them? (se abre en una pestaña nueva) oficial sup-artifacts · consultada el 2026-10-25
9. Claude is providing incorrect or misleading responses. What's going on? (se abre en una pestaña nueva) oficial sup-claude-is-providing-incorrect-or-misleading · consultada el 2026-10-25
10. Delete or rename a conversation (se abre en una pestaña nueva) oficial sup-delete-or-rename-a-conversation · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Un Proyecto es un espacio propio dentro de Claude con su historial de chats y su base de conocimiento ^[1]. Tiene dos piezas que lo hacen útil:

• Conocimiento del proyecto: documentos, textos o código que subes una vez y que Claude usa en todos los chats del proyecto ^[2].
• Instrucciones del proyecto: cómo debe comportarse Claude en ese espacio (rol, tono, formato, normas), aplicadas a todos sus chats ^[2].

Resuelve el problema de repetir lo mismo en cada conversación: volver a subir la ordenanza, volver a explicar el formato del informe, volver a recordar que escribes para la Secretaría municipal. Es el equivalente, en la app, al "prompt de sistema" de la lección 02.

Los Proyectos están en todos los planes; en Free puedes tener hasta cinco ^[2].

2. Cuándo usarla y cuándo NO

Úsalos cuando:

• Trabajas de forma continuada sobre un mismo tema con documentación estable: un expediente, un proyecto de obra, un repositorio, un manual.
• Quieres que varias conversaciones partan del mismo contexto y las mismas normas.
• En Team o Enterprise, quieres que un equipo comparta conocimiento e instrucciones ^[2].

No los uses (o no basta con ellos) cuando:

• Es una consulta suelta: un chat normal es más rápido.
• Esperas que un chat del proyecto "recuerde" lo que dijiste en otro: los chats de un proyecto no comparten contexto entre sí salvo lo que esté en el conocimiento ^[2] (o en la memoria, lección 05).
• Necesitas que Claude actúe sobre archivos o sistemas: eso es trabajo de Cowork, conectores o Claude Code (módulos B y C).

3. Tutorial paso a paso

Paso 1: crear el proyecto

1. Abre Projects en la parte izquierda o ve a claude.ai/projects.
2. Pulsa + New Project (arriba a la derecha).
3. Escribe nombre y descripción. Claude no ve ni el nombre ni la descripción: son solo para ti ^[2].
4. En Team o Enterprise, elige si es privado o compartido con la organización (si tus administradores lo permiten) ^[2].

Paso 2: añadir conocimiento

1. En la página principal del proyecto, pulsa + en la zona de conocimiento (panel derecho).
2. Sube documentos, textos o fragmentos de código ^[2].

Límites de archivos en proyectos: 30 MB por archivo, número ilimitado mientras el total quepa en el contexto, y se extrae solo el texto (salvo en los PDF multimodales) ^[3].

RAG automático (planes de pago): cuando el conocimiento se acerca al límite de contexto, Claude activa solo un modo de recuperación (RAG) que amplía la capacidad hasta unas 10 veces. Verás un indicador y una herramienta de búsqueda en el conocimiento dentro del chat. No hay interruptor manual ^[4].

Paso 3: escribir las instrucciones

1. Pulsa Set project instructions.
2. Escribe cómo debe comportarse Claude y guarda ^[2].

Aplica aquí las técnicas de la lección 02: rol, contexto, formato de salida y el porqué de cada norma. Mantenlas breves: la ayuda recomienda instrucciones de proyecto cortas para ahorrar uso ^[5].

Paso 4: trabajar y mover chats

• Abre chats nuevos desde el propio proyecto.
• Para mover un chat existente: flecha junto al nombre del chat > Add to project > elige el proyecto en la ventana "Move chat". Con el mismo menú lo sacas o lo mueves a otro ^[2].

Paso 5: compartir (solo Team y Enterprise)

1. Abre el proyecto y pulsa Share project junto a su nombre.
2. Añade personas por nombre, correo o pegando una lista de correos.
3. Elige el rol y pulsa Share ^[2]:

Para quitar a alguien, el creador pulsa su rol y elige Remove access ^[2].

Paso 6: archivar o borrar

• Archivar: tres puntos arriba a la derecha y confirmar. Se conservan conversaciones, miembros, permisos y conocimiento.
• Borrar: tres puntos > Yes, delete. Un proyecto archivado no se puede borrar hasta desarchivarlo ^[2].

Una nota sobre la nueva versión de Proyectos

Anthropic está desplegando por fases una versión rediseñada, en beta, en la que el proyecto es una única conversación que reparte el trabajo en hilos paralelos en la nube. Empieza por algunos usuarios Pro y Max de Claude Code; el chat, Cowork, Team y Enterprise llegarán después ^[1]. Si tu interfaz no coincide con estos pasos, puede deberse a ese cambio.

4. Ejemplo práctico

Caso: proyecto "Ordenanza de obras en vía pública" para los técnicos de un ayuntamiento.

Conocimiento:

• Texto de la ordenanza municipal vigente (PDF).
• Modelo de informe técnico de licencia de obra (DOCX).
• Tres informes ya emitidos, anonimizados, como ejemplos de estilo.

Instrucciones del proyecto:

Eres un técnico de la oficina de obras de un ayuntamiento. Ayudas a redactar informes
técnicos sobre solicitudes de ocupación y obras en vía pública.

- Basa cada afirmación normativa en el texto de la ordenanza del conocimiento del
  proyecto y cita el artículo. Si la ordenanza no regula algo, dilo expresamente.
- Sigue la estructura del modelo de informe: antecedentes, análisis técnico,
  conclusión y condiciones.
- Tono administrativo formal, en tercera persona. Los informes los firma un técnico
  y los revisa Secretaría, así que no inventes plazos, tasas ni referencias.
- Si faltan datos de la solicitud, enuméralos al final en "Datos pendientes".

Uso diario: cada solicitud nueva va en un chat nuevo dentro del proyecto. Claude aplica la ordenanza y el formato sin que tengas que repetirlos. Si una conversación aporta algo útil para todas (por ejemplo, un criterio interpretativo aprobado), lo añades como texto al conocimiento, porque los chats no se lo comunican entre sí.

Variante para desarrollo: un proyecto "API de inspecciones" con el README, la especificación OpenAPI del backend Spring Boot y la guía de estilo del equipo, e instrucciones del tipo "responde con ejemplos en Java 21 y Spring Boot; para la app Android, en Kotlin". Para trabajar directamente sobre el repositorio, Claude Code es mejor herramienta (lección 18).

5. Errores frecuentes y límites conocidos

• Escribir instrucciones en la descripción. Claude no ve el nombre ni la descripción del proyecto ^[2].
• Suponer que los chats del proyecto se comunican. No comparten contexto salvo mediante el conocimiento ^[2] o la memoria.
• Subir archivos grandes como en el chat. En proyectos el límite es de 30 MB por archivo, frente a los 500 MB del chat ^[3].
• Esperar análisis visual de planos. En el conocimiento del proyecto se extrae solo texto, salvo PDF multimodales ^[3].
• Contar con el RAG en Free. El modo RAG automático es de los planes de pago ^[4].
• Compartir en Pro o Max. Compartir proyectos es solo de Team y Enterprise ^[2].
• Instrucciones de proyecto en Free. Un artículo de ayuda las limita a planes de pago mientras otros dicen que los proyectos están en todos los planes: contradicción abierta (A1-5 en research/CONTRADICCIONES.md). Comprueba en tu cuenta si aparece Set project instructions.
• Instrucciones de organización. En Team y Enterprise, los propietarios pueden fijar instrucciones para toda la organización (hasta 3.000 caracteres) que prevalecen sobre las individuales si chocan ^[6]. Cómo interactúan con las de proyecto no está documentado.

6. Ejercicio práctico

Enunciado: crea un proyecto para un tema real y recurrente de tu trabajo.

1. Elige el tema (un tipo de informe, un procedimiento, una aplicación).
2. Sube al conocimiento entre dos y cinco documentos de referencia sin datos personales.
3. Escribe unas instrucciones de 8 a 15 líneas con rol, normas, formato y qué hacer si falta información.
4. Abre dos chats distintos en el proyecto con dos casos diferentes.
5. En el segundo chat, pregunta por algo que solo dijiste en el primero y observa la respuesta.

Criterio de éxito:

• El proyecto tiene conocimiento e instrucciones, y las instrucciones no están en la descripción.
• En ambos chats Claude aplica el formato y las normas sin que las repitas.
• Al menos una respuesta cita un documento del conocimiento y has comprobado la cita.
• Has comprobado que el segundo chat no conoce lo dicho en el primero y sabes cómo resolverlo (añadirlo al conocimiento).

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. What are projects? (se abre en una pestaña nueva) oficial sup-what-are-projects · consultada el 2026-10-25
2. How can I create and manage projects? (se abre en una pestaña nueva) oficial sup-how-can-i-create-and-manage-projects · consultada el 2026-10-25
3. Upload files to Claude (se abre en una pestaña nueva) oficial sup-upload-files-to-claude · consultada el 2026-10-25
4. Retrieval augmented generation (RAG) for projects (se abre en una pestaña nueva) oficial sup-retrieval-augmented-generation-rag-for-proje · consultada el 2026-10-25
5. How do usage and length limits work? (se abre en una pestaña nueva) oficial sup-how-do-usage-and-length-limits-work · consultada el 2026-10-25
6. Set organization instructions (se abre en una pestaña nueva) oficial sup-set-organization-instructions · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Por defecto, cada conversación con un modelo de lenguaje empieza de cero. Claude ofrece tres mecanismos para controlar qué recuerda y qué no:

A esto se suman las instrucciones de cuenta ("Instructions"), que son preferencias fijas que se aplican a todas tus conversaciones ^[3].

Resuelve dos problemas opuestos: no tener que repetir quién eres y cómo trabajas, y poder trabajar con algo puntual sin que quede rastro en la memoria.

Importante para la administración pública: la nueva experiencia de memoria no está disponible para organizaciones con acuerdos HIPAA o de sector público con Anthropic ^[1]. Si tu organización tiene un acuerdo de ese tipo, no verás esta función.

2. Cuándo usarla y cuándo NO

Usa la memoria cuando quieras que Claude conozca de forma estable tu puesto, tus herramientas habituales (Spring Boot, Android Studio, Excel con macros) o tus preferencias de redacción.

Usa las instrucciones de cuenta para normas que quieres siempre, sin depender de lo que Claude decida recordar (por ejemplo, "responde en español de España").

Usa un Proyecto (lección 04) para el contexto de un tema concreto; la memoria es más general.

Usa un chat sin memoria o de incógnito cuando:

• Pruebas algo puntual que no quieres que influya en conversaciones futuras.
• Tratas un asunto que no debe quedar en tu memoria.

No confíes en ninguna de ellas como garantía de confidencialidad. En Team y Enterprise, los chats de incógnito sí entran en las exportaciones de datos de la organización y en la Compliance API ^[2]. La lección 07 trata la privacidad en detalle.

3. Tutorial paso a paso

Los ajustes conviven en dos diseños. En el nuevo están en Settings > Your Claude; en el anterior, en Settings > Memory ^[1]. Aquí se indican los dos cuando difieren.

A. Activar o desactivar la memoria

1. Ve a Settings > Your Claude y activa Memory from chats (en el diseño anterior: Settings > Memory > Generate memory from chats) ^[1].
2. Claude guarda la memoria como temas individuales mientras conversas; también puedes pedirle explícitamente que recuerde algo ^[1].

Pausar o restablecer ^[1]:

• Pausar: conserva lo guardado, pero Claude deja de usarlo y de añadir entradas.
• Restablecer: borra para siempre toda la memoria, incluida la de los proyectos. No se puede deshacer.

B. Revisar y corregir lo que recuerda

1. Settings > Your Claude > Manage junto a Your memory.
2. En Topics, edita o borra cada tema ^[1].

C. Temas sensibles

• Por defecto, Claude no guarda temas sensibles como salud, religión, política o identidad de género. Para permitirlo hay que activar Include sensitive topics in memory; afecta solo a lo que se guarde a partir de ese momento.
• Nunca se guardan, aunque lo pidas: números de documentos oficiales de identidad, antecedentes penales, números de cuentas financieras ni situación migratoria ^[1].

D. Memoria y proyectos

• Cada proyecto tiene memoria propia. Dentro de un proyecto, Claude usa la memoria de ese proyecto y la de tu cuenta, pero no la de otros proyectos.
• Para aislar un proyecto por completo: en la página del proyecto, apartado Memory, desactiva Use account memory ^[1].

E. Un chat suelto sin memoria

• Web y escritorio: chat nuevo > + > pulsa Memory para desactivarla > envía el primer mensaje.
• Móvil: chat nuevo > + > desactiva el interruptor Memory > cierra el panel > envía el primer mensaje.

El ajuste queda fijado al enviar el primer mensaje. Ese chat no alimenta la memoria, pero sí queda en tu historial y se puede buscar ^[1].

F. Búsqueda en chats anteriores

Está activada por defecto cuando llega a tu cuenta. Se desactiva en Settings > Your Claude con Search and reference chats ^[1].

G. Chat de incógnito

1. Fuera de un proyecto, abre un chat nuevo y pulsa el icono del fantasma (arriba a la derecha).
2. Verás un borde negro y la etiqueta Incognito chat.
3. Ciérralo con la x; después no se puede reabrir ^[2].

Características ^[2]:

• No se guarda en el historial ni en la memoria y no se usa para entrenar modelos.
• Se conserva 30 días por defecto (más en Enterprise con retención personalizada).
• No está disponible dentro de proyectos.
• En la experiencia unificada de chat y Cowork se abre en la interfaz anterior y no puede crear archivos ni ejecutar código.

H. Instrucciones de cuenta

En Settings > Your Claude > Instructions (diseño anterior: Settings > Account > Instructions for Claude) escribes preferencias que se aplican a toda la cuenta ^[3].

4. Ejemplo práctico

Caso: un técnico que alterna documentación administrativa municipal y desarrollo de software.

Instrucciones de cuenta (estables, siempre activas):

Respondo en español de España. Trabajo en un ayuntamiento como técnico de ingeniería
civil y desarrollo aplicaciones con Spring Boot (Java) y Android (Kotlin).
Cuando cites normativa o documentación técnica, indica la fuente y la fecha si la conoces,
y avisa si no puedes comprobarla.

Memoria: deja que Claude aprenda detalles como tus herramientas habituales. Revisa los Topics cada cierto tiempo y borra lo que esté desactualizado (por ejemplo, una versión antigua de una librería).

Proyecto aislado: en el proyecto "Ordenanza de obras" de la lección 04 desactivas Use account memory para que tus preferencias de programación no se cuelen en los informes administrativos.

Chat sin memoria: para probar un prompt nuevo sobre un caso ficticio, abres un chat con Memory desactivada antes del primer mensaje, de modo que la prueba no altere lo que Claude sabe de ti.

Lo que no harías: pegar datos personales de un vecino en un chat de incógnito "porque no se guarda". Se conserva 30 días y, en Team o Enterprise, puede aparecer en exportaciones de la organización ^[2].

5. Errores frecuentes y límites conocidos

• Pensar que borrar un chat borra lo que Claude recordó de él. No: hay que borrar los temas de memoria uno a uno ^[1].
• Restablecer la memoria sin querer. Es irreversible e incluye la de los proyectos ^[1].
• Intentar desactivar la memoria a mitad de chat. Solo se puede antes del primer mensaje ^[1].
• Confundir "chat sin memoria" con incógnito. El primero sigue en el historial; el incógnito no ^[1].
• Buscar la búsqueda en chats en Free. Es solo de planes de pago ^[1].
• Usar incógnito dentro de un proyecto. No está disponible ^[2].
• Memoria en Team. Un mismo artículo de ayuda tiene una sección que atribuye el control al propietario y otra antigua que dice que Team no tiene controles de organización; se sigue la sección actual (A1-6 en research/CONTRADICCIONES.md).
• Estilos de respuesta. No hay un artículo de ayuda vigente sobre los estilos de respuesta en claude.ai: No verificado (NV1). La ayuda de personalización remite a las instrucciones y a las skills ^[3].

6. Ejercicio práctico

Enunciado:

1. Escribe unas instrucciones de cuenta de 3 a 6 líneas.
2. Abre Manage junto a Your memory y revisa todos los Topics. Corrige o borra al menos uno.
3. En el proyecto que creaste en la lección 04, decide si debe usar la memoria de la cuenta y configúralo.
4. Abre un chat con Memory desactivada y otro de incógnito. Anota en qué se diferencian.

Criterio de éxito:

• Tus instrucciones de cuenta están guardadas y una respuesta nueva las respeta.
• Has revisado la lista de temas de memoria y has corregido o eliminado al menos uno.
• Puedes explicar por qué tu proyecto usa o no usa la memoria de la cuenta.
• Puedes decir, sin consultar la lección, dos diferencias entre un chat sin memoria y uno de incógnito.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Use Claude's chat search and memory to build on previous context (se abre en una pestaña nueva) oficial sup-use-claude-s-chat-search-and-memory-to-build · consultada el 2026-10-25
2. Use incognito chats (se abre en una pestaña nueva) oficial sup-use-incognito-chats · consultada el 2026-10-25
3. Understanding Claude's personalization features (se abre en una pestaña nueva) oficial sup-understanding-claude-s-personalization-featu · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Un artefacto es un contenido que Claude crea para que se lo enseñes a otra persona: un diseño, una presentación, un documento, un panel o una pequeña herramienta interactiva. Se abre junto a la conversación, donde puedes editarlo, volver a él y compartirlo ^[1].

Resuelve el problema de "copiar y pegar la respuesta en otro sitio": el resultado vive como un objeto propio, con versiones, que se edita y se comparte con un enlace.

Claude crea un artefacto cuando el contenido es sustancial y autónomo (normalmente más de 15 líneas), probablemente se va a editar o reutilizar, se entiende sin el resto del chat y merece la pena volver a él ^[1].

Disponibilidad: Free, Pro, Max, Team y Enterprise, y también en Claude Code ^[1].

Fuente de la tabla: ^[1].

Esta lección cubre lo básico. Las plantillas (Docs, Slides, Design, Dashboards, Motion), los artefactos que llaman a Claude y los que usan conectores se tratan en la lección 13.

2. Cuándo usarla y cuándo NO

Úsalos para:

• Un documento o informe que vas a pulir en varias rondas.
• Una presentación para una reunión.
• Una herramienta pequeña: una calculadora de mediciones, un conversor de unidades, una checklist interactiva de inspección.
• Algo que quieres compartir con un compañero sin enviar archivos.

No los uses para:

• Respuestas cortas o de un solo uso: un mensaje normal basta.
• Aplicaciones con servidor, usuarios y base de datos real: un artefacto es una página autónoma. Para eso, desarrollo propio (por ejemplo, tu backend Spring Boot) con ayuda de Claude Code.
• Datos personales o confidenciales en artefactos con almacenamiento compartido: todo el que abre el artefacto ve ese almacenamiento ^[2].

3. Tutorial paso a paso

Paso 1: requisito previo

Activa Cloud code execution and file creation (en el diseño nuevo, Create and edit files):

• Free, Pro y Max: Settings > Capabilities.
• Team y Enterprise: lo gestiona un propietario en Organization settings > Capabilities ^[1].

Paso 2: crear un artefacto

Tres maneras ^[1]:

1. Pídelo en cualquier chat ("créame un artefacto con…").
2. Pulsa Output en la caja de mensaje y elige una plantilla.
3. Elige una plantilla en la pestaña Artifacts de la barra lateral.

Paso 3: iterar

• Pide cambios a Claude en el chat, o edita directamente en los artefactos basados en plantilla.
• En un documento o Markdown, selecciona un fragmento y pulsa Edit with Claude para cambiar solo esa parte.
• Si editas un mensaje anterior, se crea otra versión del chat con sus propios artefactos, sin perder el trabajo previo ^[1].
• Si aparece un error, pulsa Try fixing with Claude: copia el error en un mensaje nuevo para que Claude intente arreglarlo, sin garantía de éxito ^[1].

Paso 4: compartir

Los artefactos son privados hasta que los compartes ^[2].

1. Pulsa Share.
2. Elige quién tiene acceso y con qué nivel.
3. Copia el enlace ^[2].

Opciones de enlace por plan ^[2]:

Niveles de permiso: Can view (leer y ver comentarios), Commenter (además comentar y descargar archivos) y Can edit (además modificar). Algunos tipos solo ofrecen ver o editar ^[2].

Para dejar de compartir: vuelve a "Only you" u "Only people invited", o quita a personas concretas ^[2].

Quién puede abrirlo: hace falta una cuenta de Claude, salvo en los artefactos heredados publicados desde Free, Pro o Max ^[2].

Paso 5: artefactos heredados

Los artefactos creados en un chat antes del 16-09-2026 son "heredados": siguen funcionando y se pueden publicar y compartir, pero ya no se crean nuevos ^[1]. En Free, Pro y Max se publican con Publish; Unpublish retira el acceso de forma irreversible y borra los datos guardados ^[2].

Paso 6: accesibilidad con teclado

• Entrar en un artefacto: Tab hasta él e Intro.
• Salir: Esc repetidamente hasta volver al panel; un Esc más lo cierra ^[3].

4. Ejemplo práctico

Caso: checklist interactiva de inspección de aceras para la brigada de obras.

Prompt:

Crea un artefacto: una checklist interactiva para inspeccionar aceras municipales.

- Campos de cabecera: calle, tramo (desde/hasta), fecha, inspector.
- Apartados: pavimento (baldosas sueltas, hundimientos, raíces), bordillos,
  accesibilidad (vados, pasos de peatones), mobiliario urbano, alcorques.
- Cada elemento: estado (correcto / deficiente / no aplica) y observaciones.
- Al final, un resumen con el número de deficiencias por apartado y un botón
  para copiar el resumen como texto, para pegarlo en el parte.
- Diseño legible en el móvil y con buen contraste.
- No guardes datos entre sesiones.

Iteración: pruébala, y pide cambios concretos ("añade 'tapas de registro' al apartado de pavimento", "ordena los apartados por frecuencia de incidencias"). Si algo falla, usa Try fixing with Claude.

Compartir: con Team, compártela con "Anyone at [tu ayuntamiento]" y permiso Can view para que la brigada la use sin poder modificarla.

Por qué "No guardes datos": si el artefacto usara almacenamiento compartido, cualquiera que lo abriera vería lo guardado por otros ^[2]. Para un parte con datos, el resultado se copia y se registra en el sistema oficial del ayuntamiento.

Variante para desarrollo: un artefacto que convierta un JSON de respuesta de tu API Spring Boot en una tabla legible para enseñárselo a un responsable que no programa.

5. Errores frecuentes y límites conocidos

• No ver artefactos. Falta activar la ejecución de código y creación de archivos o, en organizaciones, que esté activado por el propietario ^[1].
• Intentar cambiar la compartición desde el móvil. Solo desde web o escritorio ^[2].
• Compartir por enlace un artefacto que usa apps conectadas o llama a Claude. No se puede compartir por enlace ^[2].
• Esperar que los demás vean tus datos de una app conectada. Cada persona usa sus propias conexiones; puede ver errores en lugar de tus datos ^[2].
• Usar el almacenamiento como base de datos. Son 20 MB por artefacto, solo texto, sin imágenes ni binarios ^[1].
• Pulsar Unpublish en un heredado. Es irreversible y borra los datos ^[2].
• Límites técnicos de la página. La documentación de Claude Code detalla una política de seguridad estricta y un tamaño máximo de 16 MiB; si se aplica igual a los artefactos del chat es No verificado (NV4).
• Nombres de permisos distintos según la página (Can view/Commenter/Can edit, viewer/editor): contradicción registrada (A2-33 en research/CONTRADICCIONES.md). Esta lección usa los de la ayuda de compartir.

6. Ejercicio práctico

Enunciado: crea un artefacto útil para tu trabajo, itéralo y compártelo.

1. Elige uno: una calculadora (por ejemplo, superficie y volumen de una zanja con cama de arena), una checklist o un resumen visual de un procedimiento.
2. Créalo con un prompt que indique campos, comportamiento y diseño.
3. Haz al menos dos iteraciones, una de ellas con Edit with Claude o editando un mensaje anterior.
4. Compártelo con un compañero (o, si estás en Free/Pro/Max, genera el enlace y revisa quién podría abrirlo).
5. Vuelve a dejarlo en "Only you" cuando termines la prueba.

Criterio de éxito:

• El artefacto funciona y has comprobado sus resultados a mano en al menos un caso.
• Has hecho dos iteraciones y conservas la versión anterior.
• Sabes qué nivel de permiso has dado y por qué.
• Has vuelto a restringir el acceso al terminar.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. What are artifacts and how do I use them? (se abre en una pestaña nueva) oficial sup-artifacts · consultada el 2026-10-25
2. Share artifacts (se abre en una pestaña nueva) oficial sup-share-artifacts · consultada el 2026-10-25
3. Use artifacts with a keyboard or screen reader (se abre en una pestaña nueva) oficial sup-artifacts-a11y · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Usar Claude en un puesto público plantea tres preguntas que conviene responder antes de pegar el primer documento:

1. ¿Qué hace Anthropic con lo que escribo? ¿Lo usa para entrenar? ¿Cuánto tiempo lo guarda?
2. ¿Puedo fiarme de lo que responde? Los modelos de lenguaje pueden "alucinar".
3. ¿Qué normas de uso se aplican a decisiones que afectan a ciudadanos?

Esta lección recoge lo que dice Anthropic en sus fuentes oficiales. No es asesoramiento jurídico: para valorar el RGPD, el Esquema Nacional de Seguridad u otra normativa aplicable a tu organismo, consulta a tu Delegado de Protección de Datos y a los servicios jurídicos. La configuración de organizaciones (Team y Enterprise) se trata en detalle en la lección 32.

2. Cuándo usarla y cuándo NO

Aplica estas comprobaciones siempre que:

• Vayas a introducir datos personales, de salud, económicos o documentos internos.
• El resultado vaya a usarse en un expediente, un informe firmado o una decisión sobre una persona.
• Uses una cuenta personal (Free, Pro o Max) para tareas de trabajo.

Cuándo NO usar Claude (o no sin más controles):

• Como única fuente de verdad. La ayuda oficial lo desaconseja expresamente ^[1].
• Para decidir sobre prestaciones públicas u otros usos de alto riesgo sin revisión humana cualificada: la Usage Policy lo exige (ver paso 5).
• Con datos que tu organización no permite tratar en servicios externos, sea cual sea el proveedor.

3. Tutorial paso a paso

Paso 1: entiende qué tipo de cuenta usas

La regla sobre entrenamiento depende del tipo de producto:

En los productos comerciales, la organización es la responsable del tratamiento de los datos de sus usuarios y Anthropic actúa como encargada ^[4].

Paso 2: revisa el ajuste de entrenamiento (cuentas de consumo)

1. Ve a Settings > Privacy (en web, escritorio o móvil). La ruta directa es claude.ai/settings/data-privacy-controls ^[2].
2. Revisa el ajuste Help improve our AI models y decide si lo quieres activado ^[2].

Lo que conviene saber ^[5]:

• Desactivarlo no es retroactivo del todo: tus datos siguen en los entrenamientos que ya estén en curso y en los modelos ya entrenados.
• Con el ajuste activado, los chats nuevos o reanudados pueden conservarse desidentificados hasta 5 años en los procesos de entrenamiento.

Otras reglas:

• Los chats de incógnito no se usan para entrenar modelos ^[6].
• Las valoraciones excluyen el contenido bruto que Claude lee mediante conectores (por ejemplo, Google Drive o servidores MCP), pero sí incluyen lo que copies directamente en la conversación ^[3].

Paso 3: conoce los plazos de conservación (consumo)

Fuente de la tabla: ^[5].

Las valoraciones guardan la conversación completa. Pulsar el pulgar en una respuesta guarda toda la conversación relacionada hasta 5 años, desvinculada de tu identificador, y puede usarse para entrenar ^[3]. En Team y Enterprise, los propietarios pueden desactivarlo en Organization settings > Data and Privacy con el ajuste Rate chats ^[3].

Paso 4: verifica las respuestas

Claude puede producir información que parece correcta y no lo es, incluidas citas que suenan fiables sin base real, y sus datos de entrenamiento pueden estar desfasados ^[1]. La ayuda recomienda ^[1]:

• No usarlo como única fuente de verdad.
• Revisar con especial cuidado los consejos de alto impacto.
• Abrir las fuentes citadas por la búsqueda web.

Técnicas oficiales para reducir alucinaciones ^[7]:

1. Permitir que diga "no lo sé".
2. Pedir citas literales de los documentos antes de responder.
3. Verificar cada afirmación con una cita y retirar las que no la tengan.
4. Limitar la respuesta a los documentos que aportas.

Ninguna técnica elimina el problema: la información crítica siempre se valida ^[7].

Paso 5: respeta la Usage Policy en usos de alto riesgo

La política de uso de Anthropic (Usage Policy) define requisitos para usos de alto riesgo, entre ellos la elegibilidad para prestaciones públicas, la salud, el empleo o la vivienda: una persona cualificada debe revisar la recomendación antes de aplicarla y hay que informar a los afectados de que interviene la IA ^[8]. La versión que figura en la página entra en vigor el 12-11-2026 ^[8].

Paso 6: datos sensibles

La ayuda aconseja prudencia con datos financieros, historiales de salud, contraseñas y documentos confidenciales ^[9]. Regla práctica de este tutorial: anonimiza o seudonimiza antes de pegar (sustituye nombres, DNI, direcciones y referencias catastrales por marcadores) salvo que tu organización tenga un acuerdo y una política que lo permitan.

4. Ejemplo práctico

Caso: te piden un borrador de respuesta a una reclamación vecinal por daños en una acera tras unas obras.

Mal planteado:

• Pegas la reclamación completa, con nombre, DNI, dirección y teléfono, en tu cuenta personal Pro.
• Pides "redacta la resolución estimando o desestimando".
• Copias la respuesta al expediente.

Bien planteado:

1. Cuenta: usas la cuenta corporativa de Team o Enterprise si existe; si solo tienes una cuenta personal, revisas antes el ajuste de entrenamiento (paso 2).
2. Datos: sustituyes los identificadores: [RECLAMANTE], [DIRECCIÓN], [FECHA_OBRA].
3. Prompt: pides un borrador de respuesta basado solo en el informe técnico adjunto, con citas, y que indique qué datos faltan (lección 02).
4. Decisión: la estimación o desestimación la decide y firma la persona competente; Claude solo ayuda a redactar. Esto es coherente con la exigencia de revisión humana de la Usage Policy para decisiones de alto riesgo ^[8].
5. Verificación: compruebas cada cita normativa y cada fecha contra el expediente.
6. Valoraciones: no pulsas el pulgar en esa conversación si contiene información interna, porque enviaría la conversación completa ^[3].

5. Errores frecuentes y límites conocidos

• Pensar que borrar un chat lo saca de todo. Sale del historial al momento, pero el almacenamiento interno tarda hasta 30 días y no sale de entrenamientos en curso si el ajuste estaba activado ^[5].
• Usar incógnito como garantía. No se entrena con él, pero se conserva 30 días y, en Team y Enterprise, entra en las exportaciones de la organización ^[6].
• Confiar en citas sin abrirlas. Pueden ser incorrectas ^[1].
• Pulsar el pulgar con información interna. La valoración guarda la conversación entera durante 5 años ^[5].
• Dar por hecho que hay residencia de datos en la UE. Para productos comerciales, la página oficial indica que los datos se almacenan en EE. UU.; una opción de residencia en la UE es No verificado (NV23) ^[10].
• Dar por hecha una certificación europea. Anthropic lista ISO 27001:2022, ISO/IEC 42001:2023 y SOC 2 ^[11]; el ENS u otras certificaciones europeas no constan: No verificado (NV24).
• Memoria en el sector público. La nueva memoria no está disponible para organizaciones con acuerdos de sector público (lección 05).

6. Ejercicio práctico

Enunciado: redacta una "política personal de uso de Claude" de una página para tu puesto.

1. Indica qué tipo de cuenta usas (consumo o comercial) y el estado de tu ajuste de mejora del modelo.
2. Clasifica tus datos de trabajo en tres niveles: se pueden usar tal cual, solo anonimizados, nunca.
3. Escribe tu lista de comprobación antes de usar una respuesta en un documento oficial (al menos cuatro puntos).
4. Prueba la técnica de citas: pide a Claude un resumen de un documento técnico con citas literales y verifica tres de ellas.

Criterio de éxito:

• Sabes si tu cuenta es de consumo o comercial y cómo está tu ajuste de entrenamiento.
• Tu clasificación de datos tiene ejemplos concretos de tu trabajo en cada nivel.
• Tu lista de comprobación incluye revisión humana y verificación de citas.
• Has verificado tres citas y anotado si alguna era incorrecta.
• Has identificado a quién consultar en tu organización sobre protección de datos.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Claude is providing incorrect or misleading responses. What's going on? (se abre en una pestaña nueva) oficial sup-claude-is-providing-incorrect-or-misleading · consultada el 2026-10-25
2. How do I change my model improvement privacy settings? (se abre en una pestaña nueva) oficial priv-how-do-i-change-my-model-improvement-privac · consultada el 2026-10-25
3. Is my data used for model training? (se abre en una pestaña nueva) oficial priv-is-my-data-used-for-model-training · consultada el 2026-10-25
4. Does Anthropic act as a data processor or controller? (se abre en una pestaña nueva) oficial priv-does-anthropic-act-as-a-data-processor-or-c · consultada el 2026-10-25
5. How long do you store my data? (se abre en una pestaña nueva) oficial priv-how-long-do-you-store-my-data · consultada el 2026-10-25
6. Use incognito chats (se abre en una pestaña nueva) oficial sup-use-incognito-chats · consultada el 2026-10-25
7. Reduce hallucinations (se abre en una pestaña nueva) oficial api-reduce-hallucinations · consultada el 2026-10-25
8. Usage Policy (se abre en una pestaña nueva) oficial news-aup · consultada el 2026-10-25
9. I would like to input sensitive data into my chats with Claude. Who can view my conversations? (se abre en una pestaña nueva) oficial sup-i-would-like-to-input-sensitive-data-into-my · consultada el 2026-10-25
10. Where are your servers located? Do you host your models on EU servers? (se abre en una pestaña nueva) oficial priv-where-are-your-servers-located-do-you-host · consultada el 2026-10-25
11. What certifications has Anthropic obtained? (se abre en una pestaña nueva) oficial priv-what-certifications-has-anthropic-obtained · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Las apps de Claude para iOS y Android llevan el chat al teléfono y añaden dos formas de hablar con Claude:

El criterio de elegir dictado cuando ya sabes qué quieres decir y modo voz para pensar en voz alta procede del tutorial de Academy ^[1].

Resuelve el problema de trabajar fuera de la mesa: en una visita de obra, en una inspección o en un desplazamiento, puedes dictar observaciones o consultar algo sin teclear.

Requisitos de las apps: iOS o iPadOS 18.0 o posterior ^[2]; Android 8.0 o posterior ^[3]. Se buscan como "Claude by Anthropic" en la tienda.

2. Cuándo usarla y cuándo NO

Úsala para:

• Dictar notas de una inspección y pedir que las ordene en un parte.
• Consultas rápidas sobre un documento que ya está en un proyecto.
• Redactar un mensaje o un evento de calendario desde el móvil (integraciones del sistema).

Cuándo NO:

• Para tareas que necesitan tus archivos locales, que Claude use el navegador o el ordenador: en el móvil solo funcionan a través de la app de escritorio abierta en tu equipo ^[4].
• Para dictar datos personales de terceros en la calle: aplica las reglas de la lección 07.
• Si necesitas el modelo Fable: no está disponible en modo voz ^[5].

3. Tutorial paso a paso

A. Instalar

• iOS: App Store > "Claude by Anthropic" > obtener ^[2].
• Android: Google Play > "Claude by Anthropic" > instalar ^[3].

Si tu organización usa Microsoft Intune, existe una versión gestionada, "Claude for Intune", para Enterprise; consulta con tu servicio de informática antes de instalar ^[2].

B. Dictar en el móvil

1. Toca el micrófono a la derecha del campo de texto.
2. La primera vez, elige el idioma. Para cambiarlo después: tus iniciales > Speech Input Language.
3. Habla y toca la flecha para enviar, o la X para cancelar ^[6].

Datos útiles ^[6]:

• Disponible en iOS y Android en todos los planes.
• Admite 12 idiomas, entre ellos el español (los distintos del inglés, en beta).
• El audio se borra tras convertirse en texto; Anthropic no guarda copia ni lo usa para entrenar modelos generativos.

C. Configurar el idioma del modo voz

Hazlo antes de empezar. Claude no detecta el idioma solo, y cambiar el idioma de la interfaz no cambia el de la voz ^[5].

• Ruta: Settings > Capabilities > Voice > Spoken language. Si no aparece, búscalo en Settings > General ^[5].
• La ayuda dice que admite muchos idiomas y que los distintos del inglés están en beta, pero no publica la lista ^[5]. Un anuncio del blog de Anthropic incluye español de España y de Latinoamérica ^[7] (fuente oficial complementaria: compruébalo en tu app).

D. Usar el modo voz

• Móvil: toca el icono de onda de sonido junto al micrófono, elige una voz y habla.
• Web y escritorio: icono de onda abajo a la derecha en un chat nuevo; Stop para salir ^[5].

Modos de escucha ^[5]:

• Manos libres (por defecto): responde cuando haces una pausa.
• Pulsar para hablar: mantienes un botón mientras hablas; recomendado en sitios ruidosos, como una obra.

Otros detalles ^[5]:

• Es una función beta, disponible en todos los planes.
• Usa los mismos modelos que el chat según tu plan; Fable no está disponible.
• Puede usar herramientas conectadas (por ejemplo, Google Calendar); en Free, solo una.
• Cuenta para los límites de uso y la conversación se guarda como transcripción en el historial.
• En Cowork y Claude Code solo hay dictado, no modo voz.

E. Integraciones del móvil

En iOS, Claude puede redactar mensajes y correos que se abren en tus apps, consultar y crear eventos de calendario, usar la ubicación y Mapas y añadir recordatorios ^[8]. En Android hay integraciones equivalentes con mensajería, correo, calendario, mapas y alarmas ^[9].

• Claude redacta, pero tú envías: no lee mensajes ni correos existentes ni accede a tus contactos ^[8].
• La ubicación no está disponible para miembros de Team y Enterprise ^[8].
• Los datos de salud solo funcionan en EE. UU. y con Pro o Max ^[8].

4. Ejemplo práctico

Caso: inspección de un muro de contención tras unas lluvias.

1. En el sitio, abre un chat en tu proyecto "Inspecciones" (lección 04) y usa el dictado (no el modo voz: quieres texto revisable):

Inspección muro de contención camino del Molino, punto kilométrico 1,2.
Fisura vertical de unos tres milímetros a dos metros del extremo norte.
Mechinales del tramo central obstruidos. Ligero desplome aparente en coronación,
sin medir. Sin desprendimientos. Hago fotos de la fisura y de los mechinales.

2. Añade las fotos con + y pide:

Ordena estas notas en el formato de parte de inspección del proyecto:
descripción, deficiencias observadas, medidas urgentes propuestas y
datos que faltan por medir. No añadas valoraciones que no estén en mis notas.

3. De vuelta en la oficina, revisa el parte en el escritorio, completa las mediciones y adjunta las fotos al expediente oficial.

Por qué dictado y no modo voz: el resultado tiene que ser un texto exacto que firmas; con el dictado ves lo que se ha transcrito antes de enviarlo.

Truco de ruido: si alguna vez usas el modo voz en obra, cambia a pulsar para hablar ^[5].

5. Errores frecuentes y límites conocidos

• Hablar en español con el modo voz configurado en inglés. Hay que fijar el idioma antes; no se detecta solo ^[5].
• Buscar Fable en el modo voz. No está disponible ^[5].
• Esperar que el móvil maneje tus archivos locales. Solo a través de la app de escritorio abierta ^[4].
• Olvidar que consume cupo. El modo voz cuenta para los límites del plan ^[5].
• Desinstalar la app pensando que cancela la suscripción. No la cancela ^[3].
• Gesto de dictado distinto. La ayuda describe tocar el micrófono y luego la flecha; un tutorial de Academy describe mantener pulsado y soltar. Puede depender de la versión de la app (A2-35 en research/CONTRADICCIONES.md).
• Dispatch y Claude Duet. Dispatch (encargar tareas al escritorio desde el móvil) está en beta limitada y cerrado a usuarios nuevos ^[10]; se trata en la lección 15. Claude Duet es una vista previa solo para EE. UU. ^[11], por lo que no está disponible en España.

6. Ejercicio práctico

Enunciado:

1. Instala la app y configura el idioma del dictado y del modo voz en español.
2. Dicta las notas de una visita real o simulada (mínimo cinco observaciones) y pide que las ordene en tu formato de parte.
3. Mantén una conversación de dos minutos en modo voz para repasar un tema técnico (por ejemplo, las fases de una licitación de obra) y revisa después la transcripción en el historial.
4. Crea con Claude un evento de calendario para la siguiente visita y confírmalo tú en la app de calendario.

Criterio de éxito:

• El modo voz te responde en español sin que lo pidas en cada mensaje.
• El parte generado no contiene datos que no estuvieran en tu dictado.
• Has encontrado la transcripción del modo voz en tu historial.
• El evento de calendario lo has revisado y guardado tú.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. How to choose between voice mode and dictation (Academy) (se abre en una pestaña nueva) oficial acad-how-to-choose-between-voice-mode-and-dictat · consultada el 2026-10-25
2. Install Claude for iOS (se abre en una pestaña nueva) oficial sup-install-claude-for-ios · consultada el 2026-10-25
3. Install Claude for Android (se abre en una pestaña nueva) oficial sup-install-claude-for-android · consultada el 2026-10-25
4. Use Claude Cowork on web, desktop, and mobile (se abre en una pestaña nueva) oficial sup-cowork-surfaces · consultada el 2026-10-25
5. Use voice mode (se abre en una pestaña nueva) oficial sup-use-voice-mode · consultada el 2026-10-25
6. Use dictation on Claude mobile (se abre en una pestaña nueva) oficial sup-use-dictation-on-claude-mobile · consultada el 2026-10-25
7. Think through hard problems in voice mode (blog) (se abre en una pestaña nueva) oficial complementaria claude-think-through-hard-problems-in-voice-mode · consultada el 2026-10-25
8. Use Claude with iOS apps (se abre en una pestaña nueva) oficial sup-use-claude-with-ios-apps · consultada el 2026-10-25
9. Use Claude with Android apps (se abre en una pestaña nueva) oficial sup-use-claude-with-android-apps · consultada el 2026-10-25
10. Assign tasks from anywhere in Claude Cowork (Dispatch) (se abre en una pestaña nueva) oficial sup-cowork-dispatch · consultada el 2026-10-25
11. Get started with Claude Duet (se abre en una pestaña nueva) oficial sup-get-started-with-claude-duet · consultada el 2026-10-25
12. Claude Mobile apps (colección de ayuda) (se abre en una pestaña nueva) oficial sup-claude-mobile-apps · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Hay dos formas de que Claude trabaje con documentos de oficina, y conviene no confundirlas:

Resuelve el salto entre "Claude me da un texto" y "tengo el archivo listo": una hoja con fórmulas, un informe con los estilos de tu plantilla o una presentación con el patrón corporativo.

2. Cuándo usarla y cuándo NO

Creación de archivos en la app, cuando:

• Partes de cero o de datos sueltos (un CSV, unas notas) y quieres un archivo nuevo.
• No tienes Microsoft 365 o trabajas desde el móvil.

Claude for M365, cuando:

• El archivo ya existe y tiene que conservar fórmulas, estilos o plantilla.
• Quieres revisar un documento con control de cambios o entender un modelo de Excel celda a celda.

Cuándo NO:

• Macros y VBA. Claude for Excel no admite macros ni operaciones VBA, ni las tablas de datos de análisis de hipótesis ^[3]. Para revisar o escribir código VBA, pégalo como texto en el chat (lección 03) o usa Claude Code.
• Entregables finales sin revisión, cálculos críticos sin verificar o datos muy sensibles sin controles: la propia documentación de Excel lo desaconseja ^[3].
• Archivos de origen desconocido. Pueden contener instrucciones ocultas (inyección de instrucciones); usa solo hojas de confianza ^[3].
• Office 2016 o 2019, iPad o Android. Los complementos no funcionan en esas versiones ^[3].

3. Tutorial paso a paso

Parte A: crear archivos en la app

1. Activa Code execution and file creation (en el diseño nuevo, Create and edit files) en Settings > Capabilities. En Team y Enterprise lo controla un propietario en Organization settings > Capabilities. En el móvil: tus iniciales > Settings > Capabilities ^[1].
2. Viene activado por defecto en Free, Pro, Max y Team, y en Enterprise para organizaciones nuevas ^[1].
3. Pide el archivo indicando formato y estructura.
4. Descárgalo desde la conversación o guárdalo en Google Drive ^[1].

Límites y consumo ^[1]:

• 30 MB por archivo, al subir y al descargar.
• Consume más cupo que un chat normal.
• El artículo no menciona macros ni archivos .xlsm.

Parte B: instalar Claude for M365

1. Abre el listado Claude for Microsoft 365 en Microsoft AppSource y pulsa Get it now. Ese listado instala Excel, Word y PowerPoint; Outlook tiene listado propio, Claude for Outlook ^{[3] [4]}.
2. Abre la aplicación, activa el complemento e inicia sesión con tu cuenta de Claude ^[3].
3. En organizaciones, el administrador puede desplegarlo desde el Microsoft 365 Admin Center (Settings > Integrated apps) ^[3]. Si tu ayuntamiento bloquea la tienda de Office, habla con informática: el despliegue es suyo.

Planes: Excel, Word y PowerPoint están disponibles de forma general en Pro, Max, Team y Enterprise ^{[3] [5] [6]}. Outlook está en beta en esos mismos planes ^[4].

Versiones de Excel admitidas ^[3]:

• Excel en la web.
• Excel para Windows con suscripción a Microsoft 365, compilación 16.0.13127.20296 o posterior.
• Excel para Mac 16.46 o posterior.

Parte C: qué hace cada complemento

Excel ^[3]:

• Responde preguntas sobre el libro con citas a celdas en las que puedes hacer clic.
• Cambia supuestos manteniendo las fórmulas, para que se recalculen las celdas dependientes.
• Localiza el origen de errores como #REF! o #DIV/0 y propone la corrección.
• Crea modelos o rellena plantillas, también en libros de varias pestañas.
• Ordena, filtra, edita tablas dinámicas, aplica formato condicional y crea listas desplegables de validación.
• Avisa antes de sobrescribir datos.

Word ^[5]:

• Responde con citas a secciones del documento.
• Edita el texto seleccionado sin romper estilos ni numeración.
• Con control de cambios activado, sus ediciones quedan como revisiones que aceptas o rechazas.
• Recorre los comentarios, hace el cambio pedido y responde en el hilo.
• No admite archivos .doc antiguos: guárdalos antes como .docx.

PowerPoint ^[6]:

• Usa el patrón, los diseños, las fuentes y los colores de tu plantilla.
• Edita diapositivas concretas sin regenerar toda la presentación.
• Convierte viñetas en diagramas y gráficos nativos editables.

Outlook (beta) ^[4]:

• Clasifica la bandeja, resume hilos con citas, redacta respuestas y propone horas de reunión.
• Nunca envía nada por su cuenta: deja los borradores para que los envíes tú.
• Requiere Exchange Online (no funciona con Exchange local) y un consentimiento de Microsoft Graph que debe dar un administrador global del inquilino.

Parte D: instrucciones persistentes

En el panel del complemento, Settings > Instructions guarda preferencias para todas las conversaciones de esa aplicación (por ejemplo, separador de miles o moneda). Las de Excel solo valen en Excel ^[3].

4. Ejemplo práctico

Caso: presupuesto de una obra de reurbanización en Excel (con macros) y su memoria en Word.

1. Excel, con una copia de trabajo. La documentación recomienda empezar con una copia de confianza antes de pedir ediciones amplias ^[3]. Como el complemento no trabaja con macros ni VBA ^[3], y no está documentado si abre libros .xlsm (No verificado (NV21)), guarda una copia como .xlsx para el análisis y mantén el original con macros intacto.

Explica cómo se calcula el importe total de la celda H58 de la hoja Resumen,
con referencias a las celdas de origen. Después, localiza el origen del error
#REF! de la hoja Capítulo 3 y propón la corrección sin aplicarla.

Revisa las citas a celdas haciendo clic en ellas y aplica tú la corrección si es correcta.

2. Word, con control de cambios. Activa el control de cambios en la memoria del proyecto y pide:

Revisa el apartado 4 "Descripción de las obras" para que las unidades y cantidades
coincidan con el presupuesto. Mantén los estilos del documento y deja cada cambio
como revisión.

Aceptas o rechazas cada revisión en el panel de Word ^[5].

3. Lo que no harías: pedirle a Claude for Excel que reescriba las macros de cálculo; no está soportado ^[3]. Para eso, exporta el módulo VBA como texto y trabájalo en el chat o en Claude Code.

Variante sin Microsoft 365: sube el CSV de mediciones al chat y pide "crea un .xlsx con una hoja de mediciones, una de precios y una de resumen con fórmulas, no valores pegados". Descarga el archivo y comprueba las fórmulas.

5. Errores frecuentes y límites conocidos

• Pedir macros o VBA a Claude for Excel. No están soportados ^[3].
• Usar Office 2016 o 2019, Excel en iPad o en Android. El complemento no funciona ahí ^[3].
• Abrir un .doc antiguo en Word. Hay que convertirlo antes a .docx ^[5].
• Esperar que Outlook envíe correos. Solo deja borradores ^[4].
• Usar Outlook con Exchange local. Requiere Exchange Online ^[4].
• Buscar el historial del complemento en otro equipo. Se guarda en local en el navegador y no se sincroniza entre dispositivos ^[3].
• Dar por hecho que hereda la retención y auditoría de la organización. Claude for Excel no hereda la retención personalizada ni aparece en los registros de auditoría de Enterprise, aunque sí en la Compliance API (beta) ^[3]. Relevante si tu organismo tiene obligaciones de custodia.
• Abrir hojas de terceros sin precaución. Pueden contener instrucciones ocultas; revisa las confirmaciones que pide antes de operaciones de riesgo ^[3].
• Acceso a red en Team (creación de archivos): el artículo de ayuda se contradice; comprueba el ajuste en la administración (A3-53 en research/CONTRADICCIONES.md).
• Modelos en Outlook: la página cita modelos de generaciones anteriores; no se recoge aquí ningún modelo concreto (A1-23).

6. Ejercicio práctico

Enunciado: con una hoja de cálculo real de tu trabajo (copia sin datos personales y sin macros):

1. Pregunta a Claude cómo se calcula una celda clave y comprueba las citas.
2. Pide un cambio de supuesto (por ejemplo, un coeficiente o un precio unitario) y verifica que las fórmulas dependientes se recalculan y no se han convertido en valores.
3. En Word, con control de cambios, pide la corrección de un apartado y revisa cada revisión.
4. Si no tienes Microsoft 365, haz la variante: genera un .xlsx desde el chat a partir de un CSV y comprueba que contiene fórmulas.

Criterio de éxito:

• Has comprobado a mano al menos dos citas a celdas.
• Tras el cambio de supuesto, las celdas dependientes siguen teniendo fórmulas.
• Todas las ediciones en Word han quedado como revisiones y has decidido cada una.
• Tu original con macros sigue intacto y sabes por qué trabajaste sobre una copia.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Create and edit files with Claude (se abre en una pestaña nueva) oficial sup-create-and-edit-files-with-claude · consultada el 2026-10-25
2. Claude for M365 overview (se abre en una pestaña nueva) oficial claude-office-agents-overview · consultada el 2026-10-25
3. Use Claude for Excel (se abre en una pestaña nueva) oficial claude-excel · consultada el 2026-10-25
4. Use Claude for Outlook (se abre en una pestaña nueva) oficial claude-outlook · consultada el 2026-10-25
5. Use Claude for Word (se abre en una pestaña nueva) oficial claude-word · consultada el 2026-10-25
6. Use Claude for PowerPoint (se abre en una pestaña nueva) oficial claude-powerpoint · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Además de Microsoft 365 (lección 09), Claude se integra con otras herramientas de trabajo:

Resuelve el problema de cambiar de aplicación: Claude trabaja donde ya están tus correos, documentos, conversaciones de equipo o tu proyecto Android.

Esta lección se apoya en los conectores, que se explican en detalle en la lección 12: conviene leerla antes.

2. Cuándo usarla y cuándo NO

Úsala cuando:

• Tu organización trabaja en Google Workspace y quieres que Claude busque, lea o redacte sobre tus correos y documentos.
• Tu equipo coordina el trabajo en Slack y queréis delegar tareas compartidas en un canal (Claude Tag).
• Desarrollas la app Android en Android Studio y quieres Claude Code integrado en el IDE.

Cuándo NO:

• Claude Tag en planes individuales: no está disponible en Free, Pro ni Max ^[3].
• Complemento de Google con archivos de Office: solo trabaja con archivos nativos de Google; los de Office hay que convertirlos ^[2].
• Complemento de Google en Firefox: no funciona; sí en Chrome, Edge y Safari ^[2].
• Datos regulados: el complemento de Google no admite ZDR ni uso cubierto por HIPAA ^[2].

3. Tutorial paso a paso

A. Conectores de Google Workspace

Qué puede hacer cada uno ^[1]:

Aprobaciones por defecto: Claude pide tu aprobación antes de enviar, responder o reenviar correos y antes de compartir, mover o enviar a la papelera archivos de Drive. En Team y Enterprise, los propietarios pueden cambiarlo ^[1].

Añadir un archivo de Drive a un chat: + > Add from Google Drive > elige un archivo reciente o pega la URL. En proyectos, solo en proyectos privados, desde la sección Files ^[1].

Edición en directo: activa los conectores de Docs, Sheets o Slides, pega el enlace o pide un archivo por su nombre. Se abre en un panel junto al chat, en la web con Chrome o en Claude Desktop con el navegador integrado; si no, usa Open in Google ^[1].

B. Complemento dentro de Google Docs, Sheets y Slides

1. Instálalo desde Google Workspace Marketplace (una instalación vale para las tres apps).
2. Abre un archivo > Extensions > Claude > Open Claude ^[2].

En Sheets explica y escribe fórmulas, detecta valores escritos a mano, limpia datos y crea modelos y gráficos en pestañas nuevas. Cada operación tiene un máximo de 6 minutos, y no crea activadores, menús personalizados ni actualizaciones programadas ^[2].

C. Claude Tag en Slack (Team y Enterprise)

Configuración (la hace un propietario, una vez) ^[3]:

1. Entra en claude.ai/admin-settings/claude-tag.
2. En Slack, envía @Claude connect para obtener un código de emparejamiento e introdúcelo en la página.
3. Fija un límite de gasto mensual, añade Claude a los canales y lanza.

Uso: cualquiera en un canal donde esté Claude lo menciona con @Claude y le encarga una tarea. Claude publica en el hilo una lista de pasos mientras trabaja y todo queda visible para el canal ^[3].

Cómo funciona por dentro ^[3]:

• Cada tarea corre en un sandbox temporal en la nube, que se descarta cuando la conversación queda inactiva.
• Empieza sin acceso a tus sistemas: el administrador conecta los servicios por canal, espacio o para todo Slack.
• El trabajo en canales se cobra por uso contra el saldo de la organización, con el límite de gasto. Los mensajes directos uno a uno usan la cuenta de Claude de quien escribe.

La app anterior: Claude Tag sustituye a la app anterior "Claude in Slack", incluida "Claude Code in Slack". Desde el 05-10-2026 la versión anterior ya no responde en canales de espacios emparejados con una organización; en espacios no emparejados sigue respondiendo a usuarios Pro y Max ^[5].

D. Claude Code en Android Studio

Android Studio figura entre los IDE compatibles con el plugin de Claude Code para JetBrains, que está en beta ^[4]:

1. Instala la CLI de Claude Code (lección 18): el plugin no la incluye.
2. Instala el plugin Claude Code [Beta] desde JetBrains Marketplace y reinicia el IDE.
3. Ejecuta claude en el terminal integrado, o /ide desde un terminal externo para conectarlo ^[4].

El atajo para abrirlo es Ctrl+Esc en Windows y Linux, o Cmd+Esc en Mac ^[4].

4. Ejemplo práctico

Caso A, ayuntamiento con Google Workspace: preparar la reunión de seguimiento de una obra.

Con los conectores de Gmail, Calendar y Drive:
1. Busca los correos de la última semana con el asunto "Reurbanización calle Real"
   y resúmelos por remitente, con fecha.
2. Busca en Drive el acta de la reunión anterior y lista los acuerdos pendientes.
3. Propón tres huecos de una hora la semana próxima en los que estemos libres
   la directora de obra y yo.
No envíes nada ni crees eventos sin que te lo confirme.

Claude te pedirá aprobación antes de cualquier envío ^[1]; además, la última línea del prompt lo deja claro.

Caso B, equipo de desarrollo con Slack (Team): en el canal #app-inspecciones, alguien escribe:

@Claude la app Android falla al sincronizar partes sin conexión desde ayer.
Revisa los commits de esta semana del repositorio de la app, intenta reproducir
el fallo y abre un pull request en borrador con la corrección.

Para que funcione, el administrador ha concedido el repositorio a la app de GitHub de Claude. El pull request se revisa como el de cualquier compañero.

Caso C, Android Studio: abres el proyecto de la app, ejecutas claude en el terminal integrado y trabajas con Claude Code como en el módulo C.

5. Errores frecuentes y límites conocidos

• Esperar que Claude lea los adjuntos de Gmail. Solo ve sus metadatos ^[1].
• Esperar imágenes de Drive. Al leer archivos extrae solo el texto ^[1].
• Pedir un "documento" genérico esperando un Google Doc. Si no nombras Google, crea un archivo local ^[1].
• Usar el complemento de Google con un .docx o .xlsx sin convertir. Solo admite archivos nativos ^[2].
• Gráficos en Slides. El conector no puede añadir gráficos a Google Slides ^[1].
• Buscar Claude Tag con una cuenta Pro. Es solo de Team y Enterprise ^[3].
• Dar por hecho que Claude Tag ve todo. Empieza sin acceso; el administrador define qué alcanza en cada canal ^[3].
• Gmail "solo borradores". Algunas fuentes antiguas decían que no enviaba; la ayuda vigente dice que envía con aprobación (A1-22 en research/CONTRADICCIONES.md).
• Plugin de JetBrains en modos automáticos. La documentación advierte de que, en modos que aceptan ediciones solas, Claude podría modificar archivos de configuración del IDE; se recomienda el modo manual ^[4].

6. Ejercicio práctico

Enunciado: elige la integración que corresponda a tu entorno:

• Google Workspace: conecta Gmail, Calendar y Drive y repite el caso A con un tema real.
• Slack con Team: pide a tu administrador un canal de prueba con Claude Tag y encárgale convertir un hilo de decisión en un documento.
• Android Studio: instala el plugin y pide a Claude Code que explique la estructura de módulos de tu proyecto.

Criterio de éxito:

• La integración funciona y sabes qué plan o permiso de administrador ha hecho falta.
• Has comprobado al menos un resultado contra la fuente original (correo, acta o código).
• Ninguna acción con efectos (enviar, compartir, borrar, abrir pull request) se ha ejecutado sin tu revisión.
• Sabes explicar qué datos ve Claude en tu integración y cuáles no.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Use Google Workspace connectors (se abre en una pestaña nueva) oficial sup-use-google-workspace-connectors · consultada el 2026-10-25
2. Use Claude in Google Docs, Sheets, and Slides (se abre en una pestaña nueva) oficial sup-use-claude-in-google-docs-sheets-and-slides · consultada el 2026-10-25
3. Work with Claude Tag (se abre en una pestaña nueva) oficial claude-claude-tag-overview · consultada el 2026-10-25
4. JetBrains IDEs (Claude Code) (se abre en una pestaña nueva) oficial cc-jetbrains · consultada el 2026-10-25
5. Migrate from the earlier Claude in Slack app (Claude Tag) (se abre en una pestaña nueva) oficial claude-migrate-from-earlier · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Research es el modo de investigación de Claude: en lugar de una búsqueda puntual, hace búsquedas encadenadas en la web y en tus herramientas conectadas y devuelve un informe con citas ^[1]. Cada afirmación del informe enlaza a su fuente ^[2].

Resuelve el problema de las preguntas que necesitan muchas fuentes: una revisión del estado de la técnica, una comparativa de soluciones o un informe previo a una decisión.

2. Cuándo usarla y cuándo NO

La ayuda oficial distingue tres herramientas ^[3]:

• Búsqueda web: un dato concreto y actual.
• Razonamiento extendido: un problema complejo que no necesita información externa.
• Research: un informe que reúne muchas fuentes. Razonamiento y Research se pueden combinar.

Úsalo para:

• Preparar un informe técnico de opciones (materiales, soluciones constructivas, tecnologías).
• Revisar qué publican fuentes oficiales sobre un tema antes de redactar una propuesta.
• Combinar información de la web con tus documentos internos conectados.

Cuándo NO:

• Para una pregunta con respuesta única: la búsqueda web es más rápida y gasta menos.
• Si la respuesta está en tus propios documentos: súbelos o usa un Proyecto.
• Como base única de una decisión: el informe es un punto de partida que verificas (lección 07).
• En el plan Free: no está disponible ^[1].

3. Tutorial paso a paso

Paso 1: prepara el chat

1. Comprueba que la búsqueda web está activada: Research no funciona sin ella ^[1].
2. Si quieres que use tus documentos, activa los conectores que necesites en ese chat (lección 12).
3. Lanza la investigación desde la web o el escritorio si necesitas conectores: en el móvil solo busca en la web y omite los conectores sin avisar ^[1].

Paso 2: actívalo

• Pulsa + abajo a la izquierda y elige Research. Aparece un indicador azul; púlsalo otra vez para desactivarlo ^[1].
• En la interfaz unificada de chat y Cowork también puedes usar /deep-research ^[4].

Paso 3: escribe un buen encargo

Los consejos oficiales son indicar el objetivo y las decisiones que debe apoyar, la estructura del informe y las restricciones (presupuesto, plazo, ámbito geográfico) ^[2]. Si Claude no investiga, pídeselo de forma explícita ("usa la herramienta de investigación para…") ^[1].

Paso 4: espera y revisa

• Duración: la ayuda habla de entre 1 y 3 minutos ^[3], Academy de "unos minutos o más" ^[2], y un anuncio de 2025 de entre 5 y 45 minutos para investigaciones avanzadas ^[5]. Cuenta con que puede ir de unos minutos a decenas de minutos (A5-62 en research/CONTRADICCIONES.md).
• Revisión: abre las citas de las afirmaciones clave y comprueba que dicen lo que el informe atribuye.

Paso 5: cuidado con los conectores de escritura

Durante Research, Claude usa las herramientas de los conectores sin pedir aprobación en cada uso ^[1]. La ayuda de conectores personalizados recomienda desactivar las herramientas que escriben o modifican datos antes de investigar ^[6].

4. Ejemplo práctico

Caso: informe previo sobre pavimentos drenantes para calles residenciales de un municipio de clima mediterráneo.

Objetivo: preparar un informe previo para la comisión de urbanismo que decida
si incluir pavimentos drenantes en el próximo plan de reurbanización de calles
residenciales con tráfico bajo.

Estructura:
1. Tipos de pavimento drenante usados en vías urbanas y sus requisitos de
   mantenimiento.
2. Experiencias documentadas en municipios españoles o europeos de clima
   mediterráneo, con fuente.
3. Ventajas, limitaciones y riesgos (colmatación, capacidad portante, coste de
   mantenimiento).
4. Normativa o guías técnicas españolas aplicables, citando la fuente oficial
   y la fecha de cada documento.
5. Preguntas abiertas que el equipo técnico debería resolver.

Restricciones:
- Prioriza fuentes oficiales y técnicas (administraciones, centros de
  investigación, normas). Señala cuándo una fuente es comercial.
- Si no encuentras un dato, dilo en lugar de estimarlo.
- Máximo 1.500 palabras.

Revisión del resultado:

1. Abre las fuentes de los apartados 2 y 4 y comprueba fechas y vigencia.
2. Marca como pendiente cualquier norma citada que no hayas podido abrir.
3. Usa el informe como borrador interno; el informe a la comisión lo firma el técnico.

5. Errores frecuentes y límites conocidos

• Lanzarlo sin búsqueda web. No funciona ^[1].
• Lanzarlo desde el móvil esperando conectores. Solo busca en la web, sin avisar ^[1].
• Esperar que use servidores MCP locales de Claude Desktop. No puede ^[1].
• Dejar activos conectores con permisos de escritura. Research los usa sin aprobación ^{[1] [6]}.
• Elegir modelo para Research. Usa Opus 5.5 u Opus 4.8 aunque elijas otro; en Team y Enterprise falla si el administrador ha desactivado los dos para tu rol ^[1].
• Gastar el cupo. Consume los límites más deprisa que un chat normal ^[1].
• Fiarse de una cita sin abrirla. Las citas facilitan la verificación, no la sustituyen ^[7].

6. Ejercicio práctico

Enunciado: encarga a Research un informe sobre una decisión técnica real de tu trabajo (un material, una tecnología, una librería para tu app Spring Boot o Android).

1. Escribe el encargo con objetivo, estructura en apartados y restricciones.
2. Lánzalo desde la web o el escritorio.
3. Elige cinco afirmaciones del informe y comprueba sus fuentes.
4. Anota cuánto ha tardado y si alguna fuente era comercial o estaba desactualizada.

Criterio de éxito:

• El encargo tiene objetivo, estructura y al menos dos restricciones.
• Has verificado cinco afirmaciones con su fuente y anotado el resultado de cada una.
• Has identificado al menos una limitación del informe (dato que falta, fuente débil o desactualizada).
• Antes de lanzarlo, revisaste qué conectores estaban activos y si alguno podía escribir datos.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Use Research on Claude (se abre en una pestaña nueva) oficial sup-use-research-on-claude · consultada el 2026-10-25
2. Research mode for deep dives (Academy) (se abre en una pestaña nueva) oficial acad-research-mode-for-deep-dives · consultada el 2026-10-25
3. When should I use web search, extended thinking, and Research? (se abre en una pestaña nueva) oficial sup-when-should-i-use-web-search-extended-thinki · consultada el 2026-10-25
4. Claude Cowork and chat are one Claude (se abre en una pestaña nueva) oficial sup-cowork-onechat · consultada el 2026-10-25
5. Integrations and advanced Research (blog) (se abre en una pestaña nueva) oficial complementaria claude-integrations · consultada el 2026-10-25
6. Get started with custom connectors using remote MCP (se abre en una pestaña nueva) oficial sup-get-started-with-custom-connectors-using-rem · consultada el 2026-10-25
7. Claude is providing incorrect or misleading responses. What's going on? (se abre en una pestaña nueva) oficial sup-claude-is-providing-incorrect-or-misleading · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Un conector permite a Claude acceder a una aplicación o servicio externo, recuperar datos y actuar en él: tu correo, tu almacenamiento de documentos, tu gestor de tareas o un sistema propio. Claude hereda los permisos que tú tienes en ese servicio ^[1].

Resuelve el problema de copiar y pegar: en lugar de llevar la información a Claude, Claude va a buscarla donde está.

Los conectores se basan en el Model Context Protocol (MCP), el estándar abierto que Anthropic publicó para conectar asistentes de IA con datos y herramientas ^[2]. El protocolo se explica en la lección 23; aquí nos centramos en usarlos desde la app.

Tipos ^{[1] [3]}:

2. Cuándo usarla y cuándo NO

Usa un conector remoto (directorio o personalizado) para servicios en la nube con URL pública: funciona en todas las superficies ^[3].

Usa una extensión de escritorio para archivos locales, bases de datos en localhost, aplicaciones de escritorio o acceso al sistema ^[3].

Cuándo NO:

• Servidores internos detrás de una VPN o cortafuegos como conector personalizado: Claude se conecta desde la nube de Anthropic, no desde tu equipo. Si el servidor no es accesible desde internet (o no se permiten los rangos IP de Anthropic), no conectará ^[5]. Para un sistema interno del ayuntamiento, esto suele descartar el conector personalizado y apuntar a una extensión de escritorio o a Claude Code.
• Servidores de los que no te fías. Anthropic no verifica los conectores personalizados ^[5].
• Datos que no pueden salir de tu jurisdicción sin analizarlo: los servicios conectados procesan los datos en su propia infraestructura y con sus propias condiciones, posiblemente fuera de EE. UU. ^[1].

3. Tutorial paso a paso

A. Conectar un servicio del directorio

1. Desde un chat: pulsa + (o escribe /), pasa el ratón por Connectors, elige Manage connectors y pulsa + junto a Connectors. También desde Customize > Connectors ^[1].
2. Abre el conector, revisa la descripción, pulsa Connect o Install y autentícate ^[1].

B. Activarlo en cada conversación

Los servicios conectados no están activos en todas las conversaciones: + (o /) > Connectors > activa los que necesites en ese chat ^[1].

Tool access: en el mismo menú, Tool access permite elegir Auto (por defecto) u On demand; se recomienda On demand con 10 o más conectores activos ^[1].

C. Añadir un conector personalizado (Pro y Max)

1. Customize > Connectors > + Add > Add custom connector.
2. Escribe un nombre y la URL del servidor MCP remoto > Continue.
3. Revisa la autenticación detectada > Continue.
4. En Authentication, elige Sign in now, Sign in when needed o No sign in.
5. En OAuth client, la opción recomendada es Use Claude's published identity.
6. Si el servidor usa una clave fija, añádela en Request headers.
7. Pulsa Add ^[5].

D. Extensiones de escritorio

• Se gestionan en Claude Desktop: Settings > Desktop app > Manage junto a Extensions (en el diseño anterior, Settings > Extensions) ^[3].
• Una extensión es un paquete .mcpb (antes .dxt) que incluye el servidor MCP y sus dependencias. Se instala abriéndolo con Claude Desktop y pulsando Install, sin terminal ni archivos de configuración ^[6].
• Los valores sensibles, como claves de API, se guardan en el llavero del sistema operativo ^[6].

E. En Team y Enterprise

1. Un Owner o Primary Owner habilita el conector en Organization settings > Connectors > Browse connectors > Add to your team. Habilitarlo no da acceso: cada miembro se autentica con su cuenta ^[1].
2. Los conectores personalizados los añade un propietario en Organization settings > Connectors > Add > Custom > Web; después cada miembro pulsa Connect en Customize > Connectors ^[5].
3. Permisos de herramientas: para cada categoría o herramienta, Always allow, Needs approval o Blocked. Se aplican a toda la organización y solo pueden restringir ^[1].
4. Solicitudes: con Let members request connectors activado (por defecto en Team, no en Enterprise), las peticiones llegan a Organization settings > Notifications, pestaña Requests ^[1].

En Team y Enterprise los conectores solo funcionan en proyectos privados, y los chats con contenido sincronizado no se pueden compartir ^[1].

4. Ejemplo práctico

Caso: un técnico quiere que Claude consulte dos fuentes:

1. El gestor de documentos en la nube del ayuntamiento, si tiene conector en el directorio.
2. Una base de datos local (SQLite) con el inventario de señalización vertical, en su portátil.

Decisión por tipo de conector:

Uso con permisos mínimos:

Con la extensión de la base de datos de señalización (solo lectura):
lista las señales de la calle Mayor instaladas antes de 2015, agrupadas por tipo,
y prepara una tabla para planificar su reposición. No modifiques ningún registro.

Configuración prudente: activa solo los conectores necesarios en ese chat y, si la extensión ofrece herramientas de escritura, desactívalas o déjalas con aprobación.

5. Errores frecuentes y límites conocidos

• No ver los datos del conector. Está conectado pero no activado en esa conversación ^[1].
• Conector personalizado que no conecta. El servidor está detrás de una VPN o cortafuegos ^[5].
• Buscar servidores locales en claude.ai o Cowork. Los configurados en claude_desktop_config.json no están disponibles ahí ^[5].
• Instalar extensiones de escritorio en la web o el móvil. Solo funcionan en Claude Desktop y Claude Code ^[3].
• Editar un conector personalizado. Hay que quitarlo y volver a añadirlo ^[5].
• Inyección de instrucciones. Un servidor malicioso o un contenido manipulado pueden intentar dar órdenes a Claude; revisa las entradas y salidas de las herramientas y elige "permitir siempre" solo con servidores de confianza ^[5].
• Research con conectores de escritura. Durante Research se usan sin aprobación por uso; desactiva las herramientas que escriben ^[5].
• Free y conectores personalizados. Solo uno ^[1].
• Rutas distintas para añadir un conector personalizado según el artículo y el plan (A2-27 en research/CONTRADICCIONES.md).

6. Ejercicio práctico

Enunciado:

1. Conecta un servicio del directorio que uses en tu trabajo.
2. Abre dos chats: en uno activa el conector y en otro no. Haz la misma pregunta y compara.
3. Revisa los permisos de las herramientas del conector y desactiva (o pon con aprobación) las que escriben o borran datos.
4. Haz una lista de los sistemas de tu organización que te gustaría conectar y clasifícalos en: directorio, personalizado (con URL pública), extensión de escritorio o no viable.

Criterio de éxito:

• El conector responde con datos reales en el chat donde está activado y no en el otro.
• Las herramientas con efectos (escribir, enviar, borrar) están desactivadas o requieren aprobación.
• Tu lista de sistemas justifica cada clasificación con la accesibilidad del sistema (internet, intranet o equipo local).
• Sabes qué servicio externo procesa los datos de cada conector que usas.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Use connectors to extend Claude's capabilities (se abre en una pestaña nueva) oficial sup-use-connectors-to-extend-claude-s-capabiliti · consultada el 2026-10-25
2. Introducing the Model Context Protocol (se abre en una pestaña nueva) oficial news-model-context-protocol · consultada el 2026-10-25
3. When to use desktop and web connectors (se abre en una pestaña nueva) oficial sup-when-to-use-desktop-and-web-connectors · consultada el 2026-10-25
4. Use interactive connectors in Claude (se abre en una pestaña nueva) oficial sup-use-interactive-connectors-in-claude · consultada el 2026-10-25
5. Get started with custom connectors using remote MCP (se abre en una pestaña nueva) oficial sup-get-started-with-custom-connectors-using-rem · consultada el 2026-10-25
6. Desktop Extensions (Anthropic Engineering) (se abre en una pestaña nueva) oficial eng-desktop-extensions · consultada el 2026-10-25

1. Qué es y qué problema resuelve

En la lección 06 creaste artefactos sencillos. Esta lección cubre tres capacidades que los convierten en herramientas de trabajo:

1. Plantillas: tipos de artefacto con un editor propio: Docs, Slides, Design, Dashboards y Motion ^[1].
2. Artefactos con IA: artefactos que llaman a Claude mientras alguien los usa ^[1].
3. Artefactos con conectores y almacenamiento: leen y escriben en tus aplicaciones conectadas y guardan datos entre sesiones ^[1].

Resuelve el problema de pasar de "un documento estático" a "una herramienta que el equipo usa": un documento vivo que se edita en común, una presentación con la plantilla institucional o un panel que consulta datos.

2. Cuándo usarla y cuándo NO

Úsalas cuando:

• Varias personas tienen que editar o comentar el mismo documento (Docs).
• Necesitas una presentación coherente con un sistema de diseño (Slides, Design).
• Quieres respuestas rápidas sobre datos de un almacén o de una aplicación conectada (Dashboards).
• Una herramienta interna necesita "pensar" (artefactos con IA), por ejemplo clasificar textos que pega el usuario.

Cuándo NO:

• Análisis profundos o definitivos con Dashboards: está pensado para preguntas exploratorias rápidas; para análisis más profundos, lleva el panel a otra herramienta ^[2].
• Compartir con enlace público un artefacto que usa conectores o llama a Claude: no se puede compartir por enlace ^[3].
• Datos sensibles en almacenamiento compartido: todos los que abren el artefacto lo ven ^[3].
• Documentos que deben conservarse con garantías: en Docs, el borrado es permanente y no hay papelera ^[4].

3. Tutorial paso a paso

A. Crear desde una plantilla

1. Comprueba que tienes activada la ejecución de código y creación de archivos (lección 06).
2. En la caja de mensaje pulsa Output y elige la plantilla, o elige una en la pestaña Artifacts ^[1]. Para un documento también puedes escribir /docs ^[4].
3. Describe público, propósito, secciones y fuentes.
4. Refina por chat, editando directamente o con comentarios.

B. Docs: trabajar en común

• Selecciona texto para comentar. Si mencionas @Claude en un comentario, Claude hace la edición que pides con los permisos de quien lo pide ^[4].
• Los gráficos que vienen de aplicaciones conectadas no se actualizan solos: pide a Claude que los refresque ^[4].
• Exporta a Word, PDF, Markdown o Google Docs; un documento puede convertirse en presentación con Slides ^[4].
• Solo el propietario puede renombrar o borrar, y el borrado es permanente ^[4].

C. Design: diseños con sistema de diseño

• Empieza con Output > Design. Refina por chat, edición directa o comentarios en línea ^[5].
• Los proyectos nuevos heredan el sistema de diseño de la organización si existe ^[5].
• Export (arriba a la derecha) ofrece, entre otros, .zip, PDF, PPTX, HTML independiente y Google Slides ^[5].
• La versión independiente de Claude Design (claude.ai/design) cierra el 14-12-2026; hay que trasladar antes los sistemas de diseño ^[5].

D. Dashboards (beta)

1. Conecta un almacén de datos (Redshift, BigQuery, ClickHouse, Databricks o Snowflake) u otra aplicación conectada ^[2].
2. Pide el panel en el chat, con Output > Dashboards o con la plantilla de la pestaña Artifacts ^[2].
3. Funciona mejor si describes qué quieres saber y nombras la tabla o aplicación, en lugar de pedir un gráfico concreto ^[2].
4. Claude escribe una consulta SQL por gráfico; puedes abrir cada consulta para ver qué cuenta, y cada gráfico muestra cuándo se refrescó ^[2].
5. En Enterprise viene desactivado: un propietario lo activa en Organization settings > Artifacts ^[2].

E. Artefactos con IA

• El artefacto puede llamar a Claude. Quien lo usa inicia sesión con su propia cuenta y el consumo cuenta en su plan; el autor no necesita claves de API ni paga más ^[1].
• Los artefactos nuevos piden permiso la primera vez que necesitan llamar a Claude ^[1].

F. Artefactos con conectores y almacenamiento

• En Pro, Max, Team y Enterprise (web y escritorio), un artefacto puede leer y escribir en tus aplicaciones conectadas ^[1].
• Cada persona que lo abre usa sus propias conexiones: si no tiene acceso, verá errores en lugar de tus datos ^[3].
• Puede guardar datos de texto entre sesiones en almacenamiento personal o compartido, con un máximo de 20 MB por artefacto y sin imágenes ni binarios ^[1].

G. Administración (Team y Enterprise)

Los propietarios controlan los artefactos en Organization settings > Artifacts (artefactos, plantillas, compartición externa, invitaciones por correo, presencia y sistemas de diseño) y los conectores en artefactos con Enable artifact connectors en Organization settings > Capabilities ^[6]. Ese último ajuste es todo o nada: no se puede limitar a qué aplicaciones llegan ^[6].

4. Ejemplo práctico

Caso: seguimiento de incidencias en vía pública para el concejal de Obras.

1. Dashboards (si los datos están en un almacén conectado):

Con la tabla incidencias_via_publica del almacén conectado, quiero saber:
- cuántas incidencias se abrieron cada mes del último año, por tipo
  (pavimento, alumbrado, señalización, otros);
- el tiempo medio de resolución por tipo;
- los diez tramos de calle con más incidencias abiertas.
Muéstrame la consulta de cada gráfico.

Abre cada consulta y comprueba, con una consulta tuya o con el sistema de origen, que los totales coinciden.

2. Docs para el informe trimestral: crea el documento con /docs, comparte con el jefe de servicio con permiso de edición y pídele que deje comentarios; resuelve los que sean de redacción mencionando @Claude.

3. Slides para la comisión: convierte el documento en presentación y aplica la plantilla institucional si tu organización tiene un sistema de diseño cargado.

4. Artefacto con IA para la oficina de atención ciudadana: una herramienta donde el personal pega el texto de un aviso y Claude propone categoría y prioridad. Cada persona usa su propia cuenta y su cupo ^[1]. Por diseño, la herramienta no guarda los avisos (no usa almacenamiento compartido).

5. Errores frecuentes y límites conocidos

• Esperar refresco automático en Docs. Los gráficos de apps conectadas se refrescan cuando se le pide a Claude ^[4].
• Frecuencia de refresco de Dashboards. Cada gráfico muestra su último refresco, pero la frecuencia no está documentada: No verificado (NV5).
• Buscar Dashboards en Enterprise. Hay que activarlo antes ^[2].
• Compartir por enlace un artefacto con conectores o IA. No es posible ^[3].
• Borrar un Doc por error. Es permanente ^[4].
• Seguir trabajando en el Claude Design independiente. Cierra el 14-12-2026 ^[5].
• Live artifacts antiguos. Los artefactos de Cowork creados antes del 19-08-2026 no se editan en el sitio: hay que volver a publicarlos como artefacto nuevo ^[7].
• Plantillas en beta. La documentación de Claude Code dice que todas las plantillas están en beta y la ayuda solo marca así Dashboards y Motion (A1-15 en research/CONTRADICCIONES.md).
• Residencia de datos. Claude Design no admite residencia de datos ^[6].

6. Ejercicio práctico

Enunciado: crea un pequeño "kit" de artefactos para un tema de tu servicio:

1. Un Doc con un procedimiento interno, compartido con un compañero que deje al menos dos comentarios.
2. Resuelve un comentario mencionando @Claude y otro a mano.
3. Convierte el Doc en Slides y expórtalo a PDF.
4. Si tienes datos conectados, crea un Dashboard con dos preguntas y revisa sus consultas SQL. Si no, crea un artefacto con IA que resuma textos pegados por el usuario.

Criterio de éxito:

• El Doc tiene comentarios resueltos y sabes quién puede borrarlo.
• La presentación exportada mantiene el contenido del Doc.
• Has leído al menos una consulta SQL del Dashboard y comprobado su resultado, o has probado el artefacto con IA con dos textos distintos.
• Ningún artefacto con conectores o IA está compartido por enlace público.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. What are artifacts and how do I use them? (se abre en una pestaña nueva) oficial sup-artifacts · consultada el 2026-10-25
2. Get started with Claude Dashboards (se abre en una pestaña nueva) oficial sup-dashboards · consultada el 2026-10-25
3. Share artifacts (se abre en una pestaña nueva) oficial sup-share-artifacts · consultada el 2026-10-25
4. Get started with Claude Docs (se abre en una pestaña nueva) oficial sup-docs · consultada el 2026-10-25
5. Get started with Claude Design (se abre en una pestaña nueva) oficial sup-design · consultada el 2026-10-25
6. Artifacts admin guide for Team and Enterprise plans (se abre en una pestaña nueva) oficial sup-artifacts-admin · consultada el 2026-10-25
7. Use live artifacts in Claude Cowork (se abre en una pestaña nueva) oficial sup-live-artifacts · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Claude Cowork lleva el enfoque agéntico de Claude Code al trabajo que no es programación: describes el resultado que quieres y Claude ejecuta una tarea de varios pasos, como organizar archivos o producir hojas de cálculo y presentaciones, sin terminal ^[1].

Resuelve el problema de las tareas que no caben en una respuesta: reunir información de varias fuentes, procesar una carpeta de documentos, generar varios entregables y entregarlos como archivos editables.

El nombre y la fusión con el chat. Lo que al principio de este tutorial llamabas "cowork" se llama oficialmente Claude Cowork. Anthropic lo está fusionando con el chat: en la experiencia nueva no eliges modo, Claude decide si responde rápido o emprende una tarea larga ^[2]. Si tu caja de mensaje todavía muestra las opciones Chat y Cowork, tu cuenta aún no tiene la experiencia nueva; cuando llega, no se puede volver atrás ^[2].

Dónde se ejecuta. Desde el 06-10-2026, las tareas nuevas de Pro y Max se ejecutan en la nube en todas las superficies, sin opción de elegir ^[3]. Cada sesión corre en un entorno temporal en servidores de Anthropic que se destruye al terminar ^[4].

Planes y superficies ^[1]:

Free no tiene Cowork ^[1].

2. Cuándo usarla y cuándo NO

Úsala para:

• Procesar una carpeta de documentos (clasificar, renombrar, extraer datos a una tabla).
• Producir varios entregables encadenados: investigar, resumir y generar un informe y una presentación.
• Tareas que conviene repetir con regularidad (lección 15).

Cuándo NO:

• Programar sobre un repositorio: para eso está Claude Code ^[5].
• Archivos muy sensibles: la ayuda recomienda evitarlos y trabajar en una carpeta dedicada con copias de seguridad ^[6]. Los archivos locales que abre una sesión se procesan en servidores de Anthropic ^[6].
• Trabajo que deba quedar solo en tu equipo: el modo "solo en tu ordenador" se ha retirado para las tareas nuevas de Pro y Max; ese trabajo pasa a Claude Code en la app de escritorio ^[3].
• Una pregunta rápida: gasta menos un chat normal; dile a Claude si solo quieres una respuesta breve ^[1].

3. Tutorial paso a paso

Paso 1: elige el modo de aprobación

En el selector de modo de la caja de mensaje ^{[1] [6]}:

• Por defecto: Auto en Pro, Max y Team; Manual en Enterprise. El modo se aplica a toda la conversación ^[2].
• Siempre, en cualquier modo, Claude pide permiso explícito antes de borrar archivos de forma permanente ^[6].
• La ayuda recomienda Manually approve para archivos, cuentas o sitios sensibles, herramientas nuevas y acciones difíciles de deshacer ^[6].

Paso 2: conecta solo lo necesario

• Carpetas locales (escritorio): Claude solo accede a las carpetas que conectas ^[1]. Una sesión en la nube solo llega a tu equipo mientras Claude Desktop está abierto, solo en esas carpetas y con tus permisos ^[6].
• Instrucciones de carpeta: al elegir una carpeta local puedes añadir contexto propio de ese proyecto ^[1].
• Conectores y plugins: se gestionan desde + o desde Customize > Connectors; cada herramienta puede quedar en Always allow, Needs approval o Blocked ^[1].

Paso 3: describe el resultado

• Interfaz anterior: elige Cowork en la caja de mensaje, describe la tarea, revisa el planteamiento de Claude y déjalo trabajar ^[1].
• Experiencia nueva: escribe la tarea en cualquier conversación ^[1].

Describe el resultado final, los archivos de entrada, el formato de salida y qué no debe tocar.

Paso 4: supervisa y revisa

• Vigila accesos inesperados a archivos o sitios y que la tarea no se desvíe; detenla si algo no cuadra ^[6].
• Recibirás una notificación en el móvil cuando la tarea termine o necesite una respuesta ^[3].
• Revisa los archivos entregados antes de usarlos.

Paso 5: gestiona tus tareas

• Las tareas aparecen en Recents junto a los chats ^[2].
• Para borrar: menú ⋮ o icono de papelera. Sale del historial al momento y del almacenamiento interno en 30 días ^[1].
• Las sesiones no se pueden compartir; los artefactos sí ^[1].
• Consulta el consumo en Settings > Usage: las tareas largas gastan mucho más que una pregunta rápida ^[2].

4. Ejemplo práctico

Caso: preparar la documentación de una revisión de contratos menores de obra del último trimestre.

Preparación:

1. Crea una carpeta de trabajo revision_contratos_T3 con copias de los PDF de los contratos (sin datos personales innecesarios) y la plantilla de informe en DOCX.
2. Conecta solo esa carpeta.
3. Elige Manually approve para la primera ejecución.

Encargo:

En la carpeta revision_contratos_T3 hay los contratos menores de obra del tercer
trimestre (PDF) y la plantilla de informe (DOCX).

1. Crea una hoja de cálculo con una fila por contrato: número de expediente,
   objeto, adjudicatario, importe sin IVA, fecha de adjudicación y plazo de ejecución.
   Si un dato no aparece en el PDF, deja la celda vacía y márcala en una columna
   "Dato no encontrado".
2. Ordena la hoja por importe y añade una fila de totales con fórmulas.
3. Rellena la plantilla de informe con un resumen de la hoja: número de contratos,
   importe total, contratos por tipo de obra y observaciones.
4. Guarda los dos archivos en una subcarpeta "salida". No modifiques ni borres
   los PDF originales.

Revisión: comprueba tres filas al azar contra sus PDF, revisa que la fila de totales use fórmulas y lee el informe antes de pasarlo al jefe de servicio.

Por qué funciona: carpeta dedicada con copias (recomendación oficial ^[6]), aprobación manual la primera vez, criterio explícito para datos que faltan y prohibición de tocar los originales.

5. Errores frecuentes y límites conocidos

• Cerrar Claude Desktop a mitad de una tarea con archivos locales. La sesión en la nube sigue, pero pierde el acceso a tus archivos ^[3].
• Confundir aislamiento con permiso. El entorno aislado protege tu equipo y tu red del código que ejecuta Claude, pero no limita lo que Claude lee o hace con el acceso que le das ^[6].
• Inyección de instrucciones. El riesgo aparece cuando Claude lee contenido externo y además puede actuar; limitar cualquiera de las dos cosas lo reduce ^[6].
• Pensar que los permisos de red lo cubren todo. No se aplican a web fetch, búsqueda web ni MCP, incluido Claude in Chrome ^[6].
• Buscar "Only on your computer". Se ha retirado para las tareas nuevas de Pro y Max ^[3].
• Plugins con servidores MCP locales en la web o el móvil. Solo funcionan en la app de escritorio ^[1].
• Cuotas. No hay cifras oficiales de uso de Cowork por plan: No verificado (NV7).
• Nombres de modos distintos según la página (Manual/Auto/Skip frente a los nombres largos): esta lección usa los nombres largos de la ayuda vigente (A2-25 en research/CONTRADICCIONES.md).
• Administración pública: en Team y Enterprise, el historial de las sesiones locales se guarda en el equipo del usuario, fuera de las políticas de retención, y el administrador no puede borrarlo de forma centralizada ^[7]. Tenlo en cuenta para la custodia documental.

6. Ejercicio práctico

Enunciado: delega en Cowork una tarea real de documentación con una carpeta de copias.

1. Crea una carpeta de trabajo con entre 5 y 15 documentos de prueba (copias, sin datos personales).
2. Encarga una tarea con al menos dos entregables (una tabla y un documento).
3. Hazlo primero en Manually approve y observa qué acciones pide aprobar.
4. Repite una variante en Automatically approve y compara.

Criterio de éxito:

• Claude solo ha accedido a la carpeta de trabajo y los originales siguen intactos.
• Has comprobado a mano al menos tres datos de la tabla contra los documentos.
• Puedes describir qué acciones pidió aprobar en modo manual y cuáles hizo solo en modo automático.
• Sabes dónde se ha procesado cada archivo (tu equipo o la nube) y cómo borrar la tarea.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Get started with Claude Cowork (se abre en una pestaña nueva) oficial sup-cowork-start · consultada el 2026-10-25
2. Claude Cowork and chat are one Claude (se abre en una pestaña nueva) oficial sup-cowork-onechat · consultada el 2026-10-25
3. Use Claude Cowork on web, desktop, and mobile (se abre en una pestaña nueva) oficial sup-cowork-surfaces · consultada el 2026-10-25
4. Claude Cowork architecture overview (se abre en una pestaña nueva) oficial sup-cowork-arch · consultada el 2026-10-25
5. Claude Code Desktop (se abre en una pestaña nueva) oficial cc-desktop · consultada el 2026-10-25
6. Use Claude Cowork safely (se abre en una pestaña nueva) oficial sup-cowork-safe · consultada el 2026-10-25
7. Use Claude Cowork on Team and Enterprise plans (se abre en una pestaña nueva) oficial sup-cowork-team · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Algunas tareas no se hacen una vez, sino cada semana o cada mañana: un resumen de novedades, una revisión de pull requests, un informe periódico. Claude tiene dos sistemas de tareas programadas y una función para encargar trabajo desde el móvil:

Resuelve el problema de acordarse de hacer las tareas repetitivas y de poder delegarlas cuando no estás delante del ordenador.

No confundas los dos /schedule. En una tarea de Cowork, /schedule crea una tarea programada de Cowork ^[4]; en la CLI de Claude Code, /schedule crea una tarea programada en la nube de Claude Code ^[2].

2. Cuándo usarla y cuándo NO

Úsala para:

• Un resumen semanal del estado de expedientes o incidencias a partir de tus conectores.
• Una revisión nocturna de los pull requests del backend Spring Boot (Claude Code).
• Una tarea que reacciona a un evento de GitHub, como abrir un pull request (Claude Code).

Cuándo NO:

• Tareas con datos sensibles o acciones difíciles de deshacer: las tareas programadas se ejecutan sin que las supervises en tiempo real; la ayuda recomienda empezar por tareas simples y de poco riesgo ^[5].
• Algo que debe ejecutarse más de una vez por hora en Claude Code: el intervalo mínimo es de una hora ^[2].
• Dispatch si eres usuario nuevo: no está abierto a usuarios nuevos ^[3].

3. Tutorial paso a paso

A. Tareas programadas de Cowork

Dónde se ejecutan: en remoto, así que siguen su calendario aunque el equipo esté dormido o la app cerrada. Si la tarea necesita archivos o aplicaciones locales, se ejecuta solo en local ^[1].

Frecuencias: cada hora, diaria, semanal, días laborables o manual ^[1].

Crear una (experiencia nueva) ^[1]:

1. En cualquier conversación, describe la tarea y cada cuánto debe ejecutarse.
2. Responde a las preguntas de Claude.
3. Revisa nombre, calendario e instrucciones y pulsa Schedule.

Crear una (interfaz de Cowork) ^[1]:

• Scheduled en la barra lateral > New task > Create with Claude (te guía con preguntas) o Set up manually.
• En el formulario manual ("Create scheduled task"): nombre, prompt, modo de aprobación, frecuencia, modelo (opcional) y carpeta (opcional). Pulsa Save.

Gestionar: desde Scheduled ves las tareas y sus ejecuciones pasadas y futuras, las editas, las pausas, las reanudas, las borras o las lanzas a demanda ^[1]. Cada ejecución es una sesión de Cowork que revisas como cualquier otra ^[1].

B. Tareas programadas en la nube de Claude Code

Es una configuración guardada (un prompt, uno o varios repositorios y conectores) que se ejecuta en la infraestructura de Anthropic, así que funciona con el portátil cerrado. Está en research preview ^[2].

Disparadores ^[2]:

• Schedule: periódico (cada hora, cada noche, semanal) o una sola vez en una fecha.
• API: una petición HTTP a su propio endpoint con un token.
• GitHub: eventos de pull requests, releases o issues.

Crear desde la CLI (ejemplos de la documentación oficial) ^[2]:

/schedule daily PR review at 9am

/schedule tomorrow at 9am, summarize yesterday's merged PRs

Para gestionarlas: /schedule list, /schedule update y /schedule run ^[2].

Detalles importantes ^[2]:

• Requiere iniciar sesión con una cuenta de claude.ai; con una clave de API de Console o un proveedor como Bedrock, /schedule no está disponible.
• Las expresiones cron de cinco campos se escriben en UTC; las frecuencias predefinidas, en tu hora local.
• Se rechazan las expresiones que se ejecutan más de una vez por hora.
• Límite de 100 ejecuciones programadas por hora por cuenta, y consumen el uso de tu suscripción.
• Pertenecen a tu cuenta: los commits y mensajes salen con tu identidad.
• Todos tus conectores se incluyen por defecto: quita los que la tarea no necesite, porque Claude puede usarlos, también para escribir.
• En Team y Enterprise, un propietario puede desactivarlas en Organization settings > Capabilities > Remote sessions.

Alternativas locales: las tareas programadas de Claude Desktop y /loop programan trabajo en tu equipo en lugar de en la nube ^[2].

C. Dispatch (solo si ya lo tienes)

Dispatch es un hilo único y persistente desde el que escribes a Claude en el móvil para que trabaje en tu escritorio: los trabajos de desarrollo van a Claude Code y el trabajo del conocimiento a Cowork ^[3].

• Requisitos: Claude Desktop actualizado, abierto y con el equipo despierto; la app móvil actualizada; plan Pro o Max ^[3].
• Riesgo: una orden desde el móvil puede leer, mover o borrar archivos, usar servicios conectados, controlar el navegador y abrir aplicaciones en tu escritorio ^[3].
• Si no te aparece, la ayuda recomienda usar Cowork en la nube ^[3].

4. Ejemplo práctico

Caso A, Cowork: resumen semanal de avisos de obra.

Cada lunes a las 8:00, con el conector de correo:
1. Busca los correos de la semana anterior con "aviso de obra" en el asunto.
2. Crea una tabla con fecha, remitente, ubicación y tipo de actuación.
3. Señala los avisos que mencionan corte de tráfico o de suministro.
No respondas ni reenvíes ningún correo.

Empieza con aprobación manual y revisa las tres primeras ejecuciones en Scheduled antes de dejarla en automático.

Caso B, Claude Code: revisión nocturna del backend.

/schedule every weekday at 7:07, review pull requests opened in the last 24 hours
in the inspections-api repository: check that new endpoints have tests and
that no credentials appear in the diff. Leave a summary comment on each PR.

El minuto 7 no es casualidad: la documentación avisa de que una ejecución programada exactamente a la hora en punto puede empezar con varios minutos de retraso ^[2]. Antes de crearla, revisa qué conectores incluye y quita los que no necesite.

5. Errores frecuentes y límites conocidos

• Tareas con efectos sin revisar. Se ejecutan sin supervisión; revisa los resultados de cada ejecución y pausa o borra las que no necesites ^[5].
• Esperar archivos locales en una tarea en la nube. Las que necesitan archivos o apps locales se ejecutan solo en local ^[1].
• Escribir la hora del cron en hora local. Va en UTC si son cinco campos sin prefijo ^[2].
• /schedule "desconocido" en la CLI. Suele deberse a que has iniciado sesión con una clave de Console o un proveedor externo ^[2].
• Olvidar que actúa con tu identidad. Los commits y mensajes salen a tu nombre ^[2].
• Límites de Cowork. La ayuda no especifica cuotas ni número máximo de ejecuciones: No verificado (NV8).
• Dispatch. La ayuda lo da por cerrado a usuarios nuevos y la tabla de disponibilidad de Claude Code lo marca como disponible en Pro y Max; esta lección sigue a la ayuda (A1-1 en research/CONTRADICCIONES.md).

6. Ejercicio práctico

Enunciado:

1. Crea una tarea programada de Cowork, de poco riesgo y solo de lectura (por ejemplo, un resumen semanal de una carpeta o de tu correo).
2. Ejecútala a demanda desde Scheduled y revisa el resultado.
3. Si usas Claude Code con GitHub, crea con /schedule una tarea de una sola vez para mañana y compruébala con /schedule list.
4. Escribe en dos líneas por qué cada tarea es segura de ejecutar sin supervisión.

Criterio de éxito:

• La tarea de Cowork aparece en Scheduled y has revisado al menos una ejecución.
• Ninguna tarea tiene conectores o permisos de escritura que no necesite.
• Si has creado la de Claude Code, sabes en qué zona horaria se ejecuta y con qué identidad actúa.
• Tu justificación de seguridad menciona qué pasaría si la tarea fallara.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Schedule recurring tasks in Claude Cowork (se abre en una pestaña nueva) oficial sup-cowork-sched · consultada el 2026-10-25
2. Automate work with scheduled tasks (Claude Code) (se abre en una pestaña nueva) oficial cc-routines · consultada el 2026-10-25
3. Assign tasks from anywhere in Claude Cowork (Dispatch) (se abre en una pestaña nueva) oficial sup-cowork-dispatch · consultada el 2026-10-25
4. Get started with Claude Cowork (se abre en una pestaña nueva) oficial sup-cowork-start · consultada el 2026-10-25
5. Use Claude Cowork safely (se abre en una pestaña nueva) oficial sup-cowork-safe · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Claude in Chrome es una extensión del navegador con la que Claude ve las pestañas, hace clic, escribe y navega para completar tareas en sitios web ^[1]. En Max y Team (y en Pro a medida que avanza el despliegue), el panel lateral funciona como una sesión de Cowork: se guarda en el historial, puede continuar en la web, el escritorio o el móvil y usa tus skills, plugins y conectores ^[1].

Resuelve el problema de las tareas en webs que no tienen conector: rellenar formularios repetitivos, recopilar información de varias páginas o comprobar el funcionamiento de una aplicación web.

2. Cuándo usarla y cuándo NO

Úsala para:

• Investigación y relleno de formularios en sitios de confianza, que es por donde la ayuda recomienda empezar ^[3].
• Probar tu propia aplicación web en local mientras desarrollas (con Claude Code).

Cuándo NO (lista oficial) ^[3]:

• Gestionar cuentas financieras o inversiones.
• Manejar documentos legales o contratos.
• Procesar información médica.
• Acceder a cuentas de trabajo con datos sensibles.
• Sitios con datos personales de otras personas.
• Páginas con datos regulados.

Para la administración pública: la ayuda recomienda usar un perfil de navegador separado sin acceso a cuentas sensibles, y cita expresamente las de banca, salud y administración ("government") ^[3]. No uses Claude in Chrome con tu sesión iniciada en la sede electrónica, el gestor de expedientes ni el correo corporativo.

3. Tutorial paso a paso

Paso 1: prepara un perfil de Chrome aparte

Crea un perfil de Chrome nuevo solo para Claude, sin sesiones iniciadas en servicios sensibles. Es la recomendación oficial ^[3].

Paso 2: instala la extensión

1. Abre Chrome y la ficha de Claude en Chrome Web Store.
2. Pulsa Add to Chrome.
3. Inicia sesión con tu cuenta de Claude.
4. Fíjala: icono del puzle > chincheta junto a Claude.
5. Acepta los permisos ^[1].

Paso 3: elige el modo de aprobación

El panel empieza en Automatically approve: Claude revisa cada acción por seguridad y se detiene a preguntar cuando hace falta. Si cambias de modo, se conserva en sesiones futuras ^[1]. Los otros modos son Manually approve y Skip all approvals ^[4]. Para tareas nuevas o sitios desconocidos, empieza en manual.

Paso 4: entiende los límites que no se saltan

• Siempre pide confirmación (aunque hayas permitido el sitio) para cambiar permisos, conceder autorizaciones, introducir información sensible y descargar archivos ^[4].
• Nunca hace, tenga el permiso que tenga, operaciones de inversión ni salta CAPTCHAs, entre otras acciones prohibidas ^[3].

Paso 5: atajos y tareas programadas

• Atajos: guarda un prompt que funcione y ejecútalo escribiendo / en el chat ^[1].
• Tareas programadas: icono del reloj, arriba a la derecha del panel; diarias, semanales, mensuales o anuales ^[1].
• Flujos grabados: solo en el panel lateral clásico (⋮ > Switch back to classic) ^[1].

Paso 6: revisa y revoca permisos

Icono de la extensión > tres puntos > Extension settings > Permissions > Your approved sites: revoca los sitios que ya no necesites ^[4].

Paso 7 (desarrolladores): Claude Code con Chrome

1. Inicia sesión en Claude Code con /login (con clave de API la integración queda desactivada) ^[2].
2. Arranca con:

claude --chrome

3. Comprueba el estado y gestiona la conexión con /chrome ^[2].

Claude abre pestañas nuevas, puede leer la consola y el DOM, probar formularios y se detiene en páginas de inicio de sesión o CAPTCHA para que las resuelvas tú ^[2]. No funciona en WSL ^[2].

4. Ejemplo práctico

Caso A, Claude Code + Chrome: probar el formulario web de alta de incidencias que desarrollas con Spring Boot, levantado en local.

Abre http://localhost:8080/incidencias/nueva. Rellena el formulario con tres casos:
uno válido, uno con la dirección vacía y uno con una fecha futura. Para cada caso,
anota el mensaje que muestra la página y cualquier error de la consola del navegador.
No envíes más de un formulario por caso.

Es un uso de bajo riesgo: tu propia aplicación, en local y con datos de prueba.

Caso B, panel de Chrome: recopilar las fechas de las convocatorias de ayudas para eficiencia energética publicadas en varias webs oficiales, en un perfil de Chrome sin sesiones iniciadas, con Manually approve y pidiendo una tabla con el enlace de cada dato. Abre después cada enlace para comprobarlo.

Lo que no harías: pedirle que tramite algo en la sede electrónica con tu certificado o tu sesión iniciada.

5. Errores frecuentes y límites conocidos

• Usarla con tu perfil de Chrome habitual. Claude hace capturas de las pestañas y no puede filtrar lo sensible de lo que ve ^[3].
• Inyección de instrucciones. Instrucciones ocultas en una web pueden intentar desviar a Claude; el riesgo no es cero. Para la tarea si Claude hace algo inesperado ^[3].
• Leer la cifra de seguridad como garantía. El artículo cita menos del 0,08 % de ataques con éxito en pruebas internas con Claude Opus 4.8; es una cifra de Anthropic, no una evaluación independiente ^[3].
• Datos regulados. No está cubierto por un BAA, ni siquiera en organizaciones con HIPAA ^[3].
• Responsabilidad. Eres responsable de lo que Claude hace en tu nombre: lo que publica, envía o modifica ^[3].
• Otros navegadores. La ayuda dice "solo Chrome", mientras que la documentación de Claude Code admite otros Chromium para su integración (A1-14 en research/CONTRADICCIONES.md).
• Claude Code con clave de API o con Bedrock. La integración no está disponible ^[2].

6. Ejercicio práctico

Enunciado:

1. Crea un perfil de Chrome dedicado e instala la extensión.
2. En Manually approve, pide una tarea de solo lectura en dos webs oficiales (por ejemplo, reunir los horarios y teléfonos de atención de dos organismos).
3. Revisa qué permisos por sitio has concedido y revoca los que no vayas a reutilizar.
4. Si desarrollas aplicaciones web, prueba claude --chrome contra tu aplicación en local.

Criterio de éxito:

• El perfil que usa Claude no tiene sesiones iniciadas en servicios sensibles.
• Has aprobado cada acción y sabrías explicar qué hizo Claude en cada paso.
• La lista Your approved sites solo contiene los sitios que quieres mantener.
• Has comprobado los datos recogidos contra las webs originales.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Get started with Claude in Chrome (se abre en una pestaña nueva) oficial sup-get-started-with-claude-in-chrome · consultada el 2026-10-25
2. Use Claude Code with Chrome (se abre en una pestaña nueva) oficial cc-chrome · consultada el 2026-10-25
3. Use Claude in Chrome safely (se abre en una pestaña nueva) oficial sup-use-claude-in-chrome-safely · consultada el 2026-10-25
4. Claude in Chrome permissions guide (se abre en una pestaña nueva) oficial sup-claude-in-chrome-permissions-guide · consultada el 2026-10-25

1. Qué es y qué problema resuelve

El uso del ordenador (computer use) permite a Claude manejar aplicaciones de tu escritorio: ver la pantalla, hacer clic, escribir y desplazarse, desde una sesión de Cowork o de Claude Code en Claude Desktop ^[1].

Resuelve el problema de las aplicaciones que no tienen conector ni versión web: un programa de escritorio antiguo, una aplicación de gestión interna o una herramienta técnica sin API.

Claude usa primero la herramienta más precisa: conectores, después el navegador y, en último lugar, la pantalla ^[1]. Manejar la pantalla es lo más lento.

2. Cuándo usarla y cuándo NO

Úsala para:

• Tareas repetitivas y de bajo riesgo en una aplicación de escritorio sin conector (por ejemplo, exportar varios informes de un programa de mediciones).
• Comprobar visualmente una aplicación que estás desarrollando.

Cuándo NO:

• Si existe un conector o una versión web: son más rápidos y fiables ^[1].
• En una cuenta de Team o Enterprise: no está disponible ^[1].
• Con aplicaciones o documentos sensibles abiertos: Claude ve lo que hay en pantalla.
• Cuando un error sea difícil de deshacer: no hay sandbox entre Claude y tus aplicaciones ^[1].

3. Tutorial paso a paso

Paso 1: actívalo en Claude Desktop

1. Actualiza Claude Desktop.
2. Ve a Settings > Capabilities. Si no aparece la sección "Computer use", ve a Settings > System, en This computer.
3. Activa Enable computer use.
4. Inicia una sesión de Cowork o de Claude Code ^[1].

En macOS el sistema te pedirá los permisos de Accessibility (para hacer clic y escribir) y Screen Recording (para ver la pantalla) ^[2].

Paso 2: aprueba cada aplicación

Claude pide permiso antes de acceder a cada aplicación, y debes aprobarlo para que pueda usarla ^[1]. La aprobación dura la sesión ^[2].

Según la documentación de Claude Code Desktop, el nivel de control es fijo por tipo de aplicación: solo ver en navegadores y plataformas de trading, solo clic en terminales e IDE, y control completo en el resto ^[2].

Paso 3: bloquea las aplicaciones que no debe tocar

Usa la App blocklist: las peticiones a esas aplicaciones se deniegan solas. Las plataformas de inversión, trading y criptomonedas vienen bloqueadas por defecto ^[1].

Paso 4: modo en segundo plano (macOS 15 o posterior)

Claude trabaja en ventanas en segundo plano sin quitarte el ratón ni el teclado, y suele esperar si estás escribiendo. Pide permiso la primera vez que una tarea necesita la pantalla completa. Se cambia con How Claude uses the apps you allow en la sección Computer use ^[1].

Paso 5 (Claude Code en la terminal)

En la CLI de Claude Code el uso del ordenador está en research preview, solo en macOS y con Pro o Max. Se activa desde /mcp, seleccionando el servidor computer-use ^[3]. Para detenerlo, pulsa Esc ^[3].

Para desarrolladores: la herramienta de la API

En la API existe una herramienta de computer use para construir tus propios agentes; la documentación recomienda ejecutarla en una máquina virtual o contenedor dedicado con privilegios mínimos, sin credenciales y con confirmación humana para las acciones con consecuencias ^[4]. Se trata en el módulo E.

4. Ejemplo práctico

Caso: una aplicación de escritorio antigua de gestión de mediciones que solo permite exportar los informes de uno en uno.

Preparación:

1. Cierra el correo, el gestor de expedientes y cualquier documento con datos personales.
2. Añade a la App blocklist el cliente de correo y el navegador con tu sesión corporativa.
3. Crea una carpeta de salida vacía.

Encargo (en una sesión de Cowork, con aprobación manual):

Usa la aplicación "Mediciones" para exportar a PDF los informes de las obras
2026-014, 2026-015 y 2026-016, uno por uno, desde el menú de informes.
Guarda cada PDF en la carpeta "exportaciones" con el código de obra como nombre.
No modifiques ningún dato dentro de la aplicación. Si aparece un diálogo que no
sea de exportar o guardar, detente y pregúntame.

Revisión: abre los tres PDF y comprueba que corresponden a las obras pedidas.

Por qué este diseño: el uso del ordenador no tiene sandbox y una acción en una aplicación permitida puede afectar a otra ^[1]; por eso se limita lo que hay abierto, se bloquean aplicaciones y se pide parar ante cualquier imprevisto.

5. Errores frecuentes y límites conocidos

• Buscarlo en una cuenta de Team o Enterprise. No está disponible por ahora ^[1].
• Esperar velocidad. Manejar la pantalla es más lento que un conector, y las tareas complejas pueden necesitar un segundo intento ^[1].
• Cerrar Claude Desktop o suspender el equipo. La tarea se queda sin acceso ^[1].
• Confiar en el aislamiento. No hay sandbox entre Claude y tus aplicaciones ^[1].
• Dejar datos sensibles a la vista. Claude ve la pantalla de las aplicaciones que usa.
• Estado de la función. La ayuda la llama "beta" y la documentación de Claude Code "research preview" (A1-10 en research/CONTRADICCIONES.md).

6. Ejercicio práctico

Enunciado: si tienes Pro o Max y macOS o Windows:

1. Activa el uso del ordenador y configura la App blocklist con al menos tres aplicaciones sensibles.
2. Elige una tarea repetitiva de bajo riesgo en una aplicación de escritorio sin conector.
3. Ejecútala con aprobación manual y observa cada petición de permiso.
4. Anota cuánto tardó frente a hacerlo a mano y si repetirías la tarea así.

Criterio de éxito:

• Las aplicaciones sensibles están en la lista de bloqueo antes de empezar.
• Has aprobado cada aplicación de forma consciente y ninguna fuera de la tarea.
• El resultado es correcto y lo has comprobado.
• Puedes justificar por qué, para esa tarea, no había una opción mejor (conector o navegador).

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Let Claude use your computer in Cowork (se abre en una pestaña nueva) oficial sup-cowork-computer · consultada el 2026-10-25
2. Claude Code Desktop (se abre en una pestaña nueva) oficial cc-desktop · consultada el 2026-10-25
3. Computer use (Claude Code CLI) (se abre en una pestaña nueva) oficial cc-computer-use · consultada el 2026-10-25
4. Computer use tool (Claude API) (se abre en una pestaña nueva) oficial api-computer-use-tool · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Claude Code es el agente de programación de Anthropic: lee tu repositorio, edita archivos y ejecuta comandos para completar tareas de desarrollo ^[1]. No tienes que pegarle el código: lee los archivos del proyecto cuando los necesita ^[2].

Resuelve el problema de trabajar con IA sobre un proyecto real: en lugar de copiar fragmentos al chat, Claude Code entiende la estructura de tu backend Spring Boot o tu app Android, hace los cambios, ejecuta los tests y te enseña el resultado.

Superficies (todas comparten el mismo motor y la misma configuración) ^[1]:

Cuentas: necesitas Pro, Max, Team, Enterprise o una cuenta de Console. El plan Free no incluye Claude Code. También funciona con Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry ^[5].

2. Cuándo usarla y cuándo NO

Úsala para:

• Entender un repositorio que no conoces.
• Corregir errores, añadir funciones, escribir tests y refactorizar.
• Operaciones de Git en lenguaje natural ^[2].

Elige superficie así:

• Trabajas en Android Studio o IntelliJ: CLI en el terminal integrado más el plugin de JetBrains.
• Prefieres no usar la terminal: la pestaña Code de Claude Desktop.
• Quieres que siga trabajando con el portátil cerrado: sesiones en la nube (requieren GitHub).

Cuándo NO:

• Trabajo que no es programación (informes, hojas de cálculo, presentaciones): Cowork (lección 14).
• Con el plan Free: no está incluido ^[5].
• Sin control de versiones: usa Git siempre que trabajes con Claude Code; es tu red de seguridad.

3. Tutorial paso a paso

Paso 1: comprueba los requisitos

Windows 10 1809 o posterior (o Windows Server 2019+), macOS 13.0 o posterior, Ubuntu 20.04+, Debian 10+ o Alpine 3.19+; 4 GB de RAM o más; procesador x64 o ARM64; conexión a internet ^[5].

Paso 2: instala (Windows)

La instalación nativa es la recomendada y se actualiza sola en segundo plano ^[5].

PowerShell (el indicador empieza por PS C:\):

irm https://claude.ai/install.ps1 | iex

CMD (el indicador empieza por C:\ sin PS):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

No hace falta ejecutarlo como administrador ^[5].

Git for Windows es opcional pero recomendado: con él, Claude Code usa Git Bash para la herramienta Bash; sin él, ejecuta los comandos con PowerShell ^[5].

Alternativa con WinGet (no se actualiza sola) ^[5]:

winget install Anthropic.ClaudeCode

Paso 2 bis: instala (macOS, Linux o WSL)

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

En WSL, el instalador de Linux se ejecuta dentro del terminal de WSL ^[5].

Paso 3: verifica

Abre una terminal nueva y ejecuta ^[5]:

claude --version

Para un diagnóstico de instalación y configuración sin abrir sesión:

claude doctor

Si la terminal dice que claude no se reconoce, el directorio de instalación aún no está en el PATH ^[5].

Paso 4: primera sesión e inicio de sesión

cd ruta/a/tu/proyecto
claude

La primera vez te pedirá iniciar sesión en el navegador. Después puedes usar /login para cambiar de cuenta, /help para ver los comandos y /resume para retomar una conversación ^[2].

Paso 5: primeras preguntas y primer cambio

Prueba preguntas de exploración y un cambio pequeño ^[2]:

what does this project do?

explain the folder structure

Cuando Claude proponga un cambio, te pedirá aprobación según el modo de permisos; Shift+Tab cambia de modo en cualquier momento ^[2]. Los modos se explican en la lección 20.

Paso 6: comandos esenciales

Fuente de la tabla: ^[2].

Paso 7: integra el IDE

• Android Studio / IntelliJ: instala el plugin Claude Code [Beta] desde JetBrains Marketplace, reinicia el IDE y ejecuta claude en el terminal integrado (o /ide desde un terminal externo) ^[4].
• VS Code: busca "Claude Code" en Extensiones ^[3].

Paso 8: actualizaciones

La instalación nativa se actualiza sola. Para forzarlo ^[5]:

claude update

Si prefieres versiones más probadas, el canal stable va aproximadamente una semana por detrás y se configura con /config o con "autoUpdatesChannel": "stable" en settings.json ^[5].

4. Ejemplo práctico

Caso: empezar a usar Claude Code con el backend Spring Boot de la API de inspecciones en un equipo Windows del ayuntamiento.

1. Instala con PowerShell (sin permisos de administrador) y, si puedes, Git for Windows.
2. Clona el repositorio y abre una terminal en su carpeta.
3. Ejecuta claude e inicia sesión con tu cuenta Pro o la de tu organización.
4. Explora antes de cambiar nada:

Explica la estructura de este proyecto Spring Boot: módulos, capas
(controladores, servicios, repositorios), cómo se configura la base de datos
y cómo se ejecutan los tests. No modifiques ningún archivo.

5. Primer cambio acotado, en una rama nueva:

Crea una rama feature/validacion-fecha-inspeccion. En el DTO de alta de inspección,
añade una validación para que la fecha no pueda ser futura, con su test unitario.
Ejecuta los tests del módulo y enséñame el resultado.

6. Revisa el diff antes de hacer commit.

Para la app Android: abre el proyecto en Android Studio, instala el plugin y repite el paso 4 desde el terminal integrado.

5. Errores frecuentes y límites conocidos

• Intentar usarlo con el plan Free. No está incluido ^[5].
• claude no se reconoce tras instalar. Abre una terminal nueva; si persiste, el directorio no está en el PATH ^[5].
• Usar el comando de CMD en PowerShell (o al revés). Mensajes como The token '&&' is not a valid statement separator indican que estás en PowerShell; 'irm' is not recognized indica que estás en CMD ^[5].
• sudo npm install -g. La documentación lo desaconseja por problemas de permisos y seguridad ^[5].
• Esperar actualizaciones automáticas con WinGet o Homebrew. No se actualizan solos ^[5].
• Sandboxing en Windows nativo. No está soportado; sí en WSL 2 ^[5].
• Plugin de JetBrains sin la CLI. El plugin no la incluye ^[4].
• Nota para servidores MCP con npx en Windows. Una nota sobre envolverlos con cmd /c no se encontró en la documentación leída: No verificado (NV11).

6. Ejercicio práctico

Enunciado:

1. Instala Claude Code con el método adecuado a tu sistema y verifica con claude --version y claude doctor.
2. Abre un proyecto propio (Spring Boot, Android o un repositorio con macros VBA exportadas como texto) y pide una explicación de su estructura sin modificar nada.
3. Pide un cambio pequeño en una rama nueva, con su test si aplica, y revisa el diff.
4. Si usas Android Studio o IntelliJ, instala el plugin y abre Claude Code desde el IDE.

Criterio de éxito:

• claude --version muestra una versión y claude doctor no muestra errores sin explicar.
• La explicación de la estructura es correcta según tu conocimiento del proyecto.
• El cambio está en una rama nueva y has revisado el diff antes del commit.
• Sabes qué cuenta estás usando y cómo cambiarla con /login.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Claude Code overview (se abre en una pestaña nueva) oficial cc-overview · consultada el 2026-10-25
2. Quickstart (Claude Code) (se abre en una pestaña nueva) oficial cc-quickstart · consultada el 2026-10-25
3. Use Claude Code in VS Code (se abre en una pestaña nueva) oficial cc-vs-code · consultada el 2026-10-25
4. JetBrains IDEs (Claude Code) (se abre en una pestaña nueva) oficial cc-jetbrains · consultada el 2026-10-25
5. Advanced setup (Claude Code) (se abre en una pestaña nueva) oficial cc-setup · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Cada sesión de Claude Code empieza con la ventana de contexto vacía. Dos mecanismos llevan conocimiento de una sesión a otra ^[1]:

Fuente de la tabla: ^[1].

Resuelve el problema de repetir en cada sesión cómo se compila el proyecto, qué convenciones seguís o qué no debe tocarse. Es el equivalente, en Claude Code, a las instrucciones de un Proyecto de la app (lección 04).

Importante: Claude trata ambos como contexto, no como configuración obligatoria. Para bloquear una acción pase lo que pase, se usa un hook (lección 22) ^[1].

2. Cuándo usarla y cuándo NO

Pon en CLAUDE.md:

• Comandos de compilación, test y arranque que Claude no adivinaría.
• Convenciones del equipo (estructura de paquetes, nombres, estilo).
• Avisos concretos ("no modificar las migraciones ya aplicadas").

No pongas en CLAUDE.md:

• Lo que Claude puede deducir leyendo el código. La guía oficial propone una prueba: si al quitar una línea Claude no cometería errores, quítala ^[2].
• Instrucciones que solo importan a veces: van mejor en una skill (lección 24) ^[2].
• Normas que deben cumplirse siempre: usa hooks o permisos ^[1].
• Secretos o contraseñas: el archivo se comparte en el repositorio.

3. Tutorial paso a paso

Paso 1: genera un CLAUDE.md inicial

Dentro de una sesión en la raíz del proyecto, ejecuta /init. Claude analiza el código y crea un archivo con comandos de compilación, instrucciones de test y convenciones; si ya existe, propone mejoras en lugar de sobrescribirlo ^[1].

Paso 2: conoce las ubicaciones

Fuente de la tabla: ^[1].

Cómo se cargan: se leen los archivos del directorio de trabajo y de todos los superiores, y se concatenan, no se sustituyen: de la raíz del disco hacia tu directorio, y en cada nivel CLAUDE.local.md después de CLAUDE.md. Los de subdirectorios se cargan cuando Claude trabaja con archivos de ese subdirectorio ^[1].

Paso 3: mantenlo corto

• Objetivo: menos de 200 líneas por archivo. Los archivos largos consumen contexto y se siguen peor ^[1].
• Las reglas que solo afectan a una parte del código van en .claude/rules/, con reglas acotadas a rutas que se cargan solo cuando Claude trabaja con esos archivos ^[1].

Paso 4: importa otros archivos

Con @ruta/al/archivo se incluye otro archivo. Las rutas relativas se resuelven desde el archivo que importa, y se admiten hasta cuatro niveles de importación anidada ^[1]. Los imports ayudan a organizar, pero no reducen el consumo de contexto ^[1].

Paso 5: AGENTS.md

Si el repositorio ya tiene un AGENTS.md y no hay CLAUDE.md, Claude Code lo usa como instrucciones del proyecto; si hay ambos, usa solo los CLAUDE.md ^[1].

Paso 6: comprueba qué se ha cargado

/context muestra qué archivos de instrucciones y reglas se han cargado en la sesión ^[2].

Paso 7: memoria automática

Claude toma notas por su cuenta a partir de tus correcciones y preferencias; se carga en cada sesión hasta 200 líneas o 25 KB, y se comparte entre los worktrees del mismo repositorio ^[1]. Se revisa y se activa o desactiva con /memory ^[1].

4. Ejemplo práctico

Caso: CLAUDE.md del backend Spring Boot de la API de inspecciones.

# API de inspecciones (Spring Boot)

## Comandos
- Compilar y testear: `./mvnw verify`
- Solo tests unitarios de un módulo: `./mvnw -pl inspecciones-core test`
- Arrancar en local: `./mvnw spring-boot:run -Dspring-boot.run.profiles=local`

## Convenciones
- Java 21. Paquetes por funcionalidad (`inspeccion`, `incidencia`, `usuario`), no por capa.
- Los DTO de entrada se validan con Bean Validation; los mensajes de error, en español.
- Cada endpoint nuevo lleva test de controlador con MockMvc.

## Cuidado
- No modificar migraciones Flyway ya aplicadas: crear una nueva.
- Los datos de prueba están en `src/test/resources/fixtures`; no uses datos reales.

## Más contexto
@docs/arquitectura.md

CLAUDE.local.md (no se sube al repositorio):

- Mi base de datos local escucha en el puerto 5433.
- Prefiero que me expliques los cambios en español antes de aplicarlos.

Comprobación: abre una sesión nueva, ejecuta /context para confirmar que se han cargado, y pide "añade un endpoint para cerrar una incidencia". Claude debería seguir la estructura por funcionalidad y añadir el test con MockMvc sin que lo repitas.

Variante para Android: un CLAUDE.md con los comandos de Gradle del proyecto, el módulo donde viven los ViewModel y la regla de no tocar los archivos generados.

5. Errores frecuentes y límites conocidos

• CLAUDE.md demasiado largo. Se sigue peor y consume contexto; recórtalo con la prueba de "si lo quito, ¿falla algo?" ^[2].
• Esperar que CLAUDE.md impida acciones. Es contexto; para impedir algo, hooks o reglas de permisos ^[1].
• Subir CLAUDE.local.md al repositorio. Debe ir en .gitignore ^[1].
• Usar imports para "ahorrar" contexto. El archivo importado se carga entero junto al que lo importa ^[1].
• Pensar que un CLAUDE.md sustituye al otro. Se concatenan todos los niveles ^[1].
• Instrucciones que solo valen a veces en CLAUDE.md. Mejor en una skill ^[2].

6. Ejercicio práctico

Enunciado:

1. En un proyecto propio, ejecuta /init y revisa el archivo generado.
2. Reduce el resultado a lo imprescindible: comandos, convenciones no evidentes y avisos. Objetivo: menos de 60 líneas.
3. Crea un CLAUDE.local.md con una preferencia personal y añádelo a .gitignore.
4. Abre una sesión nueva, ejecuta /context y pide una tarea que deba seguir una convención del archivo.

Criterio de éxito:

• El CLAUDE.md tiene menos de 60 líneas y cada línea supera la prueba de "si la quito, ¿falla algo?".
• CLAUDE.local.md está en .gitignore.
• /context muestra los archivos cargados.
• Claude ha seguido la convención sin que la repitas en el prompt.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. How Claude remembers your project (Claude Code) (se abre en una pestaña nueva) oficial cc-memory · consultada el 2026-10-25
2. Best practices for Claude Code (se abre en una pestaña nueva) oficial cc-best-practices · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Claude Code puede editar archivos y ejecutar comandos en tu equipo. Tres mecanismos controlan qué hace sin preguntarte y cómo deshacer lo que hizo:

1. Modos de permiso: el comportamiento general de la sesión ^[1].
2. Reglas de permisos: listas allow, ask y deny para herramientas y comandos concretos ^[2].
3. Checkpoints: instantáneas automáticas de los archivos que permiten volver atrás ^[3].

Resuelve el equilibrio entre autonomía y control: que Claude no te pregunte por cada lectura, pero que nunca haga un git push --force o lea tu .env sin que lo decidas tú.

2. Cuándo usarla y cuándo NO

Elige el modo según el riesgo ^[1]:

Cuándo NO:

• bypassPermissions en tu equipo de trabajo: la documentación advierte de que no ofrece protección frente a la inyección de instrucciones ni a acciones no deseadas ^[1].
• Usar los checkpoints en lugar de Git: no sustituyen al control de versiones ^[3].
• Modo plan para un cambio de una línea: la guía de buenas prácticas propone saltarse el plan si el cambio se describe en una frase ^[4].

3. Tutorial paso a paso

Paso 1: el modo inicial

Desde la versión 2.1.283, las sesiones interactivas de terminal y VS Code empiezan en auto en todos los planes. En Windows nativo, el arranque en auto requiere al menos la versión 2.1.233. En cambio, claude -p y las sesiones donde la organización desactiva el modo auto empiezan en Manual ^[1].

Requisitos del modo auto: disponible en todos los planes; en Team y Enterprise los administradores pueden desactivarlo; exige modelos recientes (por ejemplo, Opus 4.6 o posterior en la API de Anthropic) ^[1]. Si el clasificador bloquea 3 acciones seguidas o 20 en total, el modo auto se pausa y vuelve a preguntarte ^[1].

Paso 2: cambiar de modo

• Shift+Tab recorre los modos: desde auto, la primera pulsación pasa a default, y luego default → acceptEdits → plan ^[1].
• Al arrancar: claude --permission-mode plan ^[1].
• La barra de estado indica el modo, por ejemplo plan mode on ^[1].

Paso 3: trabajar en modo plan

1. Entra con Shift+Tab hasta plan, anteponiendo /plan a un mensaje, o con claude --permission-mode plan ^[1].
2. Claude explora y propone un plan sin editar código.
3. Ctrl+G abre el plan en tu editor para modificarlo antes de aprobarlo ^[1].
4. Al aprobarlo eliges Yes, and use auto mode, Yes, manually approve edits o No, keep planning ^[1].

La guía oficial recomienda el ciclo explorar → planificar → implementar → commit ^[4].

Paso 4: reglas de permisos

Las reglas viven en settings.json (de usuario, de proyecto o local). Se evalúan en orden deny → ask → allow y decide la primera que coincide; una regla allow no puede hacer una excepción dentro de un deny ^[2].

Ejemplo de .claude/settings.json para el proyecto:

{
  "permissions": {
    "allow": [
      "Bash(./mvnw verify)",
      "Bash(./mvnw -pl * test)",
      "Bash(git status *)",
      "Bash(git diff *)"
    ],
    "ask": [
      "Bash(git push *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(curl *)"
    ]
  }
}

Detalles de la sintaxis ^[2]:

• Bash(npm run *) permite cualquier comando que empiece por npm run; el espacio antes de * importa: Bash(ls*) también coincidiría con lsof.
• Rutas: //ruta es absoluta desde la raíz; ~/ es relativa a tu carpeta de usuario; /ruta es relativa al origen del archivo de ajustes; ./ruta o sin prefijo, al directorio actual.
• Un archivo .claudeignore no tiene efecto: usa reglas Read en deny.

/permissions muestra y gestiona las reglas desde la sesión ^[2].

Paso 5: volver atrás con checkpoints

• Cada mensaje tuyo que inicia un turno crea un checkpoint; se guardan instantáneas de los 100 más recientes ^[3].
• /rewind, o Esc dos veces con el campo de texto vacío, abre el menú ^[3].
• Opciones: Restore code and conversation, Restore conversation, Restore code, Summarize from here, Summarize up to here y Never mind ^[3].

4. Ejemplo práctico

Caso: migrar el servicio de notificaciones de la API de inspecciones de envío síncrono a una cola, un cambio que toca varios módulos.

1. Prepara Git: crea una rama feature/notificaciones-cola y confirma que el árbol de trabajo está limpio.
2. Modo plan:

/plan Quiero que el envío de notificaciones por correo deje de bloquear la petición
HTTP. Analiza cómo se envían hoy, propón cómo pasar a una cola con los componentes
que ya usa el proyecto y lista los archivos que cambiarías y los tests nuevos.

3. Revisa el plan con Ctrl+G, elimina lo que no quieras (por ejemplo, cambios en la configuración de producción) y apruébalo con Yes, manually approve edits para revisar cada edición.
4. Reglas: las del ejemplo anterior permiten ./mvnw verify sin preguntar y obligan a confirmar cualquier git push.
5. Si algo sale mal: /rewind > Restore code para volver al estado anterior del turno que lo estropeó.
6. Al final: revisa el diff y haz commit tú.

5. Errores frecuentes y límites conocidos

• Escribir rutas absolutas con una sola barra. /Users/x no es absoluta en las reglas: usa // ^[2].
• Confiar en .claudeignore. No tiene efecto ^[2].
• Poner auto o bypassPermissions como modo por defecto en los ajustes del proyecto. Se ignoran ahí; van en ~/.claude/settings.json ^[1].
• Esperar que /rewind deshaga lo que hizo un comando Bash. Los archivos que solo cambió Bash no se rastrean; usa Git ^[3].
• Ediciones de subagentes. Normalmente no quedan en los checkpoints de tu sesión ^[3].
• Checkpoints antiguos. Las instantáneas se borran en la limpieza periódica, por defecto unos 30 días después ^[3].
• Modo inicial distinto entre interactivo y claude -p. Interactivo empieza en auto; -p, en Manual (A3-44 en research/CONTRADICCIONES.md).

6. Ejercicio práctico

Enunciado:

1. Crea un .claude/settings.json en un proyecto propio con al menos dos reglas allow (compilar y testear), una ask y dos deny (secretos y un comando peligroso).
2. Haz una tarea mediana en modo plan, edita el plan con Ctrl+G y apruébalo con aprobación manual de ediciones.
3. Provoca un cambio que no quieras y deshazlo con /rewind.
4. Intenta que Claude lea un archivo bloqueado y comprueba que lo deniega.

Criterio de éxito:

• El archivo de ajustes es JSON válido y /permissions muestra tus reglas.
• El plan aprobado tenía al menos una modificación tuya.
• Has restaurado código con /rewind y sabes qué cambios no habría podido deshacer.
• La lectura del archivo protegido se ha denegado.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Permission modes (Claude Code) (se abre en una pestaña nueva) oficial cc-permission-modes · consultada el 2026-10-25
2. Configure permissions (Claude Code) (se abre en una pestaña nueva) oficial cc-permissions · consultada el 2026-10-25
3. Checkpointing (Claude Code) (se abre en una pestaña nueva) oficial cc-checkpointing · consultada el 2026-10-25
4. Best practices for Claude Code (se abre en una pestaña nueva) oficial cc-best-practices · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Una vez instalado y configurado Claude Code (lecciones 18 a 20), el rendimiento depende de cómo organizas el trabajo diario. Esta lección reúne cuatro piezas:

1. Gestión de la sesión y del contexto con comandos integrados.
2. Worktrees para trabajar en paralelo sin que los cambios choquen ^[1].
3. Modo no interactivo (-p) para scripts y CI ^[2].
4. Revisión de código: el servicio Code Review y el comando local /code-review ^[3].

Resuelve el problema principal que señala la guía oficial: la ventana de contexto es el recurso que más hay que gestionar, porque el rendimiento empeora a medida que se llena ^[4].

2. Cuándo usarla y cuándo NO

Comandos y usos de la tabla: ^{[4] [3]}.

Cuándo NO:

• claude -p en un repositorio ajeno sin --bare: ejecuta los hooks y servidores MCP del proyecto sin el diálogo de confianza ^[2].
• Esperar que Code Review apruebe o bloquee un pull request: nunca lo hace; la decisión de fusionar es del equipo ^[3].
• Worktrees sin .gitignore: sus archivos aparecerían como no seguidos en tu checkout principal ^[1].

3. Tutorial paso a paso

A. Gestionar la sesión

La guía de buenas prácticas recomienda ^[4]:

• Esc detiene a Claude; Esc dos veces o /rewind vuelve a un checkpoint.
• /clear entre tareas no relacionadas.
• /compact <instrucciones> para compactar indicando qué conservar.
• /btw para preguntas que no deben entrar en el historial.
• /rename y claude --continue o --resume para retomar sesiones.
• Tras dos correcciones fallidas, mejor /clear y un prompt mejor que seguir corrigiendo.

Otros comandos útiles: /context (qué ocupa el contexto), /usage (consumo), /model y /effort ^[5].

B. Trabajar en paralelo con worktrees

1. Añade .claude/worktrees/ a tu .gitignore ^[1].
2. En una terminal:

claude --worktree feature-auth

Se crea un worktree en .claude/worktrees/feature-auth/ en una rama nueva worktree-feature-auth, partiendo por defecto de la rama principal del remoto ^[1].

3. En otra terminal, otra sesión con otro nombre para otra tarea.
4. Al salir: si el worktree está limpio y la sesión no tenía nombre, se borra solo; si tiene trabajo, Claude te pregunta si conservarlo ^[1].

Archivos ignorados como .env: un worktree es un checkout nuevo y no los tiene; lista los que quieras copiar en un archivo .worktreeinclude con sintaxis de .gitignore ^[1].

Desde un pull request: claude --worktree "#1234" (con comillas, para que la shell no trate # como comentario) ^[1].

C. Modo no interactivo

claude -p "What does the auth module do?"

• Salida estructurada con --output-format json (o stream-json), y con --json-schema para forzar un esquema ^[2].
• Aprobar herramientas concretas con --allowedTools, usando la sintaxis de reglas de permisos ^[2]:

claude -p "Look at my staged changes and create an appropriate commit" \
  --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

• --bare es el modo recomendado para scripts: no carga hooks, skills, plugins, servidores MCP, memoria ni CLAUDE.md del equipo, y necesita ANTHROPIC_API_KEY porque no usa el inicio de sesión de la suscripción ^[2].
• La entrada por tubería tiene un límite de 10 MB ^[2].

D. Revisar código

Local, cualquier plan: ejecuta /code-review en tu sesión sobre tu rama ^[3].

Code Review (servicio, Team y Enterprise) ^[3]:

• Varios agentes revisan cada pull request de GitHub, una fase de verificación filtra falsos positivos y los hallazgos se publican como comentarios en línea por gravedad, con un resumen y un check run llamado Claude Code Review.
• Por defecto se centra en la corrección (errores que romperían producción), no en estilo ni cobertura de tests.
• Se personaliza con REVIEW.md y CLAUDE.md en el repositorio.
• Niveles: Quick, Standard (por defecto) y Deep.
• Quien tenga permiso de escritura puede comentar @claude review para lanzar una revisión.
• Lo activa un Owner; no está disponible con ZDR, configuración HIPAA ni claves gestionadas por el cliente (CMEK).

4. Ejemplo práctico

Caso: jornada de trabajo en el backend de inspecciones con dos tareas en paralelo y un script de CI.

1. Dos worktrees:

claude --worktree validacion-fechas

claude --worktree informe-mensual

En el primero corriges una validación; en el segundo creas un endpoint de informe. Ninguno pisa los archivos del otro.

2. Disciplina de contexto: cuando terminas la validación, /clear antes de pedir otra cosa en esa sesión. Si una exploración se alarga, /compact y "conserva solo las decisiones sobre la API de fechas".

3. Revisión antes del pull request: /code-review en cada rama.

4. Comprobación en CI: un paso del pipeline que lista erratas del diff contra main, adaptado del ejemplo oficial ^[2]:

git diff main | claude --bare -p "you are a typo linter. for each typo in this diff, report filename:line on one line and the issue on the next. return nothing else."

Con --bare, el paso no carga configuración de nadie del equipo y se comporta igual en cualquier máquina.

5. Errores frecuentes y límites conocidos

• La sesión "cajón de sastre". Mezclar tareas llena el contexto; usa /clear entre tareas ^[4].
• Corregir una y otra vez. Tras dos correcciones fallidas, empieza de nuevo con mejor prompt ^[4].
• No dar a Claude forma de verificar. La guía insiste en dar tests, build o capturas para que compruebe su trabajo ^[4].
• Worktrees de -p sin limpiar. Con -p no hay limpieza al salir; elimínalos con git worktree remove ^[1].
• --bare sin clave de API. No lee el inicio de sesión OAuth ^[2].
• Confundir Code Review con /code-review. El primero es un servicio de Team y Enterprise sobre GitHub; el segundo, un comando local en cualquier plan ^[3].
• Leer "sin hallazgos" como "sin errores". La documentación advierte de que una revisión sin hallazgos no garantiza que el código esté libre de errores ^[3].
• /agents en tutoriales antiguos. Ya no abre un asistente de creación de subagentes (lección 25).

6. Ejercicio práctico

Enunciado:

1. Configura .gitignore y un .worktreeinclude si tu proyecto usa .env.
2. Abre dos sesiones en worktrees distintos con dos tareas pequeñas y termina ambas.
3. Ejecuta /code-review en cada rama antes de fusionar.
4. Escribe un comando claude -p con --output-format json que resuma los cambios de la última semana y guarda la salida en un archivo.

Criterio de éxito:

• Las dos tareas se han hecho en paralelo sin conflictos de archivos.
• Sabes qué worktrees quedan en disco y cómo eliminarlos.
• Has corregido o descartado razonadamente cada hallazgo de /code-review.
• El JSON del modo no interactivo tiene el campo result con el resumen.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Run parallel sessions with worktrees (se abre en una pestaña nueva) oficial cc-worktrees · consultada el 2026-10-25
2. Run Claude Code programmatically (se abre en una pestaña nueva) oficial cc-headless · consultada el 2026-10-25
3. Code Review (Claude Code) (se abre en una pestaña nueva) oficial cc-code-review · consultada el 2026-10-25
4. Best practices for Claude Code (se abre en una pestaña nueva) oficial cc-best-practices · consultada el 2026-10-25
5. Commands (Claude Code) (se abre en una pestaña nueva) oficial cc-commands · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Los hooks son comandos que tú defines y que Claude Code ejecuta automáticamente en momentos concretos de su ciclo de vida. Dan control determinista: ciertas acciones ocurren siempre, sin depender de que el modelo decida hacerlas ^[1].

Resuelve el problema que dejan abierto CLAUDE.md y las skills: esos son consejos que Claude puede seguir o no; un hook siempre se ejecuta. Sirve para formatear tras cada edición, bloquear cambios en archivos protegidos, avisarte cuando Claude espera tu respuesta o volver a inyectar contexto tras una compactación ^[1].

Eventos más usados ^[1]:

Hay muchos más; la referencia completa lista todos los eventos con sus esquemas ^[2].

2. Cuándo usarla y cuándo NO

Úsalos para:

• Normas que deben cumplirse siempre (no tocar .env, formatear el código).
• Automatizaciones repetitivas (notificaciones, registro de cambios).

Cuándo NO:

• Instrucciones que requieren criterio: van en CLAUDE.md o en una skill; también existen hooks basados en un prompt o en un agente para decisiones con criterio ^[1].
• Como único control de seguridad sobre comandos Bash: el filtrado por argumentos es aproximado; para un permitir o denegar estricto, la guía remite al sistema de permisos ^[1].
• Si no entiendes el script: un hook ejecuta comandos en tu equipo con tus permisos.

3. Tutorial paso a paso

Paso 1: dónde se configuran

Los hooks se definen en un bloque hooks dentro de un archivo de ajustes: ~/.claude/settings.json (todos tus proyectos), .claude/settings.json (el proyecto, compartido) o .claude/settings.local.json (el proyecto, solo tú) ^[1].

Paso 2: la estructura

Evento → grupo con un matcher (qué herramientas o casos) → lista de hooks con type y command. Un matcher vacío coincide con todo ^[1].

Paso 3: tu primer hook (aviso en Windows)

Ejemplo oficial para Windows con PowerShell, en ~/.claude/settings.json ^[1]:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Abre un cuadro de diálogo (que puede quedar detrás de la terminal) cada vez que Claude te espera. Comprueba que aparece con /hooks, que abre el navegador de hooks ^[1].

Paso 4: entender los códigos de salida

El hook recibe datos del evento en JSON por la entrada estándar y responde con su código de salida ^[1]:

Paso 5: bloquear archivos protegidos

Script oficial, guardado en .claude/hooks/protect-files.sh ^[1]:

#!/bin/bash
# protect-files.sh

INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

# Normalize Windows backslash separators so the patterns below match
FILE_PATH="${FILE_PATH//\\//}"

PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")

for pattern in "${PROTECTED_PATTERNS[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: $FILE_PATH matches protected pattern '$pattern'" >&2
    exit 2
  fi
done

exit 0

Y su registro en .claude/settings.json ^[1]:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
          }
        ]
      }
    ]
  }
}

El script usa Bash y jq, que hay que tener instalado ^[1]; en macOS y Linux, haz el script ejecutable con chmod +x ^[1]. En Windows, un script Bash necesita un intérprete de Bash como el que trae Git for Windows; con qué shell ejecuta Claude Code los hooks en Windows nativo es No verificado (NV33), así que pruébalo antes de confiar en él.

Paso 6: formatear tras cada edición

Patrón oficial con PostToolUse y matcher Edit|Write, que pasa el archivo editado al formateador ^[1]. El ejemplo de la guía usa Prettier; la idea vale para cualquier formateador de línea de comandos de tu proyecto.

4. Ejemplo práctico

Caso: el backend Spring Boot de inspecciones tiene archivos que nadie debe tocar sin revisión: la configuración de producción y las migraciones ya aplicadas.

1. Copia el script protect-files.sh y cambia la lista de patrones:

PROTECTED_PATTERNS=("application-prod.yml" "src/main/resources/db/migration/" ".env")

2. Regístralo en .claude/settings.json como en el paso 5 y súbelo al repositorio para que valga para todo el equipo.
3. Prueba: pide a Claude "añade un comentario en application-prod.yml". Debe bloquearse y Claude debe recibir el mensaje Blocked: y proponer otra vía ^[1].
4. Complemento: el aviso de Windows del paso 3 en tu ~/.claude/settings.json personal.

Por qué un hook y no CLAUDE.md: "no modificar migraciones aplicadas" ya está en tu CLAUDE.md (lección 19), pero eso es contexto; el hook lo hace obligatorio ^[3].

5. Errores frecuentes y límites conocidos

• Pensar que salir con 1 bloquea. Bloquea el código 2; los demás son errores no bloqueantes en la mayoría de eventos ^[1].
• Pensar que exit 0 en PreToolUse aprueba. No: la llamada sigue el flujo normal de permisos ^[1].
• Vigilar solo Edit|Write. Claude también puede cambiar archivos con comandos de shell; para cubrirlo todo, la guía sugiere un hook Stop que revise el árbol de trabajo o un hook FileChanged ^[1].
• Matchers demasiado amplios para aprobar permisos. Un matcher vacío o .* en un hook que aprueba permisos lo aprobaría todo ^[1].
• Scripts no ejecutables en macOS o Linux. Hace falta chmod +x ^[1].
• El aviso de Windows no aparece. Puede abrirse detrás de la terminal; prueba antes el comando en PowerShell ^[1].
• Lista completa de eventos. La referencia es muy extensa; la lista de eventos de la investigación se leyó solo en parte (certeza media).

6. Ejercicio práctico

Enunciado:

1. Configura el aviso de Notification adecuado a tu sistema en tus ajustes personales.
2. En un proyecto propio, adapta protect-files.sh con al menos dos rutas que deban protegerse.
3. Registra el hook en .claude/settings.json y comprueba que aparece en /hooks.
4. Pide a Claude que edite un archivo protegido y otro que no lo esté.

Criterio de éxito:

• El aviso aparece cuando Claude espera tu respuesta.
• La edición del archivo protegido se bloquea con el mensaje Blocked:.
• La edición del archivo no protegido se hace con normalidad.
• Sabes explicar por qué el script sale con 2 y no con 1.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Automate actions with hooks (Claude Code) (se abre en una pestaña nueva) oficial cc-hooks-guide · consultada el 2026-10-25
2. Hooks reference (Claude Code) (se abre en una pestaña nueva) oficial cc-hooks · consultada el 2026-10-25
3. How Claude remembers your project (Claude Code) (se abre en una pestaña nueva) oficial cc-memory · consultada el 2026-10-25

1. Qué es y qué problema resuelve

El Model Context Protocol (MCP) es un estándar abierto que Anthropic publicó el 25-11-2024 para conectar asistentes de IA con los sistemas donde están los datos ^[1]. Antes, cada fuente de datos exigía una integración a medida; MCP las sustituye por un único protocolo ^[1].

Arquitectura: los desarrolladores exponen datos y acciones mediante servidores MCP, y las aplicaciones de IA, como Claude, actúan como clientes MCP que se conectan a ellos ^[1]. Los conectores de la app (lección 12) son servidores MCP.

Primitivas del protocolo ^[2]:

Gobernanza: el 09-12-2025 Anthropic donó MCP a la Agentic AI Foundation, un fondo de la Linux Foundation cofundado con Block y OpenAI ^[3].

Esta lección se centra en usar MCP desde Claude Code.

2. Cuándo usarla y cuándo NO

Usa un servidor MCP en Claude Code cuando:

• Necesitas que Claude consulte o actúe en un sistema externo durante el desarrollo (un gestor de incidencias, una base de datos, una herramienta de diseño).
• Quieres compartir esa conexión con el equipo a través del repositorio.

Cuándo NO:

• Si existe una herramienta de línea de comandos equivalente (por ejemplo gh o aws): Academy recomienda preferirla ^[4].
• Servidores que no usas: consumen contexto; desactívalos ^[4].
• Servidores de los que no te fías: los que traen contenido externo exponen a riesgo de inyección de instrucciones ^[5].

3. Tutorial paso a paso

Paso 1: elige el tipo de servidor

Claude Code admite servidores HTTP remotos (la opción recomendada), stdio locales (un proceso en tu equipo) y SSE, que está obsoleto ^[5].

Paso 2: añade un servidor remoto (HTTP)

claude mcp add --transport http <name> <url>

Ejemplo de la documentación ^[5]:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Paso 3: añade un servidor local (stdio)

claude mcp add [options] <name> -- <command> [args...]

El -- separa las opciones de Claude Code del comando que arranca el servidor ^[5]. Ejemplo de la documentación:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Paso 4: elige el ámbito

Con --scope (o -s) ^[5]:

Un .mcp.json de proyecto tiene este aspecto ^[5]:

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

En sesiones interactivas, Claude Code pide aprobación antes de usar los servidores de un .mcp.json de proyecto. claude mcp reset-project-choices reinicia esas decisiones ^[5].

Paso 5: gestiona los servidores

claude mcp list
claude mcp get notion
claude mcp remove notion

Dentro de una sesión, /mcp muestra el estado de los servidores y permite autenticarte con OAuth ^[5].

Paso 6: vigila el tamaño de las respuestas

Claude Code avisa cuando la salida de una herramienta MCP supera 10.000 tokens y la limita a 25.000 por defecto; se cambia con la variable MAX_MCP_OUTPUT_TOKENS ^[5].

4. Ejemplo práctico

Caso: que Claude Code consulte la base de datos de desarrollo de la API de inspecciones mientras escribes consultas de un informe.

1. Elige un servidor MCP para tu base de datos de una fuente de confianza y revisa su código o su documentación antes de instalarlo.
2. Añádelo en ámbito local, para que las credenciales no lleguen al repositorio:

claude mcp add --transport stdio db-inspecciones -- <comando-del-servidor> <argumentos>

3. Usa una base de datos de desarrollo y un usuario de solo lectura.
4. Comprueba con /mcp que está conectado.
5. Pide:

Con el servidor db-inspecciones, describe las tablas inspeccion e incidencia y sus
relaciones. Después propón la consulta SQL para el informe mensual de incidencias
abiertas por tipo y barrio. No ejecutes ninguna sentencia que modifique datos.

6. Cuando el equipo quiera compartir un servidor sin secretos (por ejemplo, la documentación interna por HTTP), pásalo a ámbito project en .mcp.json.

Por qué así: credenciales fuera del repositorio, permisos mínimos en la base de datos y servidores de confianza, siguiendo los avisos de seguridad de la documentación ^[5].

5. Errores frecuentes y límites conocidos

• Usar SSE en servidores nuevos. Está obsoleto; usa HTTP ^[5].
• Olvidar el -- en servidores stdio. Separa las opciones de Claude del comando del servidor ^[5].
• Subir credenciales en .mcp.json. El ámbito project se comparte por control de versiones ^[5].
• Servidores de proyecto en claude -p. En el modo no interactivo y en el Agent SDK se cargan sin pedir aprobación ^[5].
• Muchos servidores activos. Consumen contexto; desactiva los que no uses ^[4].
• Inyección de instrucciones. Los servidores que traen contenido externo pueden introducir instrucciones maliciosas ^[5].
• Nota de Windows con npx. Una indicación sobre envolver npx con cmd /c no aparece en la parte revisada de la documentación: No verificado (NV11).
• Detalles internos del protocolo (formato de mensajes y transportes en general): solo se han encontrado en el sitio del proyecto MCP, que es una fuente de terceros: No verificado (NV32).

6. Ejercicio práctico

Enunciado:

1. Añade un servidor MCP remoto de un servicio que uses en ámbito local y comprueba su estado con /mcp.
2. Pide a Claude una consulta de solo lectura a ese servicio.
3. Crea un .mcp.json de proyecto con un servidor sin credenciales y abre una sesión nueva para ver el diálogo de aprobación.
4. Ejecuta claude mcp list y elimina el servidor que no vayas a usar.

Criterio de éxito:

• El servidor local aparece conectado en /mcp y responde a una consulta de solo lectura.
• El .mcp.json no contiene secretos.
• Has visto y respondido el diálogo de aprobación de servidores de proyecto.
• Solo quedan configurados los servidores que usas.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Introducing the Model Context Protocol (se abre en una pestaña nueva) oficial news-model-context-protocol · consultada el 2026-10-25
2. MCP review (Introduction to MCP, Academy) (se abre en una pestaña nueva) oficial acad-mcp-review · consultada el 2026-10-25
3. Donating the Model Context Protocol and establishing the Agentic AI Foundation (se abre en una pestaña nueva) oficial news-donating-the-model-context-protocol-and-est · consultada el 2026-10-25
4. MCP (Claude Code 101, Academy) (se abre en una pestaña nueva) oficial acad-mcp · consultada el 2026-10-25
5. Connect Claude Code to tools via MCP (se abre en una pestaña nueva) oficial cc-mcp · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Una skill es una carpeta con instrucciones, scripts y recursos que Claude carga solo cuando la necesita ^[1]. A diferencia de un prompt, que es una instrucción puntual de una conversación, una skill se escribe una vez y se usa automáticamente cuando encaja ^[2].

Resuelve el problema de las tareas que se repiten con un procedimiento concreto: "redacta el informe de inspección con nuestro formato", "revisa este pliego según nuestra lista de comprobación". En lugar de explicarlo cada vez o meterlo en un CLAUDE.md que se carga siempre, lo empaquetas en una skill.

Divulgación progresiva: la clave de su eficiencia ^[2]:

Diferencias con otras piezas según la ayuda oficial ^[1]:

• Un Proyecto aporta conocimiento que está siempre cargado; una skill es un procedimiento que se activa cuando hace falta.
• MCP conecta con servicios; la skill aporta el saber hacer para usarlos. Se complementan.
• Las instrucciones personalizadas se aplican a todo; la skill, solo a su tarea.

Dónde funcionan: en la app de Claude, en Claude Code y en la API ^[2]. Anthropic ofrece skills preparadas para Excel, Word, PowerPoint y PDF, que en la app se usan solas al crear documentos ^[2].

2. Cuándo usarla y cuándo NO

Úsala cuando:

• Repites un procedimiento con pasos, formato o criterios propios de tu organización.
• Necesitas incluir plantillas, ejemplos o scripts que Claude debe usar.
• Quieres que el equipo trabaje igual.

Cuándo NO:

• Algo que debe cumplirse siempre: usa hooks (lección 22).
• Contexto que vale para todo el proyecto: CLAUDE.md o instrucciones de proyecto.
• Skills de origen desconocido: usa solo las tuyas o las de Anthropic; una skill maliciosa puede dirigir a Claude a ejecutar código o acceder a datos con fines distintos de los declarados ^[2].

3. Tutorial paso a paso

Paso 1: estructura de carpeta

redactando-informes-inspeccion/
├── SKILL.md            (obligatorio)
├── plantilla.md        (opcional: recurso)
└── scripts/
    └── validar.py      (opcional: script)

Paso 2: el archivo SKILL.md

Estructura oficial mínima ^[2]:

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Reglas de los campos en la plataforma ^[2]:

• name: máximo 64 caracteres; solo minúsculas, números y guiones; sin etiquetas XML; no puede contener "anthropic" ni "claude".
• description: no vacía, máximo 1.024 caracteres, sin etiquetas XML. Debe decir qué hace y cuándo usarla, porque es lo que Claude compara con tu petición para decidir si la activa.

Buenas prácticas de autoría ^[3]:

• Sé conciso: Claude ya es capaz; añade solo lo que no sabe.
• Escribe la descripción en tercera persona, con términos concretos que sirvan de desencadenante.
• Mantén el cuerpo por debajo de 500 líneas y mueve el detalle a archivos de referencia enlazados desde SKILL.md, a un solo nivel de profundidad.
• Usa siempre / en las rutas, nunca \, también en Windows.
• Crea las evaluaciones antes de escribir la skill: al menos tres escenarios y una prueba sin la skill para comparar.

Paso 3a: usarla en Claude Code

1. Guárdala en ~/.claude/skills/<nombre>/SKILL.md (personal) o en .claude/skills/<nombre>/SKILL.md (proyecto; haz commit para compartirla) ^[4].
2. El archivo debe empezar con --- en la primera línea; los nombres de campo desconocidos se ignoran sin aviso ^[4].
3. Invócala con /<nombre> o deja que Claude la cargue cuando la petición encaje con la descripción ^[4].
4. Para referirte a sus scripts, usa ${CLAUDE_SKILL_DIR}, que apunta a la carpeta de la skill ^[4].
5. /skills lista las disponibles ^[4].

Campos útiles en Claude Code ^[4]:

Los antiguos comandos de .claude/commands/ siguen funcionando; una skill y un comando con el mismo nombre crean el mismo /nombre, y gana la skill ^[4].

Paso 3b: usarla en la app de Claude

1. Activa la ejecución de código y creación de archivos (lección 06) ^[5].
2. Comprime la carpeta en un zip con la carpeta como raíz ^[5].
3. Customize > Skills > + > + Create skill > Upload a skill y sube el zip ^[5].
4. Actívala en Customize > Skills y pruébala con varias peticiones ^[5].
5. En Team y Enterprise, puedes compartirla desde el menú de la skill o publicarla en la organización, si los administradores lo permiten ^[5].

Paso 3c: en la API

Las skills se declaran en el parámetro container de la petición junto con la herramienta de ejecución de código, y las propias se suben con los endpoints /v1/skills; en la API se comparten en todo el workspace ^[2]. Lo verás en el módulo E.

4. Ejemplo práctico

Caso: skill para redactar informes de inspección de vía pública con el formato del ayuntamiento.

~/.claude/skills/redactando-informes-inspeccion/SKILL.md:

---
name: redactando-informes-inspeccion
description: Redacta informes de inspección de vía pública con el formato municipal a partir de notas y fotos. Usar al pedir un informe, parte o acta de inspección.
---

# Informes de inspección de vía pública

## Pasos
1. Lee las notas y fotos aportadas. No inventes mediciones ni ubicaciones.
2. Sigue la estructura de [plantilla.md](plantilla.md): datos de la inspección,
   descripción, deficiencias, clasificación de urgencia y actuaciones propuestas.
3. Clasifica cada deficiencia como Urgente (riesgo para personas), Prioritaria
   o Programable, y justifica la clasificación en una frase.
4. Termina con la lista "Datos pendientes" si falta algo para cerrar el informe.

## Estilo
- Tercera persona, tono administrativo, frases cortas.
- Unidades del Sistema Internacional; fechas en formato DD/MM/AAAA.

plantilla.md contiene el esqueleto del informe oficial.

Prueba: en una sesión nueva, pide "hazme el informe de esta inspección" con unas notas. Claude debería activar la skill por la descripción. Prueba también una petición que no deba activarla ("resume este artículo") y comprueba que no la usa.

En la app: comprime la carpeta redactando-informes-inspeccion y súbela por Customize > Skills para usarla también en el chat.

5. Errores frecuentes y límites conocidos

• Descripción vaga. Si no dice cuándo usarla, Claude no la activa; incluye los términos que usarías al pedir la tarea ^[3].
• SKILL.md sin --- en la primera línea en Claude Code. El frontmatter no se lee ^[4].
• Nombres con "claude" o mayúsculas. No cumplen las reglas de la plataforma ^[2].
• Rutas con \. Usa / siempre ^[3].
• Esperar que una skill subida a la app esté en la API (o al revés). La documentación de la plataforma dice que las skills personalizadas no se sincronizan entre superficies ^[2]; la documentación de Claude Code describe, sin embargo, una sincronización en un sentido desde la cuenta de claude.ai hacia Claude Code ^[4]. Comprueba con /skills qué tienes en cada sitio.
• Compartir en la app. La documentación de la plataforma dice que las skills de claude.ai son individuales, mientras la ayuda describe compartir y publicar en Team y Enterprise; se sigue la ayuda (A1-8 en research/CONTRADICCIONES.md).
• Longitud de la descripción en la app. La ayuda de creación habla de 200 caracteres frente a los 1.024 de la plataforma; para que valga en todas partes, quédate por debajo de 200 (A3-40).
• Datos sensibles. Las skills no están cubiertas por acuerdos de retención cero (ZDR) en la API ^[2]; no escribas claves ni contraseñas en una skill.

6. Ejercicio práctico

Enunciado:

1. Elige un procedimiento que repitas al menos una vez por semana.
2. Escribe tres peticiones que deban activar la skill y dos que no.
3. Crea la skill con SKILL.md y, si procede, una plantilla.
4. Pruébala en Claude Code con las cinco peticiones y anota en cuáles se activa.
5. Ajusta la descripción hasta que acierte las cinco.

Criterio de éxito:

• name y description cumplen las reglas de la plataforma y la descripción tiene menos de 200 caracteres.
• La skill se activa en las tres peticiones previstas y no en las otras dos.
• El resultado sigue el formato de la plantilla sin que lo repitas en el prompt.
• La skill no contiene credenciales ni datos personales.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. What are Skills? (se abre en una pestaña nueva) oficial sup-what-are-skills · consultada el 2026-10-25
2. Agent Skills overview (se abre en una pestaña nueva) oficial api-agent-skills-overview · consultada el 2026-10-25
3. Skill authoring best practices (se abre en una pestaña nueva) oficial api-best-practices · consultada el 2026-10-25
4. Extend Claude with skills (Claude Code) (se abre en una pestaña nueva) oficial cc-skills · consultada el 2026-10-25
5. Using Skills in Claude (se abre en una pestaña nueva) oficial sup-using-skills-in-claude · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Un subagente es un asistente especializado con su propia ventana de contexto, un prompt de sistema propio, acceso a herramientas concretas y permisos independientes. Cuando una tarea encaja con su descripción, Claude delega en él, el subagente trabaja por su cuenta y devuelve solo el resultado ^[1].

Resuelve el problema del contexto: una búsqueda por todo el repositorio, la salida de una batería de tests o un log largo llenan la conversación principal con información que no vas a volver a mirar. El subagente hace ese trabajo aparte y te devuelve un resumen ^[2].

Beneficios oficiales ^[1]:

• Conserva el contexto principal.
• Limita qué herramientas se pueden usar.
• Reutiliza configuraciones entre proyectos.
• Especializa el comportamiento con un prompt enfocado.
• Controla costes enviando tareas a modelos más rápidos y baratos, como Haiku.

Skill frente a subagente: una skill son instrucciones que se cargan en la conversación principal; un subagente es un trabajador aislado con ventana propia que devuelve un resumen ^[2].

2. Cuándo usarla y cuándo NO

Úsalos cuando:

• Una tarea lateral inundaría la conversación de salida que no vas a volver a consultar (es el criterio literal de la documentación) ^[2].
• Quieres un revisor o un investigador con herramientas de solo lectura.
• Una tarea simple puede ir a un modelo más barato.

Cuándo NO:

• Si la solución simple basta. La guía de ingeniería de Anthropic recomienda buscar la solución más simple y añadir complejidad solo cuando haga falta; los sistemas agénticos cambian latencia y coste por rendimiento ^[3].
• Si el subagente necesita saber lo hablado. No ve el historial de la conversación; todo lo que necesite debe ir en el encargo ^[2].
• Para ahorrar uso. Sus peticiones cuentan para los mismos límites que la conversación principal ^[1].

3. Tutorial paso a paso

Paso 1: conoce los integrados

Fuente de la tabla: ^[1].

Paso 2: dónde se definen y prioridad

Si dos subagentes tienen el mismo nombre, gana el de mayor prioridad ^[1]:

Ojo: en los subagentes el proyecto va por delante del usuario, al revés que en las skills (lección 24).

Paso 3: crea uno

Archivo .claude/agents/code-reviewer.md, ejemplo literal de la documentación ^[1]:

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

• Solo name y description son obligatorios ^[1].
• Otros campos: tools (si se omite, hereda todas), disallowedTools, model (sonnet, opus, haiku, fable, un ID completo o inherit), permissionMode, isolation: worktree, background y memory ^[1].
• Claude Code vigila estas carpetas y aplica los cambios en segundos; solo hay que reiniciar al crear el primer archivo en una carpeta agents nueva ^[1].

/agents ya no abre un asistente. Hoy solo muestra un recordatorio para que pidas a Claude que cree el subagente o edites las carpetas a mano; el asistente interactivo era de la versión 2.1.197 o anterior ^[1].

Paso 4: invócalo

• Automáticamente: Claude delega cuando la tarea encaja con description.
• En lenguaje natural: Use the code-reviewer subagent to review my recent changes.
• Con mención (garantiza que se use): @"code-reviewer (agent)" look at the auth changes.
• Toda la sesión como ese subagente: claude --agent code-reviewer.

Formas de invocación de la documentación: ^[1].

Paso 5: primer plano o segundo plano

Los subagentes que Claude lanza desde la conversación principal arrancan en segundo plano por defecto, y en terminal, VS Code y escritorio el modo fork está activado por defecto. Un fork es un subagente que, a diferencia de los demás, hereda toda la conversación ^[1]. Para que Claude espere a un subagente, la documentación indica poner CLAUDE_CODE_FORK_SUBAGENT a 0 ^[1]:

{
  "env": {
    "CLAUDE_CODE_FORK_SUBAGENT": "0"
  }
}

Paso 6: vigila el contexto de las descripciones

Las descripciones ocupan contexto. Si las de tus subagentes propios superan 15.000 tokens, Claude Code avisa al arrancar; mantén las descripciones cortas y pon el detalle en el prompt de cada subagente ^[1].

4. Ejemplo práctico

Caso: un revisor de seguridad de solo lectura para el backend Spring Boot.

.claude/agents/revisor-seguridad.md:

---
name: revisor-seguridad
description: Revisa cambios de código Java/Spring Boot buscando fallos de seguridad. Usar antes de abrir un pull request.
tools: Read, Glob, Grep
model: sonnet
---

Eres un revisor de seguridad de aplicaciones Spring Boot.

Revisa solo los archivos que te indiquen. Busca:
- Endpoints sin autorización o con roles incorrectos.
- Consultas construidas concatenando texto de entrada.
- Datos personales en logs o en respuestas de error.
- Credenciales o URLs internas en el código.

Devuelve una lista por gravedad (alta, media, baja) con archivo, línea,
problema y corrección propuesta. Si no encuentras nada, dilo en una línea.
No propongas cambios de estilo.

Uso:

@"revisor-seguridad (agent)" revisa los archivos que he cambiado en esta rama
respecto a main.

Por qué así: herramientas de solo lectura (no puede modificar nada), modelo más barato para una tarea acotada y salida en formato fijo que no inunda el contexto principal.

5. Errores frecuentes y límites conocidos

• Esperar que el subagente conozca la conversación. Arranca sin el historial ^[2].
• Descripciones vagas o solapadas. Claude no delega o elige mal; escribe cuándo usar cada uno ^[1].
• Buscar el asistente de /agents. Desapareció tras la versión 2.1.197 ^[1].
• Suponer que Claude espera el resultado. Por defecto va en segundo plano ^[1].
• No reiniciar tras crear la carpeta agents. Solo se necesita la primera vez ^[1].
• Pensar que delegar sale gratis. Cada subagente gasta uso de tu plan ^[1].
• Confundir context: fork de una skill con el fork de la conversación. La skill lanza un subagente nuevo sin historial (lección 24).
• Subagentes dentro de Cowork. Su uso en Cowork no se ha verificado: No verificado (NV14).

6. Ejercicio práctico

Enunciado:

1. Crea un subagente de solo lectura para una revisión que hagas a menudo (seguridad, accesibilidad de la app Android, coherencia de nombres).
2. Invócalo con mención @ sobre una rama real.
3. Repite la misma revisión sin subagente, en la conversación principal, y compara con /context cuánto contexto ocupa cada opción.
4. Ajusta la description para que Claude lo elija solo cuando corresponda.

Criterio de éxito:

• El subagente solo tiene herramientas de lectura.
• Su informe sigue el formato que definiste.
• Has comprobado con /context que la conversación principal ocupa menos con el subagente.
• Claude lo usa al pedir una revisión y no en peticiones que no tienen que ver.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Create custom subagents (Claude Code) (se abre en una pestaña nueva) oficial cc-sub-agents · consultada el 2026-10-25
2. Extend Claude Code (features overview) (se abre en una pestaña nueva) oficial cc-features-overview · consultada el 2026-10-25
3. Building effective agents (Anthropic Engineering) (se abre en una pestaña nueva) oficial eng-building-effective-agents · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Cuando un subagente no basta, Claude Code ofrece dos formas de trabajar con muchos agentes:

Resuelve el problema de las tareas que no caben en una sola conversación: revisar cientos de archivos, investigar con hipótesis enfrentadas o migrar todo un módulo.

El dato de coste que hay que conocer: en el sistema de investigación multiagente de Anthropic (2025), los agentes usaban unas 4 veces los tokens de un chat y los sistemas multiagente unas 15 veces ^[3]. La documentación de costes de Claude Code indica, para agent teams con compañeros en modo plan, unas 7 veces los tokens de una sesión estándar ^[4]. Son medidas distintas y no son comparables entre sí, pero todas dicen lo mismo: cuesta mucho más.

2. Cuándo usarla y cuándo NO

Agent teams encajan en ^[1]:

• Investigación y revisión en paralelo, con hallazgos que se discuten.
• Módulos nuevos donde cada compañero tiene su parte.
• Depuración con hipótesis en competencia.
• Cambios que cruzan capas (frontend, backend, tests).

Workflows encajan en ^[2]:

• Auditorías de todo el código, migraciones de muchos archivos e investigación con fuentes contrastadas.
• Tareas que quieres poder repetir con la misma orquestación.

Cuándo NO:

• Tareas secuenciales, ediciones del mismo archivo o con muchas dependencias: una sola sesión o subagentes son más eficaces ^[1].
• Programación con mucho contexto compartido: la guía de ingeniería señala que los sistemas multiagente encajan peor donde todos los agentes deben compartir contexto o hay muchas dependencias, y pone la programación como ejemplo ^[3].
• Tareas rutinarias: una sola sesión es más rentable ^[1].
• Windows Terminal o el terminal de VS Code con paneles divididos: no están soportados; el modo por defecto (en el mismo proceso) funciona en cualquier terminal ^[1].

3. Tutorial paso a paso

A. Agent teams

1. Actívalos en settings.json ^[1]:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

2. Pide el equipo en lenguaje natural, describiendo roles independientes. Ejemplo de la documentación ^[1]:

I'm designing a CLI tool that helps developers track TODO comments across
their codebase. Spawn three teammates to explore this from different angles:
one on UX, one on technical architecture, one playing devil's advocate.

3. Arquitectura: el líder (tu sesión) coordina; los compañeros son instancias independientes de Claude Code; hay una lista de tareas compartida y un buzón de mensajes ^[1].
4. Interacción: los compañeros aparecen en un panel bajo la caja de texto; con las flechas eliges uno y con Intro ves su sesión y le escribes ^[1].
5. Cierre: "Ask the researcher teammate to shut down" ^[1].

Buenas prácticas oficiales ^[1]:

• Empieza con 3 a 5 compañeros y unas 5 o 6 tareas por compañero.
• Da en el encargo todo el contexto específico: los compañeros no heredan el historial del líder.
• Evita que dos compañeros editen el mismo archivo.
• Empieza por tareas de investigación y revisión, sin escribir código.

B. Dynamic workflows

1. Prueba el workflow incluido ^[2]:

/deep-research What changed in the Node.js permission model between v20 and v22?

2. Aprueba la ejecución cuando te lo pida y sigue el progreso con /workflows ^[2].
3. Pide uno propio incluyendo la palabra ultracode o diciendo "use a workflow" en tu mensaje ^[2].
4. Guárdalo si te sirve: en /workflows, selecciona la ejecución y pulsa s; se guarda en .claude/workflows/ (compartido) o ~/.claude/workflows/ (personal) y se ejecuta como /<nombre> ^[2].

Límites del entorno ^[2]:

• No admite intervención del usuario a mitad de ejecución (salvo permisos y esperas por límite de uso).
• Hasta 16 agentes simultáneos por defecto y 1.000 por ejecución.
• Aviso de "Large workflow" por encima de 25 agentes o de 1,5 millones de tokens previstos.

4. Ejemplo práctico

Caso: auditar todos los controladores del backend de inspecciones antes de una auditoría externa.

Primero, en pequeño (la documentación recomienda probar con una parte para estimar el gasto) ^[2]:

use a workflow to audit every controller under src/main/java/es/ayto/inspecciones/incidencia/
for endpoints without authorization checks, and adversarially verify each finding before
reporting it

Revisa en /workflows cuántos agentes ha lanzado y cuántos tokens ha gastado. Si el resultado es útil y el coste razonable, amplía al resto de paquetes y guarda el workflow para repetirlo antes de cada versión.

Cuándo no lo harías así: si solo tienes cuatro controladores, un subagente revisor (lección 25) es suficiente y mucho más barato.

Variante con agent team: para decidir cómo reorganizar la sincronización sin conexión de la app Android, tres compañeros con hipótesis distintas (cola local, sincronización por lotes, reintentos con backoff) que se critican entre sí, sin escribir código. Es el tipo de tarea de investigación con hipótesis en competencia que la documentación recomienda ^[1].

5. Errores frecuentes y límites conocidos

• Activar equipos sin querer. Con agent teams activados, un subagente al que Claude da nombre se lanza como compañero; para volver a subagentes normales, pon la variable a 0 ^[1].
• Reanudar sesiones con compañeros. /resume y /rewind no restauran a los compañeros en el mismo proceso ^[1].
• Equipos en modo no interactivo. Con -p y en el Agent SDK no se crean compañeros ^[1].
• Un equipo por sesión, sin equipos anidados y líder fijo ^[1].
• Workflows sin estimar el coste. Una ejecución puede gastar bastante más que la misma tarea en conversación ^[2].
• Comparar los multiplicadores de coste. El 15x (investigación multiagente, 2025) y el 7x (equipos en modo plan) miden cosas distintas (A5-66 en research/CONTRADICCIONES.md).
• Cifras de 2025. Los datos de rendimiento del sistema multiagente son de modelos de 2025 y deben leerse como históricos (A5-67).

6. Ejercicio práctico

Enunciado:

1. Ejecuta /deep-research con una pregunta técnica de tu trabajo y revisa el informe y sus fuentes.
2. Pide un workflow pequeño sobre una sola carpeta de un proyecto propio y anota agentes y tokens en /workflows.
3. Escribe en cinco líneas si esa misma tarea habría salido mejor con un subagente, un agent team o un workflow, y por qué.

Criterio de éxito:

• Has comprobado al menos tres fuentes del informe de /deep-research.
• Sabes cuántos agentes y tokens usó tu workflow.
• Tu comparación usa los criterios oficiales: dependencias entre partes, contexto compartido, escala y coste.
• Si activaste agent teams para probar, los has vuelto a desactivar.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Orchestrate teams of Claude Code sessions (se abre en una pestaña nueva) oficial cc-agent-teams · consultada el 2026-10-25
2. Orchestrate subagents at scale with dynamic workflows (se abre en una pestaña nueva) oficial cc-workflows · consultada el 2026-10-25
3. How we built our multi-agent research system (Anthropic Engineering) (se abre en una pestaña nueva) oficial eng-multi-agent-research-system · consultada el 2026-10-25
4. Manage costs effectively (Claude Code) (se abre en una pestaña nueva) oficial cc-costs · consultada el 2026-10-25

1. Qué es y qué problema resuelve

Un plugin es un paquete instalable que agrupa skills, conectores (servidores MCP), subagentes y hooks ^{[1] [2]}. Un marketplace es el catálogo del que se instala: en Claude Code, un repositorio o directorio con un archivo de catálogo ^[3].

Resuelve el problema de compartir una forma de trabajar completa: en lugar de copiar a mano una skill, un subagente revisor, un hook y la configuración de un servidor MCP en cada equipo, se publican juntos y se instalan de una vez.

Fuente de la tabla: ^[1]. En la app, los plugins están en todos los planes de pago ^[1].

2. Cuándo usarla y cuándo NO

Úsalos cuando:

• Quieres instalar de una vez un conjunto preparado por Anthropic (por ejemplo, del marketplace Knowledge Work).
• Tu equipo quiere distribuir sus skills, subagentes y hooks de forma uniforme.

Cuándo NO:

• Plugins de origen no fiable. Un plugin de Claude Code puede ejecutar código arbitrario en tu equipo con tus privilegios ^[5].
• Para una sola skill personal: basta con la carpeta de la skill (lección 24).
• Si no sabes qué trae: el nombre del marketplace dice quién publica el catálogo, no qué hace cada plugin ^[5].

3. Tutorial paso a paso

A. En la app de Claude

1. Customize (barra lateral) > pestaña Plugins > Discover > elige un plugin > Add ^[1].
2. Escribe / o pulsa + para ver las skills del plugin; en Cowork también puedes usar /nombre-plugin:comando ^[1].
3. Marketplaces de Anthropic: Knowledge Work viene añadido por defecto; hay otros como Life Sciences, Financial Services y Legal. Se añaden en Customize > Plugins > Add > Add marketplace ^[1].
4. Sincronización: los plugins que añades en la cuenta se sincronizan con Claude Code al iniciar sesión con esa cuenta (requiere la versión 2.1.273 o posterior; en un solo sentido) ^[1].

B. En Claude Code

1. Antes de instalar, revisa (procedimiento oficial) ^[5]:
   • claude plugin marketplace list muestra de dónde viene cada marketplace.
   • En la sesión, /plugin y selecciona el plugin: la sección Will install lista comandos, agentes, skills, hooks y servidores MCP.
   • Lee el código del plugin, en especial hooks/hooks.json (qué ejecuta cada hook), .mcp.json (qué comando o URL usa cada servidor) y la carpeta bin/.
2. Instala desde el panel /plugin o con la CLI. Ejemplo de instalación desde el marketplace oficial ^[6]:

/plugin install commit-commands@claude-plugins-official

3. Las skills de un plugin se invocan como /<plugin>:<skill> ^[6].
4. Desinstala lo que ya no te fíes con claude plugin uninstall <plugin> y el mismo --scope con el que lo instalaste ^[5].

C. Entender los riesgos

Según la documentación de seguridad ^[5]:

• Los hooks, monitores, servidores MCP y LSP y los procesos de los mods de un plugin se ejecutan fuera del sandbox, con tus permisos de usuario.
• Tus reglas de permisos solo cubren las llamadas a herramientas que hace Claude, no el código que el plugin ejecuta por sí mismo.
• Con la actualización automática activada en un marketplace, los archivos que revisaste pueden cambiar en tu disco.
• Los nombres de los marketplaces oficiales solo se aceptan si proceden de github.com/anthropics/; cualquier otro marketplace es de terceros, también los de tu propia organización.

D. En Team y Enterprise

• Un propietario activa la compartición en Organization settings > Plugins & skills, pestaña Policy ^[1].
• Publish to org permite ofrecer un plugin como disponible, instalado por defecto u obligatorio; los obligatorios no se pueden desactivar, tampoco en Claude Code ^[1].
• En Enterprise, con el escaneo de seguridad activado, los plugins maliciosos se bloquean y los de riesgo muestran un aviso ^[1].

4. Ejemplo práctico

Caso: empaquetar para el equipo de desarrollo del ayuntamiento lo construido en las lecciones anteriores:

• La skill redactando-informes-inspeccion (lección 24).
• El subagente revisor-seguridad (lección 25).
• El hook protect-files.sh (lección 22).

Planteamiento:

1. Un marketplace interno en un repositorio de la organización, que Claude Code tratará como de terceros aunque sea vuestro ^[5].
2. Un plugin inspecciones-dev con esas tres piezas.
3. Antes de que nadie lo instale, otra persona revisa hooks/hooks.json y los scripts siguiendo el procedimiento del paso B.1.
4. Cada desarrollador lo instala en ámbito de proyecto y comprueba en Will install que solo contiene lo esperado.

Por qué revisar aunque sea interno: el hook ejecuta un script con los permisos de cada desarrollador y fuera del sandbox ^[5].

5. Errores frecuentes y límites conocidos

• Esperar hooks o subagentes en el chat web. Solo funcionan en Cowork y Claude Code ^[1].
• Pensar que los permisos de Claude Code limitan al plugin. No cubren hooks, monitores ni servidores, que se ejecutan fuera del sandbox ^[5].
• Confiar en un plugin por el nombre del marketplace. Revisa el contenido siempre ^[5].
• Compartir un plugin añadido desde un marketplace. No se puede; solo los que has creado o subido tú ^[1].
• Sincronización con clave de API o con Bedrock. Los plugins de la cuenta no se sincronizan en esos casos ^[1].
• Interfaz antigua de Cowork. El artículo de plugins aún menciona abrir antes la pestaña Cowork, que no existe en la experiencia unificada (A2-36 en research/CONTRADICCIONES.md).

6. Ejercicio práctico

Enunciado:

1. En la app, instala un plugin del marketplace Knowledge Work y prueba una de sus skills.
2. En Claude Code, elige un plugin del marketplace oficial y, antes de instalarlo, revisa su sección Will install y su hooks/hooks.json si tiene.
3. Instálalo, úsalo y luego desinstálalo con el mismo ámbito.
4. Escribe una lista de tres comprobaciones que harías antes de aprobar un plugin para tu equipo.

Criterio de éxito:

• Sabes qué componentes traía cada plugin antes de instalarlo.
• Has identificado si el plugin tenía hooks o servidores que se ejecutan fuera del sandbox.
• La desinstalación se ha hecho con el mismo ámbito que la instalación.
• Tu lista de comprobaciones incluye el origen del marketplace y la lectura de los hooks.

7. Fuentes

Fuentes consultadas para esta lección (las del frontmatter y las citadas en el texto):

1. Use plugins in Claude (se abre en una pestaña nueva) oficial sup-plugins · consultada el 2026-10-25
2. Extend Claude Code (features overview) (se abre en una pestaña nueva) oficial cc-features-overview · consultada el 2026-10-25
3. Plugins (Claude Code) (se abre en una pestaña nueva) oficial cc-plugins · consultada el 2026-10-25
4. Get started with Claude Cowork (se abre en una pestaña nueva) oficial sup-cowork-start · consultada el 2026-10-25
5. Plugin security and trust (Claude Code) (se abre en una pestaña nueva) oficial cc-plugins-security · consultada el 2026-10-25
6. Install and manage plugins (Claude Code) (se abre en una pestaña nueva) oficial cc-discover-plugins · consultada el 2026-10-25