Deje que Claude coordine el trabajo en curso con Projects

• Envíe trabajo a un solo lugar: pegue un informe de error, un seguimiento de pila o una lista de tareas en la conversación cada vez que surja uno. Claude comienza un hilo para cada pieza de trabajo o lo pasa al hilo que ya está trabajando en esa área, y responde preguntas rápidas en su lugar.
• Establezca el contexto una sola vez: cada nuevo hilo comienza con los repositorios, instrucciones y memoria del proyecto, por lo que una regla que establezca una sola vez, como qué rama dirigirse, llega a todos ellos.
• Aléjese y regrese al trabajo terminado: cuando regrese una hora después o a la mañana siguiente, el panel Overview muestra qué hilos terminaron, qué solicitudes de extracción están listas para revisión y qué hilo está esperando su respuesta.

​

Cuándo usar un proyecto

• Un objetivo en muchos repositorios: “Llevar cada servicio a la nueva configuración de lint.” Claude puede ejecutar un hilo por repositorio, cada uno con su propia solicitud de extracción, y el panel Overview muestra cuáles están listas para revisión.
• Un área que sigues alimentando: los errores, seguimientos de pila y solicitudes de revisión para un servicio, pegados en la conversación a medida que te llegan. Una trampa que le dices a Claude que recuerde después de una corrección está en memoria del proyecto para la siguiente.
• Una compilación o migración más grande que una sesión: “Construir lo que describe docs/spec.md” o “Mover la aplicación del ORM obsoleto.” El trabajo se divide en hilos que cada uno toma una parte, las decisiones que le pides a Claude que recuerde al principio llegan a los hilos posteriores, y la especificación cambia y los errores que encuentras durante la compilación van a la misma conversación.
• Trabajo que no es código: una carpeta de contratos o una exportación de tickets de soporte a la que sigues regresando con nuevas preguntas, como “encontrar los diez errores de integración más comunes en estos tickets.” Carga los documentos en lugar de agregar un repositorio, y los hilos entregan cada informe como un archivo en la pestaña Library del proyecto.

​

Cuándo algo más se adapta mejor

• Una tarea que cabe en una sesión: “Arreglar la prueba de inicio de sesión inestable.” Comienza una sesión en la nube tú mismo.
• Trabajo que necesita herramientas o servicios que solo tu máquina puede alcanzar: una base de datos local, un emulador de dispositivo, una API detrás de tu VPN. Usa una sesión local, o vista de agente para ejecutar varias a la vez. Si el trabajo solo necesita archivos locales, cárgalos en el proyecto en su lugar.
• Una tarea que se repite en un horario sin conversación alrededor: “Publicar un informe de dependencias cada lunes.” Crea una rutina por su cuenta.
• Varias personas dándole trabajo a Claude y dirigiéndolo juntos en un canal de Slack: ver Claude Tag.

​

Cómo se organiza un proyecto

• La conversación del proyecto: una sesión de larga duración donde Claude actúa como coordinador. Toma lo que envías, decide qué se convierte en un hilo, y mantiene un registro de cada hilo que comenzó. Ve lo que los hilos reportan, no cada paso que toman.
• Hilos: los trabajadores. Cada uno es una sesión en la nube separada con su propia ventana de contexto que hace una pieza de trabajo en su propia rama, abre una solicitud de extracción cuando el trabajo lo requiere, e informa a la conversación cuando termina.
• Lo que cada hilo comienza con:
  • Los repositorios y archivos del proyecto, más sus instrucciones y memoria
  • El CLAUDE.md, skills, y plugins en cada uno de los repositorios del proyecto, y en un proyecto con un repositorio, las reglas de permisos y hooks de ese repositorio también
  • Los conectores en tu cuenta de claude.ai
  • Un entorno en la nube que establece su acceso a la red, variables de entorno, credenciales de API, y herramientas instaladas
