Ir al contenido
Español

Guía completa

Tres pasos, en orden: prepara tu equipo, accede a tu repositorio e instala CloudIA. Cada uno te dice primero qué comprobar y solo después qué instalar. El índice de la derecha te lleva a cualquier punto.

Primero compruebas si ya tienes cada pieza, y solo instalas si te falta. No hace falta saber programar: vas a copiar órdenes cortas y a pulsar botones de instaladores normales. Si nunca has usado una terminal, la guía de referencia explica cómo abrirla y cómo saber si una comprobación ha salido bien.

La plataforma al entrar y CloudIA en su primera conexión te pedirán un código de seis dígitos que genera una aplicación de autenticación en tu móvil: sin ella no puedes empezar. Si tu organización ya usa una, esa es la que debes usar. Si no tienes ninguna, cualquiera de estas dos vale — instálala en el móvil desde su tienda oficial:

Aplicación iPhone Android
Google Authenticator · Google App Store Google Play
Microsoft Authenticator · Microsoft App Store Google Play

Una aplicación de autenticación es una app del móvil que genera códigos de un solo uso, de seis dígitos, que cambian cada pocos segundos. Es el segundo factor de acceso: además de tu contraseña, demuestras que tienes tu teléfono. Así, aunque alguien consiguiera tu contraseña, no podría entrar sin ese código. Funciona sin conexión y no envía SMS: la app calcula el código por sí misma.

Basta con instalarla: no tienes que configurar nada todavía. Cuando la plataforma te pida activar el segundo factor, escanearás un código con ella.

Es el programa, instalado en tu ordenador, desde el que hablarás con CloudIA. Basta con uno. No sirve un asistente que uses dentro del navegador: tiene que poder conectarse a los conectores de tu organización, y eso solo lo hacen los de esta lista.

Utiliza el cliente que haya propuesto tu organización. Si tienes dudas sobre cuál es, contacta con el responsable de tu organización. Y si no hay ninguno definido, puedes utilizar cualquiera de estas cuatro opciones:

Claude Desktop Recomendado

Aplicación de escritorio. Es la que recomendamos: la que menos pasos deja después y la más cómoda si no trabajas habitualmente en la terminal. Se instala como cualquier otra aplicación y no necesita nada más — ni Node.js ni herramientas de desarrollo.

  1. Descárgala desde claude.com/download. La página detecta tu sistema y te ofrece la descarga que te corresponde.

    Página de descarga de Claude con el botón de descarga para tu sistema
    Así se ve la página de descarga. El botón cambia según el sistema desde el que entres.
  2. Instálala. En macOS, abre el archivo y arrastra Claude a la carpeta Aplicaciones. En Windows, ejecuta el instalador y acepta las opciones por defecto.

  3. Ábrela e inicia sesión con la cuenta de Claude que te haya proporcionado tu organización, con licencia corporativa (Team o Enterprise). No están permitidas las cuentas personales: el trabajo con CloudIA queda bajo el plan de tu organización, con sus condiciones y su control.

Déjalo instalado. En el paso 3 lo conectarás con tu organización.
Claude Code

Cliente de terminal de Anthropic. Hablas con CloudIA desde la terminal, situado en la carpeta de tu repositorio. Es la opción natural si ya trabajas en la terminal. El instalador oficial es autónomo: no necesita Node.js ni ninguna otra pieza, y se actualiza solo.

Abre una terminal y pega esta orden:

Ventana de terminal
curl -fsSL https://claude.ai/install.sh | bash

Cuando termine, cierra la terminal y abre otra nueva.

Comprueba que responde, en una terminal nueva:

Ventana de terminal
claude --version

La primera vez que lo abras, escribe claude en la carpeta de tu repositorio: se abrirá el navegador para iniciar sesión con la cuenta de Claude que te haya proporcionado tu organización, con licencia corporativa (Team o Enterprise). No están permitidas las cuentas personales.

Para otras formas de instalarlo (Homebrew, WinGet, Linux) y para resolver problemas, consulta la guía oficial de Claude Code.

Déjalo instalado. En el paso 3 lo conectarás con tu organización.
GitHub Copilot

