Claude Code Projects: coordinador, /btw, /fork y límites

Claude Code Projects organiza tareas de programación en hilos paralelos mediante un coordinador. Aprende a crear un proyecto, usar /btw y /fork, configurar recordatorios y enlaces de solo lectura, reducir el consumo de tokens y controlar Auto-continue. Compara sus límites con las sesiones locales de Claude Code, agent view y T3 Code.

Índice
Claude Code Projects: coordinador, /btw, /fork y límites

Claude Code Projects es una buena opción para coordinar varias tareas de programación relacionadas sin supervisar cada sesión por separado. A fecha del 14 de noviembre de 2026, está en beta pública con acceso gradual para los planes Pro, Max y Ultra. Su configuración inicial utiliza Opus con esfuerzo alto, por lo que puede agotar antes los límites compartidos de tu suscripción.

Empieza con un hilo pequeño, reduce el modelo y el esfuerzo cuando la tarea lo permita y desactiva Auto-continue si quieres reservar el siguiente período de uso.

La actualización del 14 de noviembre incorpora un coordinador más activo, los comandos /btw y /fork, recordatorios, enlaces de solo lectura y una navegación mejorada por los artefactos de los hilos.

La ventaja principal es que describes el trabajo en una conversación y Claude coordina las sesiones que lo ejecutan. El coste operativo es que cada hilo activo funciona como una sesión completa de Claude Code y consume tu cuota habitual.

¿Qué es Claude Code Projects y quién puede utilizarlo?

Un proyecto de Claude Code mantiene una conversación con un coordinador que distribuye el trabajo entre sesiones independientes llamadas hilos.

Por ejemplo, puedes encargarle estas tareas:

  • Corregir una regresión en la autenticación.
  • Añadir pruebas que faltan a un endpoint de pagos.
  • Investigar una consulta lenta a la base de datos.

El coordinador asigna el trabajo, supervisa los avances y presenta los resultados en la conversación del proyecto. Cada hilo recibe las instrucciones comunes del proyecto y trabaja de forma independiente.

La mayoría se ejecutan como sesiones de Claude Code en la nube. Cada una utiliza su propio entorno aislado, clon del repositorio y rama de Git.

También puedes pedir que un hilo se ejecute en tu equipo mediante Remote Control cuando necesite herramientas o archivos locales.

La diferencia importa para las tareas largas: un hilo en la nube continúa después de cerrar el portátil. Uno ejecutado en tu ordenador solo trabaja mientras ese equipo esté disponible.

No confundas esta función con los Projects antiguos de Claude.ai. Aquellos agrupaban conversaciones y archivos de referencia. La versión de Claude Code añade coordinación activa y sesiones que ejecutan tareas.

Disponibilidad y lista de espera

Según la documentación de Anthropic, el 14 de noviembre de 2026 la disponibilidad era la siguiente:

PlanDisponibilidad de Projects
ProBeta pública, despliegue gradual
MaxBeta pública, despliegue gradual
UltraBeta pública, despliegue gradual
TeamTodavía no disponible
EnterpriseTodavía no disponible

Una suscripción compatible no garantiza que Projects ya aparezca en tu cuenta.

Compruébalo así:

  1. Abre Claude Code en la web.
  2. Busca Projects en la barra lateral.
  3. Si no aparece, abre More.
  4. Comprueba también la pestaña Code de la aplicación de escritorio de Claude.
  5. Si sigue sin aparecer, visita la lista de espera de Projects.

También puedes probar la página de exploración de Projects.

El despliegue comenzó por cuentas que habían utilizado sesiones en la nube y no tenían proyectos anteriores en Claude.ai chat o Cowork.

Actualizar Claude Code desde la terminal no activa esta función. Projects se ofrece a través de las aplicaciones web, de escritorio y móvil, según la elegibilidad de cada cuenta.

¿Qué cambió en la actualización de Projects del 14 de noviembre?

Anthropic anunció varias novedades desde su cuenta @ClaudeDevs el 14 de noviembre de 2026 a las 06:51 UTC+8.

La actualización mejora principalmente la coordinación, el manejo de hilos y el acceso a los resultados.