• El panel Overview: donde ves todos los hilos a la vez y cuáles de ellos te necesitan. Sus otras pestañas son Library para los archivos que agregaste y los archivos que produjeron los hilos, Pull requests para los que abrieron los hilos, y Routines para el trabajo programado en el proyecto.

​

Crear un proyecto

• Desde cero, cuando sabes el flujo de trabajo que deseas que ejecute Claude: abre el diálogo New project y nómbralo. Comienza un nuevo proyecto desde cero te guía a través del diálogo.
• Desde una sesión en la nube que ya está haciendo el trabajo: elige Continue as a project del menú de esa sesión, y Claude propone la configuración del proyecto a partir de lo que la sesión estaba haciendo. Ver Comenzar desde una sesión en la nube existente.

​

Verifica los requisitos previos

• Plan: estás en Pro o Max y Projects aparece en tu barra lateral.
• GitHub, si el proyecto trabajará en código: tu código está en github.com en lugar de GitHub Enterprise Server, GitLab o Bitbucket, tu cuenta de GitHub conectada tiene acceso de inserción a él, y la Claude GitHub App está instalada en él. Si conectaste GitHub con /web-setup, ese token permite que tus otras sesiones en la nube accedan a un repositorio pero no es suficiente para hilos de proyecto, que necesitan la Claude GitHub App. Configurar acceso a GitHub tiene los pasos.
• Red, credenciales y herramientas: estos provienen del entorno en la nube del proyecto. El entorno predeterminado ya alcanza registros de paquetes comunes, así que verifica esto solo si el trabajo necesita otros dominios, un secreto, o una herramienta que no esté preinstalada. Si el trabajo necesita un servidor MCP, verifica que aparezca como conectado en tus conectores de claude.ai.

​

Comienza un nuevo proyecto desde cero

​

Comienza desde una sesión en la nube existente

• Continue as a project crea un nuevo proyecto nombrado después de la sesión y lo abre. Claude lee la sesión y publica Setup recommendations en la conversación para que confirmes. La sesión original permanece en tu lista de sesiones, y si estaba en medio de un turno sigue ejecutándose, así que detenla tú mismo si no deseas que ambas trabajen a la vez. Si usas el banner Set up project que puede aparecer arriba del cuadro de mensaje de la sesión en la nube, el resultado es el mismo, excepto que el turno en ejecución de la sesión se detiene una vez que se abre el proyecto.
• Move to project trae el trabajo de la sesión a un proyecto existente. Publica un mensaje en la conversación de ese proyecto pidiéndole a Claude que lea la sesión y continúe desde donde se quedó, y el nuevo trabajo continúa en los propios hilos del proyecto. La sesión original permanece en tu lista de sesiones, sin cambios.

​

Configurar acceso a GitHub

​

Trabaja en un proyecto

​

Tu primer lote

1. Escribe instrucciones del proyecto: el resumen que cada hilo comienza, como qué rama dirigirse, cómo un hilo verifica su trabajo, y qué necesita tu aprobación.
2. Envía una pequeña pieza del trabajo real, o comienza uno de los hilos que Claude sugirió, y abre el hilo cuando termine para ver cómo informa y qué hizo en su rama. Si asumió algo incorrecto o no pudo alcanzar lo que necesitaba, Los hilos adivinaron o se estancaron en lugar de preguntar cubre dónde arreglarlo.
3. Verifica Thread model y Thread effort en Project settings > General. Un nuevo proyecto ejecuta cada hilo en Opus con alto esfuerzo, que utiliza tu plan más rápido; Elige modelos y deja que Claude maneje el contexto cubre las alternativas.
4. Pídele a Claude que proponga hilos antes de comenzarlos y que ejecute algunos a la vez, y suelta esos límites una vez que algunos hilos regresen como deseas.

​

Envía trabajo y lee resultados

