跳到主要内容

本文为非官方中文翻译，内容以 OpenAI 官方英文文档为准。
官方来源：https://developers.openai.com/codex/integrations/linear

在 Linear 中使用 Codex

从 Linear issue 运行 Codex 任务

在 Linear 中使用 Codex，可以将 issue 中的工作委派出去。将某个 issue 分配给 Codex，或在评论中提及 @Codex，Codex 就会创建一个云任务，并回复进度和结果。

Linear 中的 Codex 功能仅在付费方案中提供（参见定价）。

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

设置 Linear 集成​

  1. 在 Codex 中连接 GitHub，并为你希望 Codex 处理的仓库创建一个环境，以完成 Codex 云任务 的设置。
  2. 前往 Codex 设置，为你的工作区安装 Codex for Linear。
  3. 在 Linear issue 的评论串中提及 @Codex，以关联你的 Linear 账户。

将工作委派给 Codex​

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

将 issue 分配给 Codex​

安装集成后，你可以像将 issue 分配给队友一样，将 issue 分配给 Codex。Codex 会开始工作，并将更新回传到该 issue。

将 Codex 分配给 Linear issue（浅色模式）

将 Codex 分配给 Linear issue（深色模式）

在评论中提及 @Codex​

你也可以在评论串中提及 @Codex 来委派工作或提问。Codex 回复后，可继续在该评论串中跟进，以延续同一个会话。

在 Linear issue 评论中提及 Codex（浅色模式）

在 Linear issue 评论中提及 Codex（深色模式）

当 Codex 开始处理某个 issue 后，它会选择一个环境和仓库来执行工作。
若要固定使用某个特定仓库，请在评论中写明，例如：@Codex fix this in openai/codex。

要跟踪进度：

  • 打开该 issue 的 Activity 查看进度更新。
  • 打开任务链接以查看更多详细过程。

任务完成后，Codex 会发布摘要和已完成任务的链接，以便你创建 pull request。

Codex 如何选择环境和仓库​

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

自动将 issue 分配给 Codex​

你可以使用分流规则自动将 issue 分配给 Codex：

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

Linear 会自动将进入分流的新 issue 分配给 Codex。
使用分流规则时，Codex 会使用 issue 创建者的账户来运行任务。

一个示例分流规则的截图：将所有内容分配给 Codex，并标记为 "Triage" 状态（浅色模式）

一个示例分流规则的截图：将所有内容分配给 Codex，并标记为 "Triage" 状态（深色模式）

数据使用、隐私和安全​

当你提及 @Codex 或将某个 issue 分配给它时，Codex 会接收你的 issue 内容，以理解你的请求并创建任务。
数据处理遵循 OpenAI 的隐私政策、使用条款以及其他适用的政策。
有关安全性的更多信息，请参阅 Codex 安全文档。

Codex 使用大型语言模型，这类模型可能会出错。请始终审查答案和 diff。

提示与故障排查​

  • 缺少连接：如果 Codex 无法确认你的 Linear 连接，它会在 issue 中回复一个用于连接账户的链接。
  • 环境选择不符合预期：在评论串中回复你希望使用的环境（例如，@Codex please run this in openai/codex）。
  • 代码部分不正确：在 issue 中补充更多上下文，或在你的 @Codex 评论中给出明确说明。
  • 更多帮助：参见 OpenAI 帮助中心。

为本地任务连接 Linear（MCP）​

如果你正在使用 Codex 应用、CLI 或 IDE 扩展，并希望 Codex 在本地访问 Linear issue，请将 Codex 配置为使用 Linear Model Context Protocol (MCP) 服务器。

要了解更多信息，请查看 Linear MCP 文档。

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

如果你已安装 CLI，请运行：

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 以登录。