Cómo usar Claude Code: flujo de trabajo, instalación y buenas prácticas

Cerca de 6,600 personas en Estados Unidos buscan mensualmente "how to use Claude Code". La instalación es la parte sencilla. La verdadera habilidad reside en decidir qué puede modificar Claude, aportarle suficiente contexto sin saturar la sesión y definir qué significa "terminado" antes de que escriba una sola línea.

Qué hace realmente Claude Code y cómo usar Claude Code con eficacia

Claude Code es una sesión de trabajo conectada a tu entorno de desarrollo. Puede leer archivos, explorar un repositorio, editar código, ejecutar comandos de terminal, usar git, consultar documentación e inspeccionar errores mediante complementos de inteligencia de código compatibles. Está disponible en la terminal, VS Code, entornos de desarrollo de JetBrains, la aplicación de escritorio de Claude, la web, dispositivos móviles, Slack y flujos de trabajo de CI/CD.

Imagina el modelo de lenguaje como el ingeniero y a Claude Code como el taller a su alrededor. El modelo razona sobre la tarea. El taller proporciona archivos, herramientas, permisos, memoria y un entorno para ejecutar comprobaciones. Por esa razón puede responder a "corrige las pruebas que fallan" leyendo el error, localizando el código relevante, editando varios archivos, volviendo a ejecutar las pruebas y ajustando la solución si el primer intento no funciona.

Por debajo, cada tarea sigue un ciclo de tres fases:

1. Recopilar contexto: inspeccionar el repositorio, la salida de errores, el estado de git, las instrucciones del proyecto y cualquier referencia que proporciones.
2. Ejecutar acciones: editar archivos, ejecutar comandos, emplear herramientas o solicitarte una decisión.
3. Verificar: ejecutar pruebas, compilaciones, linters u otra comprobación, y reiniciar el ciclo si el resultado falla.

Claude Code puede ejecutarse localmente en tu equipo, en un entorno en la nube administrado por Anthropic o a través de Remote Control, donde el código permanece en tu máquina mientras operas la sesión desde un navegador. El ciclo del agente es idéntico, pero la ubicación de tus archivos, herramientas y accesos de red cambia.

Cómo instalar e iniciar Claude Code

La versión de terminal ofrece la visión más clara de cómo opera Claude. Necesitas un proyecto de código y un plan de pago de Claude, una cuenta en Claude Console o acceso a través de un proveedor en la nube compatible. El plan gratuito de Claude no incluye Claude Code.

Anthropic recomienda su instalador nativo. Elige el comando correspondiente a tu terminal:

# macOS, Linux o WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows con WinGet
winget install Anthropic.ClaudeCode

Las instalaciones nativas se actualizan en segundo plano. Las instalaciones mediante Homebrew, WinGet y gestores de paquetes de Linux requieren actualizaciones manuales de forma predeterminada. Ejecuta claude --version para comprobar la instalación o claude doctor si la configuración presenta errores.

Luego abre el proyecto que deseas que Claude comprenda:

cd /ruta/a/tu-proyecto
claude

La primera ejecución inicia un flujo de inicio de sesión en el navegador. Después de eso, comienza con una pregunta de solo lectura como: "¿Qué hace este proyecto, cuál es el punto de entrada principal y cómo ejecuto sus pruebas?". Claude lee los archivos según los necesita, por lo que no es preciso adjuntar el repositorio archivo por archivo.

Si prefieres evitar la terminal, instala la extensión de VS Code o abre la pestaña Code en la aplicación de escritorio de Claude. La versión web en claude.ai/code ejecuta el trabajo en un entorno en la nube y resulta útil para tareas extensas o repositorios que no mantienes de forma local.

El flujo de trabajo que produce resultados fiables

La base más sólida es simple: delimitar, planificar, construir, verificar y revisar. Emplea los cinco pasos para modificaciones que abarquen múltiples archivos. Salta la planificación solo cuando el cambio sea tan evidente que puedas describir el diff en una sola frase.

1. Comienza con un resultado delimitado

Pedir "mejora esta app" obliga a Claude a explorar de forma dispersa y suponer qué es prioritario. Una petición superior describe el síntoma, la ubicación probable, las restricciones y la condición de éxito:

Estos detalles no son adornos de redacción. Cada uno resuelve una decisión que, de otro modo, Claude tomaría por su cuenta.

2. Entra en Plan mode antes de un cambio arriesgado

Presiona Shift+Tab hasta que la terminal muestre Plan mode, o inicia con claude --permission-mode plan. Claude podrá leer archivos y ejecutar comandos de solo lectura, pero no modificará tu código fuente. Pídele que trace el flujo actual, identifique los archivos afectados, enumere los riesgos y proponga una verificación.