Aplicación de escritorio de GitHub Copilot. Es la opción equivalente a Claude Desktop dentro de GitHub: una aplicación que se instala como cualquier otra y desde la que trabajas con agentes sin pasar por la terminal. Está disponible para macOS, Windows y Linux. Tu organización tiene que tener la licencia de GitHub Copilot activa y tú una cuenta de GitHub con tu correo corporativo.

  1. Descárgala desde github.com/features/copilot. El botón «Descargar» te ofrece la versión de tu sistema; si no es la tuya, despliega «Otras opciones de descarga».

    Página de la aplicación de escritorio de GitHub Copilot, con el botón de descarga
    Así se ve la página de la aplicación. El botón cambia según el sistema desde el que entres.
  2. Instálala. En macOS, abre el archivo y arrastra la aplicación a la carpeta Aplicaciones. En Windows, ejecuta el instalador y acepta las opciones por defecto.

  3. Ábrela e inicia sesión en GitHub con la cuenta que te haya proporcionado tu organización, con licencia de Copilot Business o Enterprise. No están permitidas las cuentas personales: con ellas no verás los conectores de tu organización.

Si ya trabajas en Visual Studio Code, Copilot también funciona dentro del editor con la extensión GitHub Copilot. Para esta guía basta con la aplicación de escritorio.

Déjalo instalado. En el paso 3 lo conectarás con tu organización.
Copilot CLI

Cliente de terminal de GitHub Copilot. Hablas con CloudIA desde la terminal, situado en la carpeta de tu repositorio. Los instaladores oficiales son autónomos: no necesitan Node.js. Además de la licencia, tu organización tiene que tener Copilot CLI habilitado en su configuración de Copilot; si al entrar te dice que no está disponible, es eso.

Abre una terminal y pega esta orden:

Ventana de terminal
curl -fsSL https://gh.io/copilot-install | bash

Cuando termine, cierra la terminal y abre otra nueva.

Comprueba que responde, en una terminal nueva:

Ventana de terminal
copilot --version

La primera vez, escribe copilot en la carpeta de tu repositorio y, cuando lo pida, la orden /login: te guiará para iniciar sesión en GitHub con la cuenta que te haya proporcionado tu organización, con licencia de Copilot Business o Enterprise. No están permitidas las cuentas personales.

Para otras formas de instalarlo (Homebrew, npm) y para resolver problemas, consulta la guía oficial de Copilot CLI.

Déjalo instalado. En el paso 3 lo conectarás con tu organización.

El trabajo con CloudIA se hace sobre una carpeta de tu equipo que es copia de un repositorio de tu organización. Aquí entiendes por qué, pides el acceso que te corresponda y traes esa copia a tu equipo.

Con las direcciones en la mano, clona cada repositorio en tu equipo: se crea una carpeta por repositorio, y esa carpeta es sobre la que trabaja CloudIA. Si ya sabes clonar repositorios, hazlo como acostumbres y pasa al paso 3. Si no, el bloque siguiente te lleva de la mano.

Por qué un repositorio

Un repositorio es una carpeta compartida y con historial, alojada en GitHub, de la que cada persona del equipo tiene una copia en su equipo. Para CloudIA es la base de conocimiento compartida del proyecto: ahí viven las instrucciones que el asistente lee al empezar, los skills y agentes que tu organización ha preparado, y la configuración de los conectores con los que trabaja. Cuando alguien mejora algo, todo el equipo lo recibe con la siguiente actualización; y lo que tú aprendes con CloudIA se puede guardar ahí para los demás. Por eso abrirás siempre tu cliente de IA dentro de esa carpeta, trabajes desde la aplicación de escritorio o desde la terminal.

No tiene por qué ser uno solo. Cada proyecto tiene su repositorio, con sus conectores y su conocimiento, y según el rol que ejerzas en la organización tendrás acceso a uno o a varios. Lo normal es empezar por uno y añadir otros cuando participes en más proyectos.

Hacen falta dos herramientas, git y la CLI de GitHub, iniciar sesión, elegir una carpeta y clonar. Son cinco puntos y van en orden: termina cada uno antes de pasar al siguiente. Todos se hacen desde una terminal (cómo abrirla). Si dudas al leer el resultado de una comprobación, mira cómo saber si ha salido bien.

Es el programa que trae el repositorio a tu equipo. Pega esta orden en la terminal y pulsa Intro:

