detachbox
PáginasElige y configura tu agente

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.

AgenteCómo inicia sesión
Claude CodeTu suscripción de Claude o una clave de API compatible; también puedes iniciar sesión dentro del terminal
CodexTu suscripción de ChatGPT o una clave de API compatible; también puedes iniciar sesión dentro del terminal
OpenCodeUna 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.

El lanzamiento por defecto de api: Claude Code con una de tres suscripciones de Claude, con una clave de DeepSeek y otra de Z.ai también a elegir, un modelo opcional y rotación entre las suscripciones de Claude cuando se agotan los límites.

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-shell con CHROME_PATH definido.

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-cli deja ahí esas CLI de nube.
  • npm i -g <package> va a ~/.npm-global, que ya está en tu PATH.
  • Un binario que dejes en ~/.local/bin funciona 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

AgenteModo
Claude CodebypassPermissions
CodexPolítica de aprobación never, acceso completo
OpenCodePermiso 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.