Codex na Prática
Versão: 1.0.0
Tempo de leitura: cerca de 4 minutos
Não tem mágica nenhuma. O ChatGPT no navegador, aquele que viralizou em 2024, responde dentro do chat. Você cola um trecho, recebe um texto, copia de volta para o Word, o e-mail, a planilha.
Um projeto no Codex é essa conversa ligada a uma pasta no computador. O Codex lê o que está lá e altera arquivo. O resultado fica na pasta.
É só isso.
O Codex vem no plano do ChatGPT. O plano pago costuma aumentar o quanto você usa. No aplicativo de desktop, Projetos junta os chats de um trabalho e indica as pastas que o Codex pode manipular. No navegador, o projeto guarda o que você enviou. No desktop, ele abre a pasta da máquina.
O que é um projeto
Crie um projeto quando o trabalho continua, depende dos mesmos arquivos, precisa de ferramentas do computador ou produz mais de um resultado (um estudo e uma apresentação, por exemplo). Um chat avulso vale a pena somente quando o pedido começa e termina ali.
No desktop você pode ligar mais de uma pasta. Uma delas é a principal: os chats novos começam nela.
Exemplo de pasta de pesquisa:
projeto-de-pesquisa
├── bibliografia
│ ├── livro-1.pdf
│ ├── livro-2.pdf
│ ├── artigo-1.pdf
│ └── artigo-2.pdf
├── base-de-dados
│ ├── dados.csv
│ ├── planilha-1.xlsx
│ └── planilha-2.xlsx
└── fichamentos
├── fichamento-1.docx
└── fichamento-2.docxNa prática
- Use como pasta principal a do trabalho (acrescente outra só quando for fonte).
- Se houver arquivos parecidos, diga qual vale.
- Não aponte a pasta pessoal inteira para o agente de IA só por conveniência:
- Isso faz que ele leia e analise coisas que talvez não fossem necessárias.
Se você usa as mesmas regras recorrentemente no projeto, pode valer a pena criar um arquivo AGENTS.md na pasta do projeto. Esse é um arquivo que o aplicativo (Codex) lê antes de começar a trabalhar. Exemplo: “não invente citação”, cheque se as referências são verdadeiras e comprováveis pelos links indicados.
Você pode pedir para o próprio agente de IA montar o arquivo.
Pedir, planejar e apontar arquivo
No ChatGPT do navegador você escreve na caixa de baixo e espera a resposta. Aqui também. A diferença é que o Codex pode alterar arquivo na pasta, então o pedido precisa dizer o que deve existir no final, o que não mexer, e como você vai conferir.
Um chat por resultado. Se misturar dois trabalhos no mesmo chat, o risco é o resultado ser pior do que a encomenda (e daí emerge e percepção de que agentes de IA não são tão capazes assim como se promete).
Exemplo:
Leia os PDFs em `bibliografia` e atualize `fichamentos/fichamento-1.docx`. Não invente citação. Quando terminar, descreva o que mudou no arquivo.Agora, dentro do aplicativo, essa mesma caixa de texto funciona de jeitos diferentes.
O jeito comum é o de sempre: você pede e ele executa. Lê a pasta, altera arquivo, devolve o resultado. É o Codex no modo agente e é o que você vê na caixa de texto acima.
Se você ainda não sabe os passos, pode ser interessante pedir primeiro um plano. Na caixa de diálogo você pode digitar / (uma barra), isso abre um menu e você pode escolher “planejamento” (escreva /plan). Nesse modo, o Codex descreve o que pretende fazer e espera você aceitar. Você pode revisar, alterar, colocar e retirar dúvidas e só depois da aprovação é que o agente vai mexer nos arquivos.
Se o trabalho é longo, com várias etapas, você pode planejar o percurso com várias etapas (e cada uma delas sendo executada e checada passo a passo) ou pode ainda definir uma meta. Nesse caso o uso seria a barra /goal. Aparece um objetivo visível no chat, e o Codex continua nisso até terminar, pausar ou precisar de você.
Além disso, a tecla / abre o menu de comandos. Dali você muda para planejamento, grava uma meta ou também pode chamar uma skill (um prompt reutilizável; saiba mais em Skills na Prática).
A tecla @, por sua vez, aponta um arquivo da pasta do projeto. Em vez de fazer upload como no ChatGPT online, você escreve @ e escolhe o PDF, a planilha, o fichamento. Desse modo, o Codex já recebe diretamente o endereço do arquivo para onde ele deve concentrar sua atenção.