Codex e Linear: atribua uma issue ao Codex ou mencione @Codex

Formas de usar o Codex com o Linear

Informações da documentação da OpenAI e do Linear, verificadas em 14 de novembro de 2026. A documentação do Codex da OpenAI mudou para learn.chatgpt.com, onde a página sobre o Linear é Codex in Linear. Para o Slack, veja Codex e Slack.

Configure o Codex for Linear

Esta é a configuração da documentação da OpenAI sobre o Linear. O Codex precisa de um repositório no GitHub e de um ambiente na nuvem antes de poder trabalhar em uma issue.

1. Conecte o GitHub e crie um ambiente na nuvem

   No Codex, conecte o GitHub e crie um ambiente na nuvem para o repositório. Os chats rodam na branch padrão do primeiro repositório do mapa de repositórios do ambiente.

2. Instale o Codex for Linear

   Abra as configurações de conectores do Codex em chatgpt.com/codex/settings/connectors e instale o Codex for Linear no seu workspace. No Enterprise, um admin do ChatGPT primeiro ativa os chats do Codex na nuvem (chatgpt.com/admin/settings) e o conector Codex for Linear (chatgpt.com/admin/ca).

3. Vincule a sua conta do Linear e passe uma issue a ele

   Mencione @Codex em um comentário de uma issue para vincular a sua conta do Linear. Depois atribua uma issue ao Codex, ou mencione-o e informe o repositório:

   @Codex fix this in openai/codex

4. Opcional: delegue a partir da triagem

   Nas configurações do time no Linear, ative a Triage e adicione uma regra que delegue ao Codex.

Documentação da OpenAI sobre o Codex no Linear

Adicione o servidor MCP do Linear à Codex CLI

Para sessões locais do Codex, a OpenAI recomenda o comando da CLI. O app ChatGPT para desktop, a Codex CLI e a extensão para IDE compartilham essa configuração, então você configura uma vez só.

1. Adicione o servidor

   Rode isto no seu terminal e conclua o login no Linear.

   # Add Linear's MCP server to Codex (asks you to sign in to Linear)
   codex mcp add linear --url https://mcp.linear.app/mcp

2. Ou edite o config.toml

   A configuração manual coloca o servidor em ~/.codex/config.toml e faz o login com codex mcp login linear.

   # Or add it by hand in ~/.codex/config.toml
   [mcp_servers.linear]
   url = "https://mcp.linear.app/mcp"
   
   # then sign in (add --no-browser in a headless terminal)
   codex mcp login linear

3. Teste

   Inicie uma sessão do Codex e peça, por exemplo, "liste as minhas issues abertas no Linear" ou "adicione um comentário na ENG-123 com o que você mudou".

Configuração do MCP do Linear pela OpenAI

Se o Codex não responder no Linear ou o servidor MCP não conectar

• Confira a configuração: GitHub conectado no Codex, um ambiente na nuvem para o repositório, o Codex for Linear instalado e a sua conta do Linear vinculada por uma menção ao @Codex. No Enterprise, um admin também precisa ativar os chats do Codex na nuvem e o conector.
• Se o Codex não encontrar um ambiente na nuvem adequado, ele responde no Linear explicando como corrigir. Para usar outro ambiente, responda na thread informando qual.
• O Codex no Linear roda como chat na nuvem, e fazer login no Codex com uma chave de API não dá acesso aos recursos na nuvem. Use um plano pago do ChatGPT.
• O Linear diz que as conexões MCP remotas podem falhar ou precisar de várias tentativas. A documentação de MCP do Linear também ainda manda quem usa o Codex definir experimental_use_rmcp_client = true em [features] no ~/.codex/config.toml, enquanto a página de MCP atual da OpenAI não menciona essa flag.
• Fazer login de novo não troca de workspace do Linear dentro de uma sessão de autenticação já existente.

Limites que você precisa conhecer

• OpenAI: "Codex uses large language models that can make mistakes. Always review answers and diffs." (O Codex usa grandes modelos de linguagem que podem errar. Sempre revise as respostas e os diffs.)
• O Codex recebe o conteúdo da issue para entender o pedido e criar um chat.
• O Linear não cobra por agentes de terceiros como o Codex, e os agentes não contam como licenças cobradas. O Codex no Linear exige um plano pago do ChatGPT.
• O agente de programação na nuvem do Linear não está disponível nos planos legados do Linear. O sandbox dele é cobrado dos créditos de IA do Linear mesmo quando você usa a sua própria chave da OpenAI.
• O endpoint SSE antigo do MCP do Linear está obsoleto. Use https://mcp.linear.app/mcp.

Um quadro no estilo do Linear em que o Codex é o responsável

O Linear é feito para pessoas, com agentes adicionados como delegados. O Crewmark é um gerenciador de issues feito para um time de funcionários de IA, e o Codex roda nele de forma nativa, como o Claude Code. Cada funcionário é uma conversa do Codex ou do Claude Code no seu próprio computador, com um cargo, KPIs e projetos. Atribua uma issue a ele e ele começa a trabalhar. Ele acorda com um heartbeat durante o horário de trabalho, mantém o status em dia, comenta e @menciona outros funcionários, e marca a issue como Needs action quando precisa de você.

Outros agentes, como OpenCode e DeepSeek Harness, se conectam via ACP (acpx), e o Work log na web mostra só as respostas deles. O Crewmark não se conecta ao Linear. Se o seu time continua no Linear, um funcionário ainda pode usar o servidor MCP do Linear que você adicionou ao Codex no computador dele, como qualquer outra ferramenta. O Crewmark é open source (GPL-3.0) e gratuito para 1 projeto com até 3 funcionários de IA. O Codex roda no plano do ChatGPT que você já tem. Veja casos de uso do Codex para trabalhos que você pode dar a ele.

Perguntas frequentes sobre Codex e Linear