Claude Code Projects: coordinador, hilos y limitaciones de la beta

Anthropic rediseñó recientemente Projects en Claude Code. Ahora es una única conversación coordinadora que inicia sesiones paralelas en la nube —hilos— para realizar tareas y recibe informes de ellas. Merece la pena crear un proyecto cuando tu trabajo tiene un objetivo que durará más que una sola sesión y generará nuevas tareas; por ejemplo, desarrollar un repositorio de GitHub durante varias semanas. La necesidad de trabajar en paralelo, por sí sola, no basta. Si necesitas corregir rápidamente un archivo aquí y ahora, una sesión normal es suficiente.

El trabajo lo dirige un coordinador: una conversación de larga duración en la que Claude decide si convierte tu mensaje en una tarea para un hilo. Los hilos escriben el código: cada uno es una sesión independiente de Claude Code en la nube, en su propia rama del repositorio. Puede haber varios hilos ejecutándose a la vez, cada uno con su propio contexto y su propia rama. El coordinador ve lo que informa un hilo al terminar, pero no cada paso que da. Te informa de las solicitudes de incorporación de cambios completadas (solicitudes para combinar cambios) y, cuando se lo indicas, pide a un hilo que las revise o las combine. A continuación se ofrece un resumen basado en la documentación oficial de Anthropic: qué configurar, cómo se organiza el trabajo y qué limitaciones tiene la beta.

La beta se está habilitando gradualmente, empezando por las cuentas Pro y Max que ya han usado sesiones de Claude Code en la nube y no han creado un proyecto en el chat normal ni en Cowork. Si todavía no ves la sección Projects, puedes apuntarte a la lista de espera.

¿Qué es Claude Code Projects, explicado de forma sencilla?#

Un proyecto es una única conversación de larga duración con un coordinador, a la que se adjuntan repositorios, memoria e instrucciones. Escribes al coordinador y este decide si responde de inmediato o inicia un hilo. No tienes que abrir manualmente una sesión nueva para cada tarea.

Un hilo es una sesión completa de Claude Code en la nube: tiene su propio contexto y su propia rama del repositorio, y abre una solicitud de incorporación de cambios cuando hace falta. El coordinador puede mantener varios hilos abiertos a la vez —por ejemplo, uno corrige un error, otro escribe pruebas y un tercero actualiza la documentación— mientras responde a tus preguntas en la conversación principal.

Para comparar, imagina varias pestañas con sesiones locales de Claude Code, cada una en su propia copia de trabajo de un repositorio. Esa copia se llama worktree: una carpeta separada para una rama, de modo que las sesiones locales no interfieran entre sí. Tú cambias entre las sesiones y decides qué asignar a cada una. Los hilos en la nube no necesitan un worktree: cada hilo clona los repositorios en su propio entorno aislado en la nube. Projects se encarga de coordinar y decidir cuándo crear un hilo nuevo y cuándo no hace falta.

Un proyecto tiene memoria e instrucciones compartidas que recibe cada hilo nuevo. La sección de configuración explica qué guardar en ellas y cómo se transmiten a los hilos.

En qué se diferencia de una sesión normal y de un equipo de agentes#

Si ya ejecutas subagentes anidados dentro de una sola sesión de Claude Code, conviene distinguirlos de los equipos de agentes y los hilos de proyecto. Un equipo de agentes es otra forma de delegar trabajo: una sesión inicia sesiones de compañeros de equipo para una tarea concreta. Puedes ejecutarlo tanto en tu propia máquina como dentro de una sesión en la nube.

• Equipo de agentes: sesiones de compañeros de equipo para una tarea concreta, que pueden iniciarse localmente o en la nube. No son hilos de proyecto independientes.
• Un proyecto y sus hilos: el trabajo se realiza en la nube. Cada hilo es una sesión independiente en su propia rama y sigue ejecutándose aunque cierres el portátil. Una sesión local no puede formar parte de un proyecto.
• Vista de agentes: una pantalla para observar varias sesiones locales en tu máquina. No tiene coordinador: tú decides qué asignar a cada una.

La documentación oficial de Anthropic señala un aspecto aparte: trabajar en paralelo, por sí solo, no es motivo para crear un proyecto. En un proyecto, Claude inicia las sesiones y recibe sus informes, y todas las sesiones parten de repositorios, instrucciones y memoria compartidos. El trabajo permanece en la nube durante toda la tarea.

Otro artículo trata un enfoque similar —un coordinador que distribuye tareas entre agentes— en Cursor Projects. El mecanismo es diferente, pero el coordinador también decide qué asignar a cada uno.

Qué configurar antes de tu primer proyecto#

Antes de crear un proyecto, comprueba tres cosas.

1. Cuenta de GitHub y Claude GitHub App. Si ya has conectado GitHub mediante /web-setup, ese token permite que tus sesiones normales en la nube accedan al repositorio. No basta para los hilos de proyecto: necesitas una cuenta de GitHub conectada con acceso de escritura al repositorio y tener instalada Claude GitHub App para ese repositorio. Sin ella, un hilo no puede clonar el repositorio ni abrir una solicitud de incorporación de cambios.

2. Instrucciones del proyecto. Las instrucciones del proyecto son un texto de hasta 16 000 caracteres que se envía a cada hilo nuevo y al propio coordinador. Incluye la información que, de otro modo, tendrías que volver a explicar en cada sesión: la estructura del repositorio, las convenciones de código y las comprobaciones necesarias antes de una solicitud de incorporación de cambios.

