乐于分享
好东西不私藏

一套插件,两个平台:42plugin CLI 正式支持 OpenAI Codex

一套插件,两个平台:42plugin CLI 正式支持 OpenAI Codex

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

来源:活水 AI 实验室

AI 编程助手正在趋同。Claude Code 和 OpenAI Codex CLI 都用 SKILL.md 来定义技能——格式一样,能力一样,只是安装目录和 Agent 配置文件长得不同。

一个是 .claude/,一个是 .codex/。一个用 Markdown + YAML frontmatter,一个用 TOML。同一份技能内容,手动复制、手动改格式,明明可以自动化的事情,不该由人来做。

今天,42plugin CLI 正式支持多平台安装。

一条命令,装到任意平台

在原有的 installupdateuninstall 命令后面加一个 --platform 参数,插件就会安装到对应平台的目录:

42plugin install opc/xx2md/md-to-docx# 安装到 Codex CLI42plugin install opc/xx2md/md-to-docx --platform codex

不加 --platform 时默认 claude,完全向后兼容,已有的使用习惯不受影响。

格式自动转换

两个平台的 Skill 文件完全相同(都是 SKILL.md),不需要任何转换。但 Agent 文件格式不同:

平台
Agent 格式
存放目录
模型名
Claude Code
.md
(YAML frontmatter)
.claude/agents/
opus / sonnet / haiku
Codex CLI
.toml
(TOML 配置)
.codex/agents/
o3 / o4-mini

CLI 在安装时自动完成转换。一个 Claude 的 .md Agent 文件,安装到 Codex 时会自动变成 .toml 格式,模型名也会自动映射:

Claude 模型
Codex 模型
推理力度
opus
o3
high
sonnet
o4-mini
medium
haiku
o4-mini
low

反过来也一样——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 更懂你的工作。

点击阅读原文,探索活水插件