Guías de Claude Code

Cómo llevar un proyecto grande con Claude Code: datos, maqueta, carriles y un agente que manda

Para llevar un proyecto grande con Claude Code, define datos y pantallas, divide tareas comprobables y separa los cambios antes de revisarlos e integrarlos.

Por

Director de Ciade · 13 min de lectura ·

Foto: alan boyce / Unsplash · tratamiento Ciade · Licencia de Unsplash
Índice del artículo
  1. En 30 segundos
  2. Una clínica dental necesita una agenda propia
  3. Del negocio a una versión que puedas aprobar
  4. Primero, las decisiones sobre los datos
  5. La maqueta debe enseñar también lo que falla
  6. Documentación por ámbito, sin cargarlo todo
  7. Qué forma de trabajo necesitas
  8. Un coordinador con responsabilidades claras
  9. Errores que debes evitar al abrir carriles
  10. Cómo convertir «cancelar cita» en una tarea comprobable
  11. Las instrucciones no sustituyen a los permisos
  12. Presupuesta la herramienta y el trabajo humano
  13. Si el encargo pide otra clase de herramienta
  14. Qué datos entran en la prueba
  15. Retomar mañana sin confundir memoria y recuperación
  16. Para practicar este modo de trabajo
  17. Dudas sobre proyectos grandes, respuestas cortas

En 30 segundos

  1. Para llevar un proyecto grande con Claude Code, define datos y pantallas, divide tareas comprobables y separa los cambios antes de revisarlos e integrarlos.

  2. Empieza con una sesión, una conversación de trabajo con el agente. Añade carriles, sesiones en carpetas separadas, cuando haya tareas independientes. El agente principal puede coordinar; una persona responsable aprueba las decisiones del negocio y la publicación.

Una clínica dental necesita una agenda propia

Ejemplo ilustrativo: una clínica dental de Zaragoza quiere organizar pacientes, profesionales y citas en una aplicación para recepción. La directora sabe cómo trabaja la clínica, pero no programa. Necesita explicar qué debe ocurrir y disponer de una forma de comprobarlo antes de encargar el proyecto completo. El ejemplo usa una copia con datos ficticios; no es un caso de cliente ni un resultado medido.

Claude Code es un agente de programación: usa inteligencia artificial para leer el proyecto, modificar archivos y ejecutar órdenes. Para organizar ese trabajo durante varias sesiones, empieza por acordar los datos, las pantallas y las comprobaciones. Así delimitas qué debe entregar el agente antes de encargarle cambios.

Del negocio a una versión que puedas aprobar

  1. Datos
  2. Pantallas y estados
  3. Tareas
  4. Cambios
  5. Comprobación
  6. Aprobación

Primero, las decisiones sobre los datos

Escribe el modelo de datos: qué cosas existen en el negocio, cómo se relacionan y qué cambios admiten. No necesitas dibujar tablas técnicas. Necesitas resolver las preguntas que condicionan el funcionamiento de la agenda.

Objetos y relaciones

Define qué pertenece a qué. En la agenda de la clínica, un paciente puede tener varias citas; cada cita corresponde a un profesional y a un tratamiento.

Estados y responsables

Decide quién cambia cada estado. Una cita puede estar pedida, confirmada, atendida o cancelada. La clínica debe decidir qué perfiles pueden realizar cada cambio.

Preguntas abiertas

Deja visibles las decisiones pendientes. ¿Una cita puede incluir varios tratamientos? ¿Qué ocurre con la agenda si un profesional deja la clínica? Resuélvelo antes de construir esa parte.

Encargo inicial
Vamos a diseñar una agenda para una clínica dental. Usa los datos de prueba de la copia.

Pacientes: una persona puede tener varias citas.
Profesionales: cada profesional tiene un horario.
Tratamientos: cada tratamiento tiene una duración.
Citas: paciente, profesional, tratamiento, día y hora.
Estados propuestos: pedida, confirmada, atendida o cancelada.

Antes de programar:
- Propón la estructura y explica las relaciones en español.
- Pregunta quién puede crear, confirmar y cancelar una cita.
- Señala qué decisiones faltan y qué partes dependen de ellas.
- Propón cómo comprobaremos cada comportamiento.

No escribas código ni cambios de base de datos hasta que apruebe la propuesta.

La maqueta debe enseñar también lo que falla

