En el artículo anterior instalamos VS Code y configuramos la extensión Claude Code como base del entorno que vamos a utilizar durante esta serie de posts.
El siguiente paso es preparar algo muy importante cuando trabajamos con scripts SQL y PL/SQL fuera del browser: el versionado del código.
Para eso vamos a instalar Git for Windows.
¿Por qué usar Git trabajando con Oracle APEX?
Cuando desarrollamos dentro de Oracle APEX, gran parte del código vive en la base de datos:
- Packages
- Procedures
- Triggers
- Scripts SQL
- Procesos PL/SQL
El taller de SQL nos permite modificar estos objetos, pero no mantiene un historial completo de cambios como lo hace un sistema de control de versiones.
Lo que Git permite es:
- Guardar versiones de cada script
- Versionar exportaciones de la aplicación de APEX
- Comparar cambios entre versiones
- Experimentar sin riesgo
- Recuperar código anterior fácilmente
- Trabajar en equipo de forma ordenada
En esta serie educativa vamos a usar Git para versionar los scripts que iremos creando sobre el esquema VUELOS-RESERVAS.
Descargar Git for Windows
Podemos descargar Git desde el sitio oficial: https://git-scm.com/downloads
En mi caso selecciono la versión para Windows. Hacemos clic en Git for Windows/x64 Setup. Ejecutamos el instalador.
Se muestra la pantalla Information, que muestra la licencia GNU General Public License. Simplemente continuamos con la instalación.
En la pantalla Select Destination Location, no es necesario modificarla. Mantenemos la ruta estándar así evitamos problemas futuros con PATH y herramientas externas, recordemos que esta guía es a fines educativos para configuraciones específicas te recomiendo leer la documentación oficial.
En la pantalla Select Components, se mantienen las opciones por defecto porque incluyen utilidades necesarias para trabajar desde la terminal y VS Code sin configuraciones adicionales. Esto nos asegura compatibilidad con scripts y herramientas externas que usaremos más adelante.
En la pantalla Select Start Menu Folder, mantenemos la carpeta sugerida por el instalador. No afecta el funcionamiento de Git.
En la pantalla Choosing the default editor used by Git, seleccionamos Visual Studio Code como editor por defecto para Git. Esto nos permite abrir archivos de configuración, commits y conflictos directamente desde VS Code cuando trabajemos con repositorios.
En la pantalla Adjusting the names of the initial branch in new repositories, marcamos la segunda opción y dejamos el nombre main.
En la pantalla Adjusting your PATH enviroment, seleccionamos: Git from the command line and also from 3rd-party software.
Esta es una opción importante porque permite ejecutar Git desde:
- La terminal de VS Code
- Scripts automatizados
- SQLcl
- Claude Code
Sin esta opción, Git no estaría disponible globalmente en nuestro entorno, es decir, en nuestro sistema.
En la pantalla Choosing the SSH executable, seleccionamos, Use bundled OpenSSH. Esta opción nos permite trabajar con repositorios remotos (GitHub, GitLab, etc.) sin instalar herramientas adicionales.
En la pantalla Choosing HTTPS transport backend, seleccionamos: Use the OpenSSL library. Esto nos asegura compatibilidad estándar con conexiones seguras HTTPS hacia repositorios remotos.
En la pantalla Configuring the line ending conversions, seleccionamos: Checkout Windows-style, commit Unix-style line endings. Esta configuración evita problemas de formato entre Windows y otros sistemas operativos cuando compartimos scripts SQL o PL/SQL. Es la opción más segura en entornos mixtos.
En la pantalla Configuring the terminal emulator to use with Git Bash, seleccionamos: Use MinTTY. Esto nos ofrece una mejor experiencia de terminal en Windows comparado con la consola clásica. Permite trabajar cómodamente con comandos Git.
En la pantalla Choose the default behavior of git pull, seleccionamos: Fast-forward or merge. Es la opción más flexible y segura para sincronizar cambios cuando trabajamos con repositorios remotos.
En la pantalla Choose a credentials helper, seleccionamos: Git Credential Manager. Esto nos permite guardar credenciales de forma segura al trabajar con repositorios remotos sin tener que escribir usuario y contraseña cada vez.
En la pantalla Configuring extra options, mantenemos las opciones por defecto:
- Enable file system caching (marcada) – mejora el rendimiento de lectura de archivos cuando trabajamos con repositorios locales.
- Enable symbolic links (sin marcar) – requiere permisos especiales en Windows y normalmente no es necesaria para trabajar con scripts SQL o PL/SQL en este entorno, por lo que la dejamos desactivada.
En la pantalla Installing vemos el proceso de instalación en el cual el instalador copia los archivos necesarios y configura Git en el sistema.
Llegamos al final de la instalación y Git quedó correctamente instalado y listo para usarse desde:
- VS Code
- Terminal integrada
- Scripts
- Herramientas externas como SQLcl o Claude Code
Ahora podemos verificar la instalación ejecutando en Visual Code en una nueva terminal: (si teniamos abierto el Visual Code, lo debemos cerrar y volver a abrir para que tome la instalacion de git)
git --version
Configurando nombre y email en Git
Antes de empezar a versionar código es recomendable configurar nuestra identidad en Git.
Ejecutamos en la terminal:
git config --global user.name "Tu Nombre" git config --global user.email "tu@email.com"
Esta información quedará registrada en cada cambio que hagamos en el repositorio.
Inicializando el repositorio del proyecto
Aunque ya tenemos descargado el dataset VUELOS-RESERVAS y sus scripts de instalación en una carpeta separada, para trabajar de forma ordenada vamos a crear una carpeta independiente para el proyecto de desarrollo.
Por ejemplo: Documents/Proyectos/APEX/vuelos-reservas-app
La idea es no mezclar los archivos originales del dataset con los scripts, objetos y exportaciones que iremos generando durante la construcción de la aplicación en APEX.
Cuando abrimos la carpeta del proyecto por primera vez, VS Code muestra un mensaje de seguridad preguntando si confiamos en los autores de los archivos del directorio.
Esto es normal y forma parte del sistema de protección del editor.
Como en este caso estamos trabajando con una carpeta creada por nosotros mismos, seleccionamos: Yes, I trust the authors.
Esto nos permite habilitar completamente las extensiones, la terminal integrada y las herramientas que usaremos en los siguientes pasos.
Abrimos una terminal y ejecutamos:
git init
Git crea una carpeta interna llamada .git dentro del directorio del proyecto. Esta carpeta contiene toda la información necesaria para el control de versiones.
Podemos verificar el estado inicial del repositorio ejecutando: git status
En este punto vemos que Git indica que el repositorio todavía no contiene commits, lo cual es normal porque aún no hemos agregado archivos al proyecto.
Creando el primer archivo del repositorio
Como primer paso dentro del workspace del proyecto (donde tenemos nuestra estructura de carpetas), vamos a crear un archivo README
Colocamos el nombre README.md dentro de la carpeta vuelos-reserva-app, luego desde el Visual Code lo abrimos desde el menu File –> Open File.
Este archivo se utiliza habitualmente para documentar el propósito del repositorio y describir su contenido.
Por ejemplo:
Proyecto APEX basado en el dataset VUELOS-RESERVAS.
Este repositorio contiene scripts, exportaciones y objetos creados durante la serie.
Registrando el primer commit del proyecto
Una vez creado el archivo README, lo agregamos al repositorio ejecutando:
git add .
Este comando indica a Git que prepare todos los archivos nuevos del directorio para ser incluidos en el próximo commit.
Luego registramos el primer commit:
git commit -m "Initial project structure"
Este commit marca el inicio formal del repositorio del proyecto.
Verificando el estado del repositorio
Ahora sí podemos comprobar que el repositorio quedó correctamente inicializado ejecutando nuevamente:
git status
El mensaje: nothing to commit, working tree clean, confirma que el repositorio está sincronizado y listo para comenzar a versionar los scripts y exportaciones que iremos generando durante la construcción de la aplicación.
Creando estructura de carpetas
Lo siguiente que vamos a hacer es crear una estructura de carpetas para tener todo ordenado. Dentro de la carpeta vuelos-reservas-app vamos a crear 3 carpetas: scripts, apex y docs.
Una vez creada la estructura de carpetas del proyecto, intentamos registrarla en el repositorio ejecutando:
git add . git commit -m "Add project folder structure"
Sin embargo, como vemos, Git muestra nuevamente el mensaje: nothing to commit, working tree clean
Esto ocurre porque Git no versiona carpetas vacías. Solo registra archivos.
Las carpetas scripts, apex y docs quedarán automáticamente incluidas en el repositorio cuando agreguemos los primeros archivos dentro de ellas, por ejemplo scripts SQL o exportaciones de la aplicación APEX.
Por ahora, la estructura del proyecto queda preparada para comenzar a organizar los objetos que iremos generando en los próximos pasos de esta serie de post.
Configurar la Variable de Entorno para Claude Code
Antes de continuar con la instalación de las siguientes herramientas del entorno, necesitamos configurar una variable de entorno que permitirá a Claude Code utilizar correctamente Git Bash como terminal en Windows.
Esta variable se llama: CLAUDE_CODE_GIT_BASH_PATH
Y debe apuntar al ejecutable de Git Bash instalado previamente con Git for Windows.
En mi caso la ruta es: C:\Users\Clarisa\AppData\Local\Programs\Git\bin\bash.exe
En el siguiente post instalaremos Node.js y seguiremos con los pasos para tener este entorno armado.
Te espero en el siguiente post!
Ir al post 3 de la serie: Instalando Node.js para usar Claude Code con Oracle Database
Crédito: Imagen de portada creada con ChatGPT