• Una pregunta rápida generalmente obtiene una respuesta en la conversación.
• El nuevo trabajo va a un hilo nuevo o a un hilo que ya está trabajando en esa área, y Claude te dice cuál. Cada hilo nuevo aparece bajo tu mensaje como una tarjeta: una caja con el título y estado del hilo, que haces clic para abrir el hilo.
• Varias tareas no relacionadas en un mensaje se convierten en hilos separados.

​

Revisa la solicitud de extracción de un hilo

• Branch: trabaja en una rama nueva, comenzada desde la rama predeterminada del repositorio.
• Pull request: abre una cuando lo pides, y puede abrir una por su cuenta para una corrección de error u otro cambio concreto.
• Después de que se abre: observa la solicitud de extracción con auto-fix activado, independientemente de si auto-fix está activado para tus otras sesiones en la nube. Inserta correcciones cuando CI falla, aborda comentarios de revisión, y responde en el hilo cuando las verificaciones pasan y la solicitud de extracción está lista para ti.

​

Ve qué te necesita en Overview

​

Abre un hilo cuando necesites control

• Leer qué hizo Claude, paso a paso.
• Dirige la tarea escribiendo en el cuadro de mensaje del hilo. Un mensaje allí va directamente a ese hilo, mientras que un seguimiento en la conversación del proyecto lo alcanza solo cuando Claude coincide el seguimiento con ese hilo.
• Responde a un aviso de permiso que el hilo está esperando.
• Interrumpe el hilo con Stop, que reemplaza el botón enviar mientras el hilo está trabajando, o presionando Esc.

​

Elige modelos y deja que Claude maneje el contexto

• Thread model y Thread effort se aplican a los hilos. Para usar un modelo diferente para una tarea, pídelo en la tarea; para un hilo ya en ejecución, usa el selector de modelo de ese hilo.
• Coordinator model y Coordinator effort se aplican a Claude en la conversación del proyecto.

​

Ajusta cómo Claude ejecuta un proyecto

• “Propón hilos y espera mi aprobación antes de comenzarlos” o “Comienza estos ahora sin pedirme que confirme”
• “Ejecuta como máximo dos hilos a la vez” o “Reutiliza un hilo existente para seguimientos en la misma área”
• “Publica actualizaciones más cortas” o “Solo publica cuando algo termina o está bloqueado”
• “Dame una actualización de estado en cada hilo”
• “Haz esta tarea con un modelo más pequeño”
• “No abras una solicitud de extracción hasta que haya visto el plan”
• “Dime qué está mal en estos repositorios y no arregles nada todavía”, cuando deseas revisar los hallazgos antes de que cualquiera se convierta en un hilo
• “Responde eso aquí en lugar de comenzar un hilo”, cuando Claude comienza un hilo para algo que quisiste como una pregunta rápida

​

Desbloquea un hilo esperando aprobación

​

Dale a un proyecto contexto permanente

​

Escribe instrucciones del proyecto

• Para qué es el proyecto
• Dónde sucede el trabajo: qué repositorios, qué rama comenzar, cómo nombrar solicitudes de extracción
• Cómo un hilo verifica su propio trabajo antes de llamarlo hecho
• Qué hacer cuando algo que necesita falta
• Qué necesita tu aprobación primero

Este proyecto mantiene la latencia p95 de la API de pagos por debajo de 200 ms: perfilado, correcciones de consultas y almacenamiento en caché, y las actualizaciones de dependencias que vienen con ellas, en el repositorio de la API de pagos.

- Rama desde main y abre un borrador de solicitud de extracción por hilo.
- Antes de llamar al trabajo hecho, ejecuta `make test` y `make lint` y pega las líneas de resumen en tu mensaje final.
- Si no puedes alcanzar algo que necesitas, como un repositorio, un secreto, una API, o un conector, di exactamente qué falta en tu primer mensaje y detente. No sustituyas, simules, o adivines.
- No fusiones, hagas push forzado, o cambies la configuración de CI sin preguntarme en el hilo.

​

Decide qué repositorios agregar