Ventana de terminal
git --version

Sale un número de versión, como git version 2.46.2: ya lo tienes, pasa al punto 2.

No lo encuentra: cómo instalarlo

Esta orden instala git y Python a la vez, así que resuelves dos piezas de una:

Ventana de terminal
xcode-select --install

Se abre una ventana del sistema pidiendo confirmación: pulsa Instalar y acepta. Tarda varios minutos y no da señales mientras tanto, es normal.

Cuando lo tengas, sigue con el punto 2: Comprueba que tienes la CLI de GitHub.

Se llama gh y es la que descarga el repositorio con tu cuenta. Compruébala igual:

Ventana de terminal
gh --version

Sale un número de versión: ya la tienes, pasa al punto 3.

No la encuentra: cómo instalarla
  1. Si usas Homebrew, el gestor de programas de macOS, basta con esta orden:

    Ventana de terminal
    brew install gh

    Si no sabes qué es Homebrew, no lo necesitas: sigue con el punto 2.

  2. Entra en la página de la última versión de GitHub CLI, baja hasta el apartado Assets y descarga el fichero que termina en _macOS_universal.pkg.

  3. Abre el fichero descargado y sigue el instalador pulsando Continuar e Instalar. Te pedirá la contraseña de tu Mac: es la de iniciar sesión en el ordenador.

Cuando lo tengas, sigue con el punto 3: Inicia sesión en GitHub.

Entra con la cuenta de GitHub de tu organización, no con una personal.

Ventana de terminal
gh auth login --hostname github.com --git-protocol https --web
Cómo se hace: lo que verás en la terminal y en el navegador

Primero, en la terminal:

  1. «Authenticate Git with your GitHub credentials? (Y/n)»: escribe Y y pulsa Intro.

  2. «First copy your one-time code: XXXX-XXXX»: el código aparece en la propia terminal, en esa misma línea, detrás de los dos puntos. No llega por correo ni al móvil. Son 8 caracteres separados por un guion: déjalos a la vista, los vas a escribir en el navegador. Por ejemplo, con un código inventado:

    ! First copy your one-time code: 1A2B-3C4D
    Press Enter to open https://github.com/login/device in your browser...
  3. «Press Enter to open https://github.com/login/device in your browser»: pulsa Intro. Se abre el navegador.

Después, en el navegador:

  1. Si te pide entrar en GitHub, hazlo con la cuenta de tu organización.
  2. Página «Device Activation»: escribe el código de 8 caracteres que te dio la terminal en las casillas, tal cual aparece, y pulsa Continue. Si no ves esta página, abre tú github.com/login/device.
  3. Primera autorización, «Authorize GitHub CLI»: pulsa el botón verde Authorize github. Da permiso a la herramienta para usar tu cuenta.
  4. Segunda autorización, si tu organización la pide: una página con el nombre de tu organización que pide autorizar el acceso a sus repositorios. Pulsa Authorize o Continue junto a tu organización. Sin esta segunda, la descarga fallará aunque hayas iniciado sesión.
  5. Verás «Congratulations, you’re all set!». Vuelve a la terminal: dirá «Logged in as TU-USUARIO».

Para saber si has iniciado sesión, usa esta orden:

Ventana de terminal
gh auth status

Si ha salido bien, verás en su respuesta:

  • «Logged in to github.com account TU-USUARIO», donde TU-USUARIO es la cuenta de tu organización.
  • «Active account: true» debajo de esa cuenta.

Si aparece otra cuenta, o responde «You are not logged into any GitHub hosts», cierra la sesión de GitHub en el navegador y repite el inicio de sesión.

Cuando lo tengas, sigue con el punto 4: Elige tu carpeta de trabajo.

