Resumen
Claude Code es la herramienta de codificación agéntica de Anthropic que vive en tu terminal, lee todo tu repositorio y edita archivos, ejecuta pruebas y abre pull requests por su cuenta. "Proyectos de Claude Code" ahora significa dos cosas: la flamante función Projects que llegó el 17 de septiembre de 2026 (agrupar sesiones relacionadas, supervisar varios agentes a la vez), y el sentido más antiguo y amplio de "una base de código sobre la que apuntas Claude Code". Lo que separa un proyecto frustrante de uno fluido es la capa de configuración que lo rodea: un archivo CLAUDE.md, subagentes, servidores MCP y skills. Está incluido en todos los planes de pago de Claude, así que la mayoría de la gente ya lo tiene.
Un límite honesto que vale la pena decir desde el principio: Claude Code es infraestructura que tú diriges, no un empleado que llega ya formado. Es excelente escribiendo software. Si tu "proyecto" en realidad es una cola de soporte o un pipeline de contenido, necesitas un compañero de equipo listo para trabajar en su lugar. Ese es el hueco que llena eesel, y, como eesel tiene su propio CLI y servidor MCP, incluso puedes dirigir a ese compañero de equipo desde la misma terminal en la que corre Claude Code.
Qué significa realmente "proyectos de Claude Code"
Me dedico a construir integraciones y APIs, así que paso gran parte de mi día dentro de Claude Code, y la frase "proyectos de Claude Code" confunde a la gente porque apunta a dos cosas distintas.
La primera es la función Projects literal, que tiene cuatro días de vida. Anthropic lo describe sin rodeos: "Agrupa sesiones de codificación relacionadas para poder ejecutar y supervisar fácilmente varios agentes Claude a la vez". Se lanzó en la app de escritorio de Claude Code el 17 de septiembre de 2026, y existe porque los power users ya estaban ejecutando varios agentes en paralelo y necesitaban un sitio donde mantenerlos organizados.
La segunda es el sentido cotidiano: un proyecto es simplemente un repositorio dentro del cual abres Claude Code. Haces cd a tu base de código, ejecutas claude, y este lee el proyecto, entiende las dependencias entre archivos y empieza a trabajar. La mayor parte de esta guía trata sobre ese segundo sentido, porque hacerlo bien es lo que hace que valga la pena usar la reluciente función nueva.
Vale la pena situar esto en su escala real, porque cambia lo en serio que debes tomarte la configuración. El anuncio de la Serie G de Anthropic (12 de febrero de 2026) cifró la tasa de ingresos anualizada de Claude Code en "más de 2.500 millones de dólares", dijo que los usuarios activos semanales se habían duplicado desde principios de año, y citó una estimación según la cual el 4% de todos los commits públicos de GitHub eran obra de Claude Code. Esto no es un juguete. Es una herramienta que grandes organizaciones de ingeniería (Netflix, Spotify, KPMG y Salesforce están entre los usuarios mencionados) ejecutan a diario contra repositorios en producción.
Cómo funciona Claude Code dentro de un proyecto
El modelo mental que más me ha ayudado: Claude Code no es autocompletado, es un bucle. Describes un resultado, y el agente lee, planifica, edita, prueba e informa, una y otra vez, hasta que la tarea está terminada o te necesita.
En la práctica eso se parece a pedirle que "añada pruebas para este archivo" y ver cómo abre el archivo, lo lee, escribe un nuevo archivo de pruebas y se detiene a esperar tu visto bueno antes de tocar nada. La distinción entre agéntico y copiloto que trazó el desarrollador Santiago Valdarrama es el marco más claro que he visto:
"Mode 1: AI writes the code, and the human copilots. Mode 2: The human writes the code, and AI copilots. These two are very different. One doesn't replace the other. Professional developers use both."
Esa pausa importa. Por defecto, Claude Code pregunta antes de editar un archivo o ejecutar un comando, y puedes aprobar una vez, aprobar y dejar de preguntar, o redirigirlo. Desde la actualización del 7 de agosto de 2026, funciona en "modo automático" por defecto en los planes Pro, Max y Team, lo que le permite trabajar más tiempo sin dejar de detectar comandos arriesgados. El punto es que tú mantienes el control del bucle, no estás entregando las llaves y esperando lo mejor.
La capa de configuración del proyecto que lo hace repetible
Esto es lo que la mayoría pasa por alto, y es el mejor predictor de si Claude Code se siente mágico o caótico: una sesión en bruto solo es tan buena como el contexto que le das. La capa de configuración es lo que convierte un golpe de suerte puntual en un proyecto repetible.
La pieza que lo sostiene todo es CLAUDE.md, un archivo markdown en la raíz de tu proyecto que Claude Code lee al comienzo de cada sesión. Contiene tus estándares de código, decisiones de arquitectura, librerías preferidas y las zonas intocables que nunca quieres que el agente refactorice. Claude Code también lee un AGENTS.md si ya mantienes uno para otros agentes, y construye su propia memoria automática a través de las sesiones. Un power user de Reddit resumió bien esta disciplina:
"I maintain a CLAUDE.md file which i update after each session. I periodically use /compact to keep the context window smaller. I start a new session for a new feature."
Sobre eso se apoyan cuatro capas más:
- Subagentes: asistentes especializados, cada uno con su propia ventana de contexto, herramientas y permisos. Los integrados como Explore (búsqueda rápida de solo lectura) y Plan se encargan del trabajo pesado, y puedes dirigir subagentes personalizados hacia un modelo más barato como Haiku para mantener los costes bajos.
- Servidores MCP: el estándar abierto para conectar Claude Code con sistemas externos, de modo que pueda leer un ticket de Jira, extraer contexto de Slack o consultar una base de datos a mitad de la tarea.
- Skills: flujos de trabajo empaquetados y compartibles que tu equipo invoca como comandos slash tipo
/review-pro/deploy-staging. - Hooks: comandos de shell que se disparan antes o después de una acción, para formatear automáticamente tras cada edición o bloquear un commit que falle el lint.
Una publicación viral en X de Suryansh (4,5 mil likes, 1,5 millones de visualizaciones) capturó por qué esta capa es la verdadera clave:
"Most people are using Claude Code completely vanilla… which is why their experience feels messy. The real power comes from the ecosystem around it."
Si hay una queja real que señalar, es el esfuerzo de configuración. Los hilos más votados de tipo "así es mi flujo de trabajo" admiten abiertamente que les llevó de dos a tres semanas afinarlo, y que "no es nada amigable para principiantes". Es un intercambio justo por una base de código en la que vives a diario, pero es un coste real, y vale la pena saberlo antes de empezar.
Ejecutar proyectos de Claude Code más allá de la terminal
Claude Code empezó como una CLI, pero ahora un proyecto puede seguirte por varias superficies, y todas comparten el mismo motor, así que tu CLAUDE.md, tus ajustes y tus servidores MCP funcionan en todas partes.
Las superficies que conviene conocer:
- CLI de terminal: la original, sigue siendo la más completa en funciones, y componible con pipes de Unix (
git diff | claude -p "review this"). - Extensiones de IDE: los plugins de VS Code y JetBrains añaden diffs en línea, menciones con @ y revisión de planes.
- App de escritorio: incluye Claude Code sin instalación aparte, y es donde vive la nueva función Projects.
- Claude Code en la web: funciona en el navegador en claude.ai/code contra repositorios que no tienes localmente, además de iOS y Android.
- Routines: tareas programadas que corren en la nube y siguen ejecutándose cuando tu ordenador está apagado, y que pueden activarse con un evento de GitHub.
Esa última categoría es donde "proyectos" deja de significar "una carpeta en la que me siento" y empieza a significar "trabajo que se ejecuta esté yo o no". También es el puente hacia el punto al que sigo volviendo: en cuanto tu agente se programa a sí mismo y llama a otros sistemas, la pregunta pasa a ser con qué otros sistemas debería estar hablando.
Cuánto cuesta ejecutar un proyecto con Claude Code
La buena noticia sobre el precio es que Claude Code está incluido en todos los planes de pago de Claude, no se vende por separado. Tu trabajo en la terminal y tus chats consumen del mismo pool de uso, que se reinicia en una ventana móvil de cinco horas, con límites semanales encima. Aquí está la lista de planes actual según la página de precios de Claude:
| Plan | Precio | Claude Code | Ideal para |
|---|---|---|---|
| Free | 0 $ | No | Solo para probar el chat de Claude |
| Pro | 20 $/mes (17 $ facturado anualmente) | Sí | Desarrolladores individuales, uso ligero a moderado |
| Max 5x | 100 $/mes | Sí | Trabajo agéntico diario |
| Max 20x | 200 $/mes | Sí | Sesiones intensivas de todo el día |
| Team | 20-100 $/puesto/mes | Sí | Uso compartido en equipo |
| Enterprise | 20 $/puesto/mes + uso de API | Sí | SSO, registros de auditoría, listo para HIPAA |
Si necesitas superar los límites de tu plan, puedes cambiar a créditos de API de pago por uso mediante una cuenta de Console, facturados a las tarifas estándar del modelo:
| Modelo | Input /MTok | Output /MTok | Posicionamiento |
|---|---|---|---|
| Fable 5.1 | 10 $ | 50 $ | Agentes de ejecución larga |
| Opus 5 | 5 $ | 25 $ | Codificación agéntica compleja |
| Sonnet 5 | 2 $ | 10 $ | Predeterminado de alto rendimiento |
| Haiku 4.5 | 1 $ | 5 $ | El más rápido y económico |
Lo único que hay que planificar son los límites, no el precio. La queja recurrente más ruidosa en Reddit es que el plan Pro de 20 dólares se estrangula rápido bajo uso intenso. El consejo constante de quienes hacen desarrollo a tiempo completo: presupuesta Max si Claude Code hace tu trabajo pesado, y apóyate en modelos de subagentes más baratos para las pasadas rutinarias.
Qué construye realmente la gente con proyectos de Claude Code
Una vez afinada la configuración, el rango de proyectos es amplio. Por lo que veo en la comunidad y uso yo mismo, los patrones se agrupan así:
| Tipo de proyecto | En qué destaca Claude Code | A qué prestar atención |
|---|---|---|
| Construcción de funciones | Entrega rápido una parte funcional, de la especificación al pull request | Puede duplicar código en lugar de refactorizar |
| Corrección de bugs | Rastrea problemas rápidamente en el historial de commits | A veces declara "hecho" prematuramente |
| Refactorizaciones | Coordina ediciones en muchos archivos | Revisa el diff, no fusiones a ciegas |
| Cobertura de pruebas | Escribe suites de pruebas completas | Verifica que las pruebas realmente afirmen algo |
| Scripts puntuales | Excelente para código de conexión y automatización | Calidad desechable a menos que pidas más |
La visión más honesta sobre esta contrapartida vino de un profesional en LinkedIn que había entregado funciones 5 veces más rápido y luego encontró la trampa:
"Claude had created 5 nearly identical methods instead of refactoring into reusable functions. The AI optimizes for 'make it work' not 'make it maintainable.'… What's working: Treating AI as a junior developer who needs review."
Ese planteamiento, un junior rápido que necesita revisión, es el que tatuaría en el monitor de un usuario nuevo. Un desarrollador con una década de experiencia llevó el mismo punto aún más lejos: "Claude Code isn't a shortcut. It's a multiplier, but only if you bring the fundamentals to the table."
Dónde termina un agente de código y empieza un compañero de equipo
Aquí está el replanteamiento que cambia cómo deberías pensar todo esto. Claude Code es asombrosamente bueno en proyectos de software. Pero muchos de los "proyectos" que la gente realmente quiere automatizar no son software en absoluto: responder tickets de soporte, escribir entradas de blog, mantener actualizada una base de conocimiento. Y para eso, un agente de código es la herramienta equivocada.
Piénsalo como infraestructura frente a empleado. Claude Code es infraestructura que operas: tú lo diriges, escribe código y ejecuta comandos, y abre pull requests para que los revises. eesel es la otra mitad: una plataforma donde contratas compañeros de equipo de IA listos para trabajar en tareas específicas. La plantilla actual es un compañero de equipo de IA para helpdesk que se une a tu cola de soporte y un redactor de blog de IA que investiga y redacta artículos extensos. Cada uno llega ya con las habilidades, integraciones y contexto de la empresa para su rol, y se activa en minutos en lugar de necesitar dos o tres semanas de configuración.
Lo que hace esto concreto para un usuario de Claude Code es que eesel no es un panel cerrado. Ofrece una superficie programable real, así que la misma persona, script o agente de código que dirige Claude Code también puede dirigir a un compañero de equipo de eesel. El @eesel/cli es un binario de npm cuya documentación dice literalmente que "todo en este sitio se puede hacer desde la terminal". Algunos comandos que conviene conocer:
eesel integrations connect <platform>conecta al compañero de equipo con tu helpdesk de Zendesk, Freshdesk o Gorgias.eesel instructionslee y edita las reglas fijas que dan forma a sus respuestas, el equivalente en soporte de unCLAUDE.md.eesel activitylista las ejecuciones de más reciente a más antigua para que puedas inspeccionar exactamente qué hizo el compañero de equipo, yeesel approvalsmantiene a una persona en el bucle.- Cada comando imprime JSON, y
--dry-runmuestra la llamada exacta al servidor que haría una escritura antes de enviarla, lo que permite programarlo con seguridad.
También hay un servidor MCP para cada workspace, así que puedes ejecutar npx @eesel/cli mcp token, pegar el comando claude mcp add que se imprime, y dejar que Claude Code opere tu compañero de equipo de soporte como un conjunto de herramientas en mitad de la sesión. Un ingeniero senior describió exactamente este cambio hacia hacerlo todo desde la terminal:
"I'm spending significantly less time in my IDE and web browser. I'm doing most things, including accessing other systems using MCP, all from Terminal."
La advertencia honesta, para no exagerar: eesel no publica un producto de API REST pública documentado por separado. La superficie programable es la CLI, el servidor MCP, los webhooks y el acceso a la red, lo cual es más que suficiente para dirigir a un compañero de equipo desde un agente, pero dilo así en lugar de imaginar una API CRUD completa.
Prueba eesel
Si el proyecto que realmente quieres automatizar es soporte al cliente o contenido en lugar de escribir código, ese es exactamente el trabajo para el que se construyó eesel. El compañero de equipo de IA para helpdesk se entrena con tus tickets pasados, tu centro de ayuda y tu documentación, se une al helpdesk que ya usas, y puede simularse contra tus tickets históricos antes de responder nunca a un cliente real. La directora de innovación de Global Pay reportó "hasta un 80% de ahorro de tiempo" tras implementarlo.
Lo mejor para el público de Claude Code: puedes operar a ese compañero de equipo entero desde la misma terminal en la que ya vives. Empieza gratis con 50 $ de uso y sin tarjeta de crédito, y luego son 40 centavos fijos por ticket o chat resuelto, sin tarifas por puesto. Prueba eesel y descubre cómo se siente un compañero de equipo listo para trabajar junto a un agente de código que tienes que dirigir tú.
Preguntas frecuentes
¿Qué son los proyectos de Claude Code?
Hay dos cosas que la gente puede querer decir. La función Projects literal (lanzada el 17 de septiembre de 2026) agrupa sesiones de codificación relacionadas en Claude Code Desktop para que puedas ejecutar y supervisar varios agentes a la vez. En un sentido más amplio, un proyecto de Claude Code es cualquier repositorio sobre el que apuntas la herramienta, configurado con un archivo CLAUDE.md para que el agente conozca tus estándares. Para llevar a cabo un trabajo de cara al cliente en lugar de escribir código, un compañero de equipo listo para trabajar como eesel es la mejor opción.
¿Cuánto cuesta ejecutar un proyecto con Claude Code?
Claude Code está incluido en todos los planes de pago de Claude: Pro a 20 $/mes, Max a 100 $ o 200 $/mes, y Team desde 20 $/puesto. Tu trabajo en la terminal y tus chats consumen del mismo pool de uso, y puedes cambiar a créditos de API de pago por uso para sesiones intensivas. Consulta la página de precios de Claude para ver las tarifas actuales.
¿Necesito saber programar para usar los proyectos de Claude Code?
En su mayoría, sí. Claude Code es una herramienta para desarrolladores que vive en tu terminal y edita repositorios reales. Si tu proyecto es un flujo de soporte o de contenido en lugar de software, necesitas un compañero de equipo que ya conozca el trabajo. El compañero de equipo de IA para helpdesk de eesel y su redactor de blog de IA se activan en minutos sin escribir código.
¿Qué es un archivo CLAUDE.md y necesito uno para cada proyecto?
CLAUDE.md es un archivo markdown en la raíz de tu proyecto que Claude Code lee al comienzo de cada sesión, con tus estándares de código, notas de arquitectura y las zonas intocables. No es estrictamente necesario tener uno, pero los proyectos con un buen CLAUDE.md se comportan de forma mucho más predecible. eesel aplica la misma idea al soporte: instrucciones fijas que determinan cómo responde el compañero de equipo.
¿Puede Claude Code trabajar en más de un proyecto a la vez?
Sí. Los agentes en segundo plano ejecutan varias sesiones completas en paralelo, y la nueva función Projects existe precisamente para agruparlas y supervisarlas. También puedes dirigir otros agentes, como un compañero de equipo de eesel a través de MCP, desde la misma sesión de Claude Code.
Article by
Rama Adi Nugraha
Rama is a software engineer at eesel AI with two years of experience writing about B2B SaaS, AI tools, and customer support technology. Based in Bali, Indonesia, he brings a developer's perspective to product comparisons — cutting through marketing copy to what the integrations and APIs actually do.