Una escena es la pantalla en un estado concreto. Recorre estas escenas de la agenda con recepción y acuerda qué debe ver la persona que trabaja allí.

La pantalla debe permitir entender y actuar con los datos que necesita recepción.

Qué se ve
Las citas del día, su hora, profesional y estado. Los nombres de los estados coinciden con los que has aprobado en el modelo de datos.
Qué se decide
Qué sucede al abrir una cita, cómo se vuelve a la agenda y qué mensaje confirma un cambio. Recepción recorre la maqueta y señala lo que falta antes de programarla.

Documentación por ámbito, sin cargarlo todo

El contexto es la información que la sesión tiene delante para trabajar. En un proyecto grande, separa el detalle de agenda, pacientes y otras partes en documentos de su ámbito. La sesión necesita el estado comprobado, los archivos que le corresponden y las decisiones que afectan al encargo. Así puedes corregir una regla en su lugar de referencia, en vez de repetir versiones distintas en cada conversación.

El archivo de instrucciones CLAUDE.md puede contener reglas comunes en la raíz y otras particulares en subcarpetas. Se cargan según el ámbito y el trabajo realizado; no supongas que todos los documentos del proyecto entran en cada sesión. Importar documentos completos también ocupa contexto. Mantén breve la guía general y reserva el detalle para la tarea que lo necesita. Aquí tienes cómo funciona el archivo de instrucciones.

Documento de un ámbito
# Ámbito: agenda

## Estado comprobado
- Funciona: [comportamiento y comprobación realizada].
- Falta: [siguiente cambio concreto].

## Terreno
- Archivos que puede modificar: [lista concreta].
- Partes ajenas: [lista concreta].

## Decisiones
- [Regla aprobada, responsable y motivo].
- Pendiente de decidir: [pregunta que bloquea el siguiente cambio].

## Problemas conocidos
- [Qué falla, cómo reproducirlo y qué se ha descartado].

Qué forma de trabajo necesitas

Estas modalidades se refieren a Claude Code en la terminal, la aplicación donde se escriben órdenes. Compara qué separa cada una; tener varias conversaciones no implica tener archivos independientes.

Datos comprobados el 4 de noviembre de 2026.

Una sesión

Anthropic

ComercialDisponible
Cuándo encaja
Para cambios que dependen del resultado anterior. Tú revisas cada encargo antes de pasar al siguiente.
Acceso y uso y límite concreto

España está admitida para usar Claude Code.

Acceso y uso
Code desde Pro o acceso por consumo.
Límite concreto
Free no incluye Claude Code.

Subagentes

Anthropic

ComercialDisponible
Cuándo encaja
Ayudantes con contexto propio que investigan o revisan y devuelven el resultado a la sesión principal.
Acceso y uso y límite concreto

Documentados para Code, sin exclusión específica de España.

Acceso y uso
Mismo acceso a Code; sus solicitudes cuentan contra los límites del plan.
Límite concreto
Pueden compartir carpeta con la sesión principal. Configura aislamiento si van a modificar archivos por separado.

Carriles

Anthropic y Git

ComercialDisponible
Cuándo encaja
Sesiones en worktrees: carpetas con una rama propia, una línea separada de cambios. Para tareas independientes.
Acceso y uso y límite concreto

Función documentada y mostrada en una demostración anterior del curso de Ciade.

Acceso y uso
Misma suscripción de Code; cada sesión consume uso. La pyme designa quién integra los cambios.
Límite concreto
El historial y el destino de subida del código siguen compartidos. Comprueba qué rama entregará cada sesión.

Agent Teams

Anthropic

ComercialDisponible con requisitos
Cuándo encaja
Un líder coordina compañeros con tareas, mensajes y contextos propios. Para trabajo independiente que necesite comunicación.
Acceso y uso y límite concreto

Función experimental, desactivada por defecto. La documentación consultada no excluye España.

Acceso y uso
Acceso a Code y activación experimental. El consumo depende de participantes y duración.
Límite concreto
Reanudar o restaurar la sesión no recupera los compañeros que compartían un mismo proceso, es decir, una misma ejecución de Claude Code.

Distingue la carpeta de trabajo de la conversación antes de repartir tareas. Puedes ampliar qué es un worktree y qué hace un subagente.

Un coordinador con responsabilidades claras

