Guía CLI de Claude Code: Comandos, Configuración y Mejores Prácticas

Author Avatar
Andrew
AI Perks Team
12,104
Guía CLI de Claude Code: Comandos, Configuración y Mejores Prácticas

Resumen rápido: Claude Code CLI es un asistente de codificación basado en terminal impulsado por IA que comprende toda su base de código, edita archivos, ejecuta comandos e se integra con herramientas de desarrollo a través del lenguaje natural. Está disponible como una interfaz de línea de comandos, extensión IDE, aplicación de escritorio e interfaz web, compatible con flujos de trabajo automatizados, revisión de código y operaciones de git directamente desde su terminal.

Las interfaces de línea de comandos nunca han sido tan inteligentes. Claude Code transforma la terminal de un lugar donde se escriben comandos arcanos en un espacio de trabajo interactivo donde el lenguaje natural se une a la ejecución de código. Esto no es otro chatbot atascado en una barra lateral, es una herramienta de codificación agentiva que vive donde los desarrolladores realmente trabajan.

La herramienta lee toda su base de código, comprende el contexto del proyecto, edita varios archivos simultáneamente y ejecuta comandos en su nombre. Creado por Anthropic, Claude Code se ejecuta localmente en su terminal mientras se conecta a la API de Claude para procesar solicitudes. ¿El resultado? Un asistente de codificación que maneja tareas rutinarias, explica código complejo y administra flujos de trabajo de git a través de comandos conversacionales.

¿Qué hace diferente a Claude Code CLI?

Los asistentes de codificación de IA tradicionales ofrecen sugerencias de autocompletado o responden preguntas en una ventana de chat. Claude Code opera en un nivel completamente diferente. Es un sistema agentivo, lo que significa que puede planificar tareas de varios pasos, ejecutarlas de forma autónoma y adaptarse en función de los resultados.

La CLI lee la estructura de su proyecto, comprende las relaciones entre archivos y mantiene el contexto de la conversación entre sesiones. Cuando se le pide que corrija un error, Claude Code no solo sugiere código. Identifica el problema, modifica los archivos relevantes, ejecuta pruebas para verificar la corrección e incluso puede confirmar los cambios en git.

Según la documentación oficial, Claude Code se integra con terminales, IDE (VS Code y JetBrains), aplicaciones de escritorio, navegadores y canalizaciones CI/CD. Esta flexibilidad significa que los desarrolladores pueden iniciar una tarea localmente y continuar desde el móvil, o automatizar las revisiones de PR mientras codifican en su entorno preferido.

Instalación y configuración

Poner Claude Code en funcionamiento lleva minutos. El proceso de instalación varía ligeramente según la plataforma, pero los pasos principales siguen siendo consistentes en Windows, macOS y Linux.

Requisitos del sistema

Antes de la instalación, verifique que el sistema cumpla con los requisitos básicos. Claude Code se ejecuta en versiones recientes de Windows, macOS y la mayoría de las distribuciones de Linux. Alpine Linux y los sistemas basados en musl requieren dependencias adicionales según la documentación de configuración avanzada.

La herramienta se actualiza automáticamente por defecto, obteniendo la última versión a través de canales de lanzamiento configurables. Los equipos que necesitan control de versiones pueden deshabilitar las actualizaciones automáticas y administrar las instalaciones manualmente.

Proceso de instalación rápida

La instalación comienza descargando el binario nativo para su plataforma. La documentación oficial proporciona instaladores específicos de la plataforma que manejan las dependencias automáticamente.

Después de la instalación, la autenticación conecta su CLI local a la API de Anthropic. Ejecute el comando de autenticación y siga las instrucciones para vincular su cuenta de Anthropic. El proceso almacena las credenciales de forma segura en el llavero de su sistema.

Flujo de trabajo de instalación de Claude Code CLI desde la descarga hasta la primera sesión

La verificación confirma que todo funciona correctamente. El comando de verificación de instalación valida el binario, comprueba el estado de autenticación y asegura que todas las dependencias estén presentes.

Comandos esenciales de la CLI

La estructura de comandos de Claude Code equilibra la simplicidad con la potencia. Los comandos básicos le permiten empezar de inmediato, mientras que las banderas avanzadas permiten flujos de trabajo complejos.

Inicio de sesiones

El comando más simple inicia una sesión interactiva. Simplemente escriba claude en su terminal. Esto inicia una conversación en la que Claude puede leer su base de código, editar archivos y ejecutar comandos.

