En los posts anteriores preparamos todo el entorno: VS Code con la extensión Claude Code, Git, Node.js, Java, SQLcl y la conexión a Oracle Autonomous Database usando el Wallet. Ahora toca dar vida a Claude Code.
En el Post 1 instalamos la extensión de Claude Code dentro de VS Code y vimos la pantalla inicial. En ese momento aclaramos que el login y la configuración completa vendrían más adelante. Ese momento es ahora.
La extensión y el CLI son dos cosas distintas
Cuando instalamos la extensión anthropic.claude-code en el Post 1, agregamos la interfaz visual de Claude dentro de VS Code: el panel lateral con el ícono de asterisco, el campo de chat, las sesiones. Esa extensión es la capa visual.
El CLI es el motor que corre por detrás. Es el componente que permite ejecutar comandos de Claude desde la terminal y es el que vamos a necesitar para registrar el MCP Server en los próximos posts. Son dos instalaciones separadas, la extensión no instala el CLI automáticamente.
Como ya tenemos Node.js instalado desde el Post 3, instalar el CLI es un solo comando.
Paso 1 – Abrir una terminal Command Prompt en VS Code
Abrimos VS Code. En la terminal, hacemos clic en la flecha junto al + y seleccionamos Command Prompt.
Nota: Es importante usar Command Prompt y no PowerShell. Con PowerShell pueden aparecer errores de política de ejecución que impiden correr comandos npm.
Paso 2 – Instalar el CLI de Claude Code
En la terminal Command Prompt ejecutamos:
npm install -g @anthropic-ai/claude-code
El flag -g instala el paquete de forma global, lo que significa que el comando claude va a quedar disponible desde cualquier carpeta del sistema.
La instalación tarda un par de minutos. Al terminar verificamos que quedó correctamente instalado:
claude --version
Paso 3 – Autenticar Claude Code con tu cuenta de claude.ai
Con el CLI instalado, el siguiente paso es autenticar Claude Code. Este proceso se hace una sola vez por equipo.
Hacemos clic en el ícono del asterisco ✳ en la barra lateral izquierda de VS Code. Aparece la pantalla de bienvenida con las opciones de login.
Claude Code puede usarse con suscripción claude.ai (Pro, Team o Enterprise) o con API key de Anthropic Console. Esta guía usa la opción de suscripción claude.ai.
Para usar el MCP Server de SQLcl que configuraremos más adelante necesitamos una suscripción activa de Claude. La extensión Claude Code for VS Code es gratuita, pero el uso de IA requiere autenticación con nuestra cuenta claude.ai.
Hacemos clic en el botón naranja Claude.ai Subscription. VS Code abre un diálogo pidiendo permiso para abrir el navegador con la URL de autenticación.
Hacemos clic en Open para continuar en el navegador.
Paso 4 – Verificar el email
El navegador abre la página de login de Claude. Se envía automáticamente un código de verificación al email asociado a tu cuenta. Ingresamos el código y hacemos clic en Verify Email Address.
Paso 5 – Autorizar la conexión
Claude muestra los permisos que solicita Claude Code: acceso al perfil, sesiones de Claude Code, conectores y archivos. Hacemos clic en Authorize para confirmar.
Paso 6 – Confirmación
El navegador muestra el mensaje de confirmación. Podemos cerrar esta ventana y volver a VS Code.
Paso 7 – Claude Code listo en VS Code
De vuelta en VS Code, el panel de Claude Code muestra New session con las pestañas Local y Web. El login está completo.
Lo que viene
Con Claude Code instalado y autenticado, en el próximo post vamos a instalar el dataset de vuelos de Café Database en nuestra base de datos demovuelos. Vamos a clonar el repositorio, crear el usuario VUELOS y ejecutar el script que carga las 57.971 filas de vuelos, reservas, plazas, aeropuertos y agencias.
Te espero en el próximo post.
Ir al post 7 de la serie: Instalando el dataset VUELOS-RESERVAS en Oracle Autonomous Database desde SQLcl
Crédito: Imagen de portada creada con ChatGPT
