Ir para o conteúdo
Promovaweb

O que é o Codex e para que serve

O Codex CLI é um agente de código da OpenAI que trabalha nos arquivos do seu projeto pelo terminal. Ele lê o repositório, propõe alterações e executa comandos, usando o resultado de cada teste para continuar a tarefa no seu app.

Ficha e sumário da página

Referência técnica
Codex CLI 0.169.0
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. O projeto entra na conversa
  2. Como uma tarefa continua depois do primeiro comando
  3. As ferramentas continuam sendo as do projeto
  4. O que você confere na entrega

O projeto entra na conversa

O diretório de trabalho dá ao Codex um lugar para procurar o código. Dentro dele estão os arquivos da aplicação, os testes e a configuração das ferramentas. Quando você descreve uma alteração, o agente pode consultar esses arquivos antes de escrever. Uma função mencionada na tarefa ganha o conteúdo real do repositório, com os nomes usados pelo projeto e as chamadas que dependem dela.

Esse acesso permite relacionar uma mensagem de erro ao arquivo que a produz. O agente pode pesquisar o nome de uma função, ler a implementação e acompanhar os testes existentes. Você acompanha as ferramentas chamadas durante a conversa e pode esclarecer o resultado esperado. O texto da tarefa orienta a investigação, enquanto os arquivos e as saídas dos comandos fornecem o código e os erros para continuar.

O código do Codex CLI é mantido pela OpenAI sob licença Apache 2.0. A licença permite consultar e modificar o cliente nos termos publicados no repositório. Os modelos acessados pelo serviço têm condições próprias. Instalar a CLI no computador coloca ali o programa que conversa com o modelo e executa ferramentas, sem instalar os pesos dos modelos da OpenAI.

  1. Tarefa

    Você informa o comportamento esperado no app.

  2. Leitura

    O agente consulta os arquivos e as instruções do projeto.

  3. Ferramentas

    Alterações e comandos produzem novos resultados.

  4. Revisão

    Você compara o código alterado e os testes executados.

O Codex alterna leitura, alteração e execução conforme os resultados das ferramentas. A revisão do código permanece com você.

Como uma tarefa continua depois do primeiro comando

Uma chamada de ferramenta devolve uma saída para o agente. Pode ser o conteúdo de um arquivo, o resultado de uma busca ou o erro de um teste. O modelo recebe esse retorno junto das instruções disponíveis e escolhe a próxima ação. Por isso uma tarefa pode envolver várias leituras e alterações até chegar à resposta final.

Num exemplo de correção de formulário, a mensagem informa que um campo vazio passa pela validação. O Codex pode localizar a validação, ler o teste correspondente e alterar a condição. Se a execução do teste mostra outra falha, esse retorno entra na conversa. O agente tem como continuar a investigação a partir do erro concreto, em vez de depender somente da descrição inicial.

Você também pode usar a CLI para entender um trecho existente sem solicitar alterações. O acesso de leitura permite explicar a ligação entre arquivos, localizar a configuração de um serviço ou identificar os comandos definidos pelo projeto. A diferença entre explicar e modificar precisa aparecer na tarefa e nas permissões da sessão. Uma pergunta sobre arquitetura não exige automaticamente escrever arquivos.

As ferramentas continuam sendo as do projeto

Os comandos executados pelo Codex dependem do ambiente disponível. Um teste que usa Node.js precisa encontrar o runtime e as dependências do repositório. Se falta um pacote, a execução pode falhar antes de alcançar o comportamento que você deseja conferir. A saída do terminal permite distinguir essa falha de preparação de uma falha na lógica do app.

A CLI oferece interação pelo terminal e execução não interativa com codex exec. A primeira mantém a conversa aberta para acompanhamento e ajustes. A segunda permite chamar o agente a partir de um script ou de uma automação. Em ambos os casos, as permissões do ambiente delimitam os comandos e os arquivos acessíveis. A automação precisa receber uma tarefa compreensível e produzir uma saída que possa ser conferida.

Uma sessão iniciada numa VPS trabalha no ambiente daquela VPS. Os arquivos locais do seu notebook não aparecem ali só porque o login usado é o mesmo. Da mesma forma, uma ferramenta instalada apenas no notebook não fica disponível no servidor. O diretório, o sistema e os executáveis encontrados pelo processo explicam o que o agente consegue consultar e executar.

O que você confere na entrega

O resumo final informa o trabalho realizado, mas a alteração permanece nos arquivos. A comparação de alterações do Git mostra as linhas modificadas para você conferir o escopo. Os testes mostram o comportamento que foi exercitado. Se algum teste depende de um serviço indisponível, essa parte continua sem confirmação, mesmo quando a alteração parece coerente durante a leitura.

A permissão de escrita também não equivale à publicação do app. Um repositório pode ter comandos separados para testar, compilar e enviar a aplicação ao servidor. Você delimita quais dessas ações fazem parte da tarefa. A sandbox e as aprovações restringem a execução, inclusive quando um comando precisa sair do diretório autorizado.

Os artigos sobre Codex no changelog acompanham as releases do cliente. A configuração do agente, os modelos disponíveis e as instruções do projeto têm seus próprios lugares, apresentados nos demais assuntos deste portal. Para trabalhar no código com orientação técnica ao vivo, o Desenvolvimento Colaborativo da Dev Side Studio oferece uma sessão na qual você opera o editor e o terminal.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.