---
title: "安装 Linear 插件"
summary: "安装 linear@openai-curated 并连接 Linear，查询和管理工单。插件连接、远程 MCP 与云端任务指派分别配置。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "Linear", "linear@openai-curated", "MCP"]
canonical: /tips/linear-codex-plugin/
---

# 安装 Linear 插件

安装 linear@openai-curated 并连接 Linear，查询和管理工单。插件连接、远程 MCP 与云端任务指派分别配置。

安装 linear@openai-curated 并连接 Linear，查询和管理工单。插件连接、远程 MCP 与云端任务指派分别配置。

这是 Linear Orbit 做的工单插件，用来搜、建、改 issues / projects / comments，并起草周报或验收标准。产品页是 [Linear](https://openai.com/business/plugins/linear/)。附件、图片和链出去的外部集成不在范围内。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/linear/.codex-plugin/plugin.json) 的 name 是 `linear`、version 是 `5.0.1`，所以精选 id 是 `linear@openai-curated`。

CLI：

```bash
codex plugin add linear@openai-curated
codex plugin list
```

TUI `/plugins` 或桌面 Plugins 搜 Linear 再装，效果一样。装完按提示 Connect Linear 账号。IDE 扩展没有 `/plugins`，用 CLI 这条。仓库 [README](https://github.com/openai/plugins/blob/main/plugins/linear/README.md) 写明现行 `5.0.1` 带 App 连接器和托管 MCP，**没有**捆绑技能；安装策略是 `AVAILABLE`，认证是 `ON_INSTALL`。不要把旧提交里的 `skills/linear` 目录当现行包，也不要 `npx skills add`。

插件同时登记 [`.app.json`](https://github.com/openai/plugins/blob/main/plugins/linear/.app.json) 和 [`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/linear/.mcp.json)。MCP 表名是 `linear`，type 是 http，URL 是 `https://mcp.linear.app/mcp`（带 `/mcp`）。插件已经登记 MCP 时，不要再手写 `mcp add linear --url https://mcp.linear.app/mcp` 叠一张。只要 MCP、不要 App 时，才走现有的本机 MCP 技巧。

在支持的 Codex 任务视图里，打开 Sources → Use plugins，再搜已安装的 Linear。ChatGPT 里可以用 `@Linear`。

0.154 起先看**当前会话**的 `/plugins`；没有再新开。`codex plugin list` 里应看到 `linear@openai-curated`。网页 Cloud 不读 `~/.codex/config.toml`。Cloud 用 Plugins 搜 Linear。

使用注意事项：

- 操作影响：建工单、改状态、写评论会动真实 Linear 工作区。


## 来源

- [OpenAI · Linear](https://openai.com/business/plugins/linear/)
- [openai/plugins · linear plugin.json](https://github.com/openai/plugins/blob/main/plugins/linear/.codex-plugin/plugin.json)
- [openai/plugins · linear README](https://github.com/openai/plugins/blob/main/plugins/linear/README.md)