Guía práctica para empezar con Claude Code desde cero

Claude Code es el agente de programación de Anthropic que trabaja directamente en tu terminal. Te explicamos cómo instalarlo, configurarlo y usarlo en proyectos de desarrollo, con recomendaciones para equipos de América Latina.

Guía práctica para empezar con Claude Code desde cero

Foto: Bernd 📷 Dittrich

Si programas y todavía no probaste Claude Code, estás perdiendo tiempo. No es una exageración: varios desarrolladores reportan que tareas que antes les tomaban una hora ahora las resuelven en cinco minutos. La herramienta de Anthropic es un agente que vive en tu terminal, lee tu proyecto completo, edita archivos, ejecuta comandos y gestiona Git. No es un autocompletado ni un chatbot bonito: es un colega que trabaja con tu base de código como si la conociera de memoria. Para equipos de desarrollo en América Latina, donde los recursos suelen ser ajustados y la presión por entregar rápido es alta, entender cómo adoptar esta herramienta puede marcar una diferencia real en productividad.

Instalación en tres comandos

El método recomendado por Anthropic es el instalador nativo. No requiere Node.js ni dependencias extra, y se actualiza solo en segundo plano. En macOS o Linux, abrí la terminal y ejecutá:

Patrocinado Advertisement

curl -fsSL https://claude.ai/install.sh | bash

En Windows, primero asegurate de tener Git for Windows instalado (Claude Code lo usa internamente para ejecutar comandos). Después, abrí PowerShell y ejecutá:

irm https://claude.ai/install.ps1 | iex

Si preferís usar CMD, el comando cambia ligeramente:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Una vez instalado, verificá con `claude --version`. Si algo falla, el comando `claude doctor` escanea tu entorno y te dice exactamente qué corregir.

Conectar tu cuenta y primera sesión

La primera vez que escribas `claude` en tu terminal, se abrirá el navegador para que inicies sesión con tu cuenta de Anthropic. Necesitás una suscripción de pago: Claude Pro (20 USD/mes) incluye acceso, pero para uso real los límites son bajos. La opción recomendada si vas a trabajar en serio es Claude Max (desde 100 USD/mes) o pagar por API en Anthropic Console. Esto es un punto a considerar para equipos latinoamericanos: el costo en dólares puede ser significativo, pero la ganancia en velocidad de desarrollo puede justificarlo si se usa con criterio.

Después de autenticarte, navegá hasta cualquier proyecto que tengas y ejecutá `claude`. La herramienta lee la estructura del proyecto y queda lista para recibir instrucciones en lenguaje natural. Podés preguntarle "¿qué hace este proyecto?", pedirle que "agregue validación de entrada al formulario de registro" o decirle "hay un bug donde los usuarios pueden enviar formularios vacíos, corregilo". Claude Code no solo responde con texto: modifica archivos, ejecuta pruebas y gestiona commits.

Configuración clave: el archivo CLAUDE.md

De todas las recomendaciones, esta es la más importante y la que menos gente aplica. El archivo `CLAUDE.md` es la memoria de tu proyecto. Le explica a Claude Code qué stack usás, qué convenciones de código seguís, qué comandos correr para tests y qué cosas no querés que haga. Para generarlo automáticamente, dentro de una sesión escribí `/init`. Después personalizalo: incluí la versión de Node o Python, el naming de variables, la estructura de carpetas, y restricciones como "nunca uses lodash" o "no toques los archivos de migración".

Un truco práctico: cada vez que Claude haga algo que no te guste, en vez de corregirlo en el chat, actualizá el `CLAUDE.md`. Así corregís el contexto, no la conversación, y el error no se repite.

Comandos esenciales para el día a día

Dentro de una sesión, escribí `/` para ver todos los comandos disponibles. Estos son los que más vas a usar:

  • `/plan`: modo planificación. Claude analiza el problema, traza un paso a paso y lo muestra antes de tocar código. Para cambios no triviales, úsalo siempre.
  • `/compact`: comprime el contexto de la conversación para liberar espacio en la ventana de contexto. Ideal después de varios turnos de diálogo.
  • `/clear`: borra todo el contexto. Útil cuando cambiás de tarea por completo.
  • `/fast`: modo rápido para iteraciones ágiles y debugging interactivo.
  • `/btw`: permite hacer una pregunta rápida sin que se agregue al historial de la conversación. No interrumpe la tarea principal.
  • `/rewind`: revierte cambios y la conversación a un punto anterior. Claude crea checkpoints automáticos mientras trabajás.

También podés ejecutar tareas únicas desde la terminal sin entrar en modo interactivo: `claude "fix the build error"` o `claude -p "explain this function"`.

Skills y subagentes: personalización avanzada

Las skills son conjuntos de instrucciones empaquetadas en un archivo `SKILL.md` que Claude puede invocar automáticamente o que vos podés llamar con un slash command. Estas te permiten crear atajos para tareas repetitivas específicas de tu proyecto. Por ejemplo, podés definir una skill llamada "refactor-auth" que le indique a Claude cómo reorganizar tu módulo de autenticación siguiendo tus convenciones.

Los subagentes, por su parte, son instancias de Claude Code que se ejecutan con un contexto específico y pueden delegarse tareas. Esto permite orquestar múltiples agentes trabajando en paralelo o en secuencia. La documentación oficial describe un mecanismo de orquestación para tareas complejas que requieren diferentes especializaciones.

Consideraciones para equipos en América Latina

Adoptar Claude Code en la región implica evaluar tres factores. Primero, el costo de las suscripciones en dólares: un plan Max de 100 USD por desarrollador por mes puede representar una inversión significativa para startups locales. Sin embargo, la ganancia en productividad —tareas que pasan de horas a minutos— puede compensar si el equipo está enfocado en entregables de alto valor. Segundo, la conexión a internet: toda la IA corre en servidores de Anthropic, no localmente. Esto exige una conexión estable y de baja latencia, algo que no siempre está garantizado en todas las zonas.

Tercero, la seguridad de los datos: al usar Claude Code, estás enviando tu código fuente a servidores externos. Para proyectos con datos sensibles o propiedad intelectual crítica, esto puede ser un obstáculo.

Antes de implementarlo, asegurate de que tu equipo tenga una política clara sobre qué código puede compartirse con la herramienta y cuál no. El archivo `CLAUDE.md` también puede incluir instrucciones para evitar que Claude acceda a directorios sensibles. Empezá con un proyecto piloto no crítico, medí el tiempo ahorrado, y recién entonces escalá la adopción. Claude Code es una herramienta poderosa, pero como cualquier tecnología de IA, requiere supervisión humana y un uso consciente de los recursos.

Fuentes

  1. Descubre el poder de la automatización: ¿Cómo Claude Code puede revolucionar tu vida?
  2. Inicio rápido - Claude Code Docs
  3. Guía paso a paso de Claude Code: lo que necesitas para empezar
  4. Qué es Claude Code y qué puede hacer esta herramienta para programar con inteligencia artificial desde la terminal de tu ordenador
  5. Sumérgete en Claude Code: El espacio de diseño de los sistemas de agentes de IA actuales y futuros
Henry González

Escrito por

Henry González

Experto en procesos y calidad

Ingeniero industrial con una obsesión por los estándares. Certificado en ISO 9001, ISO 27001 e ISO 42001 — la norma que define cómo las organizaciones deben gestionar la inteligencia artificial de forma responsable. Para Henry, la IA no es solo tecnología sino un sistema que debe auditarse, gobernarse y medirse.