Claude Code: guía para instalarlo, iniciar sesión y completar tu primera tarea

¿Qué es Claude Code y dónde corre?

Claude Code es la herramienta de codificación agéntica de Anthropic: lee tu repositorio, edita archivos y ejecuta comandos desde tu terminal, tu IDE, una app de escritorio o la web. Instálalo con curl -fsSL https://claude.ai/install.sh | bash, corre claude dentro de tu proyecto e inicia sesión en el navegador. Requiere una cuenta Pro, Max, Team, Enterprise o de Anthropic Console; el plan gratis de Claude.ai no lo incluye.

Lo importante de entrada: no es un autocompletado. Es un agente que planea una tarea, la ejecuta a través de varios archivos, corre tus comandos y verifica el resultado. Y corre en cuatro superficies —terminal (CLI), IDE (VS Code / JetBrains), app de escritorio y web— que comparten el mismo motor. Eso significa que tu CLAUDE.md, tu configuración y tus servidores MCP viajan contigo entre todas ellas: configuras una vez y lo tienes en cualquier lado.

Si vienes de otras herramientas y quieres ubicarte, escribí una comparación entre Claude Code y Cursor. Esta guía es el arranque práctico: instalar, iniciar sesión y completar tu primera tarea real.

Instalar Claude Code: el comando nativo (y Homebrew, WinGet y npm)

La forma recomendada es el instalador nativo. En macOS, Linux o WSL:

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

En Windows con PowerShell:

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

El instalador nativo se actualiza solo en segundo plano, así que no tienes que pensar en el mantenimiento. Si prefieres un gestor de paquetes, también hay opciones. Con Homebrew:

brew install --cask claude-code

Con WinGet en Windows:

winget install Anthropic.ClaudeCode

Y si vives en el ecosistema de Node, puedes usar npm (necesitas Node.js 18 o superior). No lo instales con sudo:

npm install -g @anthropic-ai/claude-code

Para actualizar la instalación de npm más adelante:

npm install -g @anthropic-ai/claude-code@latest

En cuanto a requisitos del sistema: macOS 13+, Windows 10 1809+, Ubuntu 20.04+/Debian 10+, 4 GB de RAM o más, conexión a internet y un shell Bash/Zsh/PowerShell/CMD. En Windows nativo conviene tener Git for Windows instalado para que la herramienta Bash funcione bien.

Iniciar Claude Code e iniciar sesión desde el navegador

Con Claude Code instalado, entra a tu proyecto y arráncalo:

cd your-project
claude

En la primera ejecución te va a pedir iniciar sesión y abrirá el flujo de autenticación en tu navegador. Autorizas la sesión ahí, regresas a la terminal y ya estás dentro. No hay que pegar tokens a mano ni configurar variables de entorno para el caso común: el navegador hace el trabajo.

A partir de ese momento, la sesión queda guardada y las siguientes veces que corras claude en cualquier proyecto entras directo. Este mismo inicio de sesión te sirve para las demás superficies (IDE, escritorio, web), porque comparten el mismo motor y la misma cuenta.

Verifica tu instalación con claude –version y claude doctor

Antes de pedirle nada serio, confirma que quedó bien instalado. Para ver la versión:

claude --version

Y si algo se siente raro —un comando que no responde, un problema de PATH después de instalar, o quieres un diagnóstico general— corre:

claude doctor

claude doctor revisa tu instalación y te dice qué está sano y qué no. Es el primer lugar al que ir cuando algo falla, antes de ponerte a buscar en foros. Con estos dos comandos sabes que tu entorno está listo.

La realidad del acceso: Claude Code necesita un plan de pago

Aquí no hay letra chica, y conviene tenerlo claro antes de instalar: Claude Code requiere una cuenta Pro, Max, Team, Enterprise o de Anthropic Console. El plan gratis de Claude.ai NO incluye Claude Code. Si solo tienes la cuenta gratuita, el inicio de sesión no te va a habilitar la herramienta.

Hay una segunda ruta para equipos que ya operan en un proveedor de nube: puedes correr Claude Code contra Amazon Bedrock, Google Vertex AI o Microsoft Foundry en lugar de la API directa de Anthropic. Es la opción típica cuando tu organización ya centraliza el consumo de modelos en uno de esos proveedores.

Claude Code corre sobre los modelos Claude de Anthropic, y tú eliges el modelo según la tarea (por ejemplo Sonnet 5 para el trabajo diario o Opus 4.8 cuando quieres más capacidad de razonamiento). No hay un único modelo obligatorio: elige el tuyo. Si vas a trabajar por API o quieres entender el panorama de modelos, tengo una guía de cómo usar la API de Claude y una nota de qué cambia en Claude Sonnet 5 y cómo migrar. Los detalles de planes están en claude.com/pricing.

El ciclo central: describe una tarea y Claude Code planea, edita y verifica

El uso diario es sencillo: describes lo que quieres en lenguaje natural y Claude Code se encarga del resto. Lee el código relevante, arma un plan, edita los archivos que hagan falta —a menudo varios a la vez— corre los comandos necesarios y verifica que el resultado sea correcto. Un ejemplo real, ya dentro de la sesión:

