detachbox
PáginasProjetos e inicializações

Projetos e inicializações

Cada repositório em que você trabalha é um projeto: uma pasta em /work/<project> no disco da sua conta, e um projeto novo custa $0. Um clique coloca o Claude Code, o Codex ou o OpenCode para trabalhar dentro dele, na assinatura ou chave de API que você escolher, e vários agentes rodam lado a lado.

Projetos em shipyard: api, storefront, etl-pipeline e landing, cada um com os agentes que rodam nele.

O que é um projeto

Um projeto é uma pasta em /work/<project> no disco da sua conta e tem uma pasta pessoal própria, que os terminais dele veem em /home/dev. A pasta do projeto guarda seu código, as inicializações e as conversas do agente compartilhadas entre elas. A pasta do projeto e a pasta pessoal dele continuam lá quando os terminais que as usaram terminam.

Um terminal de projeto vê o próprio projeto e a própria pasta pessoal. Logins, chaves git, configurações dos agentes e caches ali pertencem só a esse projeto, e o que o código de um projeto deixa na própria pasta pessoal nunca roda em outro projeto. Cada terminal tem Docker e pacotes do sistema próprios. Um terminal de shell acessa todos os projetos do Compute dele e trabalha numa pasta pessoal só dele.

Todo projeto novo começa com a pasta pessoal limpa: faça login no git, no gh e nas suas outras ferramentas uma vez, no terminal dele. Um projeto criado antes de as pastas pessoais serem separadas já tem suas skills, subagentes, comandos, regras, estilos de saída e plugins copiados para a pasta pessoal dele.

/work/<project> · CLAUDE.md · AGENTS.md · .claude/ · .mcp.json

Crie um projeto

  1. Abra Projetos e escolha Novo projeto.
  2. Escolha de onde vem o código:
    • Clonar: cole o endereço que você passaria ao git clone, como git@github.com:you/app.git ou https://…. Ele é clonado com o login e as chaves git da pasta pessoal do seu shell, então repositórios privados funcionam: entre uma vez num terminal de shell com gh auth login ou glab auth login.
    • Vazio: uma pasta vazia. Deixe Fazer dele um repositório git marcado para começar com git init.
    • Pasta: uma pasta dentro de /home/dev dos seus terminais de shell. Ela é copiada para o projeto, e a pasta original continua onde estava.
  3. Confira o Nome. O nome segue o do repositório ou da pasta até você escolher outro: até 40 letras latinas minúsculas, dígitos e hífens. O nome vira o caminho, /work/<name>.
  4. Escolha Criar projeto.

Com mais de um Compute, a janela também pergunta em qual Compute o projeto vive. Ele fica lá: para continuar nele em outro Compute, faça push e clone lá.

Clonar um repositório grande leva alguns minutos, e a página mostra o progresso. Se a preparação parar, a página do projeto diz por quê: corrija o endereço ali mesmo e clique em Tentar de novo para preparar o mesmo projeto outra vez. O seu primeiro projeto também pode nascer em Terminais logo depois do checkout: Comece aqui mostra as três perguntas.

Encontre um projeto

Projetos lista cada projeto com os agentes das inicializações dele. A partir de 6 projetos, um campo de busca aparece no topo: aperte / e digite parte de um nome, de um agente ou de uma conta.

Abra um projeto para ver Onde ele fica: a pasta (o botão ao lado copia o comando cd), de onde veio o código e quando o projeto foi criado.

Inicie um agente num projeto

Uma inicialização é um agente e onde ele roda: Claude Code, Codex ou OpenCode, numa assinatura ou numa chave de API. Acrescente um modelo se quiser outro que não o padrão; o campo Modelo vazio mostra qual modelo a inicialização recebe para aquele agente e provedor. Uma inicialização numa assinatura ou chave conectada no painel também pode ligar a alternância e Continuar quando o limite renovar, e aí um limite não encerra mais a execução.

Escolha o agente primeiro e depois, em Roda em, uma conta que ele possa usar: uma assinatura do Claude para o Claude Code, uma assinatura do ChatGPT para o Codex, ou uma chave de API compatível para qualquer um dos três. Agentes lista qual chave funciona com qual agente.

