Cortex DocsCortex Docs
Propietario: Equipo Cortex PlatformActualizado: 19 de junio de 2026Estado: Vigente

Guía de Inicio Rápido

Tres pasos para dejar un entorno local (notebook) listo para trabajar con QUBIK SDD: instalar la AWS CLI, pedir credenciales a Qubik DevOps y, con eso, instalar QUBIK SDD en la herramienta que uses para programar.

1. Instalar AWS CLI

Necesitás la AWS CLI v2 instalada localmente. El paso 3 la usa para autenticarte contra el registro privado de npm (AWS CodeArtifact) desde donde se instala QUBIK SDD.

🪟 WindowsAWS CLI v2

  1. Descargá el instalador oficial: AWSCLIV2.msi.

  2. Ejecutalo y seguí el asistente. También podés instalarlo en modo silencioso desde PowerShell:

    msiexec /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn

  3. Abrí una terminal nueva y confirmá la instalación:

    aws --version
🐧 LinuxAWS CLI v2

  1. Descargá el paquete:

    curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

  2. Descomprimí e instalá:

    unzip awscliv2.zip
sudo ./aws/install

  3. Confirmá la instalación:

    aws --version

2. Solicitar credenciales de AWS

Para autenticarte necesitás un usuario de AWS. Lo crea Qubik DevOps — no reutilices credenciales de otro proyecto ni las generes vos mismo.

  1. Pedile a Qubik DevOps que te cree un usuario.

  2. DevOps te entrega dos valores: el Access Key ID y el Secret Access Key.

  3. Configuralos localmente:

    aws configure

    AWS Access Key ID [None]: <el que te dio DevOps>
AWS Secret Access Key [None]: <el que te dio DevOps>
Default region name [None]: us-east-1
Default output format [None]: json

Tratalas como una contraseña

El Secret Access Key no se puede recuperar después de creado el usuario — si lo perdés, pedile a DevOps que rote las credenciales. Nunca las subas a un repo ni las compartas por canales sin cifrar.

3. Instalar Qubik SDD en tu entorno local

QUBIK SDD (comandos /qubik-*, skills y el agente de chequeo de JIRA) se distribuye sin clonar, vía el instalador @qubik/cortex-sdd publicado en el registro privado de AWS CodeArtifact.

Paso previo: autenticar npm contra CodeArtifact

Con las credenciales del paso 2 ya configuradas:

aws codeartifact login --tool npm --repository npm --domain qubik --domain-owner 287054630031 --region us-east-1 --namespace @qubik

El token vence

El login de CodeArtifact deja un token de npm temporal (dura algunas horas). Si npx @qubik/cortex-sdd empieza a fallar con 401/403, repetí este comando.

Elegí tu plataforma

⭐ Claude CodeRecomendado

  1. Corré:

    npx @qubik/cortex-sdd install

  2. Elegí la opción 1) Claude Code en el menú interactivo (o saltealo con --target claude).

  3. Reiniciá la sesión de Claude Code si los comandos /qubik-sdd:* no aparecen de inmediato.

Qué instala

~/.claude/commands/qubik-sdd/ · ~/.claude/agents/ · ~/.claude/skills/ · ~/.claude/qubik-sdd/.spec.driven.docs/ + el MCP de Cortex en ~/.claude.json.

OpenCode

  1. Corré:

    npx @qubik/cortex-sdd install --target opencode

  2. Se instala en <config>/commands/qubik-sdd/ (y agents/, skills/), donde <config> es ~/.config/opencode/ en Linux/Mac o %APPDATA%\opencode en Windows. Para forzar otra ruta, usá --opencode-dir <ruta>.

A tener en cuenta

Los agentes se instalan sin un model fijo (usan el default configurado en OpenCode). Si querés pinear uno, editalo a mano en el .md del agente después de instalar.

Codex

  1. Corré:

    npx @qubik/cortex-sdd install --target codex

  2. A diferencia de Claude Code y OpenCode, Codex solo recibe los comandos como prompts en ~/.codex/prompts/ — no tiene agente, skills ni docs del framework.

A tener en cuenta

El producto del MCP queda fijo en --product (default teampulse) porque Codex no expande variables de entorno en la URL. Para cambiarlo, reinstalá con --product <nombre> o editá ~/.codex/config.toml a mano.

Actualizar o desinstalar

Más adelante, npx @qubik/cortex-sdd@latest update trae la última versión sobre las plataformas que ya tenés instaladas. npx @qubik/cortex-sdd uninstall remueve todo lo instalado.