Projects está en versión beta pública en los planes Pro y Max y se está implementando gradualmente, comenzando con cuentas que han utilizado sesiones en la nube y no tienen proyectos existentes en el chat de claude.ai o en Cowork. Aún no está disponible en los planes Team o Enterprise. Si Projects no aparece en la barra lateral en claude.ai/code o en la pestaña Code de la aplicación de escritorio, el despliegue aún no ha llegado a su cuenta, y puede unirse a la lista de espera. Ejecutar agentes en paralelo enumera lo que puede usar mientras tanto.
- 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 las instrucciones 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
Vale la pena crear un proyecto cuando el trabajo tiene un objetivo que perdura más allá de una sesión y sigue produciendo tareas. Estos tipos de trabajo se adaptan bien a 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
Un proyecto todavía se adapta cuando solo algunas tareas necesitan tu máquina. Los hilos en la nube funcionan en repositorios de GitHub y en los archivos, carpetas y carpetas de Google Drive que cargues en el proyecto, y para la tarea ocasional que necesita una base de datos local o una herramienta en tu computadora, puedes pedirle a Claude que ejecute el hilo de esa tarea en tu computadora. Algo más se adapta mejor en estos casos:- 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 donde cada tarea necesita tu máquina: una base de datos local, un emulador de dispositivo, o 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
Un proyecto es una conversación coordinadora con Claude más los hilos que comienza para hacer el trabajo. Estas son sus partes:- 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 separada con su propia ventana de contexto que hace una pieza de trabajo e informa a la conversación cuando termina. Un hilo en la nube trabaja en su propia rama y abre una solicitud de extracción cuando el trabajo lo requiere.
- Lo que cada hilo en la nube comienza con:
- Los repositorios y archivos del proyecto, más sus instrucciones y memoria
- El
CLAUDE.mdy skills 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, secretos de red 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
Creas y usas proyectos en claude.ai/code, en la pestaña Code de la aplicación de escritorio, o en la aplicación móvil de Claude para iOS y Android. En el navegador y la aplicación de escritorio hay dos formas de comenzar 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 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
Antes de crear un proyecto, verifica tu plan, tu configuración de GitHub, y a qué necesita llegar el trabajo:- 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. - Acceso a la red, secretos y herramientas: para hilos en la nube, 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
Comenzar un proyecto desde cero significa abrir el diálogo New project, nombrar el flujo de trabajo, y opcionalmente darle un objetivo y los repositorios y archivos en los que trabaja. Solo el nombre es requerido, así que puedes crear el proyecto primero y llenar el resto a medida que el trabajo toma forma.1
Abre Projects
En claude.ai/code o en la pestaña Code de la aplicación de escritorio, selecciona Projects en la barra lateral izquierda, luego selecciona New project. En un navegador también puedes ir directamente a claude.ai/code/projects/browse.
2
Completa el diálogo New project
Limita el proyecto a un flujo de trabajo que seguirás agregando, como todo lo que se necesita para mantener una API bajo su objetivo de latencia. Cuándo usar un proyecto tiene más ejemplos. Luego completa los campos del diálogo:
- Name: cómo aparece el proyecto en la lista Projects.
- Goal (opcional): una línea de lo que estás tratando de lograr, como “Mantener la latencia p95 de la API por debajo de 200 ms”. Claude en la conversación trabaja hacia él. Sin un objetivo, Claude trabaja a partir de las tareas que envías, y puedes agregar un objetivo más tarde en Project settings > General.
- Context (opcional): los repositorios de GitHub en los que trabaja este proyecto, más cualquier archivo, carpeta o carpeta de Google Drive que los hilos deban leer. Haz clic en Add para cada uno. Agrega los repositorios que la mayoría de las tareas necesitan en lugar de cada uno que el trabajo podría tocar; Decide qué repositorios agregar cubre la elección, y puedes agregar más tarde en Project settings > Environment.
3
Crea el proyecto
Haz clic en Create project. La conversación del proyecto se abre con un cuadro de mensaje en la parte inferior, donde describes trabajo para Claude.En tu primer proyecto, Claude toma un turno por su cuenta tan pronto como se crea el proyecto, a menos que envíes un mensaje primero. Ese turno utiliza tu plan. En él, Claude puede:
- Comenzar un hilo que explora el repositorio sin cambiar nada y propone los próximos pasos, si el proyecto tiene un repositorio que puede leer.
- Publicar Setup recommendations extraídas de tus sesiones en la nube recientes: repositorios para agregar, rutinas para crear, e hilos que podría comenzar. Cada repositorio y rutina recomendados comienzan activados. Desactiva los que no deseas, luego haz clic en Update setup para agregar el resto, o ignora las recomendaciones y describe el trabajo tú mismo.
Comienza desde una sesión en la nube existente
Si ya tienes una sesión en la nube haciendo trabajo que pertenece a un proyecto, abre el menú de la sesión en la barra lateral y elige Continue as project o Move to project:- Continue as 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
La mayoría de la configuración de GitHub sucede una vez, no por proyecto. Conectas tu cuenta de GitHub a Claude una vez, y la Claude GitHub App se instala una vez por repositorio, o una vez para toda una organización de GitHub si le das todos los repositorios. Vuelves a estos pasos cuando agregas un repositorio que la Claude GitHub App aún no cubre o uno en una organización de GitHub que aplica SSO.1
Conecta tu cuenta de GitHub
Si no has usado claude.ai/code antes, tu primera visita te guía a través de conectar GitHub; ver Conectar GitHub. De lo contrario, usa una de las opciones de autenticación de GitHub.
2
Instala la Claude GitHub App en los repositorios del proyecto
Instala la Claude GitHub App y otórgale los repositorios que el proyecto usará. En un repositorio propiedad de una organización de GitHub, solo un propietario de la organización puede completar la instalación; si no eres uno, GitHub envía al propietario una solicitud de instalación y el proyecto no puede usar el repositorio hasta que lo apruebe.
3
Autoriza SSO para organizaciones que lo aplican
Si una organización de GitHub aplica SAML SSO, reconecta GitHub y autoriza la aplicación Claude para esa organización. Hasta que lo hagas, los repositorios privados de esa organización no aparecen en el diálogo New project o Project settings > Environment.
Trabajar en un proyecto
Dale trabajo a Claude a través de la conversación del proyecto: tareas una a la vez o varias a la vez, más actualizaciones y pensamientos sueltos conforme surjan. Claude enruta cada mensaje, y los hilos hacen el trabajo e informan.Su primer lote
Antes de enviar a un nuevo proyecto un lote de trabajo, configúrelo para que los primeros hilos regresen de la manera que desea:- Escribir instrucciones del proyecto: el resumen con el que comienza cada hilo, como a qué rama dirigirse, cómo un hilo verifica su trabajo, y qué necesita su aprobación.
- Envíe una pequeña pieza del trabajo real, o inicie uno de los hilos que Claude sugirió si ofreció alguno, y abra 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.
- Verifique Thread model y Thread effort en Project settings > General. Un nuevo proyecto ejecuta cada hilo en Opus con esfuerzo alto, que consume su plan más rápidamente; Elegir modelos y dejar que Claude gestione el contexto cubre las alternativas.
- Pida a Claude que proponga hilos antes de iniciarlos y ejecute algunos a la vez, y elimine esos límites una vez que algunos hilos regresen de la manera que desea.
Enviar trabajo y leer resultados
Claude decide dónde va cada mensaje que envía en la conversación:- Una pregunta rápida generalmente obtiene una respuesta en la conversación.
- El trabajo nuevo va a un hilo nuevo o a un hilo que ya está trabajando en esa área, y Claude le dice cuál. Cada hilo nuevo aparece bajo su mensaje como una tarjeta: una caja con el título y estado del hilo, que hace clic para abrir el hilo.
- Varias tareas no relacionadas en un mensaje se convierten en hilos separados.
Revisar la solicitud de extracción de un hilo
Cuando un hilo en la nube cambia código, esto es lo que hace a menos que le diga lo contrario:- Branch: trabaja en una rama nueva, iniciada desde la rama predeterminada del repositorio.
- Pull request: abre uno cuando lo solicita, y puede abrir uno por su cuenta para una corrección de errores u otro cambio concreto.
- After it opens: vigila la solicitud de extracción con auto-fix activado, independientemente de si auto-fix está activado para sus otras sesiones en la nube. Envía correcciones cuando CI falla, aborda comentarios de revisión, e informa en el hilo cuando las comprobaciones pasan y la solicitud de extracción está lista para usted.
- Resolve conflicts, Fix CI, Address comments, y Merge it envían esa instrucción al hilo como un mensaje de usted, para que pueda indicar al hilo usted mismo en lugar de esperar a que reaccione a la solicitud de extracción.
- Review PR abre la solicitud de extracción en GitHub.
- Create PR aparece cuando un hilo inactivo ha enviado una rama pero no ha abierto una solicitud de extracción. Al hacer clic, se crea la solicitud de extracción desde esa rama directamente en lugar de enviar al hilo una instrucción para abrir una.
Ver qué lo necesita en Overview
El panel Overview junto a la conversación rastrea los hilos del proyecto. Ya está abierto la primera vez que abre un nuevo proyecto. El botón Overview en el encabezado del proyecto lo cierra y reabre, y muestra un punto cuando un hilo lo está esperando. En la aplicación de escritorio, también obtiene una notificación de escritorio cuando Claude publica en la conversación, un hilo alcanza un error, o un hilo necesita su entrada, para que no tenga que mantener el proyecto abierto para enterarse. Para obtener también uno cada vez que un hilo termina un turno, o para desactivarlos para un proyecto, elija Notifications en el menú de la barra lateral del proyecto. Estas notificaciones son solo de escritorio: en un navegador, verifique el punto en el botón Overview. La pestaña Threads del panel agrupa hilos por estado:
Las otras pestañas del panel son Library para los archivos y carpetas que agregó y los archivos que produjeron los hilos, Pull requests una vez que los hilos han abierto alguno, y Routines para las rutinas que Claude configuró desde este proyecto.
Abrir un hilo cuando necesita control
Haga clic en la tarjeta de un hilo en la conversación o su fila en Overview para abrir su transcripción en el panel Overview. Desde allí puede:- Leer qué hizo Claude, paso a paso.
- Dirigir 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.
- Responder a un aviso de permiso que el hilo está esperando.
- Interrumpir el hilo con Stop, que reemplaza el botón enviar mientras el hilo está trabajando, o presionando Esc.
Elegir modelos y dejar que Claude gestione el contexto
Establezca modelos y esfuerzo en Project settings > General. Un nuevo proyecto ejecuta Opus en todas partes, con esfuerzo alto para hilos y esfuerzo bajo para la conversación:- Thread model y Thread effort se aplican a los hilos. Para usar un modelo diferente para una tarea, solicítelo en la tarea; para un hilo ya en ejecución, use el selector de modelo de ese hilo.
- Coordinator model y Coordinator effort se aplican a Claude en la conversación del proyecto.
Ajustar cómo Claude ejecuta un proyecto
Dígale a Claude en la conversación cuántos hilos ejecutar a la vez, cuándo publicar actualizaciones, y cuándo abrir solicitudes de extracción. Si Claude está coordinando de una manera que no desea, dígalo. Por ejemplo, puede decir:- “Propose threads and wait for my go-ahead before starting them” o “Start these now without asking me to confirm”
- “Run at most two threads at a time” o “Reuse an existing thread for follow-ups in the same area”
- “Post shorter updates” o “Only post when something finishes or is blocked”
- “Give me a status update on every thread”
- “Do this task with a smaller model”
- “Don’t open a pull request until I’ve seen the plan”
- “Tell me what’s wrong in these repositories and don’t fix anything yet”, cuando desea revisar los hallazgos antes de que alguno se convierta en un hilo
- “Answer that here instead of starting a thread”, cuando Claude inicia un hilo para algo que significaba como una pregunta rápida
Desbloquear un hilo esperando aprobación
Los hilos se ejecutan en modo automático cuando el modelo del hilo lo admite, por lo que la mayoría de las llamadas de herramientas se ejecutan sin pedirle. Cuando un hilo necesita su aprobación, el aviso está dentro de ese hilo y el hilo espera hasta que responda allí. Decirle a Claude en la conversación del proyecto que continúe no lo alcanza. Cada aprobación cubre esa solicitud, o el resto de ese hilo si eliges la opción más amplia. Para permitir que todos los hilos ejecuten ciertos comandos sin preguntar, o para bloquear algunos, agrega reglas de permisos al.claude/settings.json del repositorio. Comprueba que los hilos en la nube de tu proyecto las apliquen:
- Un repositorio: los hilos en la nube aplican las reglas. Consulta Qué recogen los hilos de tus repositorios.
- Varios repositorios, entorno alojado por Anthropic: las reglas de permisos de ningún repositorio llegan a un hilo en la nube, por lo que dependes del modo automático y de las aprobaciones que das dentro de cada hilo.
- Varios repositorios, entorno autoalojado: consulta qué configuración de repositorio se aplica.
Ejecutar un hilo en su propia computadora
Cuando una tarea necesita algo que solo su computadora tiene, como una base de datos local, un emulador de dispositivo, o una API detrás de su VPN, pida a Claude que ejecute el hilo para esa tarea en su computadora en lugar de en la nube. Cuando lo solicita en la conversación del proyecto, el hilo es una sesión de Claude Code en una carpeta en su máquina, conectada a través de Remote Control. Los otros hilos del proyecto continúan ejecutándose en la nube. En comparación con un hilo en la nube, un hilo en su computadora:- Funciona con los archivos, herramientas, servidores MCP, y configuración de Claude Code en esa máquina, incluidos sus hooks y reglas de permiso, en lugar del entorno en la nube del proyecto
- Comienza con las instrucciones del proyecto, pero sin sus archivos de memoria cargados
- Se ejecuta solo mientras esa computadora está despierta con Remote Control activado
1
Conectar la carpeta
En la computadora que tiene la carpeta que la tarea necesita, póngala disponible a través de Remote Control de una de dos maneras. Ambas necesitan Claude Code v2.1.280 o posterior en esa computadora.
- En la aplicación de escritorio de Claude: abra Settings > Claude Code, active Use this computer from your phone and claude.ai, y agregue la carpeta a la lista bajo ese interruptor. Los hilos pueden ejecutarse en esta computadora mientras la aplicación está abierta.
- En una terminal: ejecute
claude remote-controlen la carpeta y déjela ejecutándose. En un repositorio de git, agregue--spawn worktreepara dar a cada hilo allí su propio worktree en lugar de la carpeta misma.
2
Solicitar la tarea con Work locally
En la conversación del proyecto, elija Work locally del menú + junto al cuadro de mensaje, que etiqueta su mensaje como Local, y escriba qué desea que se haga. Decir en el mensaje que la tarea debe ejecutarse en su computadora también funciona.
3
Permitirlo en la tarjeta
Claude responde con una tarjeta Allow Claude to work in a folder on your device. Elija la carpeta si conectó varias. Dos hilos trabajando en una carpeta al mismo tiempo pueden sobrescribir los cambios del otro, por lo que si la carpeta es un repositorio de git, puede activar Worktree en las opciones de la carpeta para dar a este hilo su propio worktree en lugar de eso. Luego haga clic en Allow once.
claude remote-control se cierra. Lost contact with your folder cubre cómo hacerlo funcionar de nuevo. En la aplicación de escritorio, active Keep this computer awake for Remote Control bajo Settings > Claude Code para evitar que la computadora se duerma por sí sola.
Un proyecto no puede ejecutar un hilo en su computadora mientras Require trusted devices está activado para su cuenta.
Dale al proyecto contexto permanente
La memoria del proyecto, las instrucciones del proyecto y los repositorios, archivos y entorno del proyecto llevan contexto entre hilos. Estableces cada uno una sola vez.
Configuración del proyecto > Memoria enumera estos archivos en Memoria automática, porque Claude mismo los escribe mientras trabaja en el proyecto. Son independientes de la memoria automática que Claude Code mantiene en tu máquina, aunque ambas usen un índice
MEMORY.md. La memoria del proyecto también es independiente de los archivos CLAUDE.md en los repositorios del proyecto. Cada hilo en la nube aún lee esos archivos CLAUDE.md de su clon cuando comienza, así que pon las instrucciones sobre un repositorio en su CLAUDE.md y las notas sobre el proyecto en la memoria del proyecto.
Escribir instrucciones del proyecto
Las instrucciones del proyecto son el resumen con el que comienza cada nuevo hilo. Haz clic en el icono de engranaje en el encabezado del proyecto para abrir Configuración del proyecto, luego ve a Memoria > Instrucciones del proyecto. Un resumen útil cubre:- Para qué es el proyecto
- Dónde ocurre el trabajo: qué repositorios, de qué rama partir, cómo nombrar los pull requests
- Cómo un hilo verifica su propio trabajo antes de considerarlo terminado
- Qué hacer cuando falta algo que necesita
- Qué necesita tu aprobación primero
CLAUDE.md de ese repositorio, que cada hilo en la nube lee cuando el repositorio es parte del proyecto. Una vez que el trabajo está en marcha, cuando corrijas un hilo, dile también a Claude que recuerde la corrección: va a la memoria del proyecto y los hilos en la nube posteriores comienzan con ella.
Decidir qué repositorios agregar
Los repositorios que agregas a un proyecto vienen con todo lo que contienen, su código,CLAUDE.md y skills, en cada hilo en la nube. Los repositorios que no agregas siguen al alcance: un hilo en la nube puede agregarse uno a sí mismo cuando su tarea lo necesita. La mayoría de los proyectos usan ambos:
- Agrégalo al proyecto, en el diálogo Nuevo proyecto, en Configuración del proyecto > Entorno, o pidiendo a Claude en la conversación que lo agregue al proyecto. Cada hilo en la nube a partir de entonces lo clona y comienza con su
CLAUDE.mdy 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.jsonde cada repositorio; consulta Lo que los hilos recogen de tus repositorios. - Déjalo fuera y deja que los hilos lo agreguen cuando sea necesario. Un hilo en la nube cuya tarea necesita un repositorio que el proyecto no tiene puede agregárselo a sí mismo, y una nota en el hilo indica que se agregó solo a este hilo. El clon ocurre a mitad de la tarea, por lo que el
CLAUDE.mdy los skills de ese repositorio no estaban allí cuando el hilo comenzó. El siguiente hilo comienza sin él. Un repositorio agregado de esta manera necesita los mismos requisitos previos que un repositorio del proyecto: la aplicación GitHub de Claude instalada en él y acceso de push desde tu cuenta de GitHub.
Agregar archivos y carpetas
Agrega los archivos y carpetas que quieres que los hilos lean en el campo Contexto del diálogo Nuevo proyecto, o después con Agregar en la pestaña Biblioteca en Descripción general. Estos límites se aplican a lo que agregas:- Pestaña Biblioteca: hasta 100 archivos y 2 GB en una selección, con un único archivo de hasta 480 MB.
- Diálogo Nuevo proyecto: los archivos de más de 30 MB se omiten, así que agrega los archivos más grandes desde la pestaña Biblioteca después de crear el proyecto.
- Carpetas: cuando agregas una carpeta desde cualquiera de los dos lugares, el proyecto recibe una copia de sus primeros 100 archivos hasta 200 MB, sin archivos de más de 30 MB, archivos ocultos ni
node_modules. Un proyecto contiene hasta 10 carpetas y carpetas de Google Drive combinadas, y los archivos individuales no cuentan para ese límite. - Cambios después de la carga: las cargas son copias, por lo que un cambio que hagas en tu computadora después no llega al proyecto hasta que cargues el archivo nuevamente y elijas Reemplazar cuando se te pregunte sobre el nombre existente.
Lo que los hilos recogen de tus repositorios
Cada hilo en la nube clona cada repositorio del proyecto y cargaCLAUDE.md y skills de todos ellos. Las reglas de permisos, los hooks y env vienen solo del .claude/settings.json en el directorio en el que comienza el hilo.
En un proyecto con varios repositorios, pon las reglas permanentes en las instrucciones del proyecto y proporciona a los hilos variables de entorno a través del entorno en la nube.
Elegir un entorno para los hilos
Cada nuevo hilo en la nube comienza en el entorno en la nube del proyecto. El entorno establece a qué dominios pueden acceder los hilos, qué variables de entorno tienen, qué secretos de red se agregan a sus solicitudes y qué instala el script de configuración antes de que Claude comience. Los hilos en la nube usan un entorno predeterminado alojado por Anthropic hasta que eliges uno en Configuración del proyecto > Entorno. Si los hilos en la nube necesitan acceder a una API interna o a un registro de paquetes privado, o necesitan un token que tu máquina normalmente tiene, cambia el entorno en lugar del proyecto: consulta Acceso de red, Agregar secretos de red y Scripts de configuración.Obtener skills, plugins, conectores y herramientas en los hilos
Los hilos en la nube no tienen los skills, servidores MCP, plugins y herramientas instalados solo en tu máquina. Un hilo que Claude ejecuta en tu máquina a través de Remote Control usa lo que está instalado allí. Para que cada uno de estos esté disponible para los hilos en la nube:- Skills, subagentes y comandos: haz commit de ellos en un repositorio que agregaste al proyecto, por ejemplo un skill en
.claude/skills/<skill-name>/SKILL.md. Cada hilo en la nube clona cada repositorio del proyecto y carga.claude/skills/,.claude/agents/y.claude/commands/de cada uno de ellos, por lo que un skill con commit en un repositorio está disponible en cada hilo en la nube. Los hilos en la nube también cargan los skills que habilitas para tu cuenta de claude.ai. - Plugins: agrégalos en Configuración del proyecto > Plugins; se cargan en cada nuevo hilo en la nube. Los plugins que un repositorio declara en su
.claude/settings.jsonno se cargan en los hilos en la nube. - Servidores MCP: los hilos en la nube obtienen sus herramientas MCP de los conectores de tu cuenta de claude.ai, que son servidores MCP que conectas una sola vez en claude.ai/customize/connectors. Cada hilo en la nube puede usarlos todos sin configuración por proyecto. La conversación del proyecto en sí no tiene conectores, así que envía el trabajo que necesite uno como una tarea para un hilo en la nube. En un proyecto con un solo repositorio, los hilos en la nube también cargan servidores MCP del
.mcp.jsonde 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
Cambias la configuración del proyecto en claude.ai/code o en la aplicación de escritorio, no ensettings.json. Abre Project settings desde Settings en el menú de la barra lateral del proyecto o desde el icono de engranaje en el encabezado del proyecto.
Los cambios se guardan a medida que los realizas; un campo de texto que estés editando, como el objetivo o las instrucciones, muestra Save changes y Discard hasta que lo dejes. Los cambios en instrucciones, repositorios, plugins, y entorno en Project settings llegan a hilos nuevos, no a hilos ya en ejecución.
Pausar, archivar, o eliminar un proyecto
Los tres controles están en la parte inferior de Project settings > General:- 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
El uso del proyecto cuenta contra los mismos límites de plan que tus otras sesiones de Claude Code, y un proyecto no puede gastar más allá de esos límites por su cuenta. Un hilo que alcanza el límite de tu plan espera y continúa por su cuenta cuando el límite se reinicia, así que el trabajo que dejaste en ejecución comienza a usar tu siguiente ventana de uso sin un mensaje de ti. Un hilo alcanzó el límite de uso cubre lo que ves, cómo detenerlo, y el único caso que no espera. El trabajo va más allá de los límites de tu plan solo si has activado créditos de uso para tu cuenta. Un hilo no puede activarlos para ti.Qué utiliza tu plan
Un proyecto utiliza tus límites más rápido que una sola sesión, y en un plan Pro en particular deberías esperar alcanzar tu límite más pronto en días que ejecutes uno. Estas son las partes de un proyecto que utilizan 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
Abre Usage en Project settings para ver el uso de tokens por hilo y por modelo, y cuánto fue a la conversación del proyecto. Para reducirlo:- 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
Varias características de Claude Code permiten que más de una sesión trabaje al mismo tiempo, así que ejecutar trabajo en paralelo no es por sí solo para qué es un proyecto. En un proyecto, Claude comienza y rastrea las sesiones en lugar de usted, y cada una comienza desde las mismas instrucciones. Así es como cada característica vecina se conecta a un proyecto:- 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.
- Cloud sessions: cada hilo es una sesión en la nube a menos que pida a Claude que la ejecute en su máquina. De cualquier forma, Claude la comienza y rastrea en lugar de usted. Una sesión en la nube que comenzó usted mismo puede convertirse en un proyecto o alimentar uno a través de Continue as 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.
- Remote Control: Remote Control conecta claude.ai a una sesión de Claude Code que se ejecuta en su máquina. Cuando pide a Claude en un proyecto que ejecute un hilo en su computadora, el proyecto utiliza Remote Control para hacerlo.
- Local sessions and agent view: una sesión que comienza usted mismo en su terminal, IDE, o el entorno local de la aplicación de escritorio no puede ser agregada a un proyecto. Agent view es una pantalla para rastrear varias sesiones locales lado a lado, y usted sigue iniciando cada una y le da su tarea usted mismo.
- Worktrees: un worktree le da a cada sesión local su propia copia de trabajo de un repositorio. Los hilos en la nube no los necesitan: cada uno clona sus repositorios en su propio 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.
- Subagents: un subagente se ejecuta dentro de una sesión, realiza una tarea secundaria en su propia ventana de contexto, y devuelve un resumen a esa sesión. Los hilos de un proyecto son sesiones completas que Claude comienza y que reportan al proyecto, y un hilo aún puede usar subagentes para sus propias tareas secundarias.
- 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, en la aplicación de escritorio y en la aplicación móvil de Claude, no en el CLI de terminal, la extensión de VS Code o el plugin de JetBrains, y no a través de Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry.
- Los hilos del proyecto son sesiones en la nube, o sesiones en su propia máquina a través de Remote Control, con Anthropic como proveedor de modelo en ambos casos. Seguridad y Uso de datos cubren cómo se aíslan las sesiones en la nube y qué se retiene, y Connection and security cubre cómo un hilo en su máquina se conecta y qué se almacena.
- No puede agregar una sesión que inició usted mismo en su máquina a un proyecto. Un proyecto llega a su máquina solo al ejecutar un hilo allí a través de Remote Control, y esa sección enumera lo que necesita.
- La sandbox de un hilo en la nube 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 puede 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. No puede fusionar dos proyectos en uno.
Solución de problemas
Para los avisos de configuración de GitHub en el diálogo New project, ver Configurar acceso a GitHub.Un hilo parece estar atascado
Claude no publica cada paso que toma un hilo, así que un hilo que se muestra como en ejecución sin mensajes nuevos en la conversación del proyecto generalmente aún está trabajando. Un hilo nuevo también aprovisiona su entorno en la nube antes de que Claude comience, así que su primera actualización toma un momento. Abre el hilo para leer su transcripción. Si el hilo está esperando un aviso de permiso, respóndelo allí.Los hilos adivinaron o se estancaron en lugar de preguntar
Cuando varios hilos regresan habiendo asumido algo incorrecto, trabajado alrededor del acceso faltante, o detenido con “bloqueado”, la causa generalmente es la misma brecha en la configuración del proyecto en lugar de un problema con cada tarea. Ordena qué hilos son sólidos antes de arreglar nada:- 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.
- 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.
- 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
La conversación del proyecto muestra un banner “Claude hasn’t responded” cuando Claude está en ejecución pero sus respuestas no llegan al proyecto. Haz clic en Restart Claude en el banner, o ve a Project settings > General y haz clic en Restart en la fila Restart Claude. Claude se reconecta a la conversación; cualquier respuesta que estaba en medio de escribir se pierde, y los hilos no se ven afectados.Errores de acceso al repositorio
Tres mensajes significan que un hilo o el proyecto no puede alcanzar uno de sus repositorios. Un hilo del proyecto necesita los requisitos previos de GitHub incluso cuando tus otras sesiones en la nube clonan el mismo repositorio sin problemas.- “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
Cuando un hilo o la conversación del proyecto alcanza el límite de cinco horas o semanal de tu plan, sigue reintentando por su cuenta y continúa cuando el límite se reinicia. Mientras espera, el hilo muestra Service is busy con “Claude is still retrying and will continue automatically.” No necesitas hacer nada para que el trabajo continúe. Si prefieres que no use tu siguiente ventana de uso, haz clic en Stop en el hilo, o pausa el proyecto para poner en espera todos los hilos. Un hilo que una rutina comenzó no espera: su turno se detiene con un error de límite, y le envías un mensaje después de que el límite se reinicia. Errores de límite de uso explican los límites y cuándo se reinician.Se requieren créditos de uso adicionales
Un hilo o la conversación del proyecto hizo una solicitud que tu plan cubre solo con créditos de uso, como una a un modelo o tamaño de contexto que tu plan no incluye, y los créditos de uso no están activados para tu cuenta. Agregar créditos de uso a tu suscripción cubre quién puede activarlos o comprarlos en cada plan. Una vez que los créditos estén disponibles, envía otro mensaje para reintentar.Perdiste contacto con tu carpeta
Un hilo que se ejecuta en tu computadora muestra esto cuando la sesión de Claude Code allí dejó de responder, generalmente porque la computadora se durmió o la aplicación de escritorio oclaude remote-control se cerró. Despierta la computadora, y si la aplicación de escritorio o claude remote-control ya no se está ejecutando allí, inicia de nuevo: reabre la aplicación y confirma que Use this computer from your phone and claude.ai aún está activado en Settings > Claude Code, o ejecuta claude remote-control de nuevo en la misma carpeta.
Otros mensajes
Estos mensajes nombran su propia causa. La tabla da el próximo paso para cada uno.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 nube en la red, dales variables de entorno y secretos de red, 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