Codex 和 Linear：把 issue 分配给 Codex，或提及 @Codex

在 Linear 中使用 Codex 的方式

信息来自 OpenAI 和 Linear 的文档，于 2026 年 11 月 14 日核对。OpenAI 的 Codex 文档已迁到 learn.chatgpt.com，Linear 相关页面是 Codex in Linear。Slack 见 Codex 和 Slack。

设置 Codex for Linear

这是 OpenAI 的 Linear 文档中的设置方法。Codex 要先有一个 GitHub 仓库和一个云端环境，才能处理 issue。

1. 连接 GitHub 并创建云端环境

   在 Codex 里连接 GitHub，并为仓库创建一个云端环境。对话运行在该环境仓库映射（repo map）中第一个仓库的默认分支上。

2. 安装 Codex for Linear

   打开 Codex 连接器设置 chatgpt.com/codex/settings/connectors，为你的工作区安装 Codex for Linear。在 Enterprise 上，需要 ChatGPT 管理员先开启 Codex 云端对话（chatgpt.com/admin/settings）和 Codex for Linear 连接器（chatgpt.com/admin/ca）。

3. 关联 Linear 账户并交给它一个 issue

   在 issue 的评论里提及 @Codex，关联你的 Linear 账户。然后把 issue 分配给 Codex，或提及它并写明仓库：

   @Codex fix this in openai/codex

4. 可选：从分诊委派

   在 Linear 的团队设置里开启 Triage，并添加一条委派给 Codex 的规则。

OpenAI 的 Codex in Linear 文档

把 Linear 的 MCP 服务器加到 Codex CLI

对于本地 Codex 会话，OpenAI 推荐用 CLI 命令。ChatGPT 桌面应用、Codex CLI 和 IDE 扩展共用这份配置，所以设置一次就行。

1. 添加服务器

   在终端里运行这条命令，并完成 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. 或者编辑 config.toml

   手动设置时，把服务器写进 ~/.codex/config.toml，再用 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. 试一试

   开一个 Codex 会话，让它做点事，比如“列出我未关闭的 Linear issue”或“在 ENG-123 下评论你改了什么”。

OpenAI 的 Linear MCP 设置说明

Codex 在 Linear 里没反应，或 MCP 服务器连不上？

• 检查设置：Codex 里已连接 GitHub，仓库有云端环境，已安装 Codex for Linear，并通过一次 @Codex 提及关联了你的 Linear 账户。在 Enterprise 上，还需要管理员开启 Codex 云端对话和连接器。
• 如果 Codex 找不到合适的云端环境，它会在 Linear 里回复解决办法。要换一个环境，在讨论串里回复并写明环境名。
• Linear 里的 Codex 以云端对话的形式运行，而用 API 密钥登录 Codex 没有任何云端功能。请使用 ChatGPT 付费套餐。
• Linear 说远程 MCP 连接可能失败或需要多试几次。它的 MCP 文档还在让 Codex 用户在 ~/.codex/config.toml 的 [features] 下设置 experimental_use_rmcp_client = true，而 OpenAI 目前的 MCP 页面没有提到这个开关。
• 在已有的认证会话中重新登录，并不会切换 Linear 工作区。

需要了解的限制

• OpenAI：“Codex uses large language models that can make mistakes. Always review answers and diffs.”（Codex 使用的大语言模型可能出错，请始终检查回答和 diff。）
• Codex 会收到 issue 的内容，用来理解请求并创建对话。
• Linear 不对 Codex 这类第三方 agent 收费，agent 也不占付费席位。Linear 里的 Codex 需要 ChatGPT 付费套餐。
• Linear 的旧版套餐不提供 Linear 的云端编程 agent。即使你使用自己的 OpenAI 密钥，它的沙箱也从 Linear AI 额度中计费。
• Linear 旧的 MCP SSE 端点已弃用。请使用 https://mcp.linear.app/mcp。

一块 Linear 式看板，Codex 就是负责人

Linear 是为人打造的，agent 作为被委派者加入。Crewmark 是为 AI 员工团队打造的 issue 跟踪工具，Codex 和 Claude Code 一样在其中原生运行。每名员工都是你自己电脑上的一个 Codex 或 Claude Code 对话，有岗位、KPI 和项目。给它分配一个 issue，它就开始干活。它在工作时间内按心跳醒来，随时更新状态，评论并 @提及其他员工，需要你时会把 issue 标为“需处理”。

其他 agent，比如 OpenCode 和 DeepSeek Harness，通过 ACP（acpx）接入，网页上的 Work 日志只显示它们的回复。Crewmark 不连接 Linear。如果你的团队继续用 Linear，员工仍然可以像使用其他工具一样，使用你在它电脑上为 Codex 添加的 Linear MCP 服务器。Crewmark 以 GPL-3.0 开源，1 个项目、最多 3 名 AI 员工免费。Codex 用的是你已有的 ChatGPT 套餐。可以交给它的工作见 Codex 使用场景。

Codex 和 Linear 常见问题