• Agrégalo al proyecto, en el diálogo New project, en Project settings > Environment, o pidiéndole a Claude en la conversación que lo agregue al proyecto. Cada hilo a partir de entonces lo clona y comienza con su CLAUDE.md y skills cargados, independientemente de si la tarea lo toca. Pasar de un repositorio a varios también cambia lo que los hilos toman del .claude/settings.json de cada repositorio; ver Lo que los hilos recogen de tus repositorios.
• Déjalo fuera y deja que los hilos lo agreguen cuando sea necesario. Un hilo cuya tarea necesita un repositorio que el proyecto no tiene puede agregarlo a sí mismo, y una nota en el hilo dice que fue agregado solo a este hilo. El clon sucede a mitad de la tarea, así que el CLAUDE.md y skills de ese repositorio no estaban allí cuando el hilo comenzó. El siguiente hilo comienza sin él de nuevo. Un repositorio que un hilo agrega necesita los mismos requisitos previos que un repositorio del proyecto: la Claude GitHub App instalada en él y acceso de inserción desde tu cuenta de GitHub.

​

Lo que los hilos recogen de tus repositorios

​

Elige un entorno para los hilos

​

Obtén skills, plugins, conectores y herramientas en hilos

• Skills, subagentes, y comandos: confirma que están en un repositorio que agregaste al proyecto, por ejemplo un skill en .claude/skills/<skill-name>/SKILL.md. Cada hilo clona cada repositorio en el proyecto y carga .claude/skills/, .claude/agents/, y .claude/commands/ de cada uno de ellos, así que un skill confirmado en un repositorio está disponible en cada hilo nuevo. Los hilos también cargan los skills que habilitas para tu cuenta de claude.ai.
• Plugins: agrégalos en Project settings > Plugins; se cargan en cada hilo nuevo. Los plugins que un repositorio declara en su .claude/settings.json también se cargan; ver Lo que se lleva de tu configuración.
• Servidores MCP: los hilos obtienen sus herramientas MCP de los conectores en tu cuenta de claude.ai, que son servidores MCP que conectas una vez en claude.ai/customize/connectors o a través del enlace Manage connectors en Project settings > Environment. Cada hilo puede usar todos ellos sin configuración por proyecto. La conversación del proyecto en sí no tiene conectores, así que envía trabajo que necesita uno como una tarea para un hilo. En un proyecto con un repositorio, los hilos también cargan servidores MCP del .mcp.json de ese repositorio. Cómo los conectores llegan a Claude Code enumera las reglas para sesiones en la nube y la configuración que desactiva los conectores.
• Herramientas de línea de comandos y paquetes: instálalos en el script de configuración del entorno.

​

Referencia de configuración del proyecto

​

Pausar, archivar, o eliminar un proyecto

• Pause: detiene todo a la vez. Cada hilo en ejecución y la conversación se interrumpen, no comienzan hilos nuevos, las rutinas no se ejecutan, y el proyecto no acepta mensajes hasta que lo reanudes. Haz clic en Resume en el mismo lugar o en el banner arriba del cuadro de mensaje del proyecto; un hilo pausado continúa cuando le envías un mensaje después de eso.
• Archive: oculta el proyecto de la barra lateral y archiva sus hilos, que detiene cualquier hilo que estaba en ejecución o observando una solicitud de extracción. Las rutinas en el proyecto no se ejecutan mientras está archivado. Para traer el proyecto de vuelta, ábrelo desde la página Projects y haz clic en Unarchive. Sus hilos permanecen archivados hasta que los desarchives individualmente desde la lista de sesiones.
• Delete: elimina permanentemente el proyecto junto con sus hilos, su memoria, y sus archivos, y desactiva las rutinas del proyecto. Esto no se puede deshacer. Las ramas y solicitudes de extracción que los hilos insertaron en GitHub no se ven afectadas.

​

Uso y costo

​

