想要实现 Codex 与 Linear 的 Issue 双向同步，首先需要安装 Linear 插件，接着完成账号绑定并授权 Read/Update 权限。之后，你就能在对话中直接用自然语言查询 Issue、修改 Issue，甚至将任务直接交给 Codex 自动处理。整个过程仅需三个步骤，在常见场景下几分钟即可完成配置。

简单来说，你希望避免在两个工具间频繁切换和复制粘贴——让 Codex 自动读取 Linear 上的任务，并能分析甚至代为处理。要实现这一自动化工作流，先安装插件，再授权账号，最后直接在对话中下达指令即可。

安装 Linear 插件

打开 Codex 桌面版，点击左下角齿轮图标进入 Settings → 在左侧菜单选择 Plugins → 在搜索框中输入 Linear → 找到最新版插件（Publisher 显示为 OpenAI）→ 点击 Install 按钮。安装过程大约 5 到 8 秒，完成后按钮会变为绿色并显示 “Enabled”。请注意，此时插件只是成功安装，尚未连接你的 Linear 账户。

绑定 Linear 账户并授权

返回 Plugins 页面，找到已启用的 Linear 插件，点击右侧的 Configure → 浏览器将自动跳转到 Linear OAuth 授权页面 → 使用已登录 Linear 的浏览器账号确认授权 → 勾选 “Read issues” 和 “Update issues” → 点击 Allow。授权成功后，Codex 会自动返回，插件状态旁会显示你的 Linear 工作区名称（例如 “my-team-workspace”）。如果看到 “Not connected” 提示，通常是因为浏览器使用了无痕模式或授权被拦截，建议切换到普通窗口重新尝试。

在对话中调用 Linear 数据

新建一个对话窗口，直接输入指令即可。例如：“帮我查询 Linear 中 status:todo 且 assignee:@me 的所有 issue”，或者 “将 Linear 里 ID 为 lin-1234 的 issue 描述修改为‘增加邮箱验证逻辑’”。Codex 会自动识别关键词（如 lin-1234、status:xxx、assignee:xxx），并向 Linear API 发起查询或更新请求。首次调用时可能会弹出系统级权限提示，点击“允许”即可。

有一点需要特别注意：Codex 只能访问你本人有权限查看的 Linear 项目和 Issue。如果你在 Linear 中都无法看到某个 issue，那么 Codex 也无法获取——它不会越权读取私有队列或其他成员专属的看板。

委派任务给 Codex 处理

第一步：在 Linear 中打开目标 Issue，复制其 URL（格式类似 https://linear.app/my-team/issue/LIN-5678/title）。

第二步：将 URL 粘贴到 Codex 对话框，然后补充指令：“请基于这个 issue 编写一个 React 组件实现方案，包含 props 定义和最小可运行示例。”

第三步：Codex 会解析 URL，获取完整的上下文信息（标题、描述、优先级、关联 PR、评论等），然后生成代码并附带执行建议。

第四步：如果你确认执行，Codex 还能自动生成 PR 描述、将 Linear Issue 状态更新为 “In Progress”，并在评论中插入开发进度链接——前提是你的 Linear 插件已开启 “Write access”，并且你对该 issue 拥有编辑权限。