En el post anterior instalamos Node.js, que es el componente que necesita Claude Code para funcionar. Ahora vamos a instalar estos dos componentes JDK y SQLcl que nos permitirán conectarnos directamente a la base de datos Oracle desde la terminal.
¿Por qué necesitamos Java?
SQLcl es la herramienta de línea de comandos actual de Oracle. Reemplaza al clásico SQL*Plus y está construida completamente en Java. Esto significa que sin Java instalado en el sistema, SQLcl simplemente no arranca.
No necesitamos Java para programar ni para Oracle APEX en sí. Lo instalamos exclusivamente porque es el motor sobre el que corre SQLcl.
La versión requerida es Java 21 o superior. Instalamos el JDK (Java Development Kit) y no el JRE (Java Runtime Environment), porque el JDK incluye todo lo que necesita SQLcl para operar correctamente.
Descarga e instalación de Java 21
Descargamos el JDK 21 desde el sitio oficial de Oracle: https://www.oracle.com/java/technologies/downloads/
Seleccionamos la versión Java 21, plataforma Windows (en mi caso), y descargamos el instalador .exe (x64 Installer).
Ejecutamos el instalador.
En la pantalla Destination Folder, mantenemos la ruta por defecto: C:\Program Files\Java\jdk-21.0.10\
No es necesario cambiarla.
Hacemos clic en Next y esperamos que finalice la instalación.
Al terminar, hacemos clic en Close.
Verificamos la instalación de Java
Abrimos una terminal (Command Prompt dentro de VS Code o desde el sistema) y ejecutamos:
java -version
Debe mostrar algo similar a:
java version "21.0.11" 2026-04-21 LTS
¿Por qué SQLcl y no SQL Developer?
SQL Developer es la herramienta gráfica de Oracle, con interfaz visual. SQLcl es su equivalente de línea de comandos, liviana, sin instalador, y diseñada para trabajar desde la terminal.
Para este entorno de prácticas y estudio, necesitamos SQLcl específicamente porque:
- Se ejecuta desde la terminal integrada de VS Code
- Es la herramienta que usa el MCP Server de Oracle para conectar Claude Code con la base de datos
- Permite ejecutar scripts SQL y PL/SQL directamente desde el proyecto
- No requiere instalación, solo descomprimimos en una carpeta
SQL Developer seguirá siendo útil para tareas visuales como debugging PL/SQL complejo. Pero para la integración con Claude Code, SQLcl es lo que necesitamos.
Descarga e instalación de SQLcl
Descargamos SQLcl desde el sitio oficial de Oracle: https://www.oracle.com/database/sqldeveloper/technologies/sqlcl/download/
No tiene instalador. Es un archivo .zip que simplemente descomprimimos.
Creamos la carpeta destino: C:\tools\sqlcl\
Descomprimimos el contenido del .zip dentro de esa carpeta. Al terminar, la estructura debe verse así:
C:\tools\sqlcl\
bin\
sql
sql.exe
lib\
…
Agregar SQLcl al PATH del sistema
A diferencia de Node.js, SQLcl no agrega su ruta al PATH automáticamente. Necesitamos hacerlo manualmente para poder ejecutar el comando sql desde cualquier terminal.
-
- Abrimos el menú Inicio y buscamos “Variables de entorno”
- Seleccionamos “Editar las variables de entorno del sistema”
- Hacemos clic en “Variables de entorno…”
- En la sección Variables del sistema, seleccionamos Path y hacemos clic en Editar
- Hacemos clic en nuevo y agregamos:
C:\tools\sqlcl\bin
6. Aceptamos en todas las ventanas
Cerramos y volvemos a abrir la terminal para que tome efecto el cambio.
Verificar la instalación de SQLcl
En la terminal ejecutamos:
sql -version
Debe mostrar la versión instalada, en nuestro caso:
SQLcl: Release 26.1.0.0
Usando Virtual Machine de Hyper-V
Si tenemos una máquina virtual con ORDS, JasperReports u otras herramientas Oracle instaladas, (en mi caso tengo una instalación completa en una Virtual Machine de Hyper-V) y tengo una variable de entorno llamada JAVA_TOOL_OPTIONS configurada por esas herramientas. En ese caso, al ejecutar sql desde la terminal me encontré con un mensaje de error.
La solución en ese entorno es invocar SQLcl usando la ruta completa en lugar del comando corto: C:\tools\sqlcl\bin\sql.exe
No puedo eliminar la variable JAVA_TOOL_OPTIONS, porque la uso en mi entorno con ORDS y JasperReports. Esto lo comparto solo en caso que trabajemos con una VM y tengamos una variable de entorno que llama también a Java.
Lo que viene: conectar SQLcl con Oracle ADB usando el Wallet
Con Java y SQLcl instalados, el entorno de desarrollo está casi completo. En el próximo post vamos a descargar el Wallet de nuestra base de datos Oracle Autonomous Database y establecer la primera conexión desde la terminal usando SQLcl.
Te espero en el próximo post.
Ir al post 5 de la serie: Conexión a Oracle Autonomous Database con SQLcl usando el Wallet
Crédito: Imagen de portada creada con ChatGPT
