Use um projeto para organizar chats relacionados e dar ao ChatGPT o contexto de que ele precisa. No aplicativo do ChatGPT para desktop, a tela Projetos reúne os projetos do ChatGPT e os projetos locais vinculados a pastas no seu computador.
Escolha um projeto ou comece sem um
Crie um projeto se o trabalho for se estender ao longo do tempo, gerar mais de uma entrega ou depender dos mesmos arquivos e fontes. Inicie um chat sem projeto se puder concluir o trabalho nesse chat sem precisar do contexto compartilhado de um projeto.
Use um projeto para reunir chats, arquivos, instruções e fontes relacionados. Um mesmo projeto pode incluir chats iniciados com o Chat ou com o ChatGPT Work.
Escolha um projeto ou inicie um chat sem projeto
Crie um projeto se o trabalho for se estender ao longo do tempo, gerar mais de uma entrega ou depender dos mesmos arquivos e fontes. Inicie um chat sem projeto se puder concluir o trabalho nesse chat sem precisar do contexto compartilhado de um projeto.
Cada projeto tem uma seção Chats, que lista os chats do projeto, e uma seção Fontes, que reúne os arquivos enviados e o contexto das fontes conectadas. As instruções do projeto valem para todos os seus chats. Um projeto do ChatGPT não tem acesso direto a uma pasta no seu computador. Por isso, envie ou conecte as fontes que você quer que o ChatGPT use.
Em qualquer uma das opções, inicie um novo chat dentro do projeto para usar os arquivos e as instruções compartilhados. Para retomar o chat, abra a seção Chats.
O Codex CLI usa o diretório em que você o inicia como projeto do chat. Execute codex no diretório em que deseja que o Codex trabalhe ou passe a opção --cd <directory> (-C) para definir o diretório explicitamente. A CLI não oferece a tela Projetos do ChatGPT.
A extensão da IDE usa a pasta ou o workspace aberto na IDE como projeto local. Em um workspace com várias raízes, selecione a raiz que deseja usar no chat. A extensão não oferece a tela Projetos do ChatGPT disponível na Web e no aplicativo para desktop.
Trabalhe em um projeto
A tela Projetos reúne os projetos do ChatGPT e os projetos locais. Nos projetos do ChatGPT, os arquivos e o contexto do projeto ficam disponíveis em todos os chats relacionados. Em um projeto local, os chats têm acesso a uma ou mais pastas no seu computador, como as que contêm um conjunto de arquivos-fonte ou uma base de código.
Inicie um chat separado para cada objetivo. Assim, as mensagens e os resultados de cada chat ficam focados nesse objetivo, e o projeto mantém o trabalho relacionado organizado.
Trabalhe em um projeto
Em um projeto do ChatGPT, todos os chats têm acesso aos mesmos arquivos enviados, às mesmas instruções do projeto e às mesmas fontes conectadas. Use o Chat para uma conversa rápida ou o ChatGPT Work para uma entrega maior. Nos dois casos, o chat aparece na seção Chats do projeto. Inicie um chat separado para cada objetivo. Assim, as mensagens e os resultados de cada chat ficam focados nesse objetivo, e o projeto preserva o contexto compartilhado.
Trabalhe no diretório de um projeto
Inicie o Codex no diretório que contém os arquivos que o chat deve usar como contexto. Use /new para iniciar um chat separado para cada objetivo. Para retomar um chat salvo, use /resume com o Codex aberto ou execute codex resume.
O chat mantém o histórico das mensagens e o registro do diretório de trabalho. O Codex lê os arquivos da árvore de trabalho atual. Registre as orientações de longo prazo do projeto em AGENTS.md ou na documentação versionada para que fiquem disponíveis nos próximos chats.
Trabalhe em um workspace
Abra a pasta ou o workspace que contém os arquivos que o chat deve usar como contexto. Inicie um novo chat para cada objetivo. Para retomá-lo, selecione-o em Chats recentes. Os chats do mesmo projeto podem trabalhar com os mesmos arquivos, e cada chat mantém seu próprio histórico de mensagens.
A seleção atual e os arquivos abertos fornecem contexto para a interação em andamento. Registre as orientações de longo prazo do projeto em AGENTS.md ou na documentação versionada para que fiquem disponíveis nos próximos chats.
Organize projetos e chats
Mantenha o trabalho em andamento à vista e arquive o que já concluiu.
- Fixe um projeto para mantê-lo perto do topo da barra lateral. Você também pode fixá-lo pela tela Projetos.
- Fixe um chat se você o consulta com frequência, mesmo que apareçam chats mais recentes no projeto.
- Renomeie um chat com um título curto que descreva o resultado, como “Resumo do lançamento do 3º trimestre” ou “Revisão de acessibilidade da finalização da compra”.
- Pesquise projetos na tela Projetos. Na barra lateral, abra Pesquisar chats para encontrar um chat anterior quando você se lembrar de uma frase ou do nome de uma branch, mas não do título. A pesquisa de chats não tem um atalho padrão, mas você pode definir um em Configurações > Atalhos de teclado.
- Arquive um chat ao concluir o trabalho. Para arquivar todos os chats de um projeto de uma só vez, selecione Arquivar chats no menu do projeto.
Fixar um projeto ou chat não adiciona contexto nem altera o que o ChatGPT pode acessar. Isso muda apenas sua posição na barra lateral.
Para restaurar chats arquivados, acesse Configurações > Chats arquivados.
Organize projetos e chats
Mantenha o trabalho em andamento à vista e arquive o que já concluiu.
- Fixe um projeto para mantê-lo perto do topo da barra lateral. Você também pode fixá-lo pela tela Projetos.
- Fixe um chat se você o consulta com frequência, mesmo que apareçam chats mais recentes no projeto.
- Renomeie um chat com um título curto que descreva o resultado, como “Resumo do lançamento do 3º trimestre” ou “Revisão de acessibilidade da finalização da compra”.
- Pesquise projetos na tela Projetos. Use Cmd/Ctrl+K para pesquisar chats anteriores quando você se lembrar de uma frase ou do nome de uma branch, mas não do título.
- Arquive um chat ao concluir o trabalho.
Fixar um projeto ou chat não adiciona contexto nem altera o que o ChatGPT pode acessar. Isso muda apenas sua posição na barra lateral.
Para restaurar chats arquivados, acesse Configurações > Controles de dados > Chats arquivados.
Use projetos locais para trabalhar com pastas e bases de código
Para usar uma pasta de projeto aprovada ao retomar uma tarefa do modo Work em outro dispositivo, inicie uma nova tarefa da nuvem depois que o acesso ao computador local estiver habilitado no seu espaço de trabalho. Mantenha online e conectado o computador que contém a pasta.
A sincronização de conversas e o acesso aos arquivos do projeto são independentes.
- Sincronizar uma conversa não envia a pasta local inteira para a nuvem nem a disponibiliza em outro computador.
- Ao retomar uma tarefa, confira a quais fontes e ferramentas ela tem acesso.
- O histórico de conversas do modo Work permanece separado do histórico do Codex.
Adicione um projeto local quando o ChatGPT precisar ler ou alterar arquivos no seu computador. Os projetos não exigem uma pasta, mas você pode vincular pastas conforme necessário.
Para adicionar ou alterar pastas, abra o menu do projeto e selecione Editar projeto. Use Adicionar pasta para vincular várias pastas. O ChatGPT pode ler e alterar arquivos em todas as pastas vinculadas. Para mudar o diretório de trabalho padrão, passe o ponteiro sobre uma pasta e selecione Definir como principal.
Os novos chats começam na pasta principal. O Codex também usa essa pasta como padrão para operações do Git e para localizar automaticamente AGENTS.md, habilidades e config.toml. As pastas secundárias continuam disponíveis para pesquisar, ler e editar arquivos, mas o Codex não procura automaticamente esses arquivos de projeto nas pastas secundárias.
Use várias pastas quando partes relacionadas do trabalho estiverem em locais diferentes, como um aplicativo e sua documentação ou um site e seu backend. Crie projetos separados para trabalhos independentes ou quando cada chat precisar acessar apenas uma parte de um repositório. Assim, o contexto de trabalho fica restrito ao que interessa a cada chat. No momento, cada projeto remoto aceita uma pasta.
Use ambientes locais para definir as etapas de configuração e os comandos de uso frequente de um projeto. O painel de revisão pode mostrar alterações em vários repositórios vinculados ao mesmo projeto. As ações de pull request e de árvore de trabalho se aplicam ao repositório principal. Quando você inicia um chat em uma árvore de trabalho, as outras pastas continuam vinculadas.
Os projetos e as árvores de trabalho ajudam a organizar o trabalho. O sandbox impõe limites ao que os comandos locais podem ler, alterar ou acessar pela rede.
Inicie um chat sem projeto
No Codex, selecione Novo chat ao lado de Recentes para começar sem projeto. Use essa opção para trabalhos que você pode concluir em um único chat e que dispensam arquivos ou instruções compartilhados de um projeto e acesso a pastas. Se vários chats forem depender do mesmo contexto, crie um projeto primeiro.
Inicie um chat sem projeto
Inicie um chat na página inicial do ChatGPT quando ele não precisar dos arquivos, instruções ou fontes compartilhados de um projeto. Você pode usar o Chat ou o ChatGPT Work. Na Web, ambos criam chats.
Se o trabalho ganhar proporções maiores, mova o chat para um projeto e dê a cada chat um nome que deixe claro seu objetivo. Um projeto pode reunir chats paralelos de pesquisa, redação, revisão e acompanhamento sem misturar todas as mensagens em um único contexto.
Use o Chat rápido para uma pergunta rápida
O Chat rápido abre um chat comum do ChatGPT. Os chats do ChatGPT não aparecem na barra lateral do Codex, que reúne seus chats e projetos do Codex.
Passe o ponteiro sobre Novo chat e selecione o ícone de Chat rápido à direita. Você também pode pressionar
Cmd+Option+N no macOS ou Ctrl+Alt+N no Windows e no Linux. Em Novo chat, você pode abrir um chat existente do ChatGPT e adicioná-lo a um chat do Codex.
Adicione outras ferramentas e mais contexto
- Anexe arquivos ou imagens de entrada diretamente ao chat quando forem relevantes apenas para aquela solicitação.
- Instale plug-ins para usar o contexto e as ações de outros serviços.
- Configure os servidores MCP quando sua organização ou seu ambiente de desenvolvimento disponibilizar ferramentas por meio do Model Context Protocol.
- Use memórias, quando disponíveis, para aproveitar o contexto de trabalhos anteriores em chats futuros.
- Envie imagens de entrada ao chat quando o contexto visual for relevante apenas para aquela solicitação.
- Instale plug-ins para usar o contexto e as ações de outros serviços.
- Configure os servidores MCP quando sua organização ou seu ambiente de desenvolvimento disponibilizar ferramentas por meio do Model Context Protocol.
- Use memórias, quando disponíveis, para aproveitar o contexto de trabalhos anteriores em chats futuros.
- Faça referência a arquivos abertos ou selecione código no editor para adicionar contexto à interação atual.
- Configure os servidores MCP quando sua organização ou seu ambiente de desenvolvimento disponibilizar ferramentas por meio do Model Context Protocol.
- Use as memórias do host do Codex conectado, quando disponíveis, para aproveitar contexto útil em chats futuros.
- Adicione arquivos e fontes conectadas à seção Fontes do projeto quando quiser disponibilizá-los em todos os chats do projeto.
- Anexe arquivos ou imagens de entrada diretamente ao chat quando forem relevantes apenas para aquele chat.
- No ChatGPT Work, instale plug-ins para usar o contexto e as ações de outros serviços.
- Use memórias, quando disponíveis, para aproveitar o contexto de trabalhos anteriores em chats futuros.