For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Use o Codex no Linear

Inicie chats do Codex a partir de issues do Linear

Use o Codex no Linear para delegar tarefas diretamente nas issues. Atribua uma issue ao Codex ou mencione @Codex em um comentário. O Codex cria um chat na nuvem e responde com atualizações sobre o andamento e os resultados.

O Codex no Linear está disponível nos planos pagos (consulte a página de preços).

Se você usa um plano Enterprise, peça a quem administra seu espaço de trabalho do ChatGPT que ative os chats do Codex na nuvem nas configurações do espaço de trabalho e habilite Codex for Linear nas configurações de conectores.

Configure a integração com o Linear

  1. Configure os chats do Codex na nuvem. Para isso, conecte o GitHub ao Codex e crie um ambiente para o repositório em que o Codex vai trabalhar.
  2. Acesse as configurações do Codex e instale Codex for Linear no seu espaço de trabalho.
  3. Para vincular sua conta do Linear, mencione @Codex em uma conversa nos comentários de uma issue do Linear.

Delegue tarefas ao Codex

Você pode delegar tarefas de duas maneiras.

Atribua uma issue ao Codex

Depois de instalar a integração, você pode atribuir issues ao Codex da mesma forma que as atribui a colegas de equipe. O Codex começa a trabalhar e publica atualizações na própria issue.

Mencione @Codex nos comentários

Você também pode mencionar @Codex em conversas nos comentários para delegar tarefas ou fazer perguntas. Depois que o Codex responder, envie outra mensagem na mesma conversa para continuar o chat.

Ao começar a trabalhar em uma issue, o Codex escolhe um ambiente e um repositório para executar a tarefa. Para definir um repositório específico, inclua o nome dele no comentário, como neste exemplo: @Codex corrija isso no repositório openai/codex.

Para acompanhar o andamento da tarefa:

  • Abra Activity na issue para ver as atualizações.
  • Abra o link do chat para acompanhar o trabalho em mais detalhes.

Ao concluir a tarefa, o Codex publica um resumo e um link para o chat concluído para que você possa criar um pull request.

Como o Codex escolhe o ambiente e o repositório

  • O Linear sugere um repositório com base no contexto da issue. O Codex seleciona o ambiente que melhor corresponde à sugestão. Se a solicitação for ambígua, ele usa o ambiente que você utilizou mais recentemente.
  • O chat usa a branch padrão do primeiro repositório listado no mapa de repositórios do ambiente. Atualize o mapa no Codex se precisar definir outro repositório como padrão ou incluir mais repositórios.
  • Se não houver um ambiente ou repositório adequado, o Codex responderá no Linear com instruções para você resolver o problema antes de tentar novamente.

Atribua issues ao Codex automaticamente

Você pode usar regras de triagem para atribuir issues ao Codex automaticamente.

  1. No Linear, acesse Settings.
  2. Em Your teams, selecione sua equipe.
  3. Nas configurações do fluxo de trabalho, abra Triage e ative a triagem.
  4. Em Triage rules, crie uma regra, selecione Delegate > Codex e defina as demais propriedades que desejar.

O Linear atribui automaticamente ao Codex as novas issues que entram na triagem. Quando você usa regras de triagem, o Codex executa os chats com a conta de quem criou a issue.

Uso de dados, privacidade e segurança

Quando você menciona @Codex ou atribui uma issue ao Codex, ele recebe o conteúdo da issue para entender sua solicitação e criar um chat. O tratamento dos dados segue a Política de Privacidade, os Termos de Uso e outras políticas aplicáveis da OpenAI. Para saber mais sobre segurança, consulte a documentação de segurança do Codex.

O Codex usa modelos de linguagem de grande porte que podem cometer erros. Sempre revise as respostas e os diffs.

Dicas e solução de problemas

  • Conexão ausente: Se o Codex não conseguir confirmar sua conexão com o Linear, ele responderá na issue com um link para você conectar sua conta.
  • Ambiente diferente do esperado: Responda na mesma conversa indicando o ambiente que deseja usar (por exemplo, @Codex por favor, execute isso no ambiente openai/codex).
  • Trecho de código incorreto: Acrescente mais contexto à issue ou dê instruções explícitas no comentário em que você menciona @Codex.
  • Mais ajuda: Consulte a Central de Ajuda da OpenAI.

Conecte o Linear para trabalhar localmente (MCP)

Se você usa o aplicativo do ChatGPT para desktop, a CLI do Codex ou a extensão para IDE e quer acessar as issues do Linear localmente por uma dessas ferramentas, configure o servidor do Linear para o Model Context Protocol (MCP).

Para saber mais, consulte a documentação do Linear sobre MCP.

Os passos para configurar o servidor MCP são os mesmos na extensão para IDE e na CLI, pois ambas compartilham a configuração.

Use a CLI (recomendado)

Se a CLI estiver instalada, execute:

codex mcp add linear --url https://mcp.linear.app/mcp

O comando solicita que você entre na sua conta do Linear e a conecte ao Codex.

Configure manualmente

  1. Abra ~/.codex/config.toml no seu editor.
  2. Adicione o seguinte trecho:
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. Execute codex mcp login linear para entrar na sua conta.