用途:在 Claude Code 与 OpenAI Codex CLI 之间建立互操作桥接,实现文档转换、命令执行与技能说明。
主要能力:
- 文档转换:解析 CLAUDE.md 与项目结构,扫描 .claude/skills/、.claude/agents/、documentation/ 等目录,生成引用式的 AGENTS.md(只引用文件路径,不复制文件内容),并按技能类型给出最相关的使用方式。
- 安全机制:自动检查 Codex CLI 是否安装(codex --version),CLAUDE.md 缺失时自动运行 /init 并通知用户,校验认证与环境,给出友好错误提示。
- 执行封装:提供 exec_analysis()(只读分析,gpt-5,read-only 沙箱)、exec_edit()(代码编辑,gpt-5-codex,workspace-write)、exec_with_search()(启用搜索)、resume_session()(继续上次会话),始终使用 codex exec。
- 技能文档:为 Codex CLI 用户说明提示型、功能型、复杂型技能的使用方法,并给出 codex exec 命令语法与模型选择建议。
使用方式:输入 JSON 指定 action,如 generate-agents-md(含 project_root 与 options)或 codex-exec(含 task_type、prompt、model、sandbox)。示例命令:codex exec -m gpt-5 -s read-only -c model_reasoning_effort=high "任务描述";继续会话:codex exec resume --last。可与 /init、/update-claude、/check-docs、/sync-agents-md、/codex-exec 等命令集成。
适用场景:跨工具团队协作、需要把 Claude Code 项目配置暴露给 Codex CLI、用 Codex 执行分析或编辑任务。
限制:同步为单向(CLAUDE.md → AGENTS.md);需预先安装并登录 Codex CLI(v0.48.0 或更高)与 Claude Code v1.0+;必须使用 codex exec,否则会出现 stdout is not a terminal 错误;AGENTS.md 不同步时需手动重新生成。安装方式:cp -r generated-skills/codex-cli-bridge ~/.claude/skills/。版本 v1.0.0,Apache 2.0 许可。