Este post forma parte de una guía paso a paso que estoy preparando para dejar listo un entorno de desarrollo fuera del navegador y trabajar con objetos de Oracle Database y usar Claude Code como herramienta de apoyo para interactuar con la base de datos Oracle desde la terminal y asistirnos con consultas en lenguaje natural.
En los posts anteriores instalamos VS Code con la extensión Claude Code y Git for Windows para versionar nuestros scripts SQL y PL/SQL. Ahora toca instalar Node.js, pero antes vale la pena entender bien por qué lo necesitamos.
Node.js no es parte de Oracle ni de SQLcl. Sin embargo, es un requisito directo de Claude Code, que es la herramienta que queremos usar para conectar la inteligencia artificial con el esquema de la base de datos.
Como vimos, Claude Code es una aplicación que se instala y se ejecuta desde la terminal. Internamente está construida en JavaScript y necesita el entorno de ejecución de Node.js para funcionar. Sin Node.js instalado en el sistema, Claude Code no puede iniciarse.
Cuando instalamos la extensión Claude Code en VS Code en el primer post de esta serie, lo que hicimos fue agregar la interfaz visual dentro del editor. Pero esa interfaz necesita que el motor de Claude Code esté disponible en el sistema, y ese motor corre sobre Node.js.
Dicho de otra forma: Node.js es la base que permite que Claude Code funcione como herramienta de terminal. No es opcional.
Una aclaración importante: Node.js no interviene en la conexión con Oracle Database, no ejecuta SQL y no reemplaza a SQLcl ni a ninguna herramienta de Oracle. Su único rol en este entorno es servir como entorno de ejecución para Claude Code.
Recuerdo que cuando estaba incursionando en la creación de NFT (non-fungible tokens), también había instalado VS Code y Node.js para trabajar con scripts de generación de imágenes. Cuando trabajamos con JavaScript, la dupla VS Code + Node.js aparece una y otra vez.
¿Qué versión instalar?
Node.js tiene dos tipos de versiones:
- LTS (Long Term Support): versión estable con soporte extendido. Es la recomendada para entornos de trabajo.
- Current: versión más reciente, con las últimas funcionalidades, pero menos estable.
Para este entorno instalamos la versión LTS. Claude Code requiere Node.js versión 18 o superior, y la versión LTS actual cubre ese requisito sin problemas.
Descarga e instalación
Descargamos Node.js desde el sitio oficial: https://nodejs.org
Seleccionamos el instalador LTS para Windows (archivo .msi).
Ejecutamos el instalador y se abre el asistente.
En la pantalla End-User License Agreement, aceptamos los términos y continuamos.
En la pantalla Destination Folder, mantenemos la ruta por defecto. No es necesario cambiarla.
En la pantalla Custom Setup, dejamos la selección por defecto. Esto incluye el runtime de Node.js y npm (el gestor de paquetes), que también vamos a necesitar.
En la pantalla Tools for Native Modules, no marcamos la opción de instalar herramientas adicionales (Chocolatey, Python, compiladores). Para este entorno no lo vamos a necesitar, menos es más en este momento.
Hacemos clic en Install y esperamos a que finalice la instalación.
Al terminar, hacemos clic en Finish.
Verificar la instalación
Si teníamos abierto el Visual Code, lo cerramos y lo volvemos a abrir para que con eso Windows actualiza las variables de entorno al reiniciar la sesión.
Ahora abrimos una terminal de tipo Command Prompt no PowerShell, que puede ser la terminal integrada de VS Code o el símbolo del sistema de Windows, y ejecutamos:
node --version npm --version
Ambos comandos deben devolver un número de versión. Si Node.js responde correctamente, es porque la instalación fue completada correctamente.
Nota sobre el PATH en Windows
El instalador de Node.js agrega automáticamente las rutas necesarias al PATH del sistema. A diferencia de lo que ocurrió con Git en el post anterior, aquí no necesitamos configurar nada manualmente.
Lo que sigue
En el siguiente post vamos a instalar el JDK y SQLcl.
Con Node.js instalado, Claude Code ya puede funcionar correctamente desde la terminal. Pero para conectar Claude con Oracle Database, necesitamos esos dos componentes.
Todo va encadenado: SQLcl es la herramienta de línea de comandos de Oracle, y está construida sobre Java. Sin el JDK en nuestro sistema, SQLcl no va a arrancar. Y sin SQLcl, no podemos establecer la conexión entre Claude Code y nuestra base de datos en la nube.
Te espero en el próximo post!
Ir al post 4 de la serie: Instalando JDK y SQLcl para conectar Oracle Autonomous Database desde la terminal de VS Code
Crédito: Imagen de portada creada con ChatGPT
