---
title: "Cloudflare 官方插件用 marketplace 装，不要 npx skills add"
summary: "marketplace add cloudflare/skills，再 plugin add cloudflare@cloudflare。这会装 Skills 并登记主 MCP。不要用 npx skills add，也不要手拷到 ~/.codex/skills。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "Cloudflare", "MCP", "Skills"]
canonical: /tips/cloudflare-skills-plugin/
---

# Cloudflare 官方插件用 marketplace 装，不要 npx skills add

marketplace add cloudflare/skills，再 plugin add cloudflare@cloudflare。这会装 Skills 并登记主 MCP。不要用 npx skills add，也不要手拷到 ~/.codex/skills。

Cloudflare 官方 Codex 页的主路径是装插件：Skills 教 Workers / Wrangler，插件同时登记主 MCP。仓库 README 给的 Codex 命令是：

```bash
codex plugin marketplace add cloudflare/skills
codex plugin add cloudflare@cloudflare
codex plugin list
codex mcp list
```

marketplace 名是 `cloudflare`，插件 id 是 `cloudflare@cloudflare`。TUI 里 `/plugins` 搜 Cloudflare，桌面走 Plugins 装 Cloudflare，效果一样。清单写明安装时会要授权（`authentication: ON_INSTALL`）。

0.154 起先在当前会话核对 `/plugins` 和 `/mcp`。README 仍写「装完新开会话」：当前会话看不到 `cloudflare@cloudflare` 或 `cloudflare` MCP 时再新开。IDE 扩展没有 `/plugins`。

插件自带的斜杠命令是 `/cloudflare:build-agent`（Agents SDK 脚手架）和 `/cloudflare:build-mcp`（远程 MCP 脚手架）。这是插件技能，不是 Codex 内置。

不要做这些：

- 不要用 `npx skills add https://github.com/cloudflare/skills` 当 Codex 插件安装器。那只会拷 SKILL.md，不会登记 MCP。
- 不要手拷技能目录到 `~/.codex/skills`。那条 Clone/Copy 表给的是纯技能回退，插件路径才会带 MCP。
- 不要抄 Claude 的 `/plugin marketplace add` / `/plugin install`。Codex 是 `codex plugin marketplace add` 和 `plugin add`。
- 不要把 Google 那套 `--sparse` 抄过来。Cloudflare README 没有这条；Google 仓才需要稀疏检出。
- 不要把厂商的 Code Mode 说成 Codex 配置键 `features.code_mode`。那是 Cloudflare 这台 API MCP 自己的搜-执行模式，见 MCP 那条。

网页 Cloud 不读本机 marketplace。改完用 `codex plugin list` 看到 `cloudflare@cloudflare`。

## 来源

- [Cloudflare · Codex agent setup](https://developers.cloudflare.com/agent-setup/codex/)
- [cloudflare/skills](https://github.com/cloudflare/skills)