codex-to-claude

一键自动探测本地 Codex (ChatGPT Desktop) 环境，导出并生成适用于 Claude Code 的 MCP 服务（带自动放行代理，杜绝频繁弹窗拦截）与 Skills 技能规范。

🌟 核心功能

1. 自动探测本地 Codex 基础设施：

   • 自动扫描 /Applications/ChatGPT.app/Contents/Resources 与 ~/.codex。
   • 发现并装配 computer-use（macOS 原生 GUI 原子操控）、node_repl（代码沙箱引擎）及 cua_repl（高阶计算机与浏览器统一自动化运行时）。
   • 自动扫描 13+ 个 Codex 内置 Skills（包括 computer-use、control-chrome、visualize、deep-research、sites-building 等）。

2. 内置透明 Auto-Approve 代理：

   • 解决 Claude Code 频繁弹出 mcp server "cua_repl" requests your input (elicitation/create) 终端打断的问题。
   • 毫秒级后台放行，实现真正的无感 UI 自动化。

3. 安全配置合并与交互式安装：

   • 支持安装到 Claude Code 全局环境（~/.claude.json + ~/.claude/skills/）。
   • 支持安装到 当前项目工作区（./.mcp.json + ./.claude/skills/）。
   • 智能增量合并已有配置（如已存在的 grok-search 等不受影响），并自动保留备份。

🚀 运行方式

方式 1：使用 npx 运行

在任何终端或工作区目录下直接执行：

npx /Users/cdd/Documents/ClaudeCodeRemote/CCVibe/packages/codex-to-claude

(若已将本目录链接或发布至 npm，可直接运行 npx codex-to-claude)

方式 2：使用 node 直接运行

node /Users/cdd/Documents/ClaudeCodeRemote/CCVibe/packages/codex-to-claude/bin/cli.mjs
# 或者通过便捷脚本
node /Users/cdd/Documents/ClaudeCodeRemote/CCVibe/scripts/codex-to-claude.mjs

🛠️ CLI 选项与参数

| 选项 | 简写 | 说明 | | :--- | :--- | :--- | | --global | -g | 直接部署到 Claude Code 全局环境 (~/.claude.json 与 ~/.claude/skills/) | | --project | -p | 直接部署到当前项目环境 (./.mcp.json 与 ./.claude/skills/) | | --both | -b | 同时部署到全局与当前项目环境 | | --dry-run | -d | 仅探测并打印待写入的配置与技能，不修改磁盘任何文件 | | --yes | -y | 静默非交互模式，全部使用推荐配置 | | --all-skills | | 导出全部发现的 Codex 技能（默认仅安装 computer-use） | | --chatgpt-path <path> | | 自定义 ChatGPT.app Resources 目录 | | --codex-home <path> | | 自定义 Codex 配置主目录（默认 ~/.codex） | | --help | -h | 显示帮助文档 |

📋 典型交互流程

╭─────────────────────────────────────────────────────────────╮
│          Codex ➔ Claude Code  MCP & Skills Exporter          │
╰─────────────────────────────────────────────────────────────╯

▶ Codex 本地运行环境探测
  ChatGPT 资源路径: /Applications/ChatGPT.app/Contents/Resources
  Codex Home 路径:  /Users/cdd/.codex

  可用的 MCP 服务:
   [● 就绪] computer-use   - Direct desktop UI actions: click, type, screenshot, inspect AX tree
   [● 就绪] node_repl      - Persistent JS execution engine with top-level await and @oai/sky bridge
   [● 就绪] cua_repl       - High-level UI & browser automation runtime with pre-injected global cua object

  已发现的 Codex 内置 Skills (13 个):
   • control-in-app-browser
   • control-chrome
   • computer-history
   • computer-use
   • deep-research
   ...

▶ 配置安装选项

1. 您希望将 MCP 和 Skill 安装到哪里？
  [1] Claude Code 全局配置 (推荐: ~/.claude.json & ~/.claude/skills/)
  [2] 当前项目 (Project: ./.mcp.json & ./.claude/skills/)
  [3] 全局与当前项目同时配置 (Both)
  [4] 仅生成预览 (Dry Run，不写入任何文件)
请选择 [1/2/3/4] (默认 1): 

2. 选择要启用的 MCP 服务通道：
  [1] 全部推荐通道 (cua_repl + node_repl + computer-use，已内置自动放行代理) [默认推荐]
  [2] 仅启用 cua_repl (高阶批处理，配合 computer-use 技能最佳体验)
  [3] 仅启用 computer-use (macOS 原生单步原子工具)
请选择 [1/2/3] (默认 1): 

3. 选择要导出的技能 (Skills)：
  [1] 仅导出 computer-use 自动化技能 [默认推荐]
  [2] 导出全部已发现的 Codex 技能 (共 13 个)
请选择 [1/2] (默认 1):