Hazlo antes de clonar: el repositorio se descarga dentro de la carpeta en la que esté la terminal. Crea una carpeta para tus proyectos, fuera de cualquier carpeta que se sincronice con la nube, y abre la terminal dentro de ella:

  1. Abre el Finder y navega hasta la carpeta donde quieres crear el proyecto. Recuerda: fuera de cualquier carpeta que se sincronice con la nube, como iCloud Drive, que en muchos equipos incluye el Escritorio y Documentos. Tu carpeta personal, la que lleva tu nombre, es un buen sitio: se abre con Mayús + Cmd + H.
  2. Pulsa con el botón derecho en un hueco vacío, elige Nueva carpeta y ponle un nombre que recuerdes. Te sugerimos CloudIA, pero puedes llamarla como quieras.
  3. Abre la terminal dentro de ella, de una de estas dos formas:
    • En la terminal, escribe cd seguido de un espacio. Después arrastra la carpeta que has creado desde el Finder a la ventana de la terminal y pulsa Intro.
    • O pulsa con el botón derecho sobre la carpeta y elige Servicios y después Nuevo terminal en la carpeta. Si no te aparece esa opción, usa la forma anterior.

Para comprobar que la terminal está en la carpeta correcta, mira que el nombre de tu carpeta aparezca en la línea donde escribes, justo antes del cursor.

Por qué esta carpeta y no otra

La carpeta del repositorio será tu carpeta de trabajo: la que abrirás siempre con tu asistente de IA y donde se instalará CloudIA en el paso 3. No uses carpetas que se sincronicen con la nube, como el Escritorio o Documentos con iCloud, u OneDrive: tu clave de CloudIA se guardará en ella y se subiría a la nube.

Cuando lo tengas, sigue con el punto 5: Clona el repositorio.

Usa la terminal abierta en la carpeta del punto 4. Si la has cerrado, ábrela otra vez en esa carpeta como hiciste allí.

En macOS no hace falta preparar nada: sigue con el punto 1.

  1. En GitHub, pulsa Code, elige la pestaña GitHub CLI y copia la orden. Pégala en la terminal y pulsa Intro. Se crea una carpeta con el nombre del repositorio.

    Botón Code de un repositorio de GitHub abierto, con la pestaña GitHub CLI seleccionada y la orden gh repo clone
    Ejemplo con un repositorio público: botón Code, pestaña GitHub CLI y botón de copiar.
  2. Entra en esa carpeta: escribe cd seguido de un espacio, arrastra la carpeta nueva a la ventana de la terminal y pulsa Intro.

Esa carpeta es tu carpeta de trabajo. La usarás en el paso 3 y cada vez que abras tu asistente de IA.

Cómo se hace, paso a paso
  1. Abre en el navegador la dirección del repositorio que te dio tu organización.
  2. Pulsa el botón verde Code, arriba a la derecha de la lista de ficheros.
  3. Elige la pestaña GitHub CLI y pulsa el botón de copiar que hay a la derecha de la orden.
  4. Pégala en la terminal, que sigue en la carpeta que creaste en el punto 4, y pulsa Intro. Será algo como gh repo clone ORGANIZACION/NOMBRE-DEL-REPOSITORIO.
  5. Entra en la carpeta que acaba de crearse: escribe cd seguido de un espacio, arrastra la carpeta nueva a la terminal y pulsa Intro. Su nombre es la última parte de la orden, lo que va detrás de la barra.

Si el clonado se rechaza, el acceso todavía no está concedido, falta la segunda autorización de la organización o has iniciado sesión con otra cuenta: revisa gh auth status y, si todo parece correcto, pide a tu responsable que revise el acceso en lugar de insistir.

Si en Windows la descarga termina con Filename too long o unable to checkout working tree, el repositorio se ha descargado pero la copia está incompleta. No hace falta volver a clonarlo: entra en su carpeta (punto 5), ejecuta la orden de antes de clonar y después esta otra, que recupera los ficheros que faltaban:

Ventana de terminal
git restore --source=HEAD :/

Comprueba que ha funcionado con git status: no debe aparecer ningún fichero borrado (deleted). Si antes lo habías vuelto a clonar en otra carpeta, quédate con una sola copia.

Listo: ya tienes tu carpeta de trabajo con el repositorio dentro. Pasa al paso 3, Instala CloudIA.

Un único comando, ejecutado dentro de la carpeta del repositorio, deja tu cliente de IA conectado a los conectores de tu organización. Te pedirá la plataforma, tu email y el código de tu aplicación de autenticación; el resto lo hace él.

Son cinco puntos y van en orden: termina cada uno antes de pasar al siguiente. Todos se hacen desde una terminal (cómo abrirla).

1. Abre la terminal en tu carpeta de trabajo

