Verificando autenticación…

Saltar al contenido principal

Configuración de Codeen

Guía actualizada en Cosmos

Para instalación, configuración y uso de clientes compatibles, usa primero el quickstart oficial:

Codeen — Quickstart

Lo que sigue en esta página resume requisitos del entorno LATAM y pasos históricos del portal; puede quedar detrás del catálogo de Cosmos.

Codeen CLI es un proxy HTTP y agregador de estadísticas de alto rendimiento para las API de Cosmos GenAI Gateway y MCP. Reenvía las solicitudes de forma transparente, inyecta tokens de autenticación, enriquece los payloads con metadatos y ofrece métricas detalladas de latencia por endpoint.

Requisitos​

  • Cuenta de correo LATAM, con Autenticación Multifactor MFA en Azure.
  • Gcloud configurado con tu cuenta. (Ver Instalación de gcloud)
    Para saber que cuenta se encuentra autenticada
    gcloud auth list
    Para autenticarse con la cuenta LATAM
    gcloud auth application-default login
    • Luego deben reiniciar el terminal y/o IDE para que los cambios tengan efecto.

Instalación​

Descarga la última versión preview de Codeen desde GitLab o Google Drive:

info

Si necesitas una build de Codeen para un sistema aún no soportado, contacta a Claudio Urbina (claudio.urbina@latam.com).

  1. Descarga codeen desde GitLab o Google Drive.
    Sistema operativoArchivo
    macOS (Apple Silicon: M1, M2, M3, M4)codeen-macos-aarch64
    macOS (Intel)codeen-macos-x86_64
  2. Configuramos para facilitar su ejecución desde la terminal.
    Mover codeen a $HOME/bin
    mkdir -p $HOME/bin
    mv codeen-macos-* $HOME/bin/codeen
  3. Configuramos la ejecución del proxy:
    Dar permisos de ejecución
    cd $HOME/bin
    chmod +x codeen
    xattr -dr com.apple.quarantine codeen
  4. Asegúrate de que la carpeta $HOME/bin esté en tu variable de entorno PATH. Puedes agregar la siguiente línea a tu archivo de configuración de shell (~/.bash_profile, ~/.zshrc, etc.): 
    export PATH="$HOME/bin:$PATH"
  5. Iniciamos codeen solo la primera vez: 
    codeen init
  6. Iniciamos el proxy: 
    codeen start
  7. Cuando necesites detener el proxy, vuelve a la terminal y presiona Ctrl + C.

Verás un mensaje como el siguiente, cuando codeen esté funcionando correctamente:

[2025-08-27 13:22:58 -0400 INFO __main__:32] Starting Cosmos Proxy 0.6.0
[2025-08-27 13:22:58 -0400 INFO cosmos.proxy.cli:105] Loaded configuration from .codeen/codeen.config.yaml
[2025-08-27 13:22:58 -0400 INFO cosmos.proxy.config:85] Applying arguments to configuration
[2025-08-27 13:22:58 -0400 INFO cosmos.proxy.config:63] Applying configuration version 0.2.0
Starting Cosmos Proxy...
[2025-08-27 13:22:58 -0400 INFO cosmos.proxy.server.application:217]
      ___   ___    ___   ___   ___  _  _
     / __| / _ \  |   \ | __| | __|| \| |
    | (__ | (_) | | |) || _|  | _| | .  |
     \___| \___/  |___/ |___| |___||_|\_|

        COsmos    DEveloper    ENhancer

[2025-08-27 13:22:58 -0400 INFO cosmos.proxy.server.application:225]
[2025-08-27 13:22:58 -0400 INFO cosmos.proxy.server.application:226] Codeen version: 0.6.0
[2025-08-27 13:22:58 -0400 INFO cosmos.proxy.server.application:227] Proxy is listening on http://127.0.0.1:8150 ...

Requerimientos adicionales para las notificaciones del sistema​

Para habilitar las notificaciones del sistema en Codeen, se requieren dependencias adicionales:

Instalando terminal-notifier en macOS
brew install terminal-notifier