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.

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
- Abra Projetos e escolha Novo projeto.
- Escolha de onde vem o código:
- Clonar: cole o endereço que você passaria ao
git clone, comogit@github.com:you/app.gitouhttps://…. 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 comgh auth loginouglab 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/devdos seus terminais de shell. Ela é copiada para o projeto, e a pasta original continua onde estava.
- Clonar: cole o endereço que você passaria ao
- 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>. - 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 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.

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 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.