Cómo configurar Claude Code CLI: Inicio rápido en 5 minutos

Más de 29.000 desarrolladores en ServiceNow ya usan Claude Code a diario, y Allianz lo implementó a nivel de toda la empresa a principios de 2026. La curva de adopción de la herramienta refleja un patrón: una vez que los desarrolladores prueban la codificación agéntica en su propia terminal, no vuelven a copiar y pegar desde ventanas de chat. Este inicio rápido lo lleva de cero a una sesión funcional de Claude Code en aproximadamente cinco minutos, con una configuración real que puede seguir usando después.

Resumen: Instale Claude Code con npm install -g @anthropic-ai/claude-code, autentíquese a través de su navegador, cree un archivo CLAUDE.md con el contexto de su proyecto y configure los permisos en .claude/settings.json. Agregue un hook de Prettier para formatear automáticamente los archivos después de cada edición. Toda la configuración toma menos de cinco minutos y la configuración persiste entre sesiones.

Puntos clave

Desarrolladores individuales: CLAUDE.md y un hook de formateo cubren el 80% de lo que necesita. Comience con los permisos predeterminados y pre-apruebe herramientas a medida que genere confianza.
Líderes de equipo: Haga commit de .claude/settings.json en su repositorio para que todo el equipo comparta las mismas listas de permisos y hooks.
Ingenieros de seguridad: El modelo de permisos de tres niveles (predeterminado, pre-aprobado, omitir) se mapea directamente a niveles de confianza. El modo predeterminado requiere aprobación explícita para cada escritura y cada comando.

Requisitos previos

Necesita tres cosas antes de instalar Claude Code:

Node.js 18 o posterior. Claude Code se distribuye como un paquete npm. Verifique su versión:

node --version
# v18.0.0 or higher

Si necesita instalar o actualizar Node.js, use nvm o descárguelo directamente desde nodejs.org.

Una cuenta de Anthropic con acceso a la API. Cree una clave de API en console.anthropic.com en Settings > API Keys. Claude Code cobra contra su saldo de API o plan de suscripción Max. Tenga la clave disponible para el paso de autenticación.

Una terminal. Claude Code funciona en cualquier emulador de terminal: Terminal.app, iTerm2, Windows Terminal, Alacritty o la terminal integrada de VS Code. Recomiendo una terminal con al menos 120 columnas de ancho, ya que Claude Code muestra diffs de archivos y salidas de herramientas que se benefician del espacio horizontal.

Instalación

Instale Claude Code globalmente con npm:

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

Verifique que la instalación fue exitosa:

claude --version

Debería ver un número de versión impreso en stdout. Si obtiene un error de “command not found”, asegúrese de que el directorio global de binarios de npm esté en su PATH. Ejecute npm config get prefix y agregue el subdirectorio /bin de esa salida a su PATH.

En el primer inicio, Claude Code abre su navegador en la consola de Anthropic para autenticación OAuth. Inicie sesión, autorice, y el token se almacena localmente en ~/.claude/. Alternativamente, puede establecer la variable de entorno ANTHROPIC_API_KEY antes de iniciar. De cualquier forma, las credenciales permanecen en su computadora y solo se usan para autenticar solicitudes a la API.

Primera sesión

Navegue a cualquier directorio de proyecto y ejecute:

cd ~/Projects/my-app
claude

Claude Code inicia una sesión REPL interactiva. En el primer inicio en un proyecto nuevo, realiza varias cosas automáticamente:

Escanea la estructura del directorio para comprender la disposición del proyecto
Lee archivos de configuración como package.json, pyproject.toml o Cargo.toml para identificar el stack tecnológico
Busca un archivo CLAUDE.md en la raíz del proyecto para instrucciones específicas del proyecto

Pruebe un prompt simple para confirmar que todo funciona:

> Explain the structure of this project

Claude lee sus archivos, sintetiza la arquitectura y responde en la terminal. Verá las llamadas a herramientas en tiempo real (cada lectura de archivo, cada comando ejecutado) junto con una solicitud de permiso antes de cualquier operación de escritura.

Configuración de CLAUDE.md

CLAUDE.md es el archivo más importante para un uso efectivo de Claude Code. Se ubica en la raíz de su proyecto y contiene instrucciones que Claude lee al inicio de cada sesión. Piense en él como un README para su colaborador de IA.

Cree el archivo:

touch CLAUDE.md

Aquí tiene una plantilla inicial práctica:

# My App

## Project Context
Express.js API with React frontend. PostgreSQL database.

## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit tests, Playwright for e2e

## Code Standards
- Use async/await, never raw Promises
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging

## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations

En mi experiencia, las secciones más valiosas previenen errores repetidos. Si Claude sigue usando CommonJS cuando su proyecto usa ESM, agréguelo a CLAUDE.md. Si hay un comando de prueba específico o un paso de configuración de base de datos, documéntelo. Claude lee CLAUDE.md en cada sesión, así que cualquier cosa que ponga ahí se convierte en una instrucción persistente.

También puede colocar un CLAUDE.md en su directorio home (~/.claude/CLAUDE.md) para instrucciones globales que apliquen a todos los proyectos, y en subdirectorios para contexto que solo aplique a partes específicas de un monorepo.

