Claude Code es el agente de codificación con IA basado en terminal de Anthropic. Escribes lo que quieres en inglés simple, y él lee tu base de código, escribe código, ejecuta comandos, corrige errores y hace commits de cambios — todo desde tu terminal. Sin plugins de IDE. Sin pestañas del navegador. Solo tú y la IA en una ventana de terminal.
A diferencia de Cursor (que funciona dentro de un IDE) o Codex (que funciona en la nube), Claude Code se ejecuta localmente en tu entorno de desarrollo real. Ve tus archivos, tu historial de git y la salida de tu terminal. Esto lo hace más rápido para muchos flujos de trabajo porque no hay cambios de contexto entre la IA y tu código.
Esta guía cubre la instalación, tu primer proyecto, los comandos clave y el flujo de trabajo que hace que Claude Code funcione perfectamente.
| Herramienta | Ideal para | Dónde se ejecuta | Flujo de trabajo |
|---|---|---|---|
| Claude Code | Codificación agentiva interactiva | Terminal local | Tú guías + ejecuta pasos en vivo |
| Cursor | Codificación diaria + ediciones en línea | Dentro del IDE | Diferencias visibles + autocompletado |
| Codex | Tareas delegadas asíncronas | Entorno sandbox en la nube | Enviar tarea → revisar PR después |
Cómo instalar Claude Code
Necesitas Node.js 18+ y una cuenta de Claude (Pro o API).
Paso 1: Instala globalmente vía npm:
npm install -g @anthropic-ai/claude-code
Paso 2: Navega a tu directorio de proyecto:
cd your-project
Paso 3: Ejecuta Claude Code:
claude
La primera vez que lo ejecutes, te pedirá que te autentiques con tu cuenta de Anthropic. Si usas Claude Pro ($20/mes), obtienes una generosa asignación de tokens. Si estás en la API, pagarás por token (verifica las tarifas actuales en nuestra guía de límites de tasa).
Estimación de costos (para que no te sorprendas)
Si usas facturación por API, una sesión típica de 30–60 minutos en un repositorio mediano suele costar $2–$10 dependiendo del modelo + cantidad de iteraciones. Usa /cost regularmente y verifica sesiones largas con el Vibe Coding Cost Calculator.
Tus primeros 5 minutos con Claude Code
Una vez que Claude Code está ejecutándose, estás en una sesión interactiva. La IA tiene acceso a todo tu directorio de proyecto. Empieza con algo simple:
Pídele que explore: Escribe "What is this project? Give me a high-level overview." Claude lee tus archivos clave (package.json, README, puntos de entrada principales) y resume lo que encuentra. Es una buena forma de verificar que entiende la estructura de tu proyecto.
Pídele que encuentre algo: "Where is the authentication logic?" Claude busca en tu base de código y te indica los archivos relevantes. Entiende la estructura del código, no solo coincidencias de texto.
Pídele que cambie algo: "Add input validation to the signup form. Email must be a valid format, password minimum 8 characters." Claude identifica el componente del formulario, escribe la lógica de validación y te muestra la diferencia antes de aplicarla.
La clave: Claude Code opera en tus archivos reales. Cuando hace un cambio, el cambio es real — tus archivos se modifican en disco. Puedes ver los cambios en tu editor, ejecutar pruebas y confirmarlos normalmente.
Comandos Esenciales
Claude Code tiene varios comandos de barra diagonal que controlan su comportamiento:
| Comando | Qué Hace | Cuándo Usarlo |
|---|---|---|
/init | Crea un archivo CLAUDE.md en la raíz de tu proyecto | Antes de tu primera tarea seria en un repositorio |
/compact | Comprime el historial de conversación cerca de los límites de contexto | Sesiones largas; antes de que baje la calidad |
/cost | Muestra tokens usados + costo estimado | Facturación de API, seguimiento de presupuesto |
/clear | Reinicia la conversación manteniendo el contexto | Cambiar entre tareas no relacionadas |
¿Obteniendo valor de esto? Publicamos guías semanales sobre herramientas y flujos de trabajo de codificación con IA. Recíbelas en tu bandeja de entrada →
El archivo CLAUDE.md — El contexto de IA de tu proyecto
El archivo CLAUDE.md es lo más importante en tu flujo de trabajo con Claude Code. Es un archivo markdown en la raíz de tu proyecto que Claude lee al inicio de cada sesión. Piensa en él como instrucciones personalizadas para tu base de código.
Un buen CLAUDE.md incluye:
Resumen del proyecto: Qué hace el proyecto, la pila tecnológica y la arquitectura en 3-5 oraciones.
Convenciones de código: Tus preferencias de formato, convenciones de nomenclatura y patrones a seguir. "Usa componentes funcionales con hooks. Prefiere exportaciones nombradas. Usa Tailwind para estilos."
Archivos clave: Indica a Claude los archivos más importantes que debe entender. "Los modelos de datos principales están en lib/models/. Las rutas de API están en app/api/."
Cosas a evitar: "No modifiques los archivos de migración de la base de datos. No cambies nada en vendor/. Siempre ejecuta pruebas después de modificar archivos api/."
Sin CLAUDE.md, Claude Code produce código genérico que puede no coincidir con el estilo de tu proyecto. Con él, la salida parece código escrito por alguien que ha estado en el equipo durante meses. Esto es ingeniería de contexto en la práctica.
Flujo de trabajo real: Construyendo una funcionalidad
Aquí está cómo uso Claude Code para una sesión típica de desarrollo de funcionalidad:
1. Empieza con el objetivo: "Add a rate limiter to the API. Use Redis. Apply to the /api/submit endpoint with a limit of 10 requests per minute per IP."
2. Deja que Claude planee: Lee el código de API existente, verifica si Redis ya está configurado y propone un enfoque. Revisa el plan antes de que empiece a codificar.
3. Observa cómo trabaja: Claude crea el módulo de limitador de tasa, lo integra en la ruta de API, agrega variables de entorno para la conexión a Redis y escribe una prueba.
4. Prueba: Claude ejecuta las pruebas. Si algo falla, lee el error, ajusta el código y reintenta. Este bucle de iteración es donde los agentes brillan — maneja el ciclo de depuración que normalmente toma múltiples rondas de trabajo manual.
5. Revisa y confirma: Verifica la diferencia. Haz ajustes si es necesario. Confirma. Claude también puede escribir el mensaje de commit si se lo pides.
Para una funcionalidad como esta, Claude Code suele ahorrar 60-70% del tiempo comparado con escribirlo manualmente. Los ahorros reales están en el código boilerplate, el código de integración y la escritura de pruebas — las partes tediosas pero no intelectualmente desafiantes.
Gestión del uso de tokens
Claude Code usa tokens para cada interacción. Sesiones largas en bases de código grandes pueden ser costosas en facturación por API. Aquí hay hábitos que mantienen los costos razonables:
Usa /compact regularmente. No esperes hasta que el contexto esté lleno. Comprime después de completar cada tarea distinta.
Sé específico. "Fix the bug in the login form" es más barato que "Look at the entire application and find any bugs." Las solicitudes específicas significan menos lectura de código.
Usa /clear entre tareas no relacionadas. Si has estado trabajando en el frontend y cambias a migraciones de base de datos, limpia el contexto. El contexto antiguo desperdicia tokens y puede confundir al modelo.
Verifica /cost frecuentemente. Establece un presupuesto mental para cada sesión y compáralo. Una sesión típica de 30 minutos para una funcionalidad cuesta $2-8 en facturación por API.
Para una comparación detallada de costos entre Claude Code y Cursor, ve nuestra comparación real de costos después de 30 días.
Claude Code vs Cursor vs Codex
Guía rápida de decisión:
| Opción | Ideal cuando... | Contrapartida |
|---|---|---|
| Claude Code | Quieres cambios interactivos en todo el repositorio de forma local | Requiere revisión cuidadosa (edita archivos reales) |
| Cursor | Quieres IA dentro de tu IDE + ciclo de edición ajustado | Menos autonomía manos libres que los agentes de terminal |
| Codex | Quieres delegación asíncrona basada en PR | Menos interactivo; el contexto puede desviarse |
Claude Code: Ideal para desarrolladores que quieren contexto de todo el proyecto y flujos de trabajo nativos de terminal. Interactivo, en tiempo real, funciona en tus archivos reales. Mejor para funciones complejas, refactorización y depuración.
Cursor: Ideal para desarrolladores que quieren IA dentro de su IDE. Ve los cambios en tiempo real con diffs en línea. Mejor para codificación diaria con sugerencias de IA. Comparación completa aquí.
Codex: Ideal para equipos que quieren tareas de codificación asíncronas y por lotes. Envía una tarea, revisa el PR después. Mejor para tareas bien definidas que quieres delegar completamente. Comparación completa aquí.
Muchos desarrolladores usan dos o más. Claude Code para funciones complejas, Cursor para edición diaria, Codex para tareas por lotes.
¿Quieres mejorar tus prompts para cualquier herramienta de codificación con IA? The Prompt Optimizer te ayuda a estructurar solicitudes para resultados más claros y específicos.
¿Quieres más como esto? Publicamos semanalmente sobre herramientas de codificación con IA y flujos de trabajo para desarrolladores. Suscríbete gratis →
Preguntas frecuentes
¿Funciona Claude Code en Windows?
Sí, a través de WSL (Windows Subsystem for Linux), PowerShell o Símbolo del sistema. WSL ofrece la mejor experiencia ya que muchas herramientas de desarrollo son nativas de Linux.
¿Puede Claude Code acceder a internet?
Claude Code en sí no navega por la web, pero puede ejecutar comandos que lo hacen — curl, npm install, git clone. También puede usar servidores MCP para acceder a servicios externos como GitHub, bases de datos y APIs.
¿Cómo maneja Claude Code bases de código grandes?
La ventana de contexto de 200K tokens de Claude significa que puede cargar y procesar miles de archivos fuente simultáneamente. Para monorepos muy grandes, lee selectivamente archivos relevantes en lugar de cargar todo. El archivo CLAUDE.md le ayuda a saber qué partes del código importan para cada tarea.
¿Se envía mi código a los servidores de Anthropic?
Sí, tu código se envía a la API de Anthropic para procesamiento. Anthropic no entrena con entradas de API por defecto, pero verifica los términos actuales si trabajas con código sensible o propietario. Considera usar la API con retención de datos desactivada para máxima privacidad.
Divulgación: Algunos enlaces en este artículo son enlaces de afiliados. Solo recomendamos herramientas que hemos probado personalmente y usamos regularmente. Ve nuestra política de divulgación completa.