这页能帮你把 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 先开启两项设置:
- 在 workspace settings 里打开 Codex cloud tasks
- 在 connector settings 里启用 Codex for Linear
怎么配置 Linear 集成
- 先在 Codex 里连接 GitHub,按照 Codex cloud tasks 的要求,为 Codex 要处理的 repository 创建 environment。
- 进入 Codex settings,为你的 workspace 安装 Codex for Linear。
- 在 Linear 的 issue 评论线程里提到
@Codex,把 Linear 账号关联起来。
怎么把工作委派给 Codex
你可以用两种方式把 Linear issue 交给 Codex。
把 issue 分配给 Codex
安装集成后,分配 issue 的方式和分配给同事一样。Codex 会开始工作,并把更新发布回这个 issue。
在评论里提到 @Codex
你也可以在评论线程里提到 @Codex,把任务委派出去,或者直接提问。Codex 回复后,继续在同一线程跟进,就会沿用同一个 session。
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。
- 在 Linear 里打开 Settings。
- 在 Your teams 下选择你的 team。
- 进入 workflow settings,打开 Triage 并启用。
- 在 Triage rules 里新建规则,选择 Delegate > Codex,并按需设置其他属性。
进入 triage 的新 issue 会被 Linear 自动分配给 Codex。
使用 triage rules 时,Codex 运行 task 会使用 issue creator 的账号。
数据使用、隐私和安全
当你提到 @Codex 或把 issue 分配给它时,Codex 会收到你的 issue 内容,用来理解请求并创建 task。
数据处理遵循 OpenAI 的 Privacy Policy、Terms 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
- 用编辑器打开
~/.codex/config.toml。 - 添加以下内容:
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
- 运行
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。