Appearance
Codex 与 Linear 的集成让你可以在 issue 页面直接把任务交给 Codex——分配 issue 给 Codex 或在评论里 @Codex，Codex 自动创建 Cloud 任务执行代码修改，完成后回复结果并附上可创建 PR 的链接。本文覆盖安装步骤、任务委托方式、环境自动选择逻辑、自动 triage 规则，以及本地 MCP 接入。
在 Linear 里使用 Codex
Codex Linear 集成让你不用离开 Linear 就能委托编程任务。把 issue 分配给 Codex，或在评论里 @Codex，Codex 就会启动 Cloud 任务，执行改动，并把结果发回 issue 线程。
前提条件与安装
前提：
- 已完成 Codex Cloud 任务 配置：在 Codex 里连接了 GitHub 并创建了对应仓库的环境
- 订阅了 Plus、Pro、Business、Enterprise 或 Edu 计划（详见定价）
Enterprise 用户额外步骤：联系你的 ChatGPT 工作区管理员，在 workspace settings 里开启 Codex cloud tasks，并在 connector settings 里启用 Codex for Linear。
安装步骤：
- 前往 Codex 设置页面，安装 Codex for Linear 到你的 Linear 工作区
- 在 Linear 的任意 issue 评论里 @Codex，按提示绑定账号
委托任务给 Codex
有两种方式：
方式一：将 issue 分配给 Codex
安装完成后，在 issue 的 Assignee 里选择 Codex，就像分配给队友一样。Codex 会开始工作，并把进度更新发回 issue。
方式二：在评论里 @Codex
在任意 issue 的评论线程里提 @Codex 加任务描述。Codex 回复后可以继续在线程里跟进，保持同一个 session 上下文。
如需指定仓库，在评论里注明：
@Codex fix this in openai/codex追踪进度：
- 查看 issue 的 Activity 面板，实时看进度更新
- 点击 Codex 回复里的任务链接，在 Codex Cloud 界面查看详细日志
任务完成后，Codex 发布摘要和完成任务的链接，你可以直接从那里创建 PR。
Codex 如何选择执行环境
- Linear 根据 issue 上下文推荐一个仓库，Codex 选择最匹配的环境
- 请求模糊时，回退到你最近使用的环境
- 任务运行在该环境 repo map 第一个仓库的默认分支
- 如需更换默认仓库，在 Codex 环境设置里更新 repo map
- 如果没有合适的环境，Codex 会在 Linear 里回复说明，告诉你如何修复后重试
自动 triage 规则
可以用 Linear 的 triage 规则，让新 issue 自动分配给 Codex：
- 打开 Linear，进入 Settings
- 在 Your teams 下选择你的团队
- 在工作流设置里打开 Triage
- 在 Triage rules 里新建规则，选择 Delegate > Codex，配置你需要的其他条件
规则生效后，进入 triage 的新 issue 会自动分配给 Codex。使用 triage 规则时，Codex 以 issue 创建者的账号身份运行任务。
数据隐私与安全
@Codex 或分配 issue 时，Codex 会接收 issue 内容和评论历史来理解请求。数据处理遵循 OpenAI 隐私政策和使用条款。
Codex 使用大型语言模型，可能产生错误。请始终审查 Codex 给出的改动和 PR，不要不经验证直接合并。
本地访问 Linear（MCP 接入）
如果你在用 Codex App、CLI 或 IDE 扩展，想让 Codex 在本地任务中读取 Linear issue，可以配置 Linear MCP Server：
用 CLI 安装（推荐）
bash
codex mcp add linear --url https://mcp.linear.app/mcp按提示登录 Linear 账号完成绑定。
手动配置
在 ~/.codex/config.toml 里添加：
toml
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"然后运行 codex mcp login linear 完成登录。
CLI 和 IDE 扩展共享同一份配置，配一次两边都生效。
常见问题
Q: @Codex 后提示找不到 Linear 连接，怎么处理？
A: Codex 无法确认你的 Linear 账号绑定时，会在 issue 里回复重连链接。点击链接按提示重新绑定，成功后再重试原始请求。
Q: Codex 选错了仓库，如何指定？
A: 在评论线程里回复指定仓库，例如 @Codex please run this in openai/codex，然后重新触发任务。
Q: 能不能让某些类型的 issue 完全自动交给 Codex 处理？
A: 可以，使用 Linear 的 triage 规则配置自动分配条件（如标签、优先级、issue 类型等），满足条件的 issue 进入 triage 时会自动分配给 Codex。