Projects está en beta pública en los planes Pro, Max y Ultra y se está implementando gradualmente. El despliegue comenzó con cuentas que han utilizado sesiones en la nube y no tienen proyectos existentes en el chat de claude.ai o en Cowork. Projects aún no se ofrece en los planes Team o Enterprise.Si Projects no aparece en la barra lateral en claude.ai/code ni en la pestaña Code de la aplicación de escritorio, búscalo en More allí. Si tampoco aparece ahí, el despliegue aún no ha llegado a tu cuenta. Puedes unirte a la lista de espera, y consulta Ejecutar agentes en paralelo para ver lo que puedes 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 tarea programada en la nube 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.mdde cada uno de los repositorios del proyecto, pero no los skills,.claude/settings.jsonni.mcp.jsonde los repositorios - 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 Scheduled tasks para el trabajo programado en el proyecto.
Crear un proyecto
Puedes crear y usar 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 en la aplicación de escritorio hay dos formas de iniciar un proyecto:- Desde cero, cuando sabes qué flujo de trabajo quieres que Claude ejecute: abre el diálogo New project y ponle un nombre. Iniciar un proyecto nuevo desde cero explica el diálogo paso a paso.
- Desde una sesión en la nube que ya está haciendo el trabajo: en el menú de la barra lateral de esa sesión, elige Continue in project y luego Continue as new project. Claude propone la configuración del proyecto a partir de lo que estaba haciendo la sesión. Consulta Empezar desde una sesión en la nube existente.
Revisar los requisitos previos
Antes de crear un proyecto, revisa tu plan, tu configuración de GitHub y a qué necesita acceder el trabajo:- Plan: tienes Pro, Max o Ultra, y Projects aparece en tu barra lateral, directamente o en More. Selecciona Projects y comprueba que ofrece New project o Get started.
- GitHub, si el proyecto va a trabajar con código: tu código está en github.com y no en GitHub Enterprise Server, GitLab ni Bitbucket, tu cuenta de GitHub conectada tiene acceso de push 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 los hilos en la nube de un proyecto, que necesitan la Claude GitHub App. Configurar el acceso a GitHub tiene los pasos. - Acceso a la red, secretos y herramientas: para los hilos en la nube, provienen del entorno en la nube del proyecto. El entorno predeterminado ya accede a los registros de paquetes comunes, así que revisa esto solo si el trabajo necesita otros dominios, un secreto o una herramienta que no esté preinstalada. Si el trabajo necesita un servidor MCP, comprueba que aparece como conectado en tus conectores de claude.ai.
Iniciar un proyecto nuevo desde cero
Iniciar un proyecto desde cero significa abrir el diálogo New project, ponerle nombre al flujo de trabajo y, opcionalmente, darle un objetivo y los repositorios y archivos con los que trabaja. Solo el nombre es obligatorio, así que puedes crear el proyecto primero y completar el resto a medida que el trabajo toma forma.1
Abrir Projects
En claude.ai/code o en la pestaña Code de la aplicación de escritorio, selecciona Projects en la barra lateral izquierda, o en More dentro de ella. En un navegador también puedes ir directamente a claude.ai/code/projects/browse. Luego selecciona New project. Si en su lugar el botón dice Get started, selecciónalo y primero actualiza o archiva los proyectos existentes de claude.ai que enumera.
2
Completar el diálogo New project
Limita el proyecto a un flujo de trabajo al que seguirás agregando cosas, como todo lo necesario para mantener una API por debajo de 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 sobre lo que intentas lograr, como “Mantener la latencia p95 de la API por debajo de 200 ms”. Claude en la conversación trabaja para alcanzarlo. Sin un objetivo, Claude trabaja a partir de las tareas que envías, y puedes agregar un objetivo más adelante en Project settings > General.
- Context (opcional): los repositorios de GitHub con los que trabaja este proyecto, además de cualquier archivo, carpeta o carpeta de Google Drive que los hilos deban leer. Haz clic en Add para cada uno. Agrega los repositorios que necesitan la mayoría de las tareas en lugar de todos los que el trabajo podría tocar; Decidir qué repositorios agregar trata esta elección, y puedes agregar más después en Project settings > Environment.
3
Crear el proyecto
Haz clic en Create project. Se abre la conversación del proyecto con un cuadro de mensaje en la parte inferior, donde describes el trabajo para Claude.En tu primer proyecto, Claude toma un turno propio en cuanto se crea el proyecto, a menos que envíes un mensaje primero. Ese turno usa tu plan. En él, Claude puede:
- Iniciar un hilo que explora el repositorio sin cambiar nada y propone los siguientes pasos, si el proyecto tiene un repositorio que puede leer.
- Publicar Setup recommendations a partir de tus sesiones en la nube recientes: repositorios para agregar, tareas programadas para crear e hilos que podría iniciar. Cada repositorio y tarea programada recomendados empieza activado. Desactiva los que no quieras y luego haz clic en Update setup para agregar el resto, o ignora las recomendaciones y describe el trabajo tú mismo.
Empezar desde una sesión existente
Si una sesión en la nube que iniciaste tú mismo está haciendo un trabajo que corresponde a un proyecto, abre su menú de la barra lateral, elige Continue in project y luego elige una opción del submenú:- Elige Continue as new project para crear un proyecto nuevo a partir de la sesión. El proyecto se abre, y Claude lee la sesión y publica Setup recommendations en la conversación del proyecto para que las confirmes. La sesión original permanece en tu lista de sesiones. Si estaba en medio de un turno, sigue ejecutándose, así que detenla tú mismo si no quieres que ambos trabajen a la vez.
- Elige uno de tus proyectos existentes para llevar el trabajo de la sesión a ese proyecto. Ese proyecto se abre, y un mensaje enviado en tu nombre le pide a Claude que lea la sesión y continúe donde se quedó. La sesión original permanece en tu lista de sesiones, sin cambios.
- Si la sesión aún no está conectada, ejecuta
/remote-controlen ella. Si se conectó mientras ese ajuste estaba activado, primero desconéctala y vuelve a conectarla. - En un navegador, busca la fila de la sesión en la barra lateral de claude.ai/code, abre su menú y elige una opción del mismo submenú.
Configurar el acceso a GitHub
La mayor parte de la configuración de GitHub se hace una sola 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 acceso a todos los repositorios. Vuelves a estos pasos cuando agregas un repositorio que la Claude GitHub App aún no cubre o uno de una organización de GitHub que exige SSO.1
Conectar tu cuenta de GitHub
Si no has usado claude.ai/code antes, tu primera visita te guía para conectar GitHub; consulta Conectar GitHub. De lo contrario, usa una de las opciones de autenticación de GitHub.
2
Instalar la Claude GitHub App en los repositorios del proyecto
Instala la Claude GitHub App y concédele acceso a los repositorios que usará el proyecto. En un repositorio que pertenece a una organización de GitHub, solo un propietario de la organización puede completar la instalación; si no lo eres, GitHub le envía al propietario una solicitud de instalación y el proyecto no puede usar el repositorio hasta que la apruebe.
3
Autorizar SSO para las organizaciones que lo exigen
Si una organización de GitHub exige SAML SSO, vuelve a conectar GitHub y autoriza la aplicación de Claude para esa organización. Hasta que lo hagas, los repositorios privados de esa organización no aparecen en el diálogo New project ni en 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: los archivos y carpetas que agregaste y los archivos que produjeron los hilos
- Pull requests: se muestra una vez que los hilos han abierto alguno
- Scheduled tasks: las tareas programadas en la nube 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. Los hilos en la nube no leen las reglas de permisos del.claude/settings.json de un repositorio, por lo que dependes del modo automático y de las aprobaciones que das dentro de cada hilo.
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: abre Settings > Code o Settings > Claude Code y activa Use this computer from your phone and claude.ai. Agrega la carpeta a la lista debajo de ese interruptor. Los hilos pueden ejecutarse en esta computadora mientras la aplicación está abierta.
- En una terminal: ejecuta
claude remote-controlen la carpeta y déjalo en ejecución. En un repositorio de git, agrega--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, elige Work locally en el menú + junto al cuadro de mensaje, lo que etiqueta tu mensaje como Local, y escribe lo que quieres que se haga. Decir en el mensaje que la tarea debe ejecutarse en tu computadora también funciona.
3
Permitirlo en la tarjeta
Claude responde con una tarjeta Allow Claude to work in a folder on your device. Elige la carpeta si conectaste 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, puedes activar Worktree en las opciones de la carpeta para dar a este hilo su propio worktree en su lugar. Luego haz clic en Allow once.
claude remote-control se cierra.
- Para volver a poner en marcha el hilo: consulta Lost contact with your folder
- Para evitar que la computadora entre en reposo por sí sola: en la aplicación de escritorio, activa Keep this computer awake for Remote Control en Settings > Code o Settings > Claude Code
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 su código y suCLAUDE.md en cada hilo en la nube, pero no con sus skills, .claude/settings.json ni .mcp.json. 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.mdcargado, independientemente de si la tarea lo toca. - 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.mdde ese repositorio no estaba 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
Los hilos en la nube cargan las instruccionesCLAUDE.md de cada repositorio, pero no sus skills, los servidores de .mcp.json ni .claude/settings.json, ya sea que el proyecto tenga un repositorio o varios.
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: habilítalos para tu cuenta de claude.ai, y los hilos en la nube cargan los skills que habilitas allí, salvo algunos hilos en un entorno autoalojado. Los skills con commit en el
.claude/skills/de un repositorio no se cargan en los hilos en la nube. - 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. 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 tareas programadas 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, lo que detiene cualquier hilo que estaba en ejecución u observando un pull request. Las tareas programadas 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 tareas programadas del proyecto. Esto no se puede deshacer. Las ramas y pull requests que los hilos enviaron a GitHub no se ven afectados.
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 500 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:- En Pro, Max y Ultra dentro de los límites de tu plan, la vida útil de la caché es de una hora. Un hilo que ha estado inactivo más tiempo que eso vuelve a leer toda su conversación antes de hacer nada cuando le llega un seguimiento. Para trabajo nuevo, pídele a Claude que comience un hilo nuevo, lo cual 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. Los proyectos están disponibles en Pro, Max y Ultra. Un proyecto es solo tuyo: eres el único que le envía trabajo o ve sus hilos, y utiliza tu propio acceso a GitHub y tus conectores. Cómo Claude Tag difiere de Cowork y Claude Code tiene la comparación lado a lado.
- Sesiones en la nube: cada hilo es una sesión en la nube a menos que le pidas a Claude que la ejecute en tu máquina. De cualquier forma, Claude la comienza y rastrea en lugar de ti. También puedes llevar el trabajo de una sesión en la nube que iniciaste tú mismo a un proyecto: elige Continue in project en el menú de la barra lateral de esa sesión.
- Tareas programadas: cuando pides trabajo programado en un proyecto, Claude crea una tarea programada en la nube que se ejecuta como hilos en ese proyecto y aparece en su pestaña Scheduled tasks. Las tareas programadas 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.
- Sesiones locales y agent view: una sesión que inicias tú mismo en tu terminal, IDE o el entorno local de la aplicación de escritorio queda fuera de tus proyectos, aunque puedes llevar su trabajo a uno. Agent view es una pantalla para rastrear varias sesiones locales lado a lado, y sigues iniciando cada una y dándole su tarea tú 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 puedes agregar a un proyecto una sesión que iniciaste tú mismo en tu máquina, aunque sí puedes traer su trabajo a uno. Un proyecto llega a tu máquina 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 puedes mover o copiar un hilo a otro proyecto, o sacarlo para que esté solo. Continue in project va solo en la otra dirección: trae el trabajo de una sesión en la nube a un proyecto. No puedes 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. Un hilo que una tarea programada 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. Mientras un hilo espera, 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. 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. Si la aplicación de escritorio o claude remote-control ya no se está ejecutando allí, inícialo de nuevo:
- Aplicación de escritorio: reabre la aplicación y confirma que Use this computer from your phone and claude.ai aún está activado en Settings > Code o Settings > Claude Code
- Terminal: ejecuta
claude remote-controlde 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 tareas programadas: horarios, disparadores y administración para tareas programadas, 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