Agrega validación de RFC al formulario de registro, actualiza las
pruebas y corre la suite para confirmar que pasan.

Con eso, Claude Code localiza el formulario, escribe la validación, ajusta o crea las pruebas y ejecuta la suite para comprobar. También trabaja con git de forma nativa: puede preparar cambios (stage), hacer commits, crear ramas y abrir pull requests. En la práctica, pasas de “tengo que hacer este cambio” a “revisar el diff que ya está hecho”.

La clave es dar tareas concretas y verificables. En lugar de “mejora el código”, pide “extrae esta lógica a una función, agrega pruebas y corre lint”. Entre más claro el criterio de éxito, mejor el resultado, porque el agente puede verificarse a sí mismo.

Guíalo con CLAUDE.md y la memoria automática

Para que Claude Code trabaje como tu equipo trabaja, dale contexto persistente. Crea un archivo CLAUDE.md en la raíz del proyecto: se lee al inicio de cada sesión. Ahí pones tus estándares de código, la arquitectura, comandos importantes y las convenciones que no son obvias del código. Un ejemplo mínimo:

# Proyecto: API de pagos

## Comandos
- Pruebas: npm test
- Lint: npm run lint

## Convenciones
- TypeScript estricto, sin any.
- Toda función pública lleva pruebas.
- Los montos se manejan en centavos, nunca en flotantes.

Además del CLAUDE.md que tú escribes, Claude Code construye su propia memoria automática a medida que trabaja en tu repo, así que va acumulando contexto sesión tras sesión. La combinación —tus reglas explícitas más lo que aprende solo— es lo que hace que deje de cometer los mismos errores y respete tu estilo sin que se lo repitas cada vez.

Mantén el control con permisos y modo plan

Un agente que edita archivos y corre comandos necesita frenos, y Claude Code los trae. Con el sistema de permisos, te pide autorización antes de acciones sensibles como escribir archivos o ejecutar comandos, y tú decides caso por caso o apruebas de forma amplia según tu confianza.

El modo plan va un paso antes: Claude Code te muestra el plan completo de lo que piensa hacer —qué archivos tocará, qué comandos correrá— y espera tu visto bueno antes de mover un solo archivo. Es ideal para cambios grandes o en código que no conoces: revisas la estrategia, ajustas lo que haga falta y recién entonces lo dejas ejecutar. Entre permisos y modo plan, nunca te sorprende: tú apruebas antes de que actúe.

Ir más allá: MCP, subagentes, hooks y modo headless en CI

Cuando ya te sientas cómodo con el ciclo básico, hay varias capas para exprimir la herramienta:

• MCP (Model Context Protocol): conecta tus propias herramientas y fuentes de datos —bases de datos, APIs internas, servicios— para que Claude Code trabaje con tu contexto real, no solo con el código. Escribí una guía de cómo conectar un agente de IA a tus datos con MCP.
• Skills: empaqueta flujos repetibles como comandos, por ejemplo /review-pr, para estandarizar tareas comunes de tu equipo.
• Hooks: ejecuta comandos de shell antes o después de una acción, como formatear el código automáticamente después de cada edición.
• Subagentes / equipos de agentes: lanza varios agentes en paralelo con un líder que los coordina, útil para tareas grandes que se pueden dividir. Si quieres profundizar, tengo una nota sobre construir un agente autónomo con Sonnet 5.
• Modo headless / CI: corre Claude Code sin interfaz interactiva para automatizar. Le pasas la tarea directo y hasta puedes canalizar logs por stdin:

claude -p "resume estos errores y propone un fix" < build.log

Este modo claude -p es lo que te permite integrarlo en GitHub Actions o GitLab CI/CD: revisiones automáticas, triaje de fallos, generación de cambios dentro del pipeline. Si automatizas fuera del repo, también combina bien con orquestadores como en automatizar con n8n y Claude.

Tu checklist para la primera tarea con Claude Code

Para cerrar, este es el camino mínimo del cero a tu primer cambio entregado:

1. Instala con el comando nativo: curl -fsSL https://claude.ai/install.sh | bash (o Homebrew/WinGet/npm).
2. Verifica con claude --version y, si algo falla, corre claude doctor.
3. Confirma tu acceso: necesitas cuenta Pro, Max, Team, Enterprise o Console (el plan gratis no basta).
4. Entra a tu proyecto con cd your-project, corre claude e inicia sesión en el navegador.
5. Crea un CLAUDE.md con tus comandos y convenciones.
6. Dale una tarea concreta y verificable (edita, corre pruebas, confirma que pasan).
7. Usa modo plan y permisos para revisar antes de que actúe.

Con eso ya tienes el ciclo completo: instalación, autenticación y una primera tarea real terminada. A partir de ahí, agrega MCP, skills y CI cuando los necesites. La documentación oficial vive en code.claude.com/docs, y si quieres ubicar a Claude Code dentro del panorama de agentes, pasa por el hub de agentes de IA.