Projetos e inicializações

Cada repositório em que você trabalha é um projeto: uma pasta em /work/<project> no disco da sua conta. Um clique inicia o Claude Code, o Codex ou o OpenCode dentro dele, cada um na própria assinatura, vários lado a lado.

O que é um projeto

Um projeto é uma pasta em /work/<project> no disco da sua conta, ao lado da sua pasta pessoal /home/dev. Ele guarda seu código, as inicializações e as sessões do agente que todas elas compartilham, e continua lá quando os terminais que o usaram terminam.

Um terminal de projeto vê seu projeto e a pasta pessoal compartilhada. Cada terminal tem Docker e pacotes do sistema próprios. Um terminal Shell acessa todos os seus projetos.

/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 as suas chaves git no seu Compute, então repositórios privados funcionam.
   • 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 no seu Compute. Ela é copiada para o projeto, e a pasta original continua onde estava.
3. Confira o Nome. Ele acompanha o repositório ou a pasta até você digitar o seu: até 40 letras latinas minúsculas, dígitos e hífens. O nome vira o caminho, /work/<name>.
4. Escolha Criar projeto.

O clone de um repositório grande leva alguns minutos, e a página acompanha. O seu primeiro projeto também pode nascer em Terminais logo depois do checkout: Comece aqui mostra as três perguntas.

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 do agente e, para o Claude Code e o Codex, a alternância e Continuar quando o limite renovar.

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 primeira inicialização de um projeto vira a Inicialização padrão dele: a que um único clique roda. Todas as outras combinações que você roda ou salva ficam em Inicializações salvas, onde você pode rodar, editar, remover ou tornar padrão cada uma.

Cada inicialização guarda as próprias configurações e o próprio login dentro do projeto, fora do git. As sessões do agente são do projeto: todas as inicializações dele as veem em claude --resume ou codex resume, e uma inicialização nova retoma a mais recente, seja qual for a conta que a começou.

Claude / Codex · API · Rotation

Abra um terminal novo

Escolha Novo terminal em Terminais e preencha três campos: Projeto, Agente e Roda em. Escolha Iniciar. Uma combinação que você já salvou roda como está; uma nova fica salva como inicialização do projeto no caminho, pronta para a próxima vez.

Novo projeto… na lista de projetos traz mais código, e Shell abre um shell de login puro, que dispensa inicialização. Cada escolha inicia um ambiente novo, então escolha um terminal que está rodando na lista para voltar a ele.

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

O que fica para a próxima sessão

A pasta do projeto, com o código, as inicializações e cada sessão do agente, fica no disco da conta, assim como tudo em /home/dev.

Imagens Docker, cache de compilação, contêineres, pacotes apt e serviços do sistema pertencem a esse terminal. Continuam após fechar o navegador e são removidos ao encerrar o terminal. Guarde dados e trabalho no projeto ou na pasta pessoal.

Remova uma inicialização ou exclua um projeto

• Remover uma inicialização: abra o menu ⋯ dela na página do projeto e escolha Remover. As abas dela fecham, e as configurações e o login dela saem do projeto. O código e as sessões do agente ficam para as outras inicializações do projeto.
• Excluir um projeto: abra o menu ⋯ do projeto, escolha Excluir projeto e digite o nome dele. As abas fecham, as inicializações vão embora, e a pasta é apagada com todos os arquivos e sessões 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>, criado para você e compartilhado por tudo o que roda no projeto. Você decide no Sallyport o que cada projeto pode chamar, e o passe dele mora na pasta .detachbox do projeto.