A inicialização padrão de api: Claude Code numa de três assinaturas do Claude, com uma chave do DeepSeek e uma do Z.ai também à escolha, um modelo opcional e a alternância entre as assinaturas do Claude quando os limites se esgotam.

A primeira inicialização de um projeto vira a Inicialização padrão dele: a que um único clique roda. Um projeto sem nenhuma mostra Definir a inicialização padrão. Todas as outras combinações que você roda ou salva ficam em Inicializações salvas; Nova inicialização acrescenta uma ali sem iniciá-la.

Cada inicialização guarda as próprias configurações e o próprio login dentro do projeto, fora do git. As conversas do agente são do projeto: qualquer inicialização as encontra com claude --resume, codex resume ou opencode --continue, seja qual for a conta que as começou, então trocar de conta nunca faz você perder a conversa. Um terminal novo começa uma conversa nova. Reiniciar o terminal nesta conversa e Continuar quando o limite renovar dão sequência à atual.

Suas skills, subagentes, comandos, estilos de saída e regras no ~/.claude do projeto, e suas skills em ~/.codex/skills, chegam a todas as inicializações do projeto, seja qual for a conta em que rodam.

Claude e Codex · Chaves de API · Alternância

Edite uma inicialização

  • Inicialização padrão: escolha Editar na linha dela.
  • Inicialização salva: abra o menu ⋯ dela e escolha Editar ou Tornar padrão.

Mude o agente, Roda em, o modelo, a alternância e Continuar quando o limite renovar, depois escolha Salvar. O agente e o modelo valem para os terminais que você abrir dali em diante. A alternância chega também aos que já estão rodando, na hora.

Abra um terminal de um projeto

Escolha Iniciar ao lado de uma inicialização na página do projeto, ou escolha Novo terminal em Terminais e responda Projeto, Agente e Roda em. Uma combinação que você já salvou roda como está; uma combinação nova é salva como inicialização do projeto, pronta para a próxima vez. A linha embaixo do formulário diz qual das duas coisas Iniciar vai fazer.

Novo terminal em shipyard: escolha o projeto, o agente e onde ele roda, depois Iniciar; ou abra um Shell simples.

Cada terminal da lista mostra o projeto, o agente e a conta em que ele roda. Uma marca de alternância aparece quando a inicialização alterna assinaturas.

O projeto api: Claude Code com alternância como inicialização padrão, a um clique, e Codex review na própria conta entre as inicializações salvas.

O que fica para a próxima sessão

A pasta do projeto, com o código, as inicializações e todas as conversas do agente, fica no disco da conta. A pasta pessoal do projeto também, /home/dev nos terminais dele.

Imagens Docker, cache de compilação, contêineres, pacotes apt e serviços do sistema pertencem a esse terminal. Sobrevivem a um navegador fechado e a um reinício do nó, e vão embora quando você encerra ou reinicia o terminal. Guarde os dados dos bancos e o resto do trabalho no projeto ou na pasta pessoal dele.

Remova uma inicialização ou exclua um projeto

  • Remover uma inicialização: abra o menu ⋯ dela na página do projeto, escolha Remover e depois Remover inicialização. Os terminais dela terminam, e as configurações e o login dela saem do projeto. O código e as conversas do agente continuam à disposição das outras inicializações do projeto. Remova a inicialização padrão e a inicialização salva mais antiga vira a padrão.
  • Excluir um projeto: abra o menu ⋯ do projeto, escolha Excluir projeto e digite o nome dele. Os terminais dele terminam, as inicializações vão embora, e a pasta é apagada com todos os arquivos e conversas do agente. Faça push do que quiser manter antes.

Projetos e chaves de serviço

Com o Vault, cada projeto ganha um agente próprio no Sallyport, chamado detachbox · <project>. O detachbox cria esse agente para você, e tudo o que roda no projeto o compartilha. Você decide no Sallyport o que cada projeto pode chamar; a credencial dele fica na pasta .detachbox do projeto.