Como ligar o Codex da OpenAI ao benflow

Além do Claude Code, a Equipe IA liga o Codex da OpenAI. Ele trabalha nos cards do mesmo jeito que o Claude: pega o card, mexe no código na máquina de quem ligou, testa, registra o andamento e as evidências, publica pelo benflow quando alguém pede e presta contas no próprio card. Cada pessoa usa a própria conta do ChatGPT, e o mesmo projeto pode ter Claude e Codex lado a lado: os dois aparecem na escolha da IA ao executar, no automático e no revezamento.

Antes de começar

• Uma conta do ChatGPT com o plano Plus, Pro, Business, Enterprise ou Edu, ou uma chave de API da OpenAI. O plano grátis do ChatGPT tem pouco uso do Codex.
• Um terminal no computador ou na VPS onde o Codex vai rodar: Mac, Linux ou Windows com o Git Bash ou o WSL. Os comandos do passo a passo são do terminal; o Codex não roda dentro do app do ChatGPT para o benflow.
• Node 22 ou mais novo, porque o Codex e o plugin do benflow rodam nele. Confira com node --version.

O Codex na sub-aba IAs

Em Equipe IA, aba Agentes, a primeira sub-aba é IAs. No alto, a escolha da IA: um cartão para o Claude, o Codex (da OpenAI), o Gemini e o Cursor, estes dois com Em breve; cada um diz quantos você tem ligados e online. Com o Codex escolhido, embaixo, os seus Codex neste projeto ou, sem nenhum, o passo a passo Ligue o seu Codex em 3 passos, e o quadro Como o Codex trabalha no benflow.

benflow.net

AmpliarAmpliar a imagem: Equipe IA da Aurora Móveis na sub-aba IAs com o Codex escolhido e nenhum Codex da pessoa: os cartões Claude, Codex, Gemini e Cursor no alto e, embaixo, Ligue o seu Codex em 3 passos, com os comandos de instalar e entrar, o botão Ligar meu Codex e Pronto: os cards vão para o Codex

Passo a passo

1. 1
   Passo 1: No terminal da máquina, instale o Codex com npm install -g @openai/codex e entre com a sua conta com codex login (abre o navegador; numa VPS sem tela, use codex login --device-auth, que mostra um código para abrir no navegador de outro computador). Quem já usa o Codex pula este passo.
2. 2
   Passo 2: No painel, abra Equipe IA, aba Agentes, sub-aba IAs, escolha o cartão Codex e clique em Ligar meu Codex (para mais uma máquina, use Ligar outro Codex, no alto de Seus Codex).
3. 3
   Passo 3: Na janela Ligar meu Codex, escolha em Onde ele roda entre Meu computador e VPS ou servidor. Se quiser, dê um nome em Nome; sem nome, fica a sugestão, como "Codex do Pedro" ou "Codex da Júlia na VPS". Clique em Gerar token.
4. 4
   Passo 4: Abre a janela Ligar seu Codex, com 3 passos. No primeiro, Instalar o Codex e o plugin, digite no terminal os comandos, um de cada vez, nesta ordem: instalar o Codex, entrar com a conta do ChatGPT, adicionar a loja de plugins do benflow e instalar o plugin benflow no Codex. Cada linha tem o seu Copiar. Clique em Já instalei.
5. 5
   Passo 5: No segundo passo, Ligar o executor, rode os comandos no mesmo terminal: o primeiro acha o plugin do benflow que o Codex instalou, o segundo guarda o token do agente nesta máquina e o terceiro liga o executor do Codex em segundo plano. O token já vai nos comandos e aparece só agora; Copiar todos copia os três. Se preferir que o próprio Codex rode os comandos, abra Prefiro pedir ao Codex, clique em Copiar o prompt, abra o Codex no terminal (digite codex), cole e aprove os comandos que ele pedir. Clique em Já liguei.
6. 6
   Passo 6: No terceiro passo, Pronto, a tela espera o primeiro sinal do seu Codex e muda sozinha para Seu Codex está ligado!. Clique em Concluir. O Codex aparece num cartão da seção Seus Codex, com o selo da OpenAI no canto do ícone.

benflow.net

AmpliarAmpliar a imagem: Janela Ligar seu Codex no passo Instalar o Codex e o plugin: Digite estes comandos no terminal, com npm install -g @openai/codex, codex login, codex plugin marketplace add ally-code-team/benflow-plugin e codex plugin add benflow@benflow-marketplace, cada um com Copiar, o Deu erro? recolhido e o botão Já instalei

npm install -g @openai/codex
codex login
codex plugin marketplace add ally-code-team/benflow-plugin
codex plugin add benflow@benflow-marketplace

benflow.net