Examina el plan como si fuera una breve memoria técnica. Corrige cualquier suposición errónea ahora, antes de que se convierta en un parche distribuido en cinco archivos. Aprueba el plan cuando el alcance propuesto y las comprobaciones sean sensatos.

3. Proporciónale una comprobación que pueda ejecutar

Pruebas unitarias, el código de salida de una compilación, un linter, una comparación de fixtures o una captura de pantalla pueden actuar como señal de éxito o fracaso. Sin ella, Claude se detiene en cuanto el trabajo parece verosímil. Con ella, puede leer el fallo e intentar una solución nuevamente.

Para una modificación en el backend, solicita primero una prueba que falle y una suite de pruebas exitosa al terminar. Para un cambio de interfaz, proporciona una imagen de referencia y solicita a Claude que la compare contra una nueva captura. Para una migración, exige un recuento de las llamadas obsoletas restantes. La evidencia se revisa mucho más rápido que una simple afirmación de que el trabajo está listo.

4. Mantén el alcance de los permisos en proporción a la tarea

El modo predeterminado consulta antes de realizar ediciones y la mayoría de los comandos de shell. El modo Accept Edits elimina la solicitud repetida de aprobaciones para editar archivos mientras mantiene protegidas otras acciones. El modo Plan impide modificaciones al código fuente. El modo Auto utiliza comprobaciones de seguridad en segundo plano, pero sigue en fase de vista previa para investigación (research preview).

No uses Bypass Permissions en tu equipo de uso diario. Anthropic restringe ese modo a contenedores aislados o máquinas virtuales porque omite casi todas las confirmaciones. Los permisos tampoco hacen que una instrucción peligrosa sea segura. Las reglas deny, el aislamiento en sandboxes y los hooks son controles mucho más efectivos cuando una ruta o acción deba permanecer vetada.

5. Revisa la evidencia, no cada pulsación de tecla

Pide a Claude que resuma los archivos modificados, muestre git diff, informe el comando exacto de prueba con su resultado e identifique cualquier riesgo no resuelto. Si el trabajo es correcto, pídele que cree un commit o pull request descriptivo. Si la dirección es equivocada, presiona Esc para detenerlo. Presiona dos veces Esc o ejecuta /rewind para regresar a un punto de control previo.

Los puntos de control (checkpoints) cubren las ediciones de archivos realizadas con las herramientas de edición de Claude. No revierten escrituras en bases de datos, despliegues, llamadas a API, modificaciones generadas por Bash ni procesos externos. Mantén a git en el flujo de trabajo en todo momento.

Haz que Claude recuerde el proyecto, no toda la conversación

Un archivo CLAUDE.md es la guía operativa permanente de un repositorio. Claude lo lee al inicio de cada sesión. Ejecuta /init para generar una primera versión y luego conserva únicamente las directrices que Claude no pueda deducir de forma fiable a partir del código.

Buenas inclusiones son el comando de prueba preferido, reglas arquitectónicas atípicas, variables de entorno requeridas, convenciones de ramas y fallos conocidos del proyecto. No incluyas un recorrido archivo por archivo ni consejos genéricos de programación. Anthropic recomienda mantener cada archivo por debajo de las 200 líneas, ya que las instrucciones extensas consumen contexto y reducen el cumplimiento de directrices.

Usa hooks cuando una regla deba ejecutarse obligatoriamente cada vez. "Ejecuta el formateador tras una edición" corresponde a un hook si no se admiten excepciones. Usa skills para procedimientos que solo importan en ocasiones específicas. Emplea MCP cuando Claude requiera acceso a un servicio externo como un gestor de incidencias o un sistema de diseño. Usa subagentes cuando una investigación requiera leer tanto material que saturaría la sesión principal. La guía de subagentes en Claude Code profundiza en este modelo de aislamiento.

El contexto es el recurso escaso. La conversación, el contenido de los archivos, las salidas de comandos, las instrucciones y las definiciones de herramientas compiten por él. Ejecuta /clear entre tareas no relacionadas. Usa /compact cuando la tarea siga siendo la misma pero la sesión se haya vuelto extensa. Reanuda la sesión más reciente con claude --continue, o selecciona una anterior mediante claude --resume.

Ocho casos de uso de Claude Code, ordenados por rendimiento práctico

1. Implementar una funcionalidad delimitada en varios archivos

Un ingeniero de producto que añada autenticación con Google OAuth podría pedirle a Claude que trace el flujo de sesiones actual en Plan mode, identifique cada interfaz afectada, escriba pruebas para los callbacks, implemente la modificación, ejecute la suite de pruebas y prepare el pull request. El beneficio es un trabajo coordinado en rutas, modelos de datos, configuración y pruebas sin tener que alimentar manualmente cada archivo en un chat.

2. Reproducir y solucionar un error en producción

