学习精选 · AI 工具
Codex

同一个 Skill 能在 Claude Code 和 Codex 里通用吗?一份兼容性对照指南

DEV Community2026-11-21约 4 分钟读完AI 整理查看原文

Skill 本质上就是一个带 SKILL.md 的文件夹,两个工具的格式基本一致,主要差别在存放路径和各自独有的扩展字段。文章给出具体的安装命令和写一份「两边都能跑」的 Skill 的清单,适合同时使用两个 AI 编程代理的人。

今天就能做

  • 把现有 Skill 复制到 .agents/skills/(Codex)和 .claude/skills/(Claude Code)各一份,用软链接保持同步
  • 检查 Skill 正文里有没有 Claude Code 专属变量或工具名,改成相对路径和中性描述
  • 用一条应触发、一条不应触发的提示词,在两个工具里各验证一次 Skill 是否正常工作

Skill 的共同格式

  • 两边都是「文件夹 + SKILL.md」:YAML frontmatter 写 name 和 description,正文是 Markdown 指令,可附带参考文件、模板和脚本
  • description 是最关键的一行,决定任务匹配时 Skill 会不会被自动触发
  • 手动调用方式不同:Claude Code 输入 /skill-name,Codex CLI 输入 $ 或运行 /skills 从列表选择

存放路径是主要差异

  • Claude Code:项目级放 .claude/skills/,全局放 ~/.claude/skills/
  • Codex:项目级放 .agents/skills/(会向上级目录一直找到仓库根),全局放 $HOME/.agents/skills/
  • 文件夹名和 SKILL.md 文件名完全一样,只是父目录不同,复制过去即可

两边通用的安装步骤

  • 在仓库根目录分别建 .claude/skills/ 和 .agents/skills/,把同一个 Skill 文件夹 cp 进去
  • 全局安装则复制到 ~/.claude/skills/ 和 ~/.agents/skills/
  • 各自开新会话验证:跑一个匹配 description 的任务,或手动调用确认已加载
  • 不触发时先检查 description 写得清不清楚,再检查路径是否放对
  • 建议保留一份源文件,用复制或软链接同步到两边,避免两份内容漂移

哪些地方会失去可移植性

  • Claude Code 独有字段:allowed-tools、disable-model-invocation、context: fork、agent、arguments、paths 等;Codex 的扩展配置放在 agents/openai.yaml
  • Claude Code 的 $ARGUMENTS、${CLAUDE_SKILL_DIR} 等变量在 Codex 里不存在,改用 Skill 文件夹内的相对路径引用文件
  • 指令里别写「用 Read 工具」这类特定工具名,改成描述目标(如「读取 references/checklist.md」),让各代理自己选工具
  • 即使 Skill 完全相同,两个模型的输出措辞和深度也会不同,需要在两边分别检查结果

写一份能跨工具使用的 Skill

  • frontmatter 只用 name 和 description,description 一两句话说清做什么、什么时候用
  • 正文用纯 Markdown 写步骤、规则和清单,长参考资料放独立文件用相对路径引用
  • 不在正文里点名任何代理专属的工具或变量
  • 用「应该触发」和「不应该触发」两类提示词在两个工具里各测一遍
  • 如果 Skill 包含他人作品,记得附带 license 文件

怎么选工具

  • 已经习惯其中一个就直接留下,Skill 格式不需要你换工具
  • 团队里混用两个工具时,按共享最小格式维护一份 Skill,装进两个目录
  • 依赖 Claude Code 的 subagent 或工具权限字段的 Skill,迁移到 Codex 需要手动调整
  • 买来的 Skill 包要确认页面标注了在哪个工具里实测过,而不是只写「兼容」

原文:Codex vs Claude Code: can you use the same skill in both?

来源:DEV Community · 2026-11-21

查看原文

本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。

登录后可以点赞、查看和发表评论