3. Modelo y nivel de esfuerzo. De forma predeterminada, un proyecto nuevo ejecuta cada hilo con el modelo Opus y un nivel de esfuerzo alto, y el coordinador con un nivel de esfuerzo bajo. La documentación dice que esta configuración «consume tu asignación del plan más rápidamente» (traducción; original: draws on your plan fastest). Si tus tareas son sencillas, puedes elegir un modelo menos costoso o reducir el nivel de esfuerzo en Project settings > General. Los ajustes de los hilos y del coordinador se cambian por separado; la documentación describe opciones más económicas.

La memoria del proyecto se guarda en archivos normales, con un archivo de índice llamado MEMORY.md. Cada hilo nuevo lo lee al iniciarse y accede a los demás archivos cuando los necesita. Los hallazgos de un hilo que se guardan en la memoria quedan disponibles para el siguiente, sin necesidad de volver a explicarlos.

Qué hacer si los hilos modifican el mismo código#

Cada hilo trabaja en su propia rama y abre una solicitud de incorporación de cambios si el trabajo lo requiere. Pero el coordinador no garantiza que las tareas nunca se solapen: si varios hilos acaban trabajando en la misma parte del código, puedes pedirle al hilo correspondiente que resuelva el conflicto desde la interfaz. Junto a su solicitud de incorporación de cambios hay un botón Resolve conflicts que envía una instrucción al hilo como mensaje tuyo.

La documentación oficial sugiere indicar en las instrucciones del proyecto tus preferencias sobre el número de hilos: por ejemplo, pedirle al coordinador que no inicie más de dos hilos a la vez o que reutilice un hilo existente para tareas nuevas en la misma área. Es una preferencia que el coordinador intenta respetar, no un límite estricto. Por sí sola, no garantiza que los hilos no entren en conflicto en el mismo archivo; los conflictos existentes deben resolverse por separado. Para tareas relacionadas en la misma área, puedes reutilizar un hilo activo o inactivo. Si ha estado inactivo durante más de una hora, al recibir un mensaje nuevo vuelve a leer todo el historial, lo que afecta al uso de la asignación de tu suscripción.

Cuanto más claramente se separen las tareas por archivos o módulos, más fácil será trabajar en paralelo. Otro artículo trata sobre cómo dividir una tarea grande en partes independientes: cómo delegar la programación a miles de agentes. La escala es distinta, pero el principio de dividir el trabajo es el mismo.

Mientras la caché de la conversación siga activa (en los planes Pro y Max, durante una hora, si los límites de tu plan lo permiten), un hilo usa menos tokens de la asignación de tu suscripción para volver a procesar su historial. Cuando la caché caduca, al recibir un mensaje nuevo el hilo vuelve a leer todo su historial antes de empezar a trabajar. Para una tarea nueva e independiente, puede resultar más económico pedirle al coordinador que cree un hilo nuevo: esto puede consumir menos tokens de la misma asignación de tu suscripción que continuar una sesión antigua con un historial extenso después de que haya caducado su caché.

Limitaciones de la beta que debes conocer de antemano#

Antes de crear un proyecto para una tarea importante, comprueba las limitaciones de la beta:

• Disponible solo en Pro y Max. Team y Enterprise todavía no son compatibles.
• Límite de 200 hilos nuevos al día por cuenta, sumando todos los proyectos.
• El proyecto pertenece a una sola persona. No puedes compartir el acceso al proyecto ni a un hilo individual con otra persona, y la beta no tiene ajustes de organización para equipos.
• Acceso solo mediante claude.ai/code, la aplicación de escritorio y la aplicación móvil. Projects no funciona en la CLI del terminal, a través de Amazon Bedrock, Google Cloud Agent Platform ni Microsoft Foundry.
• Un proyecto no puede ver archivos ni herramientas locales. Los hilos funcionan con repositorios de GitHub, archivos subidos y carpetas de Google Drive, pero no con elementos que solo existen en tu máquina.

Si necesitas acceso al terminal o a herramientas que solo están disponibles en tu máquina, utiliza una sesión local o una vista de agentes para varias sesiones de este tipo. Si varias personas necesitan trabajar juntas en un mismo espacio de trabajo, Anthropic tiene un producto distinto para equipos de Team y Enterprise: Claude Tag. Está en un canal de Slack; cualquier miembro puede asignarle una tarea a Claude y todos en el canal pueden ver y dirigir el trabajo. Un proyecto funciona de otra manera: solo te pertenece a ti. Si solo necesitas determinados archivos locales, puedes subirlos al proyecto y todos los hilos tendrán acceso a ellos. Esto no proporciona acceso a herramientas locales.

Qué hacer a continuación#

Antes de trasladar tu flujo de trabajo a Projects, prueba a crear un proyecto de prueba en un repositorio no crítico: conecta GitHub App, escribe instrucciones breves, asigna al coordinador una tarea independiente y observa cómo la gestiona. Esta primera ejecución te mostrará si entiendes la interfaz del coordinador y los hilos. No permite evaluar el trabajo en paralelo, los conflictos ni el uso de la asignación para varias tareas; esos aspectos hay que probarlos por separado.