点击上方↗️「活水智能」,关注 + 星标🌟

来源:活水 AI 实验室
AI 编程助手正在趋同。Claude Code 和 OpenAI Codex CLI 都用 SKILL.md 来定义技能——格式一样,能力一样,只是安装目录和 Agent 配置文件长得不同。
一个是 .claude/,一个是 .codex/。一个用 Markdown + YAML frontmatter,一个用 TOML。同一份技能内容,手动复制、手动改格式,明明可以自动化的事情,不该由人来做。
今天,42plugin CLI 正式支持多平台安装。
一条命令,装到任意平台
在原有的 install、update、uninstall 命令后面加一个 --platform 参数,插件就会安装到对应平台的目录:
42plugin install opc/xx2md/md-to-docx# 安装到 Codex CLI42plugin install opc/xx2md/md-to-docx --platform codex不加 --platform 时默认 claude,完全向后兼容,已有的使用习惯不受影响。
格式自动转换
两个平台的 Skill 文件完全相同(都是 SKILL.md),不需要任何转换。但 Agent 文件格式不同:
.md | .claude/agents/ | ||
.toml | .codex/agents/ |
CLI 在安装时自动完成转换。一个 Claude 的 .md Agent 文件,安装到 Codex 时会自动变成 .toml 格式,模型名也会自动映射:
反过来也一样——Codex 的 .toml 文件安装到 Claude 时会自动转成 .md。
同一插件可以装到两个平台
数据库层面,同一个插件允许在不同平台各装一份。CLI 会分别跟踪每个平台的安装状态:
# 查看已安装的插件(默认只看 claude)42plugin list# 只看 codex 平台的安装42plugin list --platform codex# 卸载 codex 平台的插件42plugin uninstall opc/xx2md/md-to-docx --platform codex# 更新 codex 平台的插件42plugin update --platform codex创作者:一次编写,双平台兼容
如果你是插件创作者,在 SKILL.md 的 frontmatter 中声明兼容的平台:
---description:'将Markdown转换为DOCX'metadata:platforms:['claude','codex']---42plugin pub 发布时,validator 会自动验证 platforms 字段。未声明时默认兼容 claude。 对 Skill 类型的插件来说,两家的格式完全一样,声明双平台几乎没有额外工作量。Agent 类型的插件由 CLI 自动转换格式,创作者只需要写 Claude 版本即可。
设计原则
统一的是意图,适配的是运行时。
两家 AI 编程助手做的事情本质上一样——读取一段提示词,赋予 AI 特定的能力。区别只在运行时的目录结构和配置格式。42plugin 选择在 CLI 层做适配,让用户和创作者都不需要关心底层差异。
当前支持 Claude Code 和 Codex CLI 两个平台。架构已经预留了扩展能力——未来如果有更多 AI 编程助手采用类似的插件规范,添加一个新平台只需要定义目录映射和格式适配器。
升级 CLI
多平台安装需要最新版 CLI。升级命令:
# macOS / Linuxcurl -fsSL https://get.42plugin.com/cli | bash -s -- --upgrade# Windows(管理员 PowerShell)&([scriptblock]::Create((irm https://get.42plugin.com/win))) -Upgrade升级完成后,打开新终端窗口即可使用 --platform 参数。

活水插件(42plugin)— 增强你的 AI
发现、安装、分享更多 skill,让 Claude Code 更懂你的工作。
夜雨聆风