Qué utiliza tu plan

• Hilos en ejecución: cada uno es una sesión completa, y varios pueden ejecutarse a la vez. No hay un número fijo; Claude comienza tantos como el trabajo requiera, y un límite que pidas es una preferencia en lugar de un límite. El límite aplicado es 200 hilos nuevos por día en todos tus proyectos.
• La conversación: Claude utiliza tokens propios leyendo lo que los hilos reportan y decidiendo qué hacer a continuación.
• Hilos observando una solicitud de extracción: un hilo inactivo se despierta y utiliza tu plan de nuevo cuando CI falla o llega un comentario de revisión en su solicitud de extracción. Para detener eso, pídele en el hilo que deje de observar la solicitud de extracción.

​

Ve y reduce el uso de un proyecto

• Un seguimiento enrutado a un hilo que ha estado inactivo más tiempo que la vida útil del caché, una hora en Pro y Max dentro de los límites de tu plan, vuelve a leer toda la conversación de ese hilo antes de hacer nada. Para trabajo nuevo, pedirle a Claude que comience un hilo fresco puede usar menos que revivir uno antiguo grande.
• Para trabajo que no necesita el modelo más grande, elige un modelo más pequeño o un nivel de esfuerzo más bajo para hilos, la conversación, o ambos.
• Pídele a Claude en la conversación del proyecto que ejecute menos hilos a la vez, o que responda pequeñas preguntas él mismo en lugar de comenzar un hilo.

​

Cómo los proyectos se relacionan con otras características de Claude Code

• Claude Tag: Claude Tag es Claude en los canales de Slack de tu equipo, en planes Team y Enterprise. Cualquiera en un canal puede darle trabajo, todos en el canal lo ven y lo dirigen, y utiliza conexiones que un administrador configuró para ese canal. Un proyecto es solo tuyo: eres el único que le envía trabajo o ve sus hilos, utiliza tu propio acceso a GitHub y conectores, y está en Pro y Max. Cómo Claude Tag difiere de Cowork y Claude Code tiene el lado a lado.
• Sesiones en la nube: cada hilo es una sesión en la nube, comenzada y rastreada por Claude en lugar de por ti. Una sesión en la nube que comenzaste tú mismo puede convertirse en un proyecto o alimentar uno a través de Continue as a project o Move to project.
• Routines: cuando pides trabajo programado en un proyecto, Claude crea una rutina que se ejecuta como hilos en ese proyecto y aparece en su pestaña Routines. Las rutinas que creas fuera de un proyecto siguen funcionando por su cuenta.
• Sesiones locales y vista de agente: las sesiones en tu terminal, IDE, o el entorno local de la aplicación de escritorio se ejecutan en tu máquina y no pueden ser parte de un proyecto. Vista de agente es una pantalla para rastrear varias de esas sesiones locales; no tiene coordinador.
• Worktrees: un worktree le da a cada sesión local su propia copia de trabajo de un repositorio para que las sesiones paralelas en tu máquina no se sobrescriban entre sí. Los hilos no los necesitan: cada hilo clona sus repositorios en su propia sandbox en la nube y trabaja en su propia rama.
• Equipos de agentes: un equipo de agentes es una sesión que comienza sesiones de compañeros para una sola tarea, en tu máquina o dentro de una sesión en la nube, y termina con esa tarea.
• Projects en claude.ai chat y Cowork: la experiencia anterior de Projects, que agrupa conversaciones y archivos de referencia sin hilos o coordinador. Esos proyectos siguen funcionando como lo hacen hoy hasta que la experiencia rediseñada los alcance.

​

Limitaciones

