Verificando autenticación…

Skip to main content

Codeen Configuration

Up-to-date guide on Cosmos

For installation, configuration, and supported clients, start with the official quickstart:

Codeen — Quickstart

The sections below summarize LATAM environment requirements and legacy portal steps; they may lag behind the Cosmos catalog.

Codeen CLI is a high-performance HTTP proxy and statistics aggregator for Cosmos GenAI Gateway and MCP APIs. It transparently forwards requests, injects authentication tokens, enriches payloads with metadata, and provides detailed latency metrics per endpoint.

Requirements​

  • LATAM email account, with Azure Multi-Factor Authentication (MFA).
  • Gcloud configured with your account. (See gcloud Installation)
    To check which account is authenticated
    gcloud auth list
    To authenticate with the LATAM account
    gcloud auth application-default login
    • Then you must restart the terminal and/or IDE for the changes to take effect.

Installation​

Download the latest preview version of Codeen from GitLab or Google Drive:

info

If you need a Codeen build for a system not yet supported, contact Claudio Urbina (claudio.urbina@latam.com).

  1. Download codeen from GitLab or Google Drive.
    Operating SystemFile
    macOS (Apple Silicon: M1, M2, M3, M4)codeen-macos-aarch64
    macOS (Intel)codeen-macos-x86_64
  2. Configure to facilitate its execution from the terminal.
    Move codeen to $HOME/bin
    mkdir -p $HOME/bin
    mv codeen-macos-* $HOME/bin/codeen
  3. Configure the proxy execution:
    Give execution permissions
    cd $HOME/bin
    chmod +x codeen
    xattr -dr com.apple.quarantine codeen
  4. Make sure the $HOME/bin folder is in your PATH environment variable. You can add the following line to your shell configuration file (~/.bash_profile, ~/.zshrc, etc.): 
    export PATH="$HOME/bin:$PATH"
  5. Initialize codeen only the first time: 
    codeen init
  6. Start the proxy: 
    codeen start
  7. When you need to stop the proxy, go back to the terminal and press Ctrl + C.

You will see a message like the following, when codeen is working correctly:

[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 ...

Additional requirements for system notifications​

To enable system notifications in Codeen, additional dependencies are required:

Installing terminal-notifier on macOS
brew install terminal-notifier