跳转到内容

在 Linear 中使用 Codex

在 Linear 中使用 Codex,可从 issue 分派工作。将 issue 分配给 Codex,或在评论中提及 @Codex,Codex 就会创建云端聊天,并回复进度和结果。

Linear 中的 Codex 面向付费套餐提供(请参阅定价)。

如果你使用的是 Enterprise 套餐,请让 ChatGPT 工作区管理员在工作区设置中开启 Codex cloud chats,并在连接器设置中启用 Codex for Linear。

  1. 在 Codex 中连接 GitHub,并为希望 Codex 使用的仓库创建一个环境,以设置 Codex cloud chats。
  2. 前往 Codex 设置,为你的工作区安装 Codex for Linear。
  3. 在 Linear issue 的评论线程中提及 @Codex,以关联你的 Linear 帐户。

你可以通过两种方式进行分派:

安装集成后,你可以像将 issue 分配给团队成员一样,将 issue 分配给 Codex。Codex 会开始工作,并将更新发布回 issue。

将 Codex 分配给 Linear issue(浅色模式)

将 Codex 分配给 Linear issue(深色模式)

你也可以在评论线程中提及 @Codex,以分派工作或提出问题。Codex 回复后,可以在线程中继续跟进,以继续同一聊天。

在 Linear issue 评论中提及 Codex(浅色模式)

在 Linear issue 评论中提及 Codex(深色模式)

Codex 开始处理 issue 后,会选择环境和仓库来开展工作。

如果要固定使用特定仓库,请在评论中注明,例如:@Codex fix this in openai/codex。

如需跟踪进度:

  • 打开 issue 中的 Activity,查看进度更新。
  • 打开聊天链接,查看更多详细信息。

Codex 完成后,会发布摘要和已完成聊天的链接,方便你创建 pull request。

  • Linear 会根据 issue 上下文建议一个仓库。Codex 会选择与该建议最匹配的环境。如果请求不明确,则回退到你最近使用的环境。
  • 聊天会针对该环境仓库映射中列出的第一个仓库的默认分支运行。如果需要不同的默认仓库或更多仓库,请在 Codex 中更新仓库映射。
  • 如果没有可用的合适环境或仓库,Codex 会在 Linear 中回复如何修复问题,然后再重试。

你可以使用 triage 规则自动将 issue 分配给 Codex:

  1. 在 Linear 中前往 Settings。
  2. 在 Your teams 下选择你的团队。
  3. 在工作流设置中打开 Triage,并将其开启。
  4. 在 Triage rules 中创建规则,然后选择 Delegate > Codex(以及你想设置的其他属性)。

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

使用 triage 规则时,Codex 会使用 issue 创建者的帐户运行聊天。

将所有内容分配给 Codex,并在 “Triage” 状态中为其添加标签的示例 triage 规则截图(浅色模式)

将所有内容分配给 Codex,并在 “Triage” 状态中为其添加标签的示例 triage 规则截图(深色模式)

当你提及 @Codex 或将 issue 分配给 Codex 时,Codex 会接收 issue 内容,以了解你的请求并创建聊天。

数据处理遵循 OpenAI 的隐私政策、使用条款以及其他适用的政策。

有关安全性的更多信息,请参阅 Codex 安全文档。

Codex 使用可能出错的大型语言模型。请始终检查回答和差异。

  • 缺少连接:如果 Codex 无法确认你的 Linear 连接,它会在 issue 中回复,并附上用于连接帐户的链接。
  • 环境选择不符合预期:在评论线程中回复你想使用的环境(例如:@Codex please run this in openai/codex)。
  • 代码位置不正确:在 issue 中添加更多上下文,或在 @Codex 评论中提供明确说明。
  • 获取更多帮助:请参阅 OpenAI 帮助中心。

连接 Linear 以进行本地工作(MCP)

Section titled “连接 Linear 以进行本地工作(MCP)”

如果你使用 ChatGPT 桌面应用、Codex CLI 或 Codex IDE extension,并希望它能够在本地访问 Linear issue,请配置 Linear Model Context Protocol(MCP)服务器。

如需了解更多信息,请查看 Linear MCP 文档。

无论使用 Codex IDE extension 还是 CLI,MCP 服务器的设置步骤都相同,因为二者共享同一配置。

如果已安装 CLI,请运行:

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

系统会提示你使用 Linear 帐户登录,并将其连接到 Codex。

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