Codex MCP para Claude Code: use o Codex como servidor MCP

Se você digitou codex mcp-server no terminal e recebeu Error: stdin is not a terminal, sua máquina está bem. O comando não existe mais. Por um tempo, Codex MCP para Claude Code significou uma única configuração: rodar o Codex como servidor MCP, registrá-lo no Claude Code e deixar um agente de programação pedir uma segunda opinião ao outro. A OpenAI removeu esse subcomando, e todo tutorial que ainda o mostra leva a um beco sem saída.

Este artigo explica o que mudou, quais substitutos funcionam hoje e os comandos exatos para cada um. Você verá o plugin oficial, um wrapper MCP da comunidade, uma solução provisória com uma CLI mais antiga e a configuração inversa, em que o Codex chama o Claude Code. Cada comando vem da documentação da OpenAI, do repositório do plugin ou do README do wrapper, então você pode colá-lo sem adivinhar.

💡 Resumo rápido: instale o plugin oficial do Codex para Claude Code. Escolha um wrapper MCP da comunidade só quando precisar que o Codex apareça como ferramentas MCP de verdade.

Por que o Codex MCP parou de funcionar

O que a configuração antiga fazia

A CLI do Codex costumava incluir um subcomando, codex mcp-server, que iniciava o Codex como servidor MCP via stdio. O Claude Code podia iniciá-lo como qualquer outro servidor, então uma única linha claude mcp add transformava o Codex em uma ferramenta. O servidor expunha duas ferramentas:

A primeira chamada retornava um threadId. Passá-lo para codex-reply mantinha a conversa, então o Claude Code podia entregar uma tarefa ao Codex, ler a resposta e depois continuar na mesma sessão. O campo approval-policy aceitava untrusted, on-request ou never, e sandbox aceitava read-only, workspace-write ou danger-full-access.

O registro antigo se parecia com a linha abaixo. Ele não funciona mais em uma CLI atual:

claude mcp add codex -- codex mcp-server

Copiar prompt

O erro que você vê agora

A documentação de MCP da OpenAI agora informa que o comando codex mcp-server e o binário independente codex-mcp-server foram removidos. Em uma CLI atual, mcp-server não é um subcomando reconhecido, então a CLI trata a palavra como um prompt e tenta abrir a interface interativa. O Claude Code inicia servidores por um pipe, sem terminal anexado, então a CLI para com Error: stdin is not a terminal. Um relato de bug no projeto Quest atribui a falha exatamente a essa queda para o prompt.

No Claude Code, o sintoma é um servidor que aparece como failed em /mcp, sem nenhuma ferramenta listada. Nada na sua configuração está errado. O que ela aponta não existe mais.

Quando foi removido

Um texto de migração data o aviso de descontinuação para o Codex CLI 0.149.1, lançado em 24 de agosto de 2026. Relatos de bugs de vários projetos que dependiam do comando, incluindo o Quest e a skill second-opinion da Trail of Bits, apontam o Codex CLI 0.154.0 como a versão em que ele desapareceu. Verifique o que você está usando:

codex --version

Copiar prompt

Qualquer versão a partir da 0.154.0 não tem o subcomando, então nenhuma edição de configuração vai trazê-lo de volta.

Três formas de acessar o Codex hoje

Escolha de acordo com a forma como você quer que o Codex apareça dentro do Claude Code. A tabela mostra as contrapartidas de um relance:

Se o seu objetivo é uma segunda opinião sobre código, o plugin é o caminho mais curto. Se você já tem prompts, scripts ou subagentes que chamam ferramentas MCP pelo nome, o wrapper mantém essa estrutura com o mínimo de reescrita.

O plugin oficial

A OpenAI publica o openai/codex-plugin-cc. Ele envolve o app server do Codex pelo binário codex que já está na sua máquina, então reaproveita seu login e sua configuração do Codex. Ele precisa de Node.js 18.18 ou superior e de uma assinatura do ChatGPT (o plano gratuito conta) ou de um token da API da OpenAI. A contrapartida: você ganha comandos de barra e tarefas em segundo plano, não ferramentas MCP.

Um wrapper MCP da comunidade