Sección titulada «1. Abre la terminal en tu carpeta de trabajo»

Es la carpeta del repositorio que clonaste en el paso 2. Si la terminal del paso 2 sigue abierta en ella, ya estás: pasa al punto 2. Si no, escribe cd seguido de un espacio, arrastra la carpeta del repositorio desde el Finder o el Explorador a la ventana de la terminal y pulsa Intro. Comprueba que su nombre sale en la línea donde escribes, justo antes del cursor.

Cuando lo tengas, sigue con el punto 2: Ejecuta el instalador.

Antes, comprueba que tienes Python 3. El instalador lo necesita:

Ventana de terminal
python3 --version

Sale un número de versión: ya lo tienes. Ahora copia esta orden, cambia TU-PLATAFORMA por el identificador de tu organización, pégala en la terminal y pulsa Intro:

Ventana de terminal
curl -fsSL https://cloudframework.io/cloudia/install.sh | bash -s -- --platform TU-PLATAFORMA
No encuentra Python: cómo instalarlo

Instálalo con esta orden. Se abre una ventana del sistema pidiendo confirmación: acéptala. Tarda varios minutos sin dar señales, es normal. Al terminar, cierra la terminal, abre otra en tu carpeta de trabajo y vuelve a comprobarlo.

Ventana de terminal
xcode-select --install
Qué hace esta orden

Descarga el instalador oficial de CloudIA y lo ejecuta en esa carpeta, en macOS ya con tu plataforma indicada. No hace falta ser administrador ni instalar nada más; en Windows tampoco hay que cambiar la política de ejecución de scripts. En Windows la orden no puede llevar la plataforma, así que el instalador te la preguntará.

Si tienes varios repositorios, repítelo en cada carpeta: cada una se configura por separado.

Cuando lo tengas, sigue con el punto 3: Responde a lo que te pregunta.

Solo tres cosas:

Qué te pide Qué responder
Plataforma
el identificador de tu organización en CloudIA
Te lo da tu organización. En macOS la orden de arriba ya lo lleva puesto. En Windows te lo preguntará: escríbelo tal cual.
Email
tu usuario en la plataforma
El email corporativo con el que entras en la plataforma.
Código de 6 dígitos
verificación de identidad
Lo encontrarás en tu aplicación de autenticación (paso 1). Cambia cada 30 segundos: escríbelo justo cuando lo pida. Nunca se te pedirá la contraseña.

El código de 6 dígitos sale en tu aplicación de autenticación, sea Google Authenticator, Microsoft Authenticator u otra: el instalador cita la de Google solo como ejemplo. Mientras lo escribes verás asteriscos.

Después te ofrece los tokens que ya tengas o crear uno nuevo con la letra N. Un token es tu clave personal para los conectores; si no sabes cuál elegir, crea uno nuevo.

Qué verás en la terminal, pantalla a pantalla

Son ejemplos recreados con los mensajes reales de la versión 2.2.0 del instalador y datos ficticios.

Tu plataforma y tu email. En macOS la orden ya lleva la plataforma; en Windows te la pregunta, con «cloudframework» como valor por defecto que debes sustituir por la tuya. Después te pide tu email y confirma con qué plataforma, email y carpeta va a trabajar.

Terminal de macOS: recuadro de bienvenida, paso 1 Tu plataforma, email y confirmación de plataforma y directorio
Ejemplo recreado en macOS: arranque con la plataforma ya indicada en la orden.

Verificación de identidad. Te pide el código de seis dígitos. Nunca pide tu contraseña. Tienes tres intentos y cambia cada 30 segundos, así que escríbelo justo cuando lo pida.

Terminal de macOS: te verificas como tu email, código de 6 dígitos con asteriscos e identidad verificada
Ejemplo recreado en macOS: el código se muestra como asteriscos.

Tu token. Elige uno de la lista o crea uno nuevo con la letra N. Al crearlo eliges la caducidad: 90 días por defecto. El token solo se guarda en ficheros que git ignora, así que nunca acaba en el repositorio.

Terminal de macOS: paso 2 Tu token, lista de tokens, creación con caducidad de 90 días y token obtenido
Ejemplo recreado en macOS: elegir un token existente o crear uno nuevo.