FunciónQué haceCuándo utilizarla
Coordinador proactivoResponde en el chat del proyecto e informa del estado de los hilosPara seguir varias tareas sin abrirlas una por una
/btwAbre un hilo independiente para una cuestión secundariaPara investigar otro problema sin interrumpir el actual
/forkCrea un hilo a partir del hilo actualPara probar una implementación alternativa
RecordatoriosApartan temporalmente un hilo y vuelven a mostrarlo cuando correspondePara retomar una tarea tras una revisión o dependencia
Enlaces de solo lecturaPermiten compartir hilos individuales, con restriccionesPara mostrar el trabajo a otra persona con cuenta de Claude
Navegación por artefactosMuestra artefactos recientes o fijados y sus miniaturasPara localizar resultados anteriores

Un coordinador que informa de manera más activa

El coordinador ahora responde preguntas directamente en la conversación del proyecto y ofrece actualizaciones más frecuentes.

Por ejemplo, después de iniciar varias tareas, puedes preguntarle:

¿Qué hilos siguen trabajando, qué pull requests necesitan revisión y qué tareas están bloqueadas?

El coordinador puede resumir lo que le han comunicado los hilos. Sin embargo, no observa cada paso interno de todas las sesiones.

Por eso, si investigas un fallo, abre el hilo correspondiente. Allí podrás revisar los comandos ejecutados, las llamadas a herramientas y los resultados.

Anthropic explicó el cambio en su anuncio del coordinador del 14 de noviembre.

Cuándo usar /btw y cuándo usar /fork

Ambos comandos funcionan ahora dentro de Projects, pero sirven para situaciones distintas.

Utiliza /btw cuando surge una cuestión nueva mientras otra tarea está en marcha.

Imagina que un hilo está modificando el middleware de autenticación. Recibes una incidencia de facturación que no está relacionada.

Con /btw, puedes abrir un hilo independiente para esa incidencia. El trabajo de autenticación conserva su contexto.

Utiliza /fork para explorar otra solución al mismo problema.

Por ejemplo, un hilo está optimizando una consulta mediante un JOIN. Puedes crear una bifurcación para evaluar una vista materializada sin reemplazar el enfoque original.

La diferencia es esta:

  • /btw separa una tarea secundaria del trabajo actual.
  • /fork crea una nueva rama de trabajo a partir del hilo actual.

Los dos pueden crear nuevas sesiones y aumentar el consumo. Evita las bifurcaciones repetidas si no vas a comparar soluciones concretas.

Anthropic describió su funcionamiento en el anuncio de ambos comandos. No des por hecho que todas las versiones del CLI de Claude Code se comportan igual.

Recordatorios, enlaces compartidos y artefactos

Puedes configurar un recordatorio en cualquier hilo o pedirle a Claude que te recuerde una tarea.

Según el anuncio de los recordatorios, el hilo deja de ocupar espacio hasta que llega el momento indicado. Después vuelve a aparecer y Claude lo menciona en la conversación del proyecto.

Es útil cuando un trabajo depende de una revisión posterior. El recordatorio no sustituye la comprobación del resultado.

Anthropic también anunció la posibilidad de compartir hilos individuales mediante enlaces de solo lectura:

  1. Abre el hilo que quieres compartir.
  2. Abre su menú.
  3. Selecciona Share, si está disponible.
  4. Envía el enlace a una persona que haya iniciado sesión en Claude.

No puedes compartir con esta función un hilo que haya tenido acceso a tu ordenador.

El 14 de noviembre había una contradicción en la documentación. El anuncio oficial presenta los enlaces individuales, pero la sección de limitaciones de Projects todavía indicaba que no se podían compartir las transcripciones.

Trata el anuncio como una función que Anthropic estaba introduciendo. Comprueba si Share aparece realmente en el menú del hilo. No se ha confirmado un requisito específico de versión del CLI para este cambio de interfaz.

Un enlace de solo lectura tampoco elimina los riesgos de divulgar información. Revisa los detalles del repositorio, los registros y cualquier dato sensible antes de compartirlo.

El anuncio sobre la navegación por artefactos describe una fila superior en el panel de hilos. Allí aparecen los artefactos abiertos, actualizados o fijados recientemente. Cada hilo también puede mostrar miniaturas de sus propios artefactos, que puedes desactivar en la configuración de visualización.