@cexll/codex-mcp-server mantém a estrutura MCP. Ele chama codex exec por trás dos panos e expõe as ferramentas ask-codex, brainstorm, ping e help. Ele precisa de Node.js 18 ou superior e de uma Codex CLI instalada e autenticada. Como é código de terceiros que roda no seu repositório, leia antes de confiar nele, e espere que ele fique para trás das mudanças da Codex CLI por dias ou semanas.

Uma CLI antiga como solução provisória

Você pode instalar uma versão da Codex CLI anterior à remoção e manter o codex mcp-server funcionando:

npm install -g @openai/codex@<a-version-before-0.154.0>

Copiar prompt

Confirme que o subcomando existe antes de conectá-lo. Isso só ganha tempo. Você fica sem novos modelos e correções, e a próxima atualização quebra a configuração de novo.

💡 Trate a CLI antiga como uma ponte por uma semana, não como arquitetura.

Configure o plugin oficial

Instale primeiro a Codex CLI. O plugin depende desse binário global e usa o login que o binário já tiver.

Instale em quatro comandos

Em um shell normal, instale a CLI:

npm install -g @openai/codex

Copiar prompt

Depois, rode estes dentro do Claude Code, um de cada vez:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

Copiar prompt

/codex:setup verifica se o Codex está instalado e autenticado. Se ele apontar um problema, resolva isso antes de tudo, porque todos os outros comandos dependem dele.

O que cada comando faz

O plugin adiciona uma pequena família de comandos /codex::

Um hábito que funciona: depois que o Claude Code terminar uma alteração, rode /codex:review para ouvir a opinião de um segundo modelo antes de fazer commit. Recorra a /codex:rescue quando o Claude Code ficar em loop no mesmo bug, e acompanhe /codex:status enquanto o job roda em segundo plano.

Configure um wrapper MCP da comunidade

Escolha esse caminho quando precisar de ferramentas MCP de verdade. O wrapper fica entre o Claude Code e a Codex CLI, traduzindo chamadas de ferramentas em execuções de codex exec.

Registre no Claude Code

npm install -g @openai/codex
claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server

Copiar prompt

Depois, digite /mcp dentro do Claude Code. O servidor deve aparecer como conectado, com as ferramentas listadas abaixo dele. claude mcp list mostra o mesmo no shell.

Compartilhe por meio do .mcp.json

Adicione --scope project ao comando claude mcp add e o Claude Code grava o servidor em .mcp.json na raiz do repositório, para que toda a equipe tenha a mesma configuração:

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": ["-y", "@cexll/codex-mcp-server"]
    }
  }
}

Copiar prompt

O Claude Code pede que cada membro da equipe aprove um servidor do projeto antes de rodá-lo, o que é o comportamento certo para uma ferramenta que pode mexer em arquivos.

Configurações de sandbox e aprovação

O wrapper repassa os controles de segurança do Codex, então você decide quanta liberdade o Codex tem. O README lista estas opções:

💡 Comece com read-only para revisões e perguntas. Mude para workspace-write só quando quiser que o Codex edite arquivos. Combinar danger-full-access com never remove todos os freios, então mantenha essa combinação fora de repositórios compartilhados.

O README também menciona padrões inteligentes desde a versão 1.2: o wrapper escolhe workspace-write quando uma tarefa precisa, para evitar erros de permissão. Verifique qual modo uma execução realmente usou antes de presumir que ela continuou somente leitura.

Faça o caminho inverso

A conexão funciona nos dois sentidos. O Claude Code pode chamar o Codex, e o Codex pode chamar o Claude Code ou qualquer outro servidor MCP em que você confie.

O Codex chamando servidores MCP

O Codex consome servidores MCP nativamente. Adicione um pela CLI:

codex mcp add my-server -- npx -y your-mcp-server-package

Copiar prompt

Ou escreva-o em config.toml como uma tabela [mcp_servers.<name>]:

[mcp_servers.my-server]
command = "npx"
args = ["-y", "your-mcp-server-package"]
startup_timeout_sec = 20
tool_timeout_sec = 120

Copiar prompt

Servidores stdio também aceitam env, cwd, enabled_tools e disabled_tools, o que permite ocultar ferramentas que o Codex nunca deve chamar. Servidores HTTP recebem um url mais opções de autenticação.

