¿Qué es el AI CLI Installer?

Es un sistema que te permite usar CLIs (Command Line Interfaces) de IA como Claude, Gemini o Aider para tareas de programación, consultas o aprendizaje, directamente desde tu terminal. Tu administrador del servidor ha configurado esto para que tengas un acceso fácil y seguro.

1. Primer Acceso y Configuración Inicial (Automática)

La primera vez que inicies sesión en el servidor después de que el sistema "AI CLI Installer" haya sido instalado, se realizará una configuración automática para ti.

1. Conéctate a tu servidor vía SSH:

   ssh tu_usuario@tu_servidor.com

2. ¿Qué sucederá?

   • El sistema verificará si tienes permiso de acceso (según las reglas de WhiteList/BlackList definidas por tu administrador).
   • Si estás permitido, las CLIs de IA se instalarán automáticamente en tu directorio personal (~$HOME).
   • Las configuraciones necesarias se añadirán a tu archivo ~/.bashrc (o similar, dependiendo de tu shell).
   • Se te mostrará un mensaje de confirmación cuando todo esté listo.

2. Configura tus Claves de API

Para que las herramientas de IA puedan funcionar, necesitan tus claves de API personales. Estas claves las obtienes directamente de los proveedores de servicios de IA (Anthropic para Claude, Google para Gemini, OpenAI para Aider).

1. Edita tu archivo ~/.bashrc:

   nano ~/.bashrc

   Si usas otro shell, como zsh, el archivo podría ser ~/.zshrc.

2. Busca las líneas que empiezan con export y que están vacías:

   Tu administrador habrá pre-agregado unas líneas similares a estas (probablemente al final del archivo):

   # AI CLI Installer - Tus claves API (COMPLETAR AQUI)
   export ANTHROPIC_API_KEY="" # Clave para Claude Code
   export GEMINI_API_KEY=""    # Clave para Gemini CLI
   export OPENAI_API_KEY=""    # Clave para Aider AI (OpenAI)

3. Inserta tus claves API:

   Reemplaza las comillas vacías con tus claves reales. Por ejemplo:

   export ANTHROPIC_API_KEY="sk-tu-clave-unica-de-anthropic"
   export GEMINI_API_KEY="tu-clave-unica-de-gemini"
   export OPENAI_API_KEY="sk-tu-clave-unica-de-openai"

   ¡Importante! No compartas tus claves API con nadie. Son como contraseñas para acceder a servicios de pago o con límites.

4. Guarda los cambios y sal del editor:

   • En nano: Ctrl + O (Guardar), Enter, Ctrl + X (Salir).

5. Recarga tu configuración de shell:

   Para que los cambios en ~/.bashrc surtan efecto, debes recargar el archivo:

   source ~/.bashrc

   Ahora, las CLIs podrán acceder a tus claves.

3. Verificar y Usar las CLIs de IA

Una vez configurado, estás listo para empezar a usar las herramientas.

1. Verifica el estado de tu instalación:

   ai-status

   Esto te mostrará qué CLIs están instaladas y si tus variables de entorno (claves API) están configuradas correctamente.

2. Obtén ayuda sobre los comandos disponibles:

   ai-help

   Este comando te listará todas las CLIs instaladas y cómo usarlas.

3. Comandos de CLIs de IA incluidos (ejemplos):

   • claude-code (Claude Code): Ideal para desarrollo profesional, refactorización de código y debugging.

     claude-code "refactoriza este código Python para que sea más eficiente: [pega tu código aquí]"

   • gemini (Gemini CLI): Perfecto para aprendizaje, consultas rápidas y explorar conceptos.

     gemini "explícame qué es la arquitectura de microservicios"

   • aider (Aider AI): Tu compañero de pair programming. Trabaja directamente con tus archivos de código.

     # Navega a tu directorio de proyecto
     cd ~/mi-proyecto
     # Inicia Aider
     aider

     Aider se conectará con OpenAI (usando tu clave OPENAI_API_KEY) y te permitirá editar archivos de tu proyecto de forma interactiva.

   • ai-compare: Para comparar rápidamente diferentes CLIs de IA (si tu administrador lo ha habilitado).

     ai-compare "escríbeme un poema sobre la luna"

4. Solución de Problemas Comunes

• "command not found" al intentar usar claude-code, gemini, etc.:

  Esto suele ocurrir si no has recargado tu ~/.bashrc después de configurarlo.

  source ~/.bashrc
  ai-status # Vuelve a verificar

  Si el problema persiste, asegúrate de que el archivo .bashrc esté correctamente editado y que no haya errores de tipeo en las rutas o comandos.

• "Error de autenticación" o "Clave API inválida":

  Verifica cuidadosamente que tus claves API en ~/.bashrc son correctas y no tienen espacios extra o caracteres incorrectos. Asegúrate también de que las claves son válidas y activas en el servicio del proveedor de IA (pueden expirar o ser revocadas).

• "Acceso denegado" o "Permiso denegado":

  Este mensaje indica que tu administrador ha configurado las reglas de acceso para que tu usuario no pueda utilizar el sistema de IA. Si crees que esto es un error, contacta a tu administrador del servidor.

5. ¿Necesitas Ayuda Adicional?

• Consulta la guía detallada para usuarios (GUIA-USUARIOS.txt) en tu servidor, si está disponible.
• Contacta a tu administrador del servidor para cualquier problema o pregunta específica sobre el servicio.