Anthropic indicó que la interfaz renovada de ajustes y carpetas locales está disponible en web y escritorio. El nuevo diseño también llegó a la versión más reciente de la aplicación móvil.

Cómo configurar tu primer Claude Code Project

Crea un proyecto para un objetivo continuado y verifica un hilo pequeño antes de delegar varias tareas.

1. Comprueba el acceso al repositorio

Para trabajar con código en hilos de la nube, Anthropic exige:

  • Un repositorio alojado en github.com, no en GitHub Enterprise Server, GitLab ni Bitbucket.
  • Permisos de escritura mediante tu cuenta de GitHub conectada.
  • Claude GitHub App instalado y autorizado para ese repositorio.

Un token de GitHub configurado mediante /web-setup no basta por sí solo para los hilos de Projects.

Si no aparece tu repositorio, sigue las instrucciones oficiales para configurar GitHub. Conecta la cuenta e instala Claude GitHub App con acceso al repositorio necesario.

Si tu organización utiliza SAML SSO, también puede ser necesario autorizar la aplicación de Claude para esa organización.

Recuerda que el entorno de la nube no hereda toda la configuración local.

Los hilos cargan las instrucciones de CLAUDE.md de cada repositorio, pero no las habilidades del repositorio, los servidores de .mcp.json ni los ajustes de .claude/settings.json.

Esto incluye los hooks, las reglas de permisos y las variables de entorno definidas en .claude/settings.json.

Tampoco obtienen automáticamente las herramientas instaladas solo en tu ordenador.

Configura las capacidades necesarias en el entorno de la nube del proyecto y en las integraciones compatibles de tu cuenta de Claude. Para herramientas exclusivamente locales, considera Remote Control.

2. Crea el proyecto

Las instrucciones oficiales para crear un proyecto describen esta secuencia:

  1. Abre claude.ai/code o la pestaña Code de la aplicación de escritorio.
  2. Selecciona Projects en la barra lateral o en More y después New project.
  3. Introduce un nombre en Name.
  4. Si lo necesitas, define el objetivo en What do you want to work on?.
  5. En Context, pulsa + para añadir repositorios de GitHub, archivos o carpetas.
  6. Selecciona Create project.

Solo es obligatorio el nombre. Puedes incorporar el objetivo y el contexto más adelante.

Si aparece Get started en lugar de New project, Anthropic puede pedirte que actualices o archives primero tus antiguos proyectos de Claude.ai.

Al crear tu primer proyecto, Claude puede realizar una intervención inicial sin esperar otro mensaje. Esa intervención consume tu cuota y puede iniciar un hilo exploratorio o proponer cambios de configuración.

Revisa los repositorios y las tareas programadas recomendadas antes de aceptarlos.

3. Configura las instrucciones y los límites

Abre Project settings desde el menú lateral o el menú de la cabecera del proyecto.

Entra en Project settings > Memory > Project instructions y define las reglas que deben recibir los nuevos hilos.

Por ejemplo:

Trabaja únicamente en el repositorio seleccionado. Crea una rama distinta para cada implementación. Ejecuta las pruebas relevantes antes de informar de que has terminado. Pide autorización antes de modificar el comportamiento de una API pública. No abras un pull request hasta que apruebe el plan.

Los nuevos hilos reciben estas instrucciones.

Los cambios en instrucciones, repositorios, plugins y entornos realizados desde Project settings se aplican a los hilos nuevos. No reconfiguran los que ya se están ejecutando.

Después abre Project settings > General para revisar modelos y niveles de esfuerzo.

4. Ejecuta una tarea pequeña y comprueba el resultado

Empieza con un trabajo cuyo resultado puedas verificar:

Investiga por qué el endpoint de pedidos devuelve un estado HTTP incorrecto cuando recibe datos inválidos. Inicia un solo hilo. Identifica el caso que falla, añade una prueba de regresión y propone una corrección mínima. No abras un pull request hasta que apruebe el plan.

Es un ejemplo de instrucción, no una prueba que hayamos ejecutado.

Abre Overview para comprobar el estado del hilo. El panel utiliza categorías como Working, Waiting on you y Ready for review.

