Escolha e configure seu agente
Abra um terminal e o Claude Code, o Codex e o OpenCode já estão instalados, com as aprovações desligadas e as instruções do seu projeto no lugar. Escolha o agente e uma assinatura conectada ou uma chave de API de um dos sete provedores, e passe a tarefa.
Escolha o agente
Abra Terminais, escolha Novo terminal e o projeto, depois o Agente: Claude Code, Codex ou OpenCode. Depois escolha a conta em Roda em; a lista mostra só as contas que esse agente pode usar.
| Agente | Como faz login |
|---|---|
| Claude Code | Sua assinatura Claude ou uma chave de API compatível; também dá para fazer login no próprio terminal |
| Codex | Sua assinatura ChatGPT ou uma chave de API compatível; também dá para fazer login no próprio terminal |
| OpenCode | Uma chave de API compatível ou seu próprio login no terminal |
O login no próprio terminal funciona enquanto você não tem uma conta padrão para esse agente: em Roda em, escolha a opção em que o agente faz login no terminal. O agente pede o login como no seu notebook, e o login fica na pasta pessoal desse projeto, fora da vista dos seus outros projetos.
As chaves que cada agente aceita:
- 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.
Chaves de API mostra como adicionar, renomear e substituir as chaves.

O que vem no seu Compute
Cada terminal roda Ubuntu 26.04 LTS com sudo e Docker Engine com compose, e já traz isto:
- Agentes: Claude Code, Codex e OpenCode.
- Linguagens: Node 26, Python 3.14, Bun, uv, mise, pnpm, Yarn e pipx, com gcc e make do build-essential.
- Ferramentas: 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 e nano.
- Bancos de dados: psql, redis-cli, sqlite3 e o cliente MariaDB.
- Navegadores: Playwright com Chromium headless, ligado ao cache do Playwright de cada pasta pessoal, e
chrome-headless-shellcomCHROME_PATHdefinido.
Go, Rust, Java e Ruby estão a um comando de distância: mise use -g go@latest, mise use -g rust e assim por diante.
O Docker e tudo o que ele roda ficam atrás do shell, do tmux e do agente na fila de CPU e de disco, então uma compilação pesada não deixa o agente nem a sua digitação lentos. Todo contêiner roda sob o init do Docker, que recolhe os processos que terminaram.
Guarde suas próprias ferramentas
Instale um pacote do sistema com sudo num terminal; ao encerrar ou reiniciar o terminal, ele some. Para guardar uma ferramenta, instale-a na pasta pessoal, que pertence ao projeto:
mise use -g kubectl helm opentofu aws-clicoloca essas CLIs de nuvem lá.npm i -g <package>vai para~/.npm-global, que já está no seuPATH.- Um binário que você põe em
~/.local/binroda em todos os terminais do projeto.
O Go compila com -trimpath em cada pasta pessoal, então o cache de compilação guarda uma cópia de cada pacote, e não uma por caminho de worktree de agente. Testes que acham arquivos ao lado de si mesmos via runtime.Caller precisam disso desligado: rode go env -w GOFLAGS= no terminal do projeto ou defina GOFLAGS no ambiente.
Agentes novos, testados antes
Reconstruímos a imagem base a cada 6 horas, com as atualizações do sistema e as versões mais novas do Claude Code, do Codex e do OpenCode, e verificamos a imagem antes que qualquer terminal a use. Terminais novos e reiniciados recebem a última imagem verificada; um terminal rodando mantém a sua.
Os agentes nunca se atualizam no meio de uma execução: a versão num terminal é a que nós testamos. Para levar um terminal aos agentes mais novos, reinicie-o.
Aprovações desligadas
| Agente | Modo |
|---|---|
| Claude Code | bypassPermissions |
| Codex | Política de aprovação never, acesso total |
| OpenCode | Permissão allow |
As telas de primeira execução e as perguntas de confiança na pasta já vêm respondidas, inclusive para a pasta do projeto. Abra um terminal e o agente está pronto para uma tarefa.
As instruções do seu projeto, e as nossas
Todo agente começa em /work/<project>, então o CLAUDE.md, o AGENTS.md, as skills, hooks e configurações em .claude/ e o .mcp.json do próprio projeto funcionam como no seu notebook.
Peça a qualquer agente para lembrar algo do projeto e ele escreve em AGENTS.md, na raiz do projeto. Claude Code, Codex e OpenCode leem esse arquivo, o Claude Code até ao lado de um CLAUDE.md.
Além disso, todo agente lê /etc/detachbox/AGENTS.md, um arquivo curto do detachbox. Ele explica como funcionam as URLs de preview, para que os agentes passem o link a você quando um servidor sobe. Esse arquivo é referenciado em ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md e ~/.config/opencode/AGENTS.md, e na pasta de configurações que cada inicialização guarda no projeto.
Seu próprio arquivo num desses lugares continua seu: o detachbox só acrescenta uma referência ao nosso.
Abra uma página no seu navegador com o detachbox-open
detachbox-open <url> abre um link http ou https no navegador de quem está no terminal. xdg-open, open, sensible-browser, www-browser, x-www-browser e $BROWSER apontam todos para ele. Assim, os logins iniciados pelo gh, pelo webbrowser do Python ou por um agente caem no seu navegador.
Um link para o localhost:<port> do seu próprio Compute vira a URL de preview dele. Outros esquemas, como file:, são recusados. Sem nenhum navegador no terminal naquele momento, ele imprime o link para você abrir. O terminal no navegador mostra o que o painel faz quando chega uma página.
Pegue um link de preview com o detachbox-preview
detachbox-preview <port> [path] imprime o endereço que um servidor naquela porta tem no seu navegador, como https://3000-<terminal ID>.detachbox.dev/admin. Ele avisa quando o servidor escuta só em localhost ou quando nada escuta na porta ainda. Os agentes o usam para passar o link a você.
Passe um prompt para o agente com o detachbox-say
detachbox-say <tmux session> <text> entrega um texto ao agente daquele terminal como um prompt novo, pelo canal do próprio agente e sem simular teclas, então uma linha que você está digitando fica intacta. Funciona com o Claude Code e o Codex.
O servidor usa esse comando para digitar "continue" quando um limite renova. O código de saída 3 quer dizer que o terminal não tem Claude Code nem Codex rodando para receber o texto, e o 4, que o agente não aceitou o texto; nos dois casos, o servidor digita o texto direto no terminal.