El «agente que manda» del título es un coordinador del trabajo. Puede repartir tareas, recoger resultados y señalar dependencias. La empresa decide quién integra, es decir, quién une los cambios de las ramas, y quién autoriza publicar. No hace falta que el coordinador escriba directamente en la rama principal para ejercer esa función.

Piensa en dos encargos de la clínica: construir el formulario y redactar la documentación de recepción. Puedes separarlos si has acordado qué campos tendrá el formulario. Si ambos encargos cambian las mismas reglas de citas, resuelve la dependencia primero. Abrir más sesiones añade trabajo de coordinación y no aporta por sí mismo una comprobación mejor.

Quién responde en la prueba de la agenda

Dirección

Qué decide o comprueba: Reglas de citas, perfiles autorizados y alcance de la prueba.

Qué entrega: Decisiones aprobadas y dudas pendientes.

Recepción

Qué decide o comprueba: Si el recorrido sirve para su trabajo diario.

Qué entrega: Observaciones sobre las escenas y el comportamiento.

Agente coordinador

Qué decide o comprueba: Cómo repartir los encargos dentro del alcance acordado.

Qué entrega: Cambios, comprobaciones y dependencias por resolver.

Responsable técnico

Qué decide o comprueba: Integración, pruebas y accesos antes de publicar.

Qué entrega: Versión revisada para que dirección autorice su publicación.

Asigna un responsable a cada aprobación. Una misma persona puede asumir varias funciones, pero deja claro de cuáles responde.

Errores que debes evitar al abrir carriles

Compartir servicios reales

Una carpeta separada puede apuntar a la misma base de datos. El responsable técnico debe comprobar destinos y credenciales de prueba; el worktree no cambia esa configuración.

Dar el entorno por preparado

El responsable técnico prepara el entorno de cada carpeta antes de empezar. Debe comprobar los programas, la configuración y los puertos: los puntos de conexión que usan los servidores de prueba.

Cerrar con trabajo pendiente

Conserva los cambios sin integrar. Revisa qué queda por guardar antes de retirar una carpeta de trabajo; el borrado forzado no debe ser el cierre rutinario.

Cómo convertir «cancelar cita» en una tarea comprobable

  1. Fija el resultado

    El criterio de terminado describe un comportamiento observable. En este ejemplo, cancelar una cita de prueba la retira de la agenda activa y conserva visible su estado. Dirección confirma esa regla antes de programar. No basta con encargar «mejora la agenda» y esperar a decidir al ver el resultado.

  2. Indica qué puede cambiar

    Indica qué archivos puede modificar, qué debe entregar y qué partes quedan fuera. Adjunta las decisiones aprobadas. Si necesita cambiar las reglas de las citas u otra parte del proyecto, debe señalarlo antes; anota quién resolverá la duda y qué trabajo puede continuar.

  3. Pide una comprobación

    Pide una prueba que indique si se cumple la regla acordada. Debe comprobar el cambio de estado y que un usuario sin permiso no puede cancelar. Solicita el resultado y cómo repetirla.

  4. Revisa antes de integrar

    Compara los archivos modificados y el resultado con el encargo aprobado. Recepción revisa el recorrido acordado y el responsable técnico comprueba el conjunto antes de unir los cambios. Si el agente detecta un fallo, devuelve la tarea con ese caso concreto. Un modelo es el motor de IA que genera las respuestas. Cambiarlo o abrir otra conversación puede ayudar a revisar, pero no demuestra corrección por sí solo.

Las instrucciones no sustituyen a los permisos

Decir «revisa sin modificar» expresa una intención. Para un revisor documental, el responsable técnico puede limitar las herramientas a Read, Grep y Glob: leer archivos, buscar texto y localizar archivos. Dejar una terminal disponible no demuestra que el acceso sea de solo lectura. Comprueba también las conexiones externas que puedan realizar cambios.

Claude Code aplica reglas para bloquear, preguntar o permitir herramientas. Configura los accesos de acuerdo con la función de cada sesión y las credenciales que utiliza. Escribir «no publiques» en el encargo o en CLAUDE.md no cambia esos permisos. Tampoco todos los modos de Code te preguntan por cada modificación. Antes de entregar trabajo autónomo, el responsable técnico debe revisar la configuración efectiva.

Presupuesta la herramienta y el trabajo humano