AmpliarAmpliar a imagem: Janela Ligar seu Codex no passo Ligar o executor: Guarde o token e ligue o executor do Codex, com os três comandos do terminal (achar o plugin do benflow que o Codex instalou, guardar o token com configurar --token-stdin e ligar o executor com executar --ia codex em segundo plano), o aviso de que o token aparece só agora com Copiar todos, Prefiro pedir ao Codex recolhido e os botões Voltar e Já liguei

Os cartões Seus Codex

Cada Codex da pessoa vira um cartão em Seus Codex, igual ao dos Claudes: o que ele faz agora (o card, ou Livre), a Conta do ChatGPT com o e-mail inteiro, o plano e o modelo, o Uso do plano com a janela de 5 horas e a da semana e o botão Atualizar limites, o Plugin do benflow com a versão e a atualização automática, e quem usa. O Atualizar limites do Codex lê a conta e o uso direto do Codex da máquina, sem gastar o plano. O botão Editar abre a identidade, o Plano do ChatGPT, a conta e o token.

benflow.net

AmpliarAmpliar a imagem: Seus Codex da Aurora Móveis, na sub-aba IAs com o Codex escolhido: o cartão do Codex da Maria com o selo da OpenAI no ícone, o MacBook da Maria, Livre, a Conta do ChatGPT maria@auroramoveis.com.br, o Uso do plano com a janela de 5 h e a semana e o Ligar outro Codex

Como o Codex trabalha no benflow

• Na sua máquina. O executor do benflow chama o Codex na pasta do repositório, com o plugin do benflow e as mesmas ferramentas do Claude: andamento, evidências, prints, vídeo, concluir no local e publicação.
• Num cercado. O Codex escreve só nas pastas do trabalho (e no .git delas, para os commits) e na pasta temporária, com rede para o servidor local, os testes e o push da publicação.
• Com o mesmo fluxo do card. Branch própria, commits com a etiqueta do card, testes e evidências, pronto no local e publicação só quando alguém pede, como com o Claude. A Janela da IA mostra o que ele fez, com Codex iniciado e o modelo no começo.
• O que é só do Claude. A confirmação de comandos no card (o Codex não para para perguntar), o bloqueio de leitura das pastas dos outros projetos, o Terminal espelhado e o resumo dos chamados ao abrir o terminal são do Claude Code.

Modelo e effort do Codex

No menu do cartão, Modelo e effort lista os modelos que a conta do ChatGPT deste Codex pode usar (o Codex informa a lista ao benflow, como GPT-6.1 Sol). Sem escolha, vale o padrão do Codex na máquina, o do arquivo ~/.codex/config.toml. O mesmo vale ao executar um card com o Codex: o campo Modelo mostra os modelos dele, e não os do Claude.

Trocar a conta do ChatGPT

1. 1
   Passo 1: No cartão do Codex, abra o menu e escolha Trocar a conta do ChatGPT (ou clique em Editar). A janela abre no bloco Trocar a conta do ChatGPT.
2. 2
   Passo 2: Em Entre com a outra conta no Codex, rode no terminal da máquina codex logout e depois codex login, com a conta nova.
3. 3
   Passo 3: Em Avise o benflow, rode o comando que lê a conta do Codex (conta-codex), ou espere: o executor relê a conta sozinho em até 5 minutos. A conta nova vale para os Codex desta máquina em todos os projetos, a partir do próximo trabalho, e o token do benflow continua o mesmo.

Codex sempre ligado numa VPS

Numa VPS ou servidor, deixe o executor do Codex como serviço do sistema, como o do Claude (veja Onde o Claude roda e como deixar o seu sempre ligado). O comando é o mesmo do passo a passo, com --ia codex no fim, rodando com o usuário que fez o codex login. A mesma máquina pode ter um Claude e um Codex no mesmo projeto: cada um tem o próprio token, o próprio executor e o próprio arquivo de log em ~/.benflow. O caminho fixo do plugin do Codex é ~/.benflow/plugin-codex (o do Claude continua ~/.benflow/plugin): com o plugin 0.1.66 ou mais novo, rode uma vez o status do benflow.mjs que o Codex instalou (o mesmo "$B" do passo a passo, com status no lugar de executar) antes de criar o serviço; ele cria esse caminho, que acompanha as atualizações.

[Unit]
Description=Executor do Codex no Benflow
After=network-online.target

[Service]
User=dev
ExecStart=/usr/bin/node /home/dev/.benflow/plugin-codex/server/benflow.mjs executar --url https://benflow.net --org aurora --ia codex
Restart=always

[Install]
WantedBy=multi-user.target

Usar o benflow no Codex do terminal

Com o plugin instalado, as ferramentas do benflow também aparecem quando você abre o Codex na pasta de um repositório do projeto: peça "o que tem pra fazer no benflow?" ou "pega o chamado 12", e ele lista os chamados, abre o card e vai atualizando o andamento, como no Claude Code.

Deu erro?