Tu IA, explicada sin tecnicismosYour AI, explained without jargon
Graba no trae una IA propia: usa la que tú ya tienes, con tu cuenta. Para eso necesita una pequeña herramienta que se instala una sola vez. Aquí te explicamos qué es, cuál elegir y cómo dejarla lista en unos cinco minutos. No necesitas saber programar.Graba doesn't bring its own AI: it uses the one you already have, with your account. For that it needs a small tool you install just once. Here's what it is, which one to pick and how to set it up in about five minutes. No coding required.
¿Qué son Claude Code, Codex y Antigravity CLI?What are Claude Code, Codex and Antigravity CLI?
Seguro conoces Claude, ChatGPT o Gemini como un chat en el navegador o en el teléfono. Estas herramientas son el mismo asistente, en versión para el computador: en vez de una página web, funcionan desde la terminal (esa ventana donde se escriben comandos). Gracias a eso, Graba puede pedirle a tu IA que escriba las notas y el guion en segundo plano, sin abrir nada.You probably know Claude, ChatGPT or Gemini as a chat in your browser or phone. These tools are the same assistant, in a version for your computer: instead of a web page, they run from the terminal (that window where you type commands). That lets Graba ask your AI to write your notes and script in the background, without opening anything.
🙌 Después de instalarla, no tienes que volver a la terminal. Graba la usa por ti. Tu contraseña la escribes solo en la página oficial de tu proveedor: Graba nunca la ve.🙌 Once it's installed, you never have to go back to the terminal. Graba uses it for you. You type your password only on your provider's official page: Graba never sees it.
¿Cuál elijo?Which one should I pick?
La que ya usas. Si tienes varias, cualquiera sirve, y puedes cambiar después.The one you already use. If you have several, any works, and you can switch later.
¿No usas ninguna? Lo más simple para empezar sin pagar es ChatGPT con Codex: creas una cuenta gratis en chatgpt.com y sigues los pasos de abajo.Don't use any? The simplest free start is ChatGPT with Codex: create a free account at chatgpt.com and follow the steps below.
Antes de empezar: abre la terminalBefore you start: open the terminal
Aprieta ⌘ + Espacio, escribe Terminal y aprieta Enter. Se abre una ventana con texto: ahí vas a pegar los comandos con ⌘ + V y apretar Enter.Press ⌘ + Space, type Terminal and press Enter. A window with text opens: that's where you'll paste commands with ⌘ + V and press Enter.
Aprieta la tecla Windows, escribe PowerShell y aprieta Enter (no hace falta abrirlo como administrador). Pega los comandos con Ctrl + V o clic derecho, y aprieta Enter.Press the Windows key, type PowerShell and press Enter (no need to run it as administrator). Paste commands with Ctrl + V or right-click, and press Enter.
En Ubuntu y la mayoría de las distribuciones: Ctrl + Alt + T. Pega los comandos con Ctrl + Shift + V y aprieta Enter.On Ubuntu and most distributions: Ctrl + Alt + T. Paste commands with Ctrl + Shift + V and press Enter.
Cada comando de esta guía tiene un botón Copiar. No tienes que escribir nada a mano.Every command in this guide has a Copy button. You don't have to type anything by hand.
Claude Code
Para quienes usan ClaudeFor Claude usersTen tu cuenta listaHave your account ready
Necesitas Claude Pro o Max, o una cuenta de trabajo (Team o Enterprise). El plan gratis de Claude no incluye Claude Code.You need Claude Pro or Max, or a work account (Team or Enterprise). Claude's free plan doesn't include Claude Code.
InstálaloInstall it
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexOtras formas de instalarloOther ways to install it
- Con Homebrew:With Homebrew:
brew install --cask claude-code - Con WinGet:With WinGet:
winget install Anthropic.ClaudeCode - Con npm (necesita Node.js):With npm (needs Node.js):
npm install -g @anthropic-ai/claude-code
- Con Homebrew:With Homebrew:
Inicia sesiónSign in
Cierra la terminal, ábrela de nuevo y escribe
claude+ Enter. Se abrirá tu navegador para entrar con tu cuenta de Claude. Cuando termine, vuelve a la terminal y sal con Ctrl + C dos veces.Close the terminal, open it again and typeclaude+ Enter. Your browser will open so you can sign in with your Claude account. When it's done, go back to the terminal and exit with Ctrl + C twice.claudeComprueba que quedó bienCheck it worked
Debería mostrar un número de versión. Si algo no anda,
claude doctorte dice qué revisar.It should print a version number. If something's off,claude doctortells you what to check.claude --versionListo: vuelve a GrabaDone: go back to Graba
En Graba, en «Elige tu IA» (o Ajustes → Tu IA), toca Usar junto a Claude. Cuando diga ✓ En uso, sigue adelante.In Graba, in “Choose your AI” (or Settings → Your AI), click Use next to Claude. When it says ✓ In use, move on.
Codex
Para quienes usan ChatGPTFor ChatGPT usersTen tu cuenta listaHave your account ready
Sirve cualquier cuenta de ChatGPT: la gratis (con límites de uso más bajos) o una de pago (Plus, Pro, Business…). Si no tienes, créala en chatgpt.com.Any ChatGPT account works: the free one (with lower usage limits) or a paid one (Plus, Pro, Business…). If you don't have one, create it at chatgpt.com.
InstálaloInstall it
curl -fsSL https://chatgpt.com/codex/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Otras formas de instalarloOther ways to install it
- Con Homebrew:With Homebrew:
brew install --cask codex - Con npm (necesita Node.js):With npm (needs Node.js):
npm install -g @openai/codex
- Con Homebrew:With Homebrew:
Inicia sesiónSign in
Cierra y vuelve a abrir la terminal, escribe
codex+ Enter y elige Sign in with ChatGPT. Se abre el navegador: entra con tu cuenta y confirma. Después puedes cerrar la terminal.Close and reopen the terminal, typecodex+ Enter and choose Sign in with ChatGPT. Your browser opens: sign in and confirm. Then you can close the terminal.codexComprueba que quedó bienCheck it worked
Este comando te dice si la sesión está iniciada.This command tells you whether you're signed in.
codex login statusListo: vuelve a GrabaDone: go back to Graba
En Graba, en «Elige tu IA», toca Usar junto a ChatGPT (Codex).In Graba, in “Choose your AI”, click Use next to ChatGPT (Codex).
Antigravity CLI beta
Para quienes usan GeminiFor Gemini usersUn cambio reciente: en junio de 2026 Google dejó de ofrecer Gemini CLI para cuentas personales y lo reemplazó por Antigravity CLI (el comando agy). Graba usa Antigravity si lo tienes; si ya usabas Gemini CLI con una clave de API de pago, también funciona. Como es nuevo, el soporte de Graba está en beta: si algo falla, cuéntanos.A recent change: in June 2026 Google stopped offering Gemini CLI to personal accounts and replaced it with Antigravity CLI (the agy command). Graba uses Antigravity if you have it; if you already used Gemini CLI with a paid API key, that works too. Since it's new, Graba's support is in beta: if something breaks, let us know.
Ten tu cuenta listaHave your account ready
Una cuenta de Google. Google ofrece un uso sin costo con límites que pueden cambiar; con Google AI Pro o Ultra tienes más.A Google account. Google offers free usage with limits that may change; Google AI Pro or Ultra gives you more.
InstálaloInstall it
curl -fsSL https://antigravity.google/cli/install.sh | bashirm https://antigravity.google/cli/install.ps1 | iexInicia sesiónSign in
Cierra y vuelve a abrir la terminal y pídele algo cualquiera. La primera vez se abre el navegador para entrar con tu cuenta de Google.Close and reopen the terminal and ask it anything. The first time, your browser opens so you can sign in with your Google account.
agy -p "hola"Comprueba que quedó bienCheck it worked
agy --versionListo: vuelve a GrabaDone: go back to Graba
En Graba, en «Elige tu IA», toca Usar junto a Gemini.In Graba, in “Choose your AI”, click Use next to Gemini.
¿Qué recibe tu IA?What does your AI receive?
Solo el texto de tu grabación (la transcripción) y las instrucciones para escribir las notas y el guion. Nunca el video ni el audio. Va directo de tu computador a tu proveedor, con tu cuenta, igual que si lo pegaras en su chat.Only your recording's text (the transcript) and the instructions to write the notes and script. Never the video or audio. It goes straight from your computer to your provider, with your account, just as if you pasted it into their chat.
Un consejo: revisa la configuración de privacidad de tu cuenta de IA (por ejemplo, si permites que usen tus conversaciones para entrenar sus modelos) y elige lo que te acomode. Y recuerda avisar a los demás que estás grabando.A tip: check your AI account's privacy settings (for example, whether your conversations may be used to train their models) and choose what suits you. And remember to tell others you're recording.
Si algo no funcionaIf something doesn't work
Dice «command not found» o «no se reconoce como comando»It says “command not found” or “is not recognized”
- Cierra la terminal y ábrela de nuevo: la terminal que estaba abierta no ve lo recién instalado.Close the terminal and open it again: the one that was open can't see what you just installed.
- Si el instalador mostró un mensaje para agregar una carpeta (por ejemplo
~/.local/bin) a tu PATH, copia y ejecuta el comando que te indicó.If the installer showed a message about adding a folder (for example~/.local/bin) to your PATH, copy and run the command it showed. - Igual prueba en Graba: busca en las carpetas habituales, así que a veces la encuentra aunque la terminal no. Abre Ajustes → Tu IA.Try in Graba anyway: it looks in the usual folders, so it sometimes finds it even when the terminal doesn't. Open Settings → Your AI.
Graba dice que no has iniciado sesiónGraba says you're not signed in
Abre la terminal, escribe el nombre de tu IA (claude, codex o agy -p "hola") y completa el inicio de sesión en el navegador. Después vuelve a tocar Probar.Open the terminal, type your AI's name (claude, codex or agy -p "hello") and finish signing in in the browser. Then click Test again.
Windows dice que la ejecución de scripts está deshabilitadaWindows says running scripts is disabled
Antepón powershell -ExecutionPolicy ByPass -c y pon el comando entre comillas, así: powershell -ExecutionPolicy ByPass -c "irm https://claude.ai/install.ps1 | iex". Solo afecta a ese comando.Prefix it with powershell -ExecutionPolicy ByPass -c and put the command in quotes, like this: powershell -ExecutionPolicy ByPass -c "irm https://claude.ai/install.ps1 | iex". It only affects that command.
Usé npm y salió un error de permisos (EACCES)I used npm and got a permissions error (EACCES)
Usa mejor el instalador de un comando de arriba: no necesita Node.js ni permisos de administrador. Evita sudo npm install.Use the one-command installer above instead: it needs neither Node.js nor admin rights. Avoid sudo npm install.
Funciona, pero se acabó mi límite de usoIt works, but I ran out of usage
Cada proveedor tiene límites según tu plan. Espera a que se renueven o cambia de IA en Graba: Ajustes → Tu IA.Each provider has limits based on your plan. Wait for them to reset or switch AI in Graba: Settings → Your AI.
Mi empresa no me deja instalar programasMy company doesn't let me install software
Estos instaladores no piden permisos de administrador, pero algunas empresas los bloquean igual. Pregúntale a tu equipo de TI, o instala Graba y tu IA en un computador personal.These installers don't ask for admin rights, but some companies block them anyway. Ask your IT team, or install Graba and your AI on a personal computer.
¿Sigues con dudas?Still stuck?Cuéntanos qué pasó, con tus palabras. Respondemos y, de paso, mejoramos esta guía.Tell us what happened, in your own words. We'll reply and improve this guide along the way.
Pedir ayudaAsk for help