Para tareas únicas, pase una indicación directamente: Claude "explain this project" inicia una sesión con ese mensaje inicial. La bandera -p ejecuta una consulta y sale inmediatamente, perfecta para scripting.

ComandoComportamientoCaso de uso
claudeIniciar modo interactivoTrabajo de desarrollo general
claude "tarea"Sesión con indicación inicialEjecución de tareas enfocadas
claude -p "consulta"Consulta única, luego salirPreguntas rápidas, scripts
cat archivo | claude -p "analizar"Procesar contenido canalizadoAnálisis de registros, depuración
claude -cContinuar sesión anteriorReanudar trabajo interrumpido

Gestión de conversaciones

La bandera -c continúa su conversación más reciente. El contexto persiste entre sesiones: Claude recuerda de qué se habló, qué archivos se editaron y qué comandos se ejecutaron.

Para trabajar en varias funciones simultáneamente, la bandera --worktree crea worktrees de git aislados. Cada worktree mantiene un estado de archivo independiente mientras comparte el historial de git, evitando que las instancias de Claude interfieran entre sí.

Banderas avanzadas

Varias banderas modifican el comportamiento de Claude Code. La bandera --ide se conecta automáticamente a su IDE si está disponible. La bandera --from-pr inicia una sesión vinculada a una solicitud de extracción específica, lo que permite flujos de trabajo de revisión de código automatizados.

Las banderas de indicación del sistema alteran las instrucciones de Claude. Estas opciones avanzadas permiten a los equipos personalizar el comportamiento para flujos de trabajo específicos o aplicar estándares organizacionales.

Trabajar con Claude Code en la práctica

Comprender los comandos es una cosa. Usarlos de manera efectiva requiere comprender cómo Claude Code piensa sobre el código.

Modos de ejecución

Claude Code opera en diferentes modos según la tarea. El modo Plan describe los pasos antes de ejecutar. El modo Preguntar espera confirmación antes de realizar cambios. El modo Edición automática realiza los cambios aprobados automáticamente.

Las discusiones de la comunidad de usuarios experimentados indican pasar un tiempo considerable en el modo de planificación para refinar los enfoques antes de la ejecución. Este flujo de trabajo evita errores y asegura que Claude comprenda la tarea correctamente.

Comprensión del contexto y la base de código

Claude Code lee toda la estructura de su proyecto al comienzo de cada sesión. Identifica lenguajes de programación, marcos de trabajo, herramientas de compilación y dependencias. Este contexto informa cada sugerencia y edición.

La herramienta utiliza complementos de inteligencia de código para lenguajes tipados, proporcionando una navegación de símbolos precisa en lugar de una búsqueda basada en texto. Esto reduce las lecturas innecesarias de archivos al explorar código desconocido.

Cómo Claude Code procesa tareas desde el análisis de la base de código hasta la ejecución

Operaciones de archivo e integración de Git

Claude Code edita archivos directamente, mostrando las diferencias antes de aplicar los cambios. Los desarrolladores revisan las modificaciones propuestas y las aprueban o rechazan. La herramienta maneja varios archivos en una sola operación, manteniendo la consistencia en los cambios relacionados.

La integración de Git es nativa. Claude puede crear ramas, confirmar cambios con mensajes descriptivos, enviar a repositorios remotos e incluso crear solicitudes de extracción a través de la integración de la CLI de GitHub. La bandera --from-pr permite la revisión de código automatizada, donde Claude analiza los cambios de PR y sugiere mejoras.

Configuración y personalización

Claude Code admite la configuración en múltiples ámbitos: administrado (en todo el sistema), usuario (configuración personal), proyecto (nivel de repositorio) y local (específico de la máquina). La configuración se aplica en cascada, con ámbitos más específicos que anulan los más generales.

Archivos de configuración

La configuración reside en archivos JSON. La configuración del usuario se encuentra en ~/.claude/, la configuración del proyecto en .claude/ dentro del repositorio. Los equipos confirman la configuración del proyecto en el control de versiones, lo que garantiza un comportamiento consistente para todos los colaboradores.

La configuración disponible controla los permisos, el aislamiento, la selección del modelo, los atajos de teclado y la personalización de la interfaz de usuario. La documentación de configuración detalla cada opción y su alcance.

Permisos y seguridad

Las reglas de permisos definen a qué puede acceder Claude Code. Los desarrolladores especifican directorios permitidos, archivos excluidos y restricciones de comandos. Esto evita que la herramienta acceda a datos confidenciales o ejecute operaciones peligrosas.