• Los proyectos están disponibles en claude.ai/code y en la aplicación de escritorio, no en el CLI de terminal o a través de Amazon Bedrock, Google Cloud’s Agent Platform, o Microsoft Foundry. El comando claude project del CLI, que administra el estado local de Claude Code para un directorio, no está relacionado.
• Los hilos del proyecto son sesiones en la nube con Anthropic como proveedor de modelo. Seguridad y Uso de datos cubren cómo se aíslan las sesiones en la nube y qué se retiene.
• Una sesión local no puede ser parte de un proyecto.
• La sandbox de un hilo se pausa entre turnos y se reanuda cuando el hilo continúa. Si la sandbox no se puede reanudar, el hilo continúa desde un clon fresco, así que los cambios no confirmados pueden perderse. En tareas largas, pídele a Claude que confirme e inserte trabajo en progreso.
• Un proyecto pertenece a un usuario. No puedes compartir un proyecto o sus hilos con otro usuario, y las transcripciones de hilos no tienen la opción de compartir que tienen otras sesiones en la nube. No hay controles a nivel de organización para proyectos durante la beta.
• Un hilo pertenece al único proyecto que lo comenzó. No puedes mover o copiar un hilo a otro proyecto, o sacarlo para que esté solo. Move to project va solo en la otra dirección: trae el trabajo de una sesión en la nube a un proyecto.

​

Solución de problemas

​

Un hilo parece estar atascado

​

Los hilos adivinaron o se estancaron en lugar de preguntar

1. Pídele a Claude en la conversación: “Para cada hilo abierto, enumera lo que le pediste que hiciera, qué asumió o no pudo alcanzar, y en qué está esperando.” Claude lee cada hilo y responde en la conversación.
2. Para hilos que comenzaron desde una suposición incorrecta, abre el hilo desde Overview y márcalo resuelto desde su menú, o dile qué hacer en su lugar en su cuadro de mensaje. Su rama y cualquier solicitud de extracción permanecen en GitHub hasta que las elimines.
3. Arregla la brecha una vez, en instrucciones del proyecto o el entorno, luego envía un hilo antes de enviar el resto del trabajo de nuevo como hilos nuevos.

​

Claude no ha respondido

​

Errores de acceso al repositorio

• “Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository”, reportado antes de que comience el hilo, cuando la Claude GitHub App no está instalada en ese repositorio, está suspendida, o no está vinculada a la cuenta de GitHub que conectaste.
• “Unable to access your repository”, reportado por un hilo cuando su clon falla: GitHub rechazó el clon, el repositorio no se encontró bajo el nombre que tiene el proyecto, o la rama desde la que se le pidió al hilo que comenzara no existe.
• “Claude can’t access” un repositorio, mostrado cuando guardas repositorios en el diálogo New project o Project settings. El mensaje continúa con un enlace de instalación y un enlace de reconexión. Usa el enlace de instalación si la Claude GitHub App no está en ese repositorio, y el enlace de reconexión si lo está, ya que la Claude GitHub App puede estar instalada en GitHub sin estar vinculada a la cuenta que conectaste a Claude. Si el mensaje dice que la Claude GitHub App está suspendida o no incluye este repositorio, sigue su enlace a GitHub para arreglarlo.

​

Un hilo alcanzó el límite de uso

​

Se requieren créditos de uso adicionales

​

Otros mensajes

​

Recursos relacionados

• Usa Claude Code en la nube: cómo funcionan las sesiones en la nube detrás de cada hilo, incluidas las opciones de acceso a GitHub y auto-fix en solicitudes de extracción
• Configura entornos en la nube: cambia a qué pueden llegar los hilos en la red, dale variables de entorno y credenciales de API, e instala herramientas con un script de configuración
• Automatiza trabajo con rutinas: horarios, disparadores, y administración para rutinas, incluidas las que Claude crea desde un proyecto
• Administra múltiples agentes con vista de agente: ejecuta y rastrea varias sesiones en tu propia máquina cuando el trabajo necesita herramientas o servicios que solo tu máquina puede alcanzar
• Proyectos rediseñados: de carpeta a conversación: el anuncio de lanzamiento, con el pensamiento detrás de hacer que un proyecto sea una conversación con Claude