Para empezar a usar Claude Code, tu entorno necesita Node.js, específicamente la versión 18 o superior. Puedes verificar tu versión actual ejecutando node -v en tu terminal. Si cumples con este requisito, la instalación es sencilla.

El método recomendado es a través de npm, el gestor de paquetes de Node.js. Esto facilita la gestión de versiones y actualizaciones.

Si prefieres no usar npm o no tienes Node.js instalado, puedes usar curl para descargar un instalador nativo para tu sistema operativo. Este método es más directo pero requiere gestión manual para futuras actualizaciones.

Una vez instalado el CLI, el siguiente paso es conectar tu cuenta de Anthropic. Este proceso de autenticación vincula tu terminal con tu cuenta, permitiéndote interactuar con los modelos de Claude de forma segura.

Ejecuta el siguiente comando en tu terminal:

Este comando abrirá automáticamente una nueva pestaña en tu navegador, solicitándote que inicies sesión en tu cuenta de Anthropic. Tras una autenticación exitosa, el CLI almacenará un token de acceso de forma segura en tu máquina local. No necesitas volver a hacer esto a menos que el token expire o lo revoques.

Ahora que estás autenticado, puedes empezar a trabajar en un proyecto. Para Claude, un "proyecto" es simplemente un directorio en tu sistema de archivos. Para que Claude entienda el contexto de tu trabajo, como la estructura de carpetas de una campaña de marketing digital o las API de Shopify, necesitas inicializar el directorio.

Navega hasta el directorio raíz de tu proyecto y ejecuta:

Este comando crea un archivo crucial: CLAUDE.md. Este fichero es el manual de instrucciones del proyecto para Claude. Aquí es donde le explicas el objetivo del proyecto, las tecnologías utilizadas (por ejemplo, Google Ads API, Meta Marketing API), las convenciones de codificación y la ubicación de los archivos clave. Un CLAUDE.md bien elaborado es el factor más importante para obtener resultados precisos y útiles.

Claude Code utiliza archivos settings.json para gestionar su configuración. Comprender su jerarquía te permite personalizar el comportamiento de la herramienta tanto a nivel global como por proyecto.

Configuración Global: Existe un archivo settings.json global ubicado en el directorio de configuración de Claude (~/.claude/ en macOS/Linux). Las configuraciones aquí se aplican a todas las sesiones de Claude Code en tu máquina. Es el lugar ideal para definir preferencias generales, como tu modelo preferido o alias de comandos que uses en todos tus proyectos.

Configuración Local (Proyecto): Dentro de cada proyecto inicializado, puedes crear una subcarpeta .claude y dentro de ella un archivo settings.json. Las configuraciones definidas aquí son específicas para ese proyecto y anulan cualquier configuración conflictiva del archivo global.

Esta estructura es perfecta para gestionar requisitos específicos del proyecto. Por ejemplo, en tu proyecto de marketing, puedes configurar el settings.json local para usar un modelo de Claude optimizado para el análisis de datos, mientras que tu configuración global podría usar un modelo diferente para tareas de programación generales.

Con estos pasos, tu entorno local está listo. Has instalado el CLI, te has autenticado y sabes cómo inicializar proyectos y gestionar configuraciones para darle a Claude el contexto adecuado para tus tareas.