Codex 适配

May 10, 2026 · View on GitHub

OpenAI Codex CLI 中启用 AI Inner OS。

安装

正式用户只通过 Codex plugin / marketplace 安装。手动适配、全局脚本、手动复制 AGENTS.mdhooks.json 仅用于本仓库开发调试。

仓库根目录包含正式 Codex 插件清单:

.codex-plugin/plugin.json

清单直接引用现有 Codex hook 配置:

{
  "hooks": "./codex/hooks.json",
  "skills": "./skills/"
}

仓库还包含 repo-scoped marketplace:

.agents/plugins/marketplace.json

Codex 可从该 marketplace 发现 ai-inner-os,并从当前仓库根目录加载插件组件。

Hook 生命周期

Hook触发时机作用
SessionStart会话启动初始化会话状态
PostToolUse工具执行后追踪事件,注入最近活动上下文
Stop会话结束清理状态文件

Persona(人设切换)

正式安装场景下,人设与频率应由插件配置或插件命令管理。仓库内 scripts/switch-persona.js 只用于维护静态适配副本。

可选用户人物画像

根级 skills/user-profile-distillation 随 Codex 插件分发,但默认不触发。只有用户明确请求画像分析时才使用;读取本地历史前必须确认日期范围和来源,并通过 agent-chat-history 只读导出 prompts。持续进化模式也需显式开启,只在当前对话中维护版本化画像。

与 Claude Code 版本的差异

Claude CodeCodex CLI
协议注入SessionStart hook 自动读取 SKILL.mdAGENTS.md 静态加载
失败追踪PostToolUseFailure 独立 hook无(Codex 暂不支持)
Hook 数量9 个3 个
安装方式插件市场一键安装Codex plugin / marketplace