Conceptos básicos de permisos

Claude Code opera en tres niveles de permisos que determinan cuánta autonomía tiene el agente:

El modo predeterminado solicita permiso antes de cada escritura de archivo, ejecución de comando o acción destructiva. Usted ve exactamente lo que Claude pretende hacer y aprueba o rechaza cada paso. Recomiendo comenzar aquí.

Los permisos pre-aprobados le permiten incluir herramientas y patrones específicos en una lista de permitidos para que Claude no pregunte cada vez. Estos se configuran en el archivo .claude/settings.json de su proyecto:

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npx prisma migrate dev)"
    ]
  }
}

Este ejemplo permite que Claude lea archivos, busque en el código base y ejecute sus comandos de prueba y migración sin preguntar. Aún solicita permiso antes de escribir archivos o ejecutar cualquier otro comando bash.

Omitir permisos peligrosamente (--dangerously-skip-permissions) desactiva todas las solicitudes de confirmación. Esta bandera está destinada exclusivamente a pipelines de CI/CD y flujos de trabajo automatizados donde no hay un humano presente para aprobar. Nunca la use en sesiones interactivas en un código base que le importe.

El sistema de permisos es la razón por la que Claude Code es seguro de usar en proyectos reales. Comience con el modo predeterminado, observe qué aprobaciones se vuelven repetitivas y pre-apruebe selectivamente solo esas operaciones específicas.

Su primer hook

Los hooks son comandos de shell que se ejecutan en puntos específicos del ciclo de vida de Claude Code. Proporcionan garantías determinísticas sobre el comportamiento probabilístico del LLM. Aquí tiene un primer hook práctico: formatear automáticamente los archivos después de que Claude los edite.

Cree o edite .claude/settings.json en su proyecto:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

Este hook se ejecuta después de cada llamada a las herramientas Edit o Write. Claude Code establece $FILE_PATH con el archivo que fue modificado. Prettier lo formatea en el lugar, y || true asegura que el hook no bloquee a Claude si Prettier no está instalado o el tipo de archivo no es compatible.

Otros hooks iniciales prácticos que recomiendo:

PreToolUse en Bash: Bloquee comandos peligrosos como rm -rf / o git push --force
SessionStart: Inyecte la fecha actual, la rama activa de git o variables de entorno en el contexto (la salida stdout de los hooks de SessionStart se alimenta al contexto de Claude)
Stop: Ejecute su suite de pruebas automáticamente cuando Claude termine una tarea

Los hooks transforman Claude Code de una herramienta conversacional a un entorno de desarrollo gobernado. Incluso uno o dos hooks bien elegidos eliminan categorías completas de errores.

Próximos pasos

Este inicio rápido cubre lo esencial: instalación, su primera sesión, configuración del proyecto, permisos y un hook inicial. Para la referencia completa que cubre los 5 sistemas centrales (jerarquía de CLAUDE.md, el modelo completo de permisos, arquitectura de hooks, comandos slash personalizados y flujos de trabajo multi-agente) lea La guía completa de Claude Code.

La guía cubre la gestión de la ventana de contexto, delegación a subagentes, activación automática de habilidades y los patrones que emergen después de meses de uso diario de Claude Code. Si este inicio rápido le fue útil, la guía completa es el siguiente paso natural.

Preguntas frecuentes

¿Cuánto cuesta Claude Code?

Claude Code admite dos modelos de facturación. El modelo de pago por uso de la API cobra por token a las tarifas estándar de la API de Anthropic. Una sesión típica de 30 a 60 minutos cuesta entre $0,50 y $3,00 dependiendo del tamaño del código base y el volumen de generación. Alternativamente, el plan Max de Anthropic ($100/mes individual, $200/mes equipos) incluye el uso de Claude Code con límites de velocidad más altos. Puede monitorear el uso de la API en console.anthropic.com.

¿Puedo usar Claude Code con VS Code?

Sí. Claude Code funciona en cualquier terminal, incluyendo la terminal integrada de VS Code. Abra el panel de terminal en VS Code, navegue al directorio de su proyecto y ejecute claude exactamente como lo haría en una terminal independiente. Claude Code lee y edita archivos en disco, por lo que los cambios aparecen inmediatamente en las pestañas de su editor de VS Code. No se requiere una extensión separada de VS Code. Algunos desarrolladores mantienen un split de terminal dedicado para Claude Code junto a su editor, lo cual funciona bien para revisar los cambios a medida que ocurren.

¿Es seguro usar Claude Code en código base de producción?

El modo de permisos predeterminado de Claude Code solicita aprobación explícita antes de cada escritura de archivo y cada ejecución de comando. Nada cambia en disco sin su confirmación. El sistema de permisos, combinado con hooks que pueden bloquear operaciones peligrosas como force pushes o comandos de shell destructivos, lo hace práctico para trabajo en producción. Uso Claude Code a diario en proyectos que sirven a usuarios reales. La clave es comenzar en modo predeterminado, entender qué hace cada llamada a herramienta antes de aprobarla, y pre-aprobar gradualmente solo las operaciones en las que confía. El control de versiones es su última red de seguridad: haga commit antes de iniciar cualquier sesión significativa de Claude Code para poder siempre revertir.