Después entra en el hilo y revisa la evidencia:

  • ¿Qué archivos leyó o modificó?
  • ¿Ejecutó las pruebas solicitadas?
  • ¿Su explicación coincide con el diff?
  • ¿Faltan permisos, dependencias o alguna decisión tuya?

Normalmente, los hilos en la nube modifican ramas separadas. Pueden abrir pull requests cuando se lo pides y, para algunas correcciones concretas, también pueden hacerlo por iniciativa propia.

Si aparece Couldn’t start the session o Unable to access your repository, revisa Claude GitHub App y los permisos del repositorio. Utiliza la acción de recuperación que muestra el error y crea un hilo nuevo para el mismo trabajo.

La coordinación no elimina los conflictos de Git. Dos hilos pueden modificar el mismo código. Revisa los cambios antes de fusionarlos.

Cuando el primer hilo funcione como esperabas, añade una segunda tarea independiente.

Cómo reducir el consumo de Claude Code Projects

El primer ajuste para gastar menos cuota es cambiar los modelos y niveles de esfuerzo predeterminados.

Anthropic indica que un proyecto nuevo utiliza Opus para el coordinador y los hilos. El esfuerzo de los hilos empieza en high y el de la conversación principal en low.

Esa configuración puede resultar excesiva para correcciones sencillas, pruebas aisladas y documentación.

Cambia Thread model, el esfuerzo y Auto-continue

Abre Project settings > General.

AjusteValor predeterminadoOpción inicial para reducir consumo
Thread modelOpusUn modelo más pequeño disponible en tu cuenta
Thread effortHighMedium o low para tareas acotadas
Coordinator modelOpusUn modelo más pequeño para distribuir tareas y comunicar estados
Coordinator effortLowMantener low si la coordinación funciona bien
Auto-continue when usage limits resetOnOff si no quieres reanudar el trabajo automáticamente

Los modelos disponibles pueden variar según la cuenta y la oferta vigente.

Conserva Opus y high effort para depuración compleja, decisiones de arquitectura o trabajos que exijan razonamiento profundo.

Para pruebas pequeñas o cambios directos, prueba primero un modelo menor con menos esfuerzo. Si la calidad no es suficiente, aumenta el nivel.

Los ajustes se dividen en dos grupos:

  • Thread model y Thread effort controlan las sesiones que ejecutan las tareas.
  • Coordinator model y Coordinator effort controlan la conversación principal.

También puedes pedir otro modelo para una tarea nueva. Si el hilo ya está en marcha, utiliza su selector de modelo.

Estos valores se cambian en la interfaz de Projects, no en tu settings.json local.

Pide menos hilos, pero no lo confundas con un límite estricto

Anthropic recomienda solicitar una propuesta de hilos antes de iniciar los trabajos.

Puedes utilizar una instrucción como esta:

Propón los hilos antes de empezar. Ejecuta un máximo de dos hilos al mismo tiempo. Responde las preguntas pequeñas en esta conversación sin abrir otro hilo. Informa de los resultados y bloqueos. Espera mi aprobación antes de empezar el siguiente grupo.

La instrucción ayuda a organizar las tareas, pero no fija una restricción técnica de concurrencia.

Anthropic aclara que el número de hilos solicitado expresa una preferencia, no un máximo garantizado.

El límite obligatorio es de 500 hilos nuevos por día entre todos tus Projects.

No equivale a 500 sesiones gratuitas ni garantiza que puedas ejecutar 500 hilos simultáneos.

Comprueba en Overview cuántos hilos se han iniciado realmente.

En qué se consume la cuota

La documentación de uso y costes de Projects identifica cuatro fuentes principales.

Hilos en ejecución: cada hilo es una sesión completa. Varios hilos pueden consumir cuota a la vez.

Coordinador: leer informes, decidir qué tarea sigue y responder en el chat también consume tokens.

Seguimiento de pull requests: un hilo inactivo puede reanudarse si falla CI o aparece un comentario de revisión.

Historiales largos: volver a un hilo antiguo puede obligar a Claude a procesar de nuevo buena parte de su conversación.

Para el uso incluido en Pro, Max y Ultra, Anthropic documenta una duración de caché de una hora.

Si un hilo lleva más de una hora inactivo, al recibir otro mensaje vuelve a leer su conversación completa.