O Claude Code como servidor

O Claude Code pode expor as próprias ferramentas por MCP com claude mcp serve. Registre esse comando no Codex:

codex mcp add claude-code -- claude mcp serve

Copiar prompt

Depois disso, o Codex enxerga as ferramentas do Claude Code, como leitura de arquivos, edições e acesso ao shell, como ferramentas MCP. Teste primeiro em um repositório descartável, porque dois agentes com permissão de escrita podem sobrescrever as edições um do outro.

Corrija as falhas mais comuns

A maioria das falhas cai em cinco grupos. Identifique o sintoma e depois aplique a correção:

Uma verificação de saúde de 30 segundos pega quase todo o resto:

1. Rode codex --version para confirmar que a CLI está instalada e atualizada.
2. Rode claude mcp list para confirmar que o servidor está registrado e conectado.
3. Peça ao Claude Code para chamar ping (wrapper) ou rodar /codex:setup (plugin).

Se as três passarem e uma tarefa ainda falhar, o problema está na tarefa, não na infraestrutura. Simplifique o prompt, reduza o sandbox para read-only e rode de novo.

Como usar o GPT 5.6 Sol no PicassoIA

Quando uma configuração ainda falha, um modelo forte de programação pode analisar o erro com você. O GPT 5.6 Sol no PicassoIA foi feito para programação, escrita técnica e raciocínio em várias etapas, e lê imagens, então um print do terminal com erro também funciona.

Passo a passo

1. Abra a página do GPT 5.6 Sol no PicassoIA.
2. Cole o texto exato do erro, a saída do seu codex --version e o comando que falhou no campo de prompt.
3. Anexe uma captura de tela pela entrada de imagem quando o erro tiver mais do que algumas linhas.
4. Adicione um prompt de sistema como: "Você é um engenheiro sênior que corrige configurações de MCP. Peça os dados que faltam antes de chutar."
5. Aumente o reasoning effort para high em problemas complicados. O padrão, none, prioriza a velocidade.
6. Aumente o max completion tokens ao elevar o esforço. As próprias configurações do modelo avisam que um esforço alto pode gastar todos os tokens com raciocínio e devolver uma resposta vazia.
7. Defina a verbosity como low quando quiser apenas o comando corrigido, e high quando quiser o raciocínio detalhado.

Veja como as configurações se encaixam nesse tipo de tarefa:

Para comparar respostas, rode o mesmo prompt no Claude Sonnet 5 ou no Claude Fable 5, ambos na categoria Large Language Models. Dois modelos discordando sobre a sua configuração é um sinal útil para você mesmo ler a documentação.

Crie suas próprias imagens no PicassoIA

Artigos de configuração e READMEs ficam melhores com recursos visuais reais: uma foto de cabeçalho, um diagrama de como dois agentes se conectam, um clipe curto para uma nota de lançamento. O PicassoIA também tem sua própria API para desenvolvedores e um conector MCP, então a mesma sessão do Claude Code pode pedir imagens sem sair do terminal.

A API segue o estilo da Replicate: a URL base é https://api.picassoia.com/v1, as requisições levam um token Bearer que começa com pia_sk_, e os jobs são assíncronos, então você cria uma previsão, consulta o status e depois busca o resultado. Uma conta pode rodar 5 previsões simultâneas, compartilhadas entre tokens e conexões MCP. Quatro modelos estão disponíveis pela API e pelo conector MCP:

• PicassoIA Image para geração de imagens a partir de texto
• PicassoIA Image Editor Pro para editar uma imagem existente
• PicassoIA Video para vídeo a partir de texto ou imagem
• Seedance 2.5 Lite para vídeo com áudio

Confira a página de preços para saber o que o seu plano inclui, já que o acesso à API e ao MCP depende disso.

Escolha uma seção deste artigo, escreva um prompt de foto de 50 palavras para ela e gere sua primeira imagem no PicassoIA. Depois, envie essa imagem para um modelo de vídeo e transforme-a em um clipe de cinco segundos. Uma tarde de experimentos vai mostrar qual modelo combina com a sua documentação, e o prompt que você acabar usando vale a pena guardar para o próximo artigo.