Como usar Codex no Zé Bot

O que é

O Codex é um dos provedores que o Zé Bot orquestra. Ele usa a sua conta ChatGPT e o runtime do Codex CLI para executar tarefas nos agentes, com sessões retomáveis, streaming, ferramentas e níveis de raciocínio.

O Zé Bot não fornece o modelo: ele organiza a conta, o modelo, o workspace e o histórico em volta do Codex.

Antes de começar

• Uma conta ChatGPT com acesso ao Codex.
• O Codex CLI instalado, ou o runtime gerenciado pelo Zé Bot.
• Uma pasta de trabalho para o agente.
• Permissão para o agente executar comandos e editar arquivos, conforme o nível de aprovação.

Se o CLI ainda não estiver autenticado, rode codex login no terminal ou use o fluxo guiado em Configurações → Provedores.

Como conectar

1. Abra Configurações → Provedores.
2. Escolha Codex.
3. Conecte a conta padrão deste dispositivo ou adicione outra conta.
4. Confirme o status e o plano exibido.
5. Volte para a lista de agentes.

O Zé Bot mostra limites individuais para a conta padrão do Codex e para cada conta adicional. Os detalhes identificam a conta com nome, plano e e-mail quando disponíveis.

Como criar um agente com Codex

1. Crie ou abra um agente.
2. Em Provedor, escolha Codex.
3. Escolha o modelo. Padrão do provedor deixa o Codex resolver sozinho; você também pode selecionar um modelo específico.
4. Ajuste o nível de raciocínio quando o modelo oferecer essa opção.
5. Envie uma tarefa curta para validar a conexão.
6. Ajuste instruções, ferramentas e workspace conforme o trabalho.

Exemplo

Peça: “Leia o README deste workspace, encontre uma instrução desatualizada e proponha a correção com um diff”. O agente usa o Codex para inspecionar os arquivos, propor a mudança e pedir aprovação antes de editar.

Limites e cuidados

• A conta e o plano do ChatGPT precisam ter acesso ao Codex.
• O Zé Bot não intermedeia a cobrança nem a cota do provedor.
• O nível de aprovação vale para o agente inteiro.
• Trocar de provedor ou modelo no meio do trabalho gera um recorte de contexto local; a sessão anterior do provedor não é retomada automaticamente.
• O workspace não é um sandbox de shell: mantenha o agente na pasta autorizada.

Problemas comuns

O Codex não aparece como conectado

Rode codex login no terminal ou use o fluxo de conexão em Configurações → Provedores. Confira se o CLI está no PATH.

A cota acabou no meio do trabalho

O Zé Bot pode usar um modelo reserva, se você configurou um em Detalhes do agente → Cérebro reserva. Turnos que já produziram trabalho não são repetidos.

O agente não edita arquivos

Confira o nível de aprovação e se o provedor está pedindo permissão. Em Perguntar sempre, cada edição abre um cartão.

Próximos passos

• Leia o lançamento em /blog/codex.
• Veja os outros manuais em /manual.