Un ingeniero de guardia con un stack trace podría entregar a Claude el comando de reproducción y el módulo sospechoso. Claude podría ejecutar el fallo, rastrear la ruta de ejecución, escribir una prueba de regresión, aplicar una solución y volver a correr esa suite específica. Esto aporta un alto valor cuando la parte costosa es localizar la causa raíz y no escribir el parche.

3. Incorporar a un ingeniero a un código base desconocido

Un nuevo integrante del equipo podría consultar los puntos de entrada del repositorio, el flujo de datos, la ruta de autenticación, los comandos de despliegue y un glosario de términos internos. Las preguntas posteriores pueden descender desde la arquitectura general hasta una función individual. Esto reduce las interrupciones para el ingeniero senior que de otro modo repetiría la misma explicación.

4. Modernizar código heredado repetitivo

Un equipo de plataforma en proceso de migración de una API obsoleta podría encomendar a Claude que localice cada uso, proponga un lote pequeño, preserve la compatibilidad, modifique el primer grupo, ejecute pruebas focalizadas y cuente los usos restantes. Los incrementos pequeños y verificados son esenciales aquí. Una petición general de "moderniza el repositorio" abre demasiado margen para fallos inadvertidos.

5. Reducir la deuda técnica en pruebas

El mantenedor de un proyecto podría pedir a Claude que identifique ramas de código sin cobertura en un servicio concreto, analice el estilo de pruebas existente, agregue casos para las rutas de mayor riesgo y ejecute únicamente la suite pertinente. El beneficio no es la cantidad de pruebas generadas, sino un proceso repetible que va desde un comportamiento descubierto sin cobertura hasta la evidencia de que la nueva prueba falla por la razón adecuada y pasa tras la corrección.

6. Preparar un pull request más limpio

Antes de solicitar una revisión, un desarrollador podría pedir a Claude que examine el diff actual, elimine modificaciones accidentales, ejecute linters y pruebas, resuma el cambio de comportamiento, evalúe riesgos y redacte una descripción para el PR. Quienes revisan reciben un cambio más reducido y mejor documentado en lugar de tener que reconstruir la intención original a partir del parche.

7. Mantener la documentación alineada con el código

Un equipo de relaciones con desarrolladores o de plataforma podría orientar a Claude hacia una API modificada y solicitarle que actualice ejemplos, instrucciones del README y notas de la versión, para luego verificar que cada comando mencionado se ejecute sin errores. Los usuarios consultan a los asistentes de IA por "code documentation generator" unas 81 veces al mes (frente a 49 un año antes), a pesar de que la consulta exacta en Google es mucho menor. Esta brecha sugiere que la tarea se expresa frecuentemente dentro de conversaciones con IA en lugar de formularios de búsqueda.

8. Automatizar tareas repetitivas del repositorio

Un responsable de ingeniería podría convertir la auditoría de dependencias, la redacción de notas de versión o el triaje matutino de pull requests en una rutina programada, una tarea de escritorio o un comando de CI utilizando el modo no interactivo claude -p. El beneficio es la constancia en labores importantes que suelen posponerse. Las tareas desatendidas requieren permisos más estrictos y un destino de salida explícito, ya que no habrá ninguna persona disponible para aclarar dudas.

Tres productos que vale la pena construir alrededor de Claude Code

El mercado general de asistentes de código ya se encuentra saturado. Los productos viables consisten en capas de control focalizadas que dominan un flujo de trabajo costoso, conservan evidencia y ofrecen al comprador un motivo para preferirlos antes que abrir Claude Code directamente.

La opción más sólida: un filtro vertical de riesgos para PR

Construye un revisor enfocado en una categoría de fallo crítica y costosa, como errores de autorización en APIs fintech, migraciones inseguras en software sanitario o cambios incompatibles en una plataforma TypeScript. Inspeccionaría el pull request contra las políticas específicas del repositorio, ejecutaría comprobaciones autorizadas y devolvería evidencia a nivel de archivo en lugar de observaciones genéricas de estilo. Los líderes de ingeniería y los equipos sujetos a cumplimiento normativo son los compradores idóneos.

La demanda es menor que la de programación general, pero mucho más definida. "AI code review" registra cerca de 1,300 búsquedas mensuales en Estados Unidos, con un CPC de $63.85. "AI powered code review platform" añade 1,600 búsquedas al mes y ha aumentado un 3,173% interanual. Greptile cobra $30 por usuario al mes en su plan de revisión de código, lo que demuestra que los equipos ya aceptan una tarifa recurrente por usuario para este cometido.

La versión mínima comercializable consta de una integración con GitHub, un lenguaje o framework, cinco comprobaciones de alto valor, un comentario de revisión fundamentado con evidencia y una nueva ejecución tras aplicar el parche. El ciclo de agentes de Claude Code o el Claude Agent SDK pueden gestionar la inspección del repositorio y la ejecución de herramientas. Tu producto real radica en el paquete de políticas, el conjunto de evaluación y el registro de auditoría.