La configuración de aislamiento agrega otra capa de seguridad. Los prefijos de ruta limitan las operaciones de archivo a directorios específicos, lo cual es útil cuando se trabaja en varios proyectos o en entornos compartidos.

Gestión de costos y uso de tokens

Claude Code consume tokens de API con cada solicitud. Las bases de código más grandes y las tareas complejas utilizan más tokens. El comando /cost muestra el uso de la sesión actual y los costos estimados.

Según la documentación de gestión de costos, los equipos pueden reducir el uso de tokens administrando el contexto de manera proactiva, eligiendo los modelos apropiados, reduciendo la sobrecarga del servidor MCP e instalando complementos de inteligencia de código. La búsqueda de herramientas pospone automáticamente las descripciones de las herramientas cuando exceden el 10% de la ventana de contexto, cargando las herramientas según sea necesario en lugar de mantener todas las definiciones en contexto.

En promedio, Claude Code cuesta aproximadamente entre $100 y $200 por desarrollador al mes con Sonnet 4.6, aunque los costos varían significativamente según los patrones de uso.

Tamaño del equipoTPM por usuarioRPM por usuario
1-5 usuarios200k-300k5-7
5-20 usuarios100k-150k2.5-3.5
20-50 usuarios50k-75k1.25-1.75
50-100 usuarios25k-35k0.62-0.87
100-500 usuarios15k-20k0.37-0.47

Las recomendaciones de límites de tasa varían según el tamaño del equipo. Los equipos más pequeños pueden asignar más tokens por minuto (TPM) y solicitudes por minuto (RPM) por usuario, mientras que las organizaciones más grandes distribuyen los límites de manera más conservadora.

Accede a créditos de IA antes de ejecutar Claude Code CLI a escala

Trabajar con Claude Code CLI a menudo implica un uso continuo de la API, especialmente al crear scripts, automatizaciones o flujos de trabajo de desarrolladores en torno a LLM. Los costos pueden aumentar rápidamente a medida que crece el uso, y muchos desarrolladores o equipos comienzan a pagar el precio completo sin verificar si hay créditos disponibles.

Get AI Perks agrega créditos y descuentos para más de 200 herramientas de IA, nube y desarrollador en un solo lugar, con un valor total disponible que supera los $7 millones en programas. Por ahora, los desarrolladores pueden acceder a ofertas como $500 en créditos de Anthropic para fundadores y hasta $15,000 en créditos de Claude para participantes seleccionados. La plataforma muestra las condiciones, la probabilidad de aprobación y cómo postularse, para que los desarrolladores puedan ver rápidamente qué programas valen la pena seguir. 

 Antes de escalar su uso de Claude o integrarlo más profundamente en su flujo de trabajo, consulte Get AI Perks y reclame cualquier crédito para el que califique primero.

Integración con herramientas de desarrollo

Claude Code se extiende más allá de la terminal. La extensión VS Code lleva Claude al editor con diffs en línea, referencias de archivos a través de menciones @ y atajos de teclado. Los IDE de JetBrains obtienen una integración similar.

La extensión de Chrome permite depurar aplicaciones web en vivo. La aplicación de escritorio proporciona una interfaz independiente para equipos que prefieren GUI sobre CLI. Control remoto permite a los desarrolladores continuar sesiones en varios dispositivos: comience a trabajar en el escritorio, continúe desde el móvil.

La integración CI/CD automatiza los flujos de trabajo. GitHub Actions y GitLab CI/CD pueden activar Claude Code para revisiones de PR, triaje de problemas y pruebas automatizadas. La integración de Slack enruta los informes de errores directamente a las solicitudes de extracción.

Mejores prácticas de la comunidad

Los patrones de uso en el mundo real revelan estrategias efectivas. Las experiencias de los usuarios de repositorios comunitarios destacan varias prácticas:

Dedique tiempo a refinar los planes antes de la ejecución. La fase de planificación determina el éxito: apresurarse en las ediciones sin una dirección clara lleva a la pérdida de tokens y a malos resultados.

Use puntos de control para tareas largas. Claude Code admite puntos de control que guardan el estado de la conversación, lo que permite la recuperación si las sesiones fallan o necesitan una pausa.

Personalice la línea de estado. Los usuarios avanzados configuran pantallas de estado que muestran el modelo, el directorio, la rama de git, los archivos no confirmados y el uso de tokens. Esta información ayuda a monitorear el consumo de contexto en tiempo real.

