这页能帮你把 OpenAI Codex 接到 Linear,用来把 issue 分派给 Codex、在评论里用 @Codex 继续同一任务,或通过 MCP 让 Codex app、CLI 和 IDE Extension 本地读取 Linear issue。付费计划可用;Enterprise 还需要 workspace admin 在 ChatGPT workspace settings 和 connector settings 里开启 Codex cloud tasks 与 Codex for Linear,本地 MCP 可用 codex mcp add linear --url https://mcp.linear.app/mcp 配置并登录验证。

OpenAI Codex 接入 Linear

用 OpenAI Codex 在 Linear 里把 issue 直接委派出去:把 issue 分配给 Codex,或者在评论里提到 @Codex,Codex 就会创建 cloud task,并把进度和结果回写到 Linear。

使用前提

OpenAI Codex in Linear 需要付费计划。具体可查看 Pricing

如果你使用的是 Enterprise plan,需要让 ChatGPT workspace admin 先开启两项设置:

怎么配置 Linear 集成

  1. 先在 Codex 里连接 GitHub,按照 Codex cloud tasks 的要求,为 Codex 要处理的 repository 创建 environment
  2. 进入 Codex settings,为你的 workspace 安装 Codex for Linear
  3. 在 Linear 的 issue 评论线程里提到 @Codex,把 Linear 账号关联起来。

怎么把工作委派给 Codex

你可以用两种方式把 Linear issue 交给 Codex。

把 issue 分配给 Codex

安装集成后,分配 issue 的方式和分配给同事一样。Codex 会开始工作,并把更新发布回这个 issue。

Assigning Codex to a Linear issue (light mode) Assigning Codex to a Linear issue (dark mode)

在评论里提到 @Codex

你也可以在评论线程里提到 @Codex,把任务委派出去,或者直接提问。Codex 回复后,继续在同一线程跟进,就会沿用同一个 session。

Mentioning Codex in a Linear issue comment (light mode) Mentioning Codex in a Linear issue comment (dark mode)

Codex 开始处理 issue 后,会自动选择一个 environment 和 repo 来执行任务。

如果你想固定到某个仓库,可以在评论里直接写出来,例如:

@Codex fix this in openai/codex

要追踪进度,可以这样看:

  • 打开 issue 的 Activity,查看进度更新。
  • 打开 task link,跟着更详细的执行过程查看。

任务完成后,Codex 会在 Linear 里发布总结,并附上已完成任务的链接,方便你继续创建 pull request。

Codex 如何选择 environment 和 repo

  • Linear 会根据 issue 上下文推荐一个 repository。Codex 会选择与这个推荐最匹配的 environment。若请求含糊不清,它会回退到你最近一次使用的 environment。
  • 任务会运行在该 environment 的 repo map 中第一个 repository 的 default branch 上。如果你需要不同的默认仓库,或者要加入更多仓库,需要在 Codex 里更新 repo map。
  • 如果没有合适的 environment 或 repository,Codex 会在 Linear 里回复修复建议,先把问题处理好,再重试。

怎么自动把 issue 分配给 Codex

你可以用 triage rules 自动把新 issue 委派给 Codex。

  1. 在 Linear 里打开 Settings
  2. Your teams 下选择你的 team。
  3. 进入 workflow settings,打开 Triage 并启用。
  4. Triage rules 里新建规则,选择 Delegate > Codex,并按需设置其他属性。

进入 triage 的新 issue 会被 Linear 自动分配给 Codex。

使用 triage rules 时,Codex 运行 task 会使用 issue creator 的账号。

Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (light mode) Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (dark mode)

数据使用、隐私和安全

当你提到 @Codex 或把 issue 分配给它时,Codex 会收到你的 issue 内容,用来理解请求并创建 task。

数据处理遵循 OpenAI 的 Privacy PolicyTerms of Use 和其他适用的 policies

安全相关内容可查看 Codex security documentation

Codex 使用大语言模型,可能会出错。要始终复核回答和 diff。

常见问题

OpenAI Codex 在 Linear 里怎么分配 issue

把 issue 直接分配给 Codex,或者在评论线程里提到 @Codex。Codex 会创建 cloud task,并把进度和结果回写到 Linear。

Codex 在 Linear 里没有识别到账号怎么办

如果 Codex 无法确认你的 Linear connection,它会在 issue 里回复一个连接账号的链接。按链接完成连接后再重试。

为什么 Codex 选了不是我想要的 environment

直接在评论线程里回复你想用的 environment,例如 @Codex please run this in openai/codex。如果请求不够明确,Codex 可能会使用最近一次用过的 environment。

在本地任务里连接 Linear(MCP)

如果你在使用 Codex app、CLI 或 IDE Extension,并且想让 Codex 在本地访问 Linear issues,可以把 Codex 配置为使用 Linear Model Context Protocol(MCP)server。

更多背景可查看 Linear MCP docs

IDE extension 和 CLI 使用同一套配置,所以 MCP server 的设置步骤相同。

用 CLI 配置 Linear MCP

如果你已经安装 CLI,可以运行:

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

执行后会提示你用 Linear 账号登录,并把账号连接到 Codex。

手动配置 Linear MCP

  1. 用编辑器打开 ~/.codex/config.toml
  2. 添加以下内容:
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. 运行 codex mcp login linear 登录。

常见问题

OpenAI Codex 在 Linear 里怎么自动委派 issue

在 Linear 的 workflow settings 里启用 Triage,然后在 Triage rules 中创建规则,选择 Delegate > Codex。这样进入 triage 的新 issue 会自动分配给 Codex。

Codex 本地连接 Linear 用什么命令

如果你使用 CLI,运行 codex mcp add linear --url https://mcp.linear.app/mcp。如果手动配置,则在 ~/.codex/config.toml 里添加 Linear MCP server,然后执行 codex mcp login linear