No hay un precio fijo por proyecto. El consumo depende del modelo, el contexto, la duración y las sesiones activas. Puedes consultar el uso con /usage. En una suscripción, una estimación monetaria de la sesión no equivale a un cargo de API: la conexión que permite a un programa utilizar Claude y que lleva facturación aparte.

La App Store española y la web tienen tarifas y monedas distintas; no son conversiones. Para presupuestar la prueba de la agenda, añade el apoyo técnico, alojamiento, revisión y correcciones. Anota esas partidas durante una tarea acotada antes de ampliar el trabajo a más sesiones.

Suscripción para acceder a Claude Code

Pro

App Store España: 22,00 €/mes o 249,99 €/año.

Condición que debes conocer: Incluye Code; no incluye el consumo de API.

Max

App Store España: 149,99 €/mes.

Condición que debes conocer: Más capacidad de uso; revisar los cambios sigue siendo necesario.

Ultra

App Store España: 299,99 €/mes.

Condición que debes conocer: Conserva límite semanal. Eliminar el de cinco horas exige cuenta verificada.

Precios de la App Store española consultados el 4 de noviembre de 2026, IVA incluido. Son cuotas de la herramienta, no presupuestos de desarrollo. Confirma el importe y el periodo al contratar.

Si el encargo pide otra clase de herramienta

Una aplicación propia no es la única salida. Estas opciones tienen otro alcance y requieren apoyo técnico. Compara primero el trabajo que necesitas resolver y quién mantendrá la instalación.

OpenClaw

Es un agente general instalable con herramientas y proveedores de modelos configurables. Su licencia MIT permite uso y modificación conservando los avisos; tú preparas la infraestructura y la operación.

Hermes Agent

Ofrece memoria y habilidades reutilizables en una instalación propia, con modelo configurable. Tiene licencia MIT. Elegirlo implica asumir la configuración y el mantenimiento.

n8n Community

Puede resolver un flujo repetible entre aplicaciones. Permite uso interno bajo una licencia con restricciones. Mantener el servidor y las conexiones sigue siendo trabajo de tu empresa.

Las tres opciones se pueden instalar en España con equipo compatible y respetando sus licencias. Eso no concede acceso automático a cada proveedor o servicio conectado. No son sustitutos idénticos de Claude Code.

Qué datos entran en la prueba

Durante la prueba de la agenda, excluye las historias clínicas reales. Antes de introducir información de clientes, acuerda qué datos necesita la tarea, dónde se enviarán y quién autoriza ese uso.

En Pro, Max y Ultra, el uso del contenido para mejorar modelos depende del ajuste de privacidad. Bajo condiciones comerciales de Team, Enterprise y API, no se usa para entrenamiento por defecto, salvo participación expresa. Esa diferencia no demuestra alojamiento en España ni convierte por sí sola una instalación en adecuada para expedientes sanitarios.

Retomar mañana sin confundir memoria y recuperación

Antes de cerrar, deja un parte de tarea con el objetivo, decisiones, cambios y comprobaciones. Usa la plantilla siguiente para dejarlo por escrito. Una sesión nueva comienza con contexto nuevo; leer ese parte permite contrastar lo registrado con los archivos actuales y decidir el siguiente paso. Marca las pruebas pendientes como pendientes, aunque el agente ya haya terminado de editar.

Los puntos de restauración de Code tienen otro propósito. La orden /rewind permite volver a puntos de la sesión, pero los cambios realizados exclusivamente mediante órdenes de terminal pueden quedar fuera del seguimiento. Tampoco cubre de forma universal las modificaciones de otros agentes. Conserva el historial de versiones y las copias de seguridad por separado.

Parte para la siguiente sesión
Tarea: cancelar una cita de prueba.
Objetivo: aplicar la regla aprobada por la clínica.
Decisiones: [regla y responsable que la aprobó].
Archivos modificados: [lista].
Comprobaciones realizadas: [prueba y resultado].
Pendiente de comprobar: [lista explícita].
Cambios integrados: [cuáles y dónde].
Siguiente paso: [acción concreta y responsable].

Para practicar este modo de trabajo

El curso Claude Code a fondo incluye trabajo con varios agentes. Antes de abrir más sesiones, elige una tarea acotada de la agenda y deja escritos su resultado esperado y cómo comprobarlo. Apóyate en la guía completa de Claude Code para situar cada pieza al preparar ese encargo.

Dudas sobre proyectos grandes, respuestas cortas

¿Cómo evito que el agente pierda el rumbo en un proyecto largo?

