在 Linear 中使用 Codex

在 Linear 中使用 Codex

在 Linear 问题单中使用 OpenAI Codex 运行任务，把需求管理、上下文说明和代码执行流程连接起来，减少人工切换。

在 Linear 中使用 Codex#

Codex 中文站说明： 本页围绕“在 Linear 中使用 Codex”重新补充了中文使用场景和验证重点。界面名称可能随 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#

你也可以在评论线程中提到 @Codex，把工作委派出去，或者直接向它提问。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 会接收问题单内容，以理解请求并创建聊天。数据处理遵循 OpenAI 的隐私政策、使用条款以及其他适用政策。更多安全信息见智能体审批与安全。

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

提示与排障#

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

为本地工作连接 Linear（MCP）#

如果你在使用 ChatGPT 桌面 App、Codex CLI 或 IDE 扩展，并希望它在本地访问 Linear 问题单，请配置 Linear MCP server。

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

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

使用 CLI（推荐）#

如果你已安装 CLI，运行：

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

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

手动配置#

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

本站实践建议#

阅读“在 Linear 中使用 Codex”时，建议先在非生产项目中走完一次完整流程，并记录实际界面、命令输出和验证结果。产品更新后，可据此快速判断哪些步骤需要调整。

Codex API 与国内使用#

在实践“在 Linear 中使用 Codex”相关功能时，如需为 Codex 配置 OpenAI-compatible API，可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。