Para un trabajo nuevo, crear un hilo desde cero puede consumir menos que reactivar uno antiguo con mucho historial.

Pero no abras un hilo nuevo para cada mensaje. Si necesitas lo investigado anteriormente, mantener el contexto puede ser más útil.

Anthropic no publica un multiplicador fijo de consumo para Projects. No hay fundamento para asegurar que siempre utilice el doble, el triple o el quíntuple de cuota.

El consumo depende del número de sesiones, modelos, esfuerzo, historial y trabajo repetido.

En Project settings > Usage puedes consultar los tokens por hilo, por modelo y por conversación del proyecto.

Si quieres entender otros costes de los agentes, consulta nuestro análisis del consumo de agent_summary en Claude Code. Esas mediciones no representan un recargo medido de Projects.

¿Un proyecto inactivo consume cuota?

No, siempre que no tenga hilos en ejecución, pull requests vigilados ni mensajes nuevos.

Anthropic indica que un proyecto totalmente inactivo no consume cuota mientras permanece así. Los proyectos archivados tampoco.

Por tanto, no necesitas borrar un proyecto terminado solo para ahorrar consumo.

La excepción práctica son los hilos que siguen vigilando pull requests. Pueden volver a activarse cuando llega un evento de CI o revisión.

Cuando ya no necesites ese seguimiento, pide al hilo que deje de vigilar el pull request.

¿Qué ocurre cuando Projects alcanza un límite de uso?

Projects comparte los límites de tu suscripción con las demás sesiones de Claude Code. No ofrece una reserva independiente de tokens gratuitos.

A fecha del 14 de noviembre de 2026, las condiciones relevantes eran:

PlanLímites
ProLímite de sesión de cinco horas y límites semanales
MaxLímite de sesión de cinco horas y límites semanales
UltraLímites semanales; sin límite de cinco horas para cuentas Ultra verificadas

Las cuentas Ultra que todavía no estén verificadas pueden tener un límite temporal de sesión.

Anthropic explica esta excepción en la documentación del plan Ultra. También puedes consultar nuestra comparación de los límites de Ultra y Max.

Auto-continue puede consumir tu siguiente período de uso

Cuando un hilo o el coordinador alcanza un límite aplicable, su trabajo queda detenido.

Por defecto, se reanuda automáticamente al restablecerse el límite. Esa actividad utiliza la cuota del siguiente período.

Para impedirlo:

  1. Abre Project settings > General.
  2. Busca Auto-continue when usage limits reset.
  3. Desactívalo antes de la hora de restablecimiento indicada.
  4. Después del restablecimiento, envía un mensaje al hilo o la conversación para continuar manualmente.

El ajuste afecta a todo el proyecto, no solo al hilo que tienes abierto.

Desactivar Auto-continue no desactiva las modalidades de pago adicionales. Debes comprobarlas por separado.

Los usage credits son distintos de la cuota incluida

Los suscriptores Pro, Max y Ultra pueden activar usage credits para pagar consumo adicional.

Si están habilitados, determinadas solicitudes pueden continuar después de agotar los límites incluidos. Un hilo de Projects no puede activar esta opción por sí mismo.

Antes de iniciar muchos trabajos, entra en Settings > Usage de tu cuenta Claude.

Si tienes usage credits activados, establece un límite mensual de gasto. Desactívalos si no deseas cargos adicionales después de agotar tu cuota.

Estos créditos no son los mismos que los API credits mensuales incluidos con Max y Ultra.

Si aparece Additional usage credits are required, puede que el modelo o el tamaño del contexto solicitado requieran créditos que no tienes activados.

Primero comprueba si puedes utilizar un modelo o contexto incluido en tu plan. Si no, consulta las condiciones de usage credits de Anthropic antes de decidir si quieres pagar.

Projects frente a sesiones locales de Claude Code y T3 Code

Elige Projects cuando necesitas coordinación continuada de varias tareas relacionadas. Elige sesiones locales cuando importa más controlar el entorno y cada ejecución.

