O Codex tem um plano.Ponha-o num ficheiro que possa rever.

O que faz /plan no Codex

O comando /plan põe o Codex em plan mode. Em vez de começar a escrever código, o Codex propõe primeiro um plano de execução. Pode escrever o pedido a seguir ao comando: /plan Propose a migration plan for this service. O comando não está disponível enquanto o Codex já está a trabalhar noutra coisa, por isso use-o no início de uma tarefa.

Porque é que o plano deve ser um ficheiro

No plan mode o plano volta como mensagem de chat. A documentação da OpenAI não nomeia nenhum ficheiro de plano. Uma mensagem de chat é difícil de rever: desaparece, não é possível apontar para um só passo e mais ninguém a pode ler.

Um ficheiro resolve as três coisas. Pode comentar uma única linha, compará-lo com a versão anterior, fazer commit dele e passá-lo a outro agente. Por isso peça o plano como ficheiro, numa pasta à sua escolha.

O prompt que funciona

Depois de o Codex propor o plano, ou no mesmo pedido, diga:

Write the plan to plans/<name>.md and send it to me in DotMD for review.

O Codex escreve o ficheiro e chama o request_review do DotMD. O ficheiro aparece em Needs You na barra lateral, e o Codex espera. Lê o plano formatado, seleciona um passo e prime ⌥⌘M para comentar, e depois clica em Send. O Codex recebe os seus comentários, corrige o plano e devolve cada comentário. Aceita ou reabre cada correção e clica em Approve quando estiver certo.

Se o Codex procurar comentários no projeto em vez de os ler do DotMD, mencione o DotMD no pedido ou acrescente uma linha ao AGENTS.md: veja CLAUDE.md e AGENTS.md.

Ligue o Codex uma só vez

Ative o servidor MCP no DotMD em Settings → MCP e depois acrescente o DotMD a ~/.codex/config.toml:

[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600

tool_timeout_sec permite ao Codex esperar enquanto lê. Sem isso, o Codex deixa de esperar ao fim de cerca de um minuto. Reinicie o Codex depois de o acrescentar. A app, a CLI e a extensão para IDE partilham a mesma configuração; o guia do Codex mostra também o caminho da app.

O Codex revê o plano do Claude Code, e vice-versa

Dois agentes veem mais do que um. Deixe o Claude Code escrever o plano no plan mode e depois peça ao Codex: “Review plans/migration.md in DotMD and leave comments on the steps you disagree with.” As suas observações ficam nas linhas exatas com o nome dele. Você mantém-nas, edita-as ou apaga-as, e o Claude Code recebe só o que sobrar. Funciona igualmente no sentido contrário.

Os agentes nunca falam entre si. Tudo passa pelo ficheiro e pelos seus comentários, e é você quem decide. Mais em Um agente revê o outro.

O que verificar num plano do Codex

Um plano é barato de mudar e uma implementação não é, por isso leia-o uma vez com algumas perguntas em mente:

• Falta algum passo? Testes, uma migração, documentação, um rollback.
• A ordem está certa? Um passo que precisa do resultado de um passo posterior é um erro no plano.
• O âmbito está certo? Procure ficheiros ou áreas em que não pediu ao Codex para tocar.

Ponha cada observação como comentário no passo a que diz respeito e diga o que mudar. O Codex vê os seus comentários e o ficheiro, mais nada, por isso “use aqui o helper existente” vale mais do que “isto está errado”. O DotMD também lista qualquer alteração que não pediu em Other changes, para ver se uma correção foi mais longe do que devia.

Perguntas sobre os planos do Codex

Mais perguntas