Deja una especificación escrita con las decisiones del negocio y divide el trabajo en tareas comprobables. Entrega a cada sesión la información de su ámbito y un resultado esperado. Revisa lo construido contra ese encargo antes de continuar; pedir toda la aplicación de una vez dificulta esos puntos de control.

¿Tengo que comprar un puesto por cada agente?

No. En Team, cada puesto corresponde a una persona identificada. No se compra un puesto humano por cada subagente. Sus solicitudes cuentan dentro de los límites de uso de la suscripción; abrir más sesiones no multiplica ese cupo. Si utilizas la API, su consumo se factura aparte.

¿Necesito carpetas separadas para cualquier proyecto grande?

No. Empieza con una sesión y tareas comprobables. Añade carpetas de trabajo separadas, llamadas worktrees, cuando haya tareas independientes. Separan los archivos y las ramas, pero requieren preparar su entorno y revisar los cambios juntos antes de integrarlos. No equivalen a máquinas independientes.

¿Qué dejo escrito para continuar en otra sesión?

Deja un parte de tarea con objetivo, decisiones, archivos modificados, comprobaciones realizadas y siguiente paso. Señala también qué queda pendiente. Una sesión nueva empieza con contexto nuevo, es decir, con nueva información disponible para trabajar sobre el proyecto. Contrasta el parte con los archivos actuales antes de continuar.

Fuentes

Fuentes oficiales, consultadas el 4 de noviembre de 2026

  1. Anthropic · Qué hace Claude Code
  2. Anthropic · Planificación y tareas habituales
  3. Anthropic · Especificaciones y comprobaciones
  4. Anthropic · Proyectos grandes e instrucciones por carpeta
  5. Anthropic · Instrucciones y memoria del proyecto
  6. Anthropic · Sesiones paralelas con worktrees
  7. Git · Carpetas de trabajo enlazadas
  8. Anthropic · Subagentes y herramientas disponibles
  9. Anthropic · Equipos de agentes experimentales
  10. Anthropic · Configuración de permisos
  11. Anthropic · Puntos de restauración
  12. Anthropic · Consumo y costes
  13. Anthropic · Uso de datos en Claude Code
  14. Anthropic · Países donde funciona Claude
  15. Anthropic · Precios y acceso de los planes
  16. Anthropic · Pro y facturación separada de API
  17. Anthropic · Puestos personales de Team
  18. Apple · Claude en la App Store española
  19. Apple · Impuestos en las suscripciones
  20. OpenClaw · Licencia MIT
  21. OpenClaw · Instalación
  22. OpenClaw · Proveedores de modelos
  23. Nous Research · Licencia de Hermes Agent
  24. Nous Research · Documentación de Hermes Agent
  25. n8n · Instalación propia y Community
  26. n8n · Usos permitidos por su licencia
  27. Anthropic · Disponibilidad según función y proveedor

Cómo lo comprobamos. Fuentes oficiales consultadas el 4 de noviembre de 2026. Ciade usa Claude Code a diario desde España y su curso documenta una demostración anterior con worktrees. No hemos probado Agent Teams, OpenClaw, Hermes Agent ni n8n Community; tampoco se han realizado pruebas nuevas con subagentes ni repetido la demostración de worktrees para esta revisión.

Qué ha cambiado.

  • 4 de noviembre de 2026: Reescrito como v2. Se conservan datos, escenas, documentación por ámbito y continuidad. Se precisan los límites de aislamiento, restauración, permisos y coordinación, y se añaden precios españoles y preguntas frecuentes.

Términos relacionados

Aprende a usar la IA en tu trabajo, con criterio.

El nivel 0 es gratis: cuarenta minutos para entender qué pedirle a la IA y qué revisar. El programa completo enseña a implementarla en tu propio negocio, tarea a tarea.

El canal de Telegram de Ciade

El lunes, una palabra del glosario. El miércoles, un consejo práctico. El viernes, las noticias de IA de la semana. Y el martes, el boletín.

Unirme al canal

Tú decides qué medimos

Las cookies técnicas hacen que la web funcione. Con tu permiso, además, medimos las visitas con Ahrefs y de qué campaña llegas, y Meta mide nuestros anuncios y puede mostrarte los de Ciade en Facebook e Instagram. Puedes cambiarlo cuando quieras en «Configurar cookies», al pie de la página. Política de cookies