---
title: "安装 CircleCI 插件"
summary: "安装 circleci@openai-curated，使用 CI 相关技能。当前插件未声明 MCP，托管 MCP 可按需单独连接。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "CircleCI", "circleci@openai-curated"]
canonical: /tips/circleci-codex-plugin/
---

# 安装 CircleCI 插件

安装 circleci@openai-curated，使用 CI 相关技能。当前插件未声明 MCP，托管 MCP 可按需单独连接。

安装 circleci@openai-curated，使用 CI 相关技能。当前插件未声明 MCP，托管 MCP 可按需单独连接。

这是把失败构建诊断、CLI 操作和 `.circleci/config.yml` 优化接到 Codex。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/circleci/.codex-plugin/plugin.json) 的 name 是 `circleci`、version 是 `1.0.4`，所以精选 id 是 `circleci@openai-curated`。现行清单只声明 `skills`，没有 `apps`，也没有 `mcpServers`。仓库里没有 `.mcp.json`。

CLI：

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

TUI `/plugins` 或桌面 Plugins 搜 CircleCI 再装，效果一样；已收录的 `mcp-circleci-remote` 写的也是这条 Plugins 路径。IDE 扩展没有 `/plugins`，用 CLI 这条。装完先 `circleci auth login`，技能要新开会话才加载。

技能随插件走，SKILL.md 的 name 是 `circleci-builds`、`chunk`、`circleci-cli`、`circleci-config`。不要把 CircleCI-Public/skills 源仓里尚未打进这份精选包的 `circleci-testsuite` 当成已装技能。不要 `npx skills add` 当 Codex 安装器，也不要手拷到 `~/.codex/skills`。源仓 README 的本地 marketplace 只给作者评测用，**不是** Codex 安装步骤。

因为现行 `plugin.json` **没有**挂 `mcpServers`，不要假设 `plugin add` 会自动叠 MCP 表。只要远程 MCP、不要技能包时，才走已收录的 `mcp-circleci-remote`：`mcp add circleci --url https://mcp.circleci.com/v1/mcp` 再 `mcp login circleci`。不要装已弃用的 `npx @circleci/mcp-server-circleci`。

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

使用注意事项：

- 操作影响：重跑 pipeline、改配置会动真实项目。


## 来源

- [openai/plugins · circleci plugin.json](https://github.com/openai/plugins/blob/main/plugins/circleci/.codex-plugin/plugin.json)
- [openai/plugins · circleci-builds](https://github.com/openai/plugins/blob/main/plugins/circleci/skills/builds/SKILL.md)
- [CircleCI-Public/skills](https://github.com/CircleCI-Public/skills)