AlternativaUso recomendadoQuién coordinaPrincipal limitación
Claude Code ProjectsTrabajo relacionado entre sesiones, repositorios o varios díasCoordinador de ClaudeSolo proveedor Anthropic, beta y límites compartidos
Varias sesiones locales de Claude Code CLIPocas tareas independientes que necesitan herramientas localesTúDebes iniciar, supervisar y coordinar las sesiones
Claude Code agent viewSupervisar varias sesiones locales desde una pantallaTúResearch preview, sin coordinador de Projects
T3 CodeGestionar agentes locales, incluidos Claude Code y CodexTú o flujos configuradosRequiere configurar agentes y mantener un equipo anfitrión

Elige sesiones locales para tener control directo

Si tienes dos tareas independientes, puede bastar con abrir dos sesiones locales de Claude Code.

Puedes utilizar Git worktrees para aislarlas. Cada worktree proporciona una copia de trabajo distinta del repositorio y reduce los conflictos accidentales en los archivos locales.

Las sesiones locales pueden usar herramientas instaladas, hooks, ajustes y configuraciones de proveedores compatibles. No se convierten automáticamente en hilos de Projects.

Claude Code también incluye claude agents, una interfaz en research preview para iniciar y supervisar varias sesiones.

Anthropic compara estas opciones en Run agents in parallel.

Empieza por una solución local si todas las tareas necesitan una base de datos local, hooks personalizados o servicios inaccesibles desde la nube.

Elige T3 Code para coordinar agentes diferentes

T3 Code es una interfaz de código abierto para administrar agentes de programación que se ejecutan en tu ordenador.

Su documentación menciona Claude Code, Codex, Cursor, OpenCode y otros agentes compatibles.

Según su README público, T3 Code reúne los hilos en una interfaz y admite conexiones remotas. Además, cada hilo puede utilizar un Git worktree para aislar sus cambios.

Emplea los agentes y métodos de autenticación que tú configures. T3 Code no revende tokens.

Resulta útil cuando quieres pasar trabajo de Claude Code a Codex o controlar tareas locales desde otro dispositivo.

Sin embargo, no transforma las sesiones de terceros en Claude Code Projects ni incorpora el coordinador alojado por Anthropic.

El proveedor subyacente sigue determinando la autenticación, el acceso y la facturación.

Consulta nuestra guía para configurar T3 Code con Claude Code, Codex y pasarelas API para completar esa integración.

¿Projects permite una API key o un proveedor de modelos personalizado?

Anthropic no documenta una vía para configurar proveedores personalizados en Projects.

Sus limitaciones indican expresamente que los hilos en la nube y los ejecutados mediante Remote Control utilizan Anthropic como proveedor del modelo.

Tampoco puedes utilizar Projects directamente desde el CLI, la extensión de VS Code ni el plugin de JetBrains.

Si necesitas un endpoint API personalizado, utiliza una herramienta local compatible o una interfaz de coordinación de terceros. Comprueba por separado sus opciones de proveedor.

El acceso a una API con pago por uso no sustituye al coordinador de Projects, a la suscripción necesaria ni a la gestión de sesiones en la nube.

Una configuración inicial para controlar el consumo

Si tienes una cuenta Pro elegible y varios errores pequeños en un servicio, empieza con esta configuración:

  1. Crea un Project para el servicio y conecta únicamente el repositorio necesario.
  2. Añade a Project instructions las reglas de ramas, pruebas y aprobación.
  3. Elige un Thread model más pequeño y reduce Thread effort para tareas habituales.
  4. Mantén Coordinator effort en low y considera un Coordinator model menor.
  5. Pide que se propongan los hilos y aprueba una o dos tareas cada vez.
  6. Desactiva Auto-continue si quieres reservar la siguiente ventana de uso.
  7. Después del primer grupo, revisa Project settings > Usage.

Reserva Opus con high effort para las investigaciones que realmente lo justifiquen. Utiliza /btw y /fork cuando separar el contexto ayude a comparar o resolver el trabajo.

Para una migración prolongada entre varios repositorios, Projects puede ahorrarte coordinación manual. Para unos pocos cambios locales, las sesiones independientes o agent view pueden resultar más sencillos.

Comprueba primero el trabajo que realiza el coordinador y los tokens consumidos. Aumenta el número de hilos solo cuando conozcas ese comportamiento.

¿Quieres optimizar tu flujo de trabajo con LLM?

Conecta modelos mediante una API, gestiona claves y controla el gasto en IA.

Empezar gratis