Cuando lo tengas, sigue con el punto 4: Comprueba que ha terminado bien.

Al final, el instalador comprueba la conexión. Ha salido bien si dice «Tu EaaS + CloudIA está conectado», seguido de «Siguientes pasos».

Cómo es la pantalla final
Terminal de macOS: paso 3 Comprobación, conexiones OK, la conexión sirve, Tu EaaS + CloudIA está conectado y siguientes pasos
Ejemplo recreado en macOS: final de la instalación.
Si te dice que .mcp.json está versionado en git
Si al final dice «Commit PENDIENTE: .gitignore»

El instalador ha añadido a .gitignore los ficheros donde se guarda tu token de CloudIA, para que nunca se suban al repositorio. Es una protección: lo normal es que el repositorio ya los trajera. El instalador nunca hace commits, así que ese cambio queda pendiente. Confírmalo tú con estas dos órdenes, o pásaselo al responsable del repositorio para que lo incluya:

Ventana de terminal
git add .gitignore
git commit -m "Ignora los ficheros con el token de CloudIA"

Cuando lo tengas, sigue con el punto 5: Empieza a trabajar.

Abre tu asistente de IA dentro de tu carpeta de trabajo:

Si usas… Haz esto
Claude Desktop Abre la versión Code de la aplicación. Pulsa New y selecciona tu carpeta de trabajo: quedará a la izquierda como un proyecto. Crea y trabaja tus sesiones siempre desde ese proyecto, así CloudIA trabaja en tu carpeta.
Claude Code En una terminal, entra en tu carpeta de trabajo con cd y escribe claude.
App de GitHub Copilot Abre un proyecto, elige Open folder y selecciona tu carpeta de trabajo: quedará como un proyecto. Si la aplicación te pregunta si confías en el repositorio, pulsa Trust repository: si no, no cargará los conectores de CloudIA. Crea y trabaja tus sesiones siempre desde ese proyecto, y configura cada sesión así: (a) elige dónde trabaja la sesión: según la versión de la app lo verás como «Where to run this session» → Local repository o como «Where to work» → Current checkout; elige esa y no uses New worktree ni Cloud, porque la sesión trabajaría en una copia aparte del repositorio o en remoto y no podría leer la configuración de los conectores de CloudIA, que solo está en tu carpeta; (b) elige un modelo capaz, de los más avanzados de la lista; (c) en Context window, elige 1M.
Copilot CLI En una terminal, entra en tu carpeta de trabajo con cd y escribe copilot.
  1. Escríbele como primer mensaje 2fa <código autenticator app>, poniendo en lugar de <código autenticator app> el código de 6 dígitos que muestra en ese momento tu aplicación de autenticación. Sin esta verificación CloudIA no puede hacer nada: sus conectores la exigen antes de cualquier consulta. El código cambia cada 30 segundos; si caduca, escribe el nuevo. Es el único momento en que se escribe en la conversación, y es correcto.

  2. Después, comprueba que la instalación funciona pegando este mensaje. Te responderá con tu usuario, tu plataforma y lo que devuelve cada conector:

    Comprueba que CloudIA funciona: dime con qué usuario y plataforma estoy conectado, lista los conectores de CloudIA que tienes cargados y haz una consulta de lectura en cada uno enseñándome lo que devuelve. Si alguno falla, dime cuál y el error. No revises el repositorio ni propongas cambios.

    Si algún conector falla, te dirá cuál y con qué error: pasa ese mensaje al responsable de CloudIA de tu organización. Puede fallar un conector aunque la instalación esté bien, así que no hace falta repetirla.

  3. A partir de ahí, pídele lo que necesites, como a un compañero: qué tareas tienes, qué hay pendiente en un proyecto o que te ayude con un documento.

Listo: CloudIA ya está instalado.

Los tokens que has usado o creado con el instalador son tuyos y quedan asociados a tu usuario en la plataforma. En la plataforma, en el módulo CloudIA, sección Mi dashboard → Conectar CloudIA, puedes ver los que tienes activos, crear otros, recuperar uno para instalarlo en otro equipo y revocar los que ya no uses. Si pierdes un equipo o sospechas que un token se ha filtrado, revócalo ahí y vuelve a ejecutar el instalador: te ofrecerá crear uno nuevo.