El obstáculo es la competencia directa de revisores generalistas y plataformas de desarrollo. Un "revisor de IA" genérico carece de ventaja competitiva defendible. Esta oportunidad solo es la más sólida si el producto detecta fallos específicos de dominio que un revisor general no identifica y demuestra ese rendimiento mediante una batería de pruebas actualizada.

Un kit de despliegue de Claude Code para equipos

Desarrolla una capa guiada de configuración y políticas para responsables de ingeniería que implementan Claude Code en múltiples repositorios. Realizaría una auditoría de la instalación, generaría un CLAUDE.md conciso inicial, propondría reglas de permisos, instalaría hooks validados, guiaría una tarea inicial en el repositorio y produciría una lista de control de adopción lista para administradores.

La consulta exacta sobre cómo utilizar la herramienta genera 6,600 búsquedas al mes en Estados Unidos con un CPC de $5.71; sin embargo, los datos de citas de ChatGPT actualmente no arrojan fuentes citadas para este término. Un curso dedicado a Claude Code ya cobra un pago único de $50, mientras que Claude Pro cuesta $20 al mes. Esta combinación evidencia tanto fricción en el aprendizaje como una disposición moderada al pago.

Un producto mínimo viable podría consistir en una CLI local junto con un flujo guiado de 60 minutos para un stack tecnológico específico. Vende la primera versión como un servicio de implementación y transforma luego las comprobaciones recurrentes en software. El riesgo reside en que un simple tutorial queda obsoleto a medida que Anthropic perfecciona su proceso de bienvenida (onboarding). El valor perdurable debe apoyarse en las políticas corporativas, la configuración de repositorios y métricas de adopción, no en capturas de pantalla del flujo de instalación.

Un operador de programación para un stack vertical

Crea un asistente de desarrollo delimitado para trabajos recurrentes de agencia, tales como el mantenimiento de temas en Shopify, la reparación de plugins de WordPress o un framework concreto de herramientas internas. El cliente envía un ticket con alcance definido, revisa el plan propuesto y recibe un pull request verificado bajo los patrones estándar de ese stack.

"AI coding assistant" acumula unas 22,200 búsquedas mensuales en Estados Unidos con intención comercial y un CPC de $27.85. La consulta más especializada "agentic AI coding assistant" añade otras 2,900 búsquedas con intención transaccional. La escala del mercado es evidente, pero los asistentes generalistas ya abarcan el caso de uso común.

El MVP debería admitir un framework, una plataforma de alojamiento de repositorios, una suite de verificación y una fase de aprobación. Diseña la capa de recepción, políticas y evidencia en torno a Claude Code o el Agent SDK. Los puntos débiles son la dependencia de plataformas de terceros y la responsabilidad civil ante parches defectuosos. Si el producto no logra delimitar una tarea específica que verifique mejor que una sesión general, será solo una interfaz delgada sobre el agente de un tercero.

Qué no resuelve Claude Code

Claude Code no suprime la necesidad de criterio ingenieril. Puede elaborar un parche que supere pruebas muy acotadas y aun así infrinja supuestos del producto, introduzca vulnerabilidades de seguridad o dificulte la operación del sistema. Tus comprobaciones solo detectan las anomalías para las que han sido diseñadas.

Los permisos reducen el alcance accidental de las operaciones, pero no validan tu verdadera intención. Los puntos de control pueden restaurar archivos editados, mas no revierten efectos secundarios remotos ni cambios ejecutados por shell. Asimismo, una sesión extensa tiende a degradarse y volverse más cara conforme se satura el contexto. Limpia tareas no relacionadas, conserva breves las instrucciones del proyecto y recurre a un revisor independiente cuando el cambio sea crítico.

El coste constituye otra variable clave. Claude Code se incluye en los planes de pago, comenzando con Pro a $20 mensuales o $17 al mes mediante prepago anual. El consumo comparte el mismo fondo de recursos que el resto de las interfaces de Claude y no existe un límite fijo de mensajes. Los usuarios de la API pagan en función del consumo de tokens. Si el coste representa un factor determinante, consulta el desglose actualizado de precios de Claude Code antes de estandarizar un flujo de trabajo para tu equipo.

La conclusión directa es sencilla: recurre a Claude Code para tareas con límites bien definidos y criterios de finalización verificables por máquina. Mantén las decisiones de arquitectura, las operaciones delicadas y los equilibrios ambiguos de producto bajo supervisión humana. El agente rinde al máximo cuando puede explorar libremente, actuar dentro de un perímetro acotado y aportar pruebas de lo ejecutado.

Si buscas un agente de desarrollo consciente de repositorios o deseas implementar uno de estos flujos de trabajo verticales en tu empresa, conoce el desarrollo de agentes de IA.