Para usar AgentVera, instala los CLI de agentes de programación que quieras, añade una carpeta de proyecto, inicia uno o más agentes desde “New agent” y trabaja con ellos lado a lado en la cuadrícula del proyecto. Cada agente es el CLI real, como Claude Code o Codex, ejecutándose en su propio panel de terminal con su propio inicio de sesión. AgentVera añade lo que lo rodea: una cuadrícula por proyecto, un cuadro de mensajes con cola, el estado de un vistazo, checkpoints por turno, revisión de código y gestión de cuentas.
Esta guía te lleva de una ventana vacía a unos cuantos agentes funcionando. Cubre qué instalar primero, cómo funciona el diálogo “New agent”, cómo organizar la cuadrícula, cómo funciona el inicio de sesión para los CLI y para el propio AgentVera, y los hábitos que evitan que los agentes en paralelo se estorben.
Qué necesitas antes de empezar
AgentVera es una app de escritorio para macOS, Windows y Linux. Puedes obtenerla en la página de descarga. No incluye un modelo propio. Ejecuta los CLI de agentes que ya tienes en tu ordenador.
| Necesitas | Por qué |
|---|---|
| Al menos un CLI de agente, como Claude Code o Codex | AgentVera inicia el CLI real para cada agente |
| Un inicio de sesión para ese CLI | Los agentes usan el login y el plan propios del CLI |
| Una carpeta de proyecto, idealmente un repositorio Git | Los checkpoints, los worktrees y la revisión de código se apoyan en Git |
| Una cuenta de AgentVera (opcional) | Solo para las funciones de Pro y Team |
Si nunca has usado Claude Code, Cómo usar Claude Code explica cómo instalarlo e iniciar sesión. AgentVera admite 18 CLI de agentes, entre ellos Claude Code, Codex, Gemini CLI y GitHub Copilot CLI, así que puedes empezar con el que ya pagas.
Paso 1: añade tu primer proyecto
Abre AgentVera y haz clic en Add project folder en la barra superior. Elige la carpeta de un repositorio en el que trabajes. El proyecto aparece en la pantalla Projects home y en la barra superior, y puedes saltar entre proyectos desde ahí o con la paleta de comandos (⌘K, Ctrl K en Windows y Linux).
Cada proyecto tiene dos vistas:
- Workspace: la cuadrícula de paneles de agentes, donde pasas la mayor parte del tiempo.
- Details: información sobre el proyecto alrededor de los agentes.
Si solo quieres hacer una pregunta rápida antes de configurar un proyecto, la pantalla de inicio tiene un chat rápido. Esos chats se ejecutan en la propia carpeta de la app y no tocan tus proyectos.
Paso 2: inicia tu primer agente
Haz clic en New agent en la barra lateral, o pulsa ⌘N. El diálogo dice lo que necesita: elige una herramienta, luego dale un nombre al agente y, si hace falta, un rol.
- Tool: elige el CLI, por ejemplo Claude Code o Codex. Una herramienta que AgentVera no encuentra en este ordenador aparece marcada como Not installed.
- Agent name y Color: un nombre corto como «Backend» o «Reviewer» facilita recorrer la cuadrícula.
- Runs on: déjalo en This computer por ahora. También puedes ejecutar un agente en un servidor SSH.
- Account: el inicio de sesión que usa el agente. Por defecto es el que ya está en este ordenador. El campo muestra Signed in o Signed out.
- Workspace: la carpeta principal o uno de los worktrees de Git del proyecto.
- Role and instructions: opcional. En Claude se añade al system prompt, y en Codex se añade como instrucciones de desarrollador.
- Haz clic en Start agent.
El diálogo tiene más opciones, como perfil de contexto, navegador, mapa del proyecto, servidores MCP, contenedor Docker, presupuesto de tokens y rutas propias. Puedes dejarlas todas en sus valores por defecto en una primera ejecución y volver más tarde. Ahorro de tokens explica los perfiles de contexto, y Docker explica cómo ejecutar un agente en un contenedor.
El agente se abre en un panel. Ese panel es una terminal real que ejecuta el CLI, así que todo lo que el CLI hace en una terminal normal funciona también aquí, incluidos sus slash commands. Debajo hay un cuadro de mensajes con historial de prompts, borradores y una cola (⌘Enter encola un mensaje mientras el agente sigue ocupado).
Paso 3: inicia sesión con los agentes
Los agentes no inician sesión a través de AgentVera. Usan los inicios de sesión propios de los CLI, así que si claude o codex ya funciona en tu terminal, la cuenta por defecto está lista. AgentVera etiqueta esa cuenta por defecto como this computer.
Si una cuenta tiene la sesión cerrada, el diálogo “New agent” te avisa: «This account is signed out. Sign in from Settings → Accounts, or the agent will ask you to sign in on first launch.» Puedes seguir cualquiera de los dos caminos.
Para usar más de una cuenta de Claude o Codex, abre Settings → Accounts, haz clic en Add Claude account o Add Codex account, ponle un nombre y elige Add and sign in. Cada cuenta extra tiene su propia carpeta de configuración, y eliges con qué cuenta se ejecuta un agente al crearlo. Cómo cambiar de cuenta en Claude Code lo explica en detalle.
Paso 4: añade más agentes y organiza la cuadrícula
Un agente es útil. Dos o tres en paralelo son donde AgentVera se gana su sitio. Crea un segundo agente de la misma manera y dale a cada uno un trabajo claro y separado.
La cuadrícula está en Screen splitter (⌘⌥L). Elige el número de columnas y filas, desde 1×1 hasta 5×4, o un diseño ya preparado como «Top 2 · Bottom 1». Arrastra los divisores para cambiar el tamaño de los paneles y usa Equalize pane sizes para restablecerlos. Cada proyecto recuerda su propio diseño.
| Acción | Cómo |
|---|---|
| Intercambiar dos paneles | Arrastra un panel sobre otro |
| Maximizar un panel | Doble clic en su título, o ⌘⇧Enter |
| Mover el foco entre agentes | ⌘⌥ + teclas de flecha |
| Saltar a un panel | ⌘1 a ⌘9 |
| Abrir la paleta de comandos | ⌘K |
| Abrir el screen splitter | ⌘⌥L |
En Windows y Linux, usa Ctrl en lugar de ⌘ y Alt en lugar de ⌥. Puedes cambiar todos los atajos en Settings. Un panel también puede abrirse en un modal o en una ventana aparte si quieres un agente en una segunda pantalla.
Cuando varios agentes comparten una carpeta, pueden sobrescribir los archivos de los demás. Apuntar cada agente a su propio worktree de Git en el campo Workspace lo evita. Git worktrees para agentes en paralelo explica la configuración, y Cómo ejecutar varios agentes de Claude Code cubre cómo repartir el trabajo.
Paso 5: sigue lo que hace cada agente
Cada agente muestra un estado: Working, Waiting for you, Needs approval, Idle, Asleep, Stopped o Error. La barra de estado los cuenta, por ejemplo «2 working» o «3 agents need approval», para que veas qué te necesita sin abrir cada panel. Pulsa ⇧⌘A para ir al siguiente agente que espera una aprobación.
Cuando te alejas, las notificaciones de escritorio te avisan cuando un agente termina, falla o espera una aprobación. También puedes hacer que te lleguen al móvil. Consulta notificaciones y aprobaciones.
Paso 6: comprueba el trabajo y deshaz un mal turno
Dos funciones gratuitas te ayudan a confiar en lo que producen los agentes en paralelo.
- Revisión de código: cuando la activas en los ajustes del proyecto, un modelo de Claude que elijas revisa el código de cada agente cuando termina su turno. Los hallazgos llevan una gravedad y un enlace archivo:línea, y opcionalmente pueden volver al agente. Consulta revisión de código.
- Checkpoints: al empezar cada turno, AgentVera toma una instantánea de la carpeta de trabajo del agente. El botón Turns de la cabecera del panel lista los turnos y los archivos que cambió cada uno, y Roll back this turn devuelve la carpeta a su estado anterior. Cómo deshacer los cambios de Claude Code lo explica paso a paso.
Paso 7: inicia sesión en AgentVera solo cuando lo necesites
La mayor parte de lo que cubre esta guía está en el plan Free, sin cuenta. Pro y Team añaden funciones como flows, night shift, aprobación automática y cambio automático de cuenta. Para usarlas, elige Sign in to AgentVera en la app. Puedes iniciar sesión con el navegador (el inicio de sesión con Google y la autenticación en dos pasos se gestionan ahí) o con correo y contraseña. La página de precios lista lo que incluye cada plan.
Una primera sesión que funciona
Si no sabes qué probar primero, esta es una configuración sencilla que muestra el valor rápido:
- Añade un repositorio que conozcas bien.
- Inicia un agente de Claude Code en un worktree nuevo y pídele un cambio pequeño y bien acotado.
- Inicia un segundo agente (Codex, u otro Claude Code) en su propio worktree con una tarea no relacionada.
- Configura la cuadrícula en dos columnas y mantén ambos visibles.
- Mientras trabajan, lee los diffs, responde a las aprobaciones y encola tu siguiente mensaje.
- Cuando un turno sale mal, revierte desde Turns en lugar de discutir con el agente.
Consejos para la primera semana
- Un trabajo por agente. Pon a los agentes el nombre de su trabajo. Un rol claro en “Role and instructions” te ahorra repetirte.
- Un worktree por agente. Es la forma más fácil de evitar que los agentes se sobrescriban.
- Mantén la cuadrícula pequeña al principio. Dos o tres agentes que lees de verdad valen más que ocho que solo hojeas.
- Usa la paleta. ⌘K encuentra casi todas las acciones, con su atajo al lado.
- Vigila los límites. La barra de estado muestra el uso de 5 horas y semanal de cada cuenta. Límites de uso de Claude Code tiene consejos para que duren más.
- Cambia el idioma si quieres. La interfaz está en inglés y turco, con temas claro y oscuro, en Settings → Appearance.
Conclusión
Empezar con AgentVera lleva unos minutos. Añades un proyecto, inicias un agente con el CLI que ya usas y añades un segundo cuando tienes una segunda tarea. Todo lo demás, como worktrees, checkpoints, revisión, cuentas extra y notificaciones al móvil, se apoya en esa misma cuadrícula. Puedes añadir cada cosa cuando la necesites.