Aproveche los hooks y las habilidades. Los hooks son scripts que se ejecutan en puntos específicos del flujo de trabajo (inicio de sesión, antes de editar, después de ejecutar comandos). Las habilidades son instrucciones reutilizables que se almacenan por separado de la indicación principal. Ambos reducen la repetición y mejoran la consistencia.

Preguntas frecuentes

¿Cuánto cuesta Claude Code?

Según la página oficial de precios, Claude Code está incluido en el plan Pro por $17 al mes con suscripción anual (o $20 si se factura mensualmente). El plan Gratuito incluye Claude Code con uso limitado. Los precios de la API varían según el modelo: Claude Opus 4.5 cuesta $5 por un millón de tokens de entrada y $25 por un millón de tokens de salida. Consulte la página oficial de precios para conocer las tarifas actuales, ya que cambian con frecuencia.

¿Puede Claude Code funcionar sin conexión?

No. Claude Code requiere una conexión a Internet para comunicarse con la API de Anthropic. La herramienta se ejecuta localmente pero envía solicitudes a los servidores en la nube para su procesamiento. Los equipos con requisitos estrictos de conexión sin conexión no pueden usar Claude Code en su forma actual.

¿Claude Code almacena mi código?

Anthropic ofrece cero retención de datos para clientes empresariales. La documentación de uso de datos explica que las conversaciones se pueden configurar para eliminarse inmediatamente después del procesamiento. Las políticas de retención predeterminadas varían según el plan; consulte la documentación actual para obtener detalles específicos.

¿Qué modelos admite Claude Code?

Claude Code funciona con los modelos Claude Opus, Sonnet y Haiku. La selección del modelo equilibra el rendimiento y el costo. Los equipos pueden configurar los modelos predeterminados en la configuración o cambiar de modelo a mitad de sesión. La documentación de configuración del modelo cubre las opciones disponibles.

¿Pueden varios miembros del equipo usar Claude Code en la misma base de código?

Sí. Los worktrees de Git permiten sesiones paralelas sin conflictos. Cada desarrollador crea un worktree separado para su tarea. La bandera --worktree se encarga de esto automáticamente. La configuración del proyecto garantiza un comportamiento consistente entre los miembros del equipo.

¿Cómo actualizo Claude Code?

Claude Code se actualiza automáticamente por defecto. La herramienta busca nuevas versiones al inicio e las instala automáticamente. Los equipos pueden deshabilitar las actualizaciones automáticas y administrar las versiones manualmente a través de la configuración. Los canales de lanzamiento (estable, beta) controlan qué actualizaciones se instalan.

¿Cuál es la diferencia entre Claude Code y GitHub Copilot?

GitHub Copilot proporciona sugerencias de autocompletado mientras escribes. Claude Code es un sistema agentivo que planifica y ejecuta tareas de varios pasos. Copilot ayuda con líneas o funciones individuales. Claude Code maneja características completas, refactorizaciones, correcciones de errores y automatización de flujos de trabajo. Las herramientas se complementan; muchos desarrolladores usan ambas.

Avanzar con Claude Code

Claude Code representa un cambio en la forma en que los desarrolladores interactúan con los asistentes de codificación de IA. La CLI pone las capacidades agentivas directamente en la terminal, donde el contexto es más rico y los flujos de trabajo son más rápidos.

Empezar lleva minutos. La instalación, la autenticación y la primera sesión se realizan en una sola sesión. Pero el dominio requiere experimentación. Pruebe diferentes modos, configure permisos, configure hooks y personalice la configuración para que coincida con su flujo de trabajo.

La herramienta evoluciona rápidamente. Funciones como subagentes, integración del servidor MCP y puntos de control mejorados amplían las capacidades regularmente. Seguir el registro de cambios oficial le mantiene al día con la nueva funcionalidad.

Para los equipos que consideran la adopción, comience poco a poco. Ejecute Claude Code en un solo proyecto, establezca patrones y luego expanda. Documente su configuración en la configuración del proyecto para que todo el equipo se beneficie de un comportamiento optimizado.

¿Listo para transformar su flujo de trabajo de desarrollo? Descargue Claude Code de la documentación oficial, autentique su cuenta e inicie su primera sesión. El futuro de la codificación es conversacional, y se ejecuta en su terminal.

AI Perks

AI Perks ofrece acceso a descuentos exclusivos, créditos y ofertas en herramientas de IA, servicios en la nube y APIs para ayudar a startups y desarrolladores a ahorrar dinero.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.