Elige y configura tu agente
Abre un terminal y ya tienes Claude Code, Codex y OpenCode instalados, las aprobaciones desactivadas y las instrucciones de tu proyecto en su sitio. Elige el agente y una suscripción conectada o una clave de API de uno de siete proveedores, y pásale la tarea.
Elige el agente
Abre Terminales, elige Nueva terminal y el proyecto, y después el Agente: Claude Code, Codex u OpenCode. Luego elige la cuenta en Funciona con; la lista solo ofrece cuentas que ese agente puede usar.
| Agente | Cómo inicia sesión |
|---|---|
| Claude Code | Tu suscripción de Claude o una clave de API compatible; también puedes iniciar sesión dentro del terminal |
| Codex | Tu suscripción de ChatGPT o una clave de API compatible; también puedes iniciar sesión dentro del terminal |
| OpenCode | Una clave de API compatible o tu propio inicio de sesión dentro del terminal |
Iniciar sesión dentro del terminal funciona mientras no tengas una cuenta por defecto para ese agente: en Funciona con, elige la opción en la que el agente inicia sesión dentro del terminal. El agente te pide iniciar sesión como en tu portátil, y la sesión queda en la carpeta personal de ese proyecto, fuera de la vista de tus otros proyectos.
Las claves que acepta cada agente:
- Claude Code: Anthropic, DeepSeek, Z.ai, abliteration.ai.
- Codex: OpenAI, xAI, DeepSeek, Z.ai, abliteration.ai.
- OpenCode: Anthropic, OpenAI, xAI, DeepSeek, Z.ai, abliteration.ai, Gemini.
Claves de API muestra cómo añadirlas, renombrarlas y sustituirlas.

Lo que trae tu Compute
Cada terminal corre Ubuntu 26.04 LTS con sudo y Docker Engine con compose, y trae listo lo siguiente:
- Agentes: Claude Code, Codex y OpenCode.
- Lenguajes: Node 26, Python 3.14, Bun, uv, mise, pnpm, Yarn y pipx, con gcc y make de build-essential.
- Herramientas: git, gh, glab, ripgrep, fd, fzf, jq, yq, bat, delta, git-lfs, httpie, tmux, tree, ncdu, htop, btop, rsync, strace, lsof, netcat, dig, ping, socat, zip, vim y nano.
- Bases de datos: psql, redis-cli, sqlite3 y el cliente de MariaDB.
- Navegadores: Playwright con Chromium headless, enlazado en la caché de Playwright de cada carpeta personal, y
chrome-headless-shellconCHROME_PATHdefinido.
Go, Rust, Java y Ruby están a un comando: mise use -g go@latest, mise use -g rust, y así con los demás.
Docker y todo lo que ejecuta tienen menor prioridad de CPU y disco que el shell, tmux y el agente, así que una compilación pesada no frena al agente ni lo que escribes. Cada contenedor corre bajo el init de Docker, que recoge los procesos terminados.
Conserva tus propias herramientas
Instala un paquete del sistema con sudo en un terminal; al finalizar o reiniciar el terminal, desaparece. Para conservar una herramienta, instálala en la carpeta personal, que pertenece al proyecto:
mise use -g kubectl helm opentofu aws-clideja ahí esas CLI de nube.npm i -g <package>va a~/.npm-global, que ya está en tuPATH.- Un binario que dejes en
~/.local/binfunciona en todos los terminales del proyecto.
Go compila con -trimpath en cada carpeta personal, así que su caché de compilación guarda una copia de cada paquete en lugar de una por cada ruta de worktree de un agente. Los tests que encuentran archivos a su lado mediante runtime.Caller necesitan desactivarlo: ejecuta go env -w GOFLAGS= en el terminal del proyecto, o define GOFLAGS en el entorno.
Agentes al día, probados antes
Reconstruimos la imagen base cada 6 horas, con actualizaciones del sistema y los últimos Claude Code, Codex y OpenCode, y la comprobamos antes de que la use ningún terminal. Los terminales nuevos y reiniciados reciben la última imagen comprobada; uno en marcha conserva la suya.
Los agentes nunca se actualizan solos a mitad de trabajo: la versión de un terminal es la que probamos. Para pasar un terminal a los agentes más nuevos, reinícialo.
Las aprobaciones están desactivadas
| Agente | Modo |
|---|---|
| Claude Code | bypassPermissions |
| Codex | Política de aprobación never, acceso completo |
| OpenCode | Permiso allow |
Las pantallas de primer arranque y las preguntas de confianza en carpetas ya están respondidas, la carpeta del proyecto incluida. Abre un terminal y el agente está listo para una tarea.
Las instrucciones de tu proyecto, y las nuestras
Cada agente arranca en /work/<project>, así que el CLAUDE.md y el AGENTS.md del propio proyecto, sus skills, hooks y ajustes de .claude/, y su .mcp.json funcionan igual que en tu portátil.
Pide a cualquier agente que recuerde algo para el proyecto y lo escribe en AGENTS.md, en la raíz del proyecto. Claude Code, Codex y OpenCode leen ese archivo, Claude Code incluso junto a un CLAUDE.md.
Además, cada agente lee /etc/detachbox/AGENTS.md, un archivo corto nuestro. Explica cómo funcionan las URL de vista previa, para que los agentes te pasen el enlace en cuanto un servidor arranca. Está enlazado en ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md y ~/.config/opencode/AGENTS.md, y en la carpeta de ajustes que cada lanzamiento guarda en el proyecto.
Tu propio archivo en uno de esos sitios sigue siendo tuyo: detachbox solo añade una referencia al nuestro.
Abre una página en tu navegador con detachbox-open
detachbox-open <url> abre un enlace http o https en el navegador de quien está ante el terminal. xdg-open, open, sensible-browser, www-browser, x-www-browser y $BROWSER apuntan a él, así que los inicios de sesión que lanzan gh, el módulo webbrowser de Python o un agente llegan a tu navegador.
Un enlace al propio localhost:<port> de tu Compute se convierte en su URL de vista previa. Otros esquemas, como file:, se rechazan. Si en ese momento no hay ningún navegador ante el terminal, imprime el enlace para que lo abras tú. El terminal del navegador muestra qué hace el panel cuando llega una página.
Consigue un enlace de vista previa con detachbox-preview
detachbox-preview <port> [path] imprime la dirección que tiene en tu navegador un servidor en ese puerto, como https://3000-<terminal ID>.detachbox.dev/admin. Avisa cuando el servidor solo escucha en localhost o cuando todavía no escucha nada en el puerto. Los agentes lo usan para pasarte el enlace.
Pásale un prompt a un agente con detachbox-say
detachbox-say <tmux session> <text> entrega un texto al agente de ese terminal como un prompt nuevo. Se comunica directamente con el agente, sin simular pulsaciones de teclas, así que la línea que estás escribiendo queda intacta. Funciona con Claude Code y Codex.
El servidor lo usa para escribir «continue» cuando un límite se reinicia. El código de salida 3 significa que el terminal no tiene ningún Claude Code ni Codex en marcha al que entregarlo, y el 4, que el agente no aceptó el texto; en ambos casos el servidor lo escribe directamente en el terminal.