Aprende cómo usar Claude Code paso a paso, desde la instalación hasta los trucos avanzados con MCP, subagentes y hooks. Todo en español, sin atajos, con los comandos exactos que necesitas para empezar a programar con IA en menos de 10 minutos.
Claude Code es la herramienta oficial de línea de comandos (CLI) creada por Anthropic, los mismos creadores del modelo Claude. A diferencia de los editores tradicionales, Claude Code vive directamente en tu terminal: tú le hablas en español natural y él lee tus archivos, escribe código, ejecuta tests y resuelve errores por ti.
Si te preguntas cómo usar Claude Code sin perderte entre documentación en inglés, esta guía está hecha para ti. Aquí vas a aprender el flujo real que usan los desarrolladores profesionales hispanohablantes en 2026, sin rodeos y sin marketing.
Olvídate de copiar y pegar entre ChatGPT y tu editor. Con Claude Code le pides lo que quieres y él modifica los archivos directamente, manteniendo el contexto de todo tu proyecto.
Claude Code puede leer, editar y crear archivos, ejecutar comandos en tu terminal y correr tus tests. Todo con tu permiso explícito en cada paso.
Le puedes hablar en español y te responde en español. Perfecto para revisar código, documentar funciones o aprender frameworks nuevos.
Antes de aprender cómo usar Claude Code, conviene entender por qué se ha vuelto la opción favorita de muchos desarrolladores en 2026. La diferencia clave está en el modelo y en el modo de trabajo.
| Herramienta | Modelo principal | Modo de trabajo | Precio base |
|---|---|---|---|
| Claude Code | Claude Opus 4.7 / Sonnet 4.6 | Terminal + agente autónomo | $20/mes (Pro) |
| Cursor | GPT, Claude (multi-modelo) | Editor (fork de VS Code) | $20/mes |
| GitHub Copilot | GPT-5 / Claude | Autocompletar en editor | $10/mes |
En resumen: si buscas autocompletar mientras escribes, Copilot es suficiente. Si quieres un editor completo con IA integrada, prueba Cursor. Pero si quieres que la IA haga el trabajo por ti mientras tú revisas, Claude Code es la opción más potente.
Instalar Claude Code lleva menos de cinco minutos. Solo necesitas tener Node.js en tu computadora. Si no lo tienes, descárgalo primero desde nodejs.org e instala la versión LTS con la configuración por defecto.
Abre tu terminal (Terminal en Mac, PowerShell en Windows) y ejecuta:
node -v
npm -vSi ves números de versión, estás listo. Si dice "command not found", instala Node.js antes de continuar.
Este es el comando que lo instala para que puedas usarlo desde cualquier carpeta:
npm install -g @anthropic-ai/claude-code
En Mac o Linux, si aparece un error de permisos, agrega sudo al inicio:
sudo npm install -g @anthropic-ai/claude-codeNavega a la carpeta de tu proyecto y ejecuta:
cd mi-proyecto
claudeLa primera vez te pedirá iniciar sesión. Tienes dos opciones para autenticarte y empezar a usar Claude Code de verdad.
$20/mes con uso generoso. Recomendado si vas a usar Claude Code a diario. Necesitas tarjeta internacional y, dependiendo de tu país, una VPN.
Pagas por uso (tokens). Útil si solo lo vas a probar. Crea tu key en console.anthropic.com y exporta la variable ANTHROPIC_API_KEY.
En América Latina y España, la suscripción Pro es la opción más sencilla. Si tienes problemas de pago, también puedes usar proveedores compatibles como Z.AI (GLM) con la herramienta cc-switch.
Una vez dentro de Claude Code, la mayoría de las cosas se hacen escribiendo en lenguaje natural. Pero hay un puñado de comandos especiales (los slash commands) que te conviene memorizar desde el primer día.
| Comando | Para qué sirve | Cuándo usarlo |
|---|---|---|
/help | Lista todos los comandos disponibles | Cuando no recuerdas algo |
/clear | Borra el historial de la conversación actual | Al empezar una tarea nueva sin contexto previo |
/compact | Resume la conversación para liberar contexto | Cuando llevas muchas vueltas y va lento |
/init | Crea un archivo CLAUDE.md con la documentación de tu proyecto | La primera vez que abres un repo nuevo |
/model | Cambia entre Opus, Sonnet o Haiku | Tareas simples → Haiku, tareas complejas → Opus |
/cost | Muestra cuánto has gastado en la sesión | Si usas la API por tokens |
Shift + Tab | Activa el modo Plan (planifica antes de ejecutar) | Antes de cambios grandes o destructivos |
Estos son los tres patrones más útiles cuando empiezas a usar Claude Code en proyectos reales:
Cuando ya domines lo básico, hay tres funciones avanzadas que multiplican el valor de Claude Code. Pocos tutoriales en español las explican bien, así que aquí va el resumen práctico.
MCP (Model Context Protocol) es el sistema que permite a Claude Code hablar con servicios externos: tu base de datos, GitHub, Linear, Notion, Slack, e incluso navegadores. Instalas un servidor MCP una vez y desde ese momento Claude puede leer issues de tu Linear, hacer queries a tu Postgres o subir comentarios a un PR de GitHub sin que tú abras una sola pestaña.
Para añadir un MCP, edita tu archivo de configuración o usa el comando:
claude mcp add <nombre> <comando>Los subagentes son agentes secundarios que Claude Code lanza en paralelo para tareas específicas: revisar código, ejecutar tests, buscar archivos, hacer auditorías de seguridad. Cada subagente tiene su propio contexto y su propio conjunto de herramientas, lo cual te permite mantener limpio el contexto principal.
Por ejemplo, si le pides a Claude Code que "revise toda la carpeta backend y encuentre vulnerabilidades", él lanzará un subagente especializado que devolverá un resumen, sin saturar tu conversación con miles de líneas de código.
Los hooks son scripts que se ejecutan automáticamente en eventos clave: antes de un commit, después de editar un archivo, cuando se hace una llamada a una herramienta. Es la forma más limpia de hacer que Claude Code respete las convenciones de tu equipo: formatear el código con Prettier, correr tests al modificar un test file, o mandar una notificación a Slack cuando termine una tarea larga.
Para configurar hooks, edita el archivo .claude/settings.json de tu proyecto.
/init y deja que Claude lea todo y genere un CLAUDE.md con la arquitectura, los comandos y los puntos clave.
Claude Code es gratis como software, pero necesitas pagar por el modelo de IA que lo impulsa. Estas son las opciones reales si quieres usar Claude Code seriamente:
| Plan | Precio | Para quién |
|---|---|---|
| Claude Pro | $20/mes | Uso individual diario |
| Claude Max | $100/mes | Uso intensivo, varias horas al día |
| API (pago por uso) | ~$3-15 por millón de tokens | Equipos o uso esporádico |
| GLM via cc-switch | Variable (CNY) | Usuarios sin tarjeta internacional |
Sí. Claude entiende y responde en español de forma natural. Solo háblale en español y te contestará igual. Para mejores resultados con código, escribe los nombres de variables y funciones en inglés (es la convención estándar) pero los comentarios y explicaciones pueden ir en español.
Sí. Claude Code funciona en Windows, Mac y Linux. En Windows lo ideal es usarlo desde WSL2 o desde PowerShell. La instalación es la misma: npm install -g @anthropic-ai/claude-code.
El plan Pro de Claude cuesta $20/mes y es suficiente para la mayoría de desarrolladores. Si lo usas muchas horas al día, conviene el plan Max ($100/mes). Si solo lo quieres probar, puedes pagar por uso con la API.
Claude Code te pide permiso explícito antes de cada acción que modifica algo. Puedes configurar permisos por proyecto en el archivo .claude/settings.json y limitar qué carpetas puede tocar. Para datos sensibles, usa el modo Plan para revisar todo antes de ejecutar.
Pulsa Shift + Tab dos veces. Verás un indicador en la parte inferior. En este modo, Claude planifica los cambios y te muestra el plan antes de tocar ningún archivo. Es esencial para refactorizaciones grandes.
Opus 4.7 es el modelo más potente y razona mejor en problemas complejos, pero es más lento y caro. Sonnet 4.6 es más rápido y barato, ideal para el día a día. Cambia entre ellos con el comando /model.
Técnicamente sí, pero no es recomendable. Claude Code es una herramienta para acelerar a desarrolladores, no para reemplazarlos. Necesitas entender lo que hace para revisar el código que genera.
El software es gratis, pero el modelo de IA no. Puedes probarlo con créditos gratis de la API de Anthropic al registrarte. Para uso continuo necesitas suscripción Pro o créditos API.
Ya conoces lo básico. Ahora abre tu terminal, instala Claude Code y prueba un comando real en un proyecto pequeño. La curva de aprendizaje es cuestión de minutos, no de días.
Volver a las instrucciones de instalación