OpenAI Codex 中文文档（4.14更新）
联系我 ↗
官方文档 ↗

在 Linear 中使用 Codex

从 Linear 问题单中运行 Codex 任务

你可以在 Linear 中把工作委派给 Codex。把问题单指派给 Codex，或者在评论中提到 @Codex，Codex 就会创建一个云端任务，并把进度和结果回贴到问题单中。

Linear 中的 Codex 仅在付费计划中可用（见定价）。

如果你使用的是 Enterprise 计划，请让 ChatGPT 工作区管理员先在 工作区设置 中开启 Codex 云端任务，并在 连接器设置 中启用 Codex for Linear。

设置 Linear 集成

  1. 先配置好 Codex 云端任务：在 Codex 中连接 GitHub，并为你希望 Codex 处理的仓库创建一个环境。
  2. 打开 Codex 设置，为你的工作区安装 Codex for Linear。
  3. 在 Linear 问题单的评论线程中提到 @Codex，以完成你的 Linear 账号绑定。

把工作委派给 Codex

你可以通过两种方式委派：

把问题单指派给 Codex

安装集成后，你就可以像给队友分配任务一样，把问题单直接分配给 Codex。Codex 会开始工作，并把更新回贴到问题单中。

把 Codex 指派给 Linear 问题单（浅色模式）

把 Codex 指派给 Linear 问题单（深色模式）

在评论中提到 @Codex

你也可以在评论线程中提到 @Codex，把工作委派出去，或者直接向它提问。Codex 回复后，你还可以在同一线程继续追问，从而延续同一个会话。

在 Linear 问题单评论中提到 Codex（浅色模式）

在 Linear 问题单评论中提到 Codex（深色模式）

当 Codex 开始处理某个问题单后，它会选择一个环境和仓库来执行任务。如果你想固定某个仓库，可以直接在评论中写出来，例如：@Codex fix this in openai/codex。

如果你想跟踪进度，可以查看：

  • 问题单里的 Activity（活动），查看进度更新
  • 任务链接，跟踪更详细的执行过程

任务结束后，Codex 会发布一份总结，并附上已完成任务的链接，方便你创建拉取请求（pull request）。

Codex 如何选择环境和仓库

  • Linear 会先基于问题单上下文推荐一个仓库，Codex 会优先选择最匹配该推荐的环境。如果请求本身有歧义，它会退回到你最近一次使用的环境。
  • 任务会运行在该环境的 repo map（仓库映射）中列出的第一个仓库的默认分支上。如果你需要改默认仓库，或让同一环境支持更多仓库，请在 Codex 中更新 repo map。
  • 如果找不到合适的环境或仓库，Codex 会直接在 Linear 中回复说明，告诉你在重试前需要先修正什么。

自动把问题单指派给 Codex

你可以通过 triage rules（分诊规则）自动把问题单指派给 Codex：

  1. 在 Linear 中打开 Settings（设置）。
  2. 在 Your teams（你的团队） 下选择你的团队。
  3. 在 workflow 设置中打开 Triage 并启用它。
  4. 在 Triage rules（分诊规则） 中创建一条规则，并选择 Delegate > Codex（以及你想附带设置的其他属性）。

这样一来，所有进入 triage 的新问题单都会自动分配给 Codex。使用分诊规则时，Codex 会以问题单创建者的账号来运行任务。

把所有问题单自动指派给 Codex 的分诊规则示例（浅色模式）

把所有问题单自动指派给 Codex 的分诊规则示例（深色模式）

数据使用、隐私与安全

当你提到 @Codex 或把问题单指派给 Codex 时，Codex 会接收问题单内容，以理解请求并创建任务。数据处理遵循 OpenAI 的 隐私政策、使用条款 以及其他适用政策。更多安全信息见智能体审批与安全。

Codex 使用的是大型语言模型，它可能出错。请始终评审它的回答和差异。

提示与排障

  • 缺少连接：如果 Codex 无法确认你的 Linear 连接状态，它会在问题单中回复一条账号连接链接。
  • 环境选择不符合预期：可以在线程里直接回复你想要的环境，例如 @Codex please run this in openai/codex。
  • 定位到了错误代码区域：可以继续在评论中使用 @Codex 补充更精确上下文。
  • 更多帮助：参见 OpenAI Help Center

为本地任务连接 Linear（MCP）

如果你在使用 Codex App、CLI 或 IDE 扩展，并希望 Codex 在本地访问 Linear issues，可以把 Codex 配置为使用 Linear 的模型上下文协议（MCP）服务端。

更多信息可参见 Linear MCP 文档。

无论你使用 IDE 扩展还是 CLI，MCP 服务端的设置步骤都相同，因为两者共享同一套配置。

使用 CLI（推荐）

如果你已安装 CLI，运行：

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

系统会提示你使用 Linear 账号登录，并把它连接到 Codex。

手动配置

  1. 编辑 ~/.codex/config.toml：
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. 运行：
codex mcp login linear

来源：https://developers.openai.com/codex/integrations/linear