@codingplay/codex-init

@codingplay/codex-init 是一个面向 Codingplay 中转环境的 Codex 安装器。

当前实现包含：

• Windows 首装主流程骨架
• Git 检测；npm/npx 流程不会自动下载 Git，避免误装
• Node 检测；npm/npx 流程要求已有 Node 20+
• 官方 @openai/codex 安装，固定使用 https://registry.npmmirror.com
• ~/.codex/config.toml 覆盖写入
• ~/.codex/auth.json 覆盖写入
• Windows 下 VCRUNTIME140_1.dll 缺失时的自动补装
• 若运行库已存在但 codex 仍无反应，则停止并提示人工支持

本地开发

cd /Users/shmily/Desktop/codingplay-init
npm install -g .
codingplay-init --help

给用户的 npm 用法

推荐两种形式：

npx --yes --registry=https://registry.npmjs.org @codingplay/codex-init@latest

或：

npm install -g @codingplay/codex-init
codingplay-init

说明：

• codingplay-init 无参数时默认就是完整安装流程
• --yes 会跳过 npx 的安装确认，不需要用户先输入 y
• --registry=https://registry.npmjs.org 会强制使用 npm 官方源，避免镜像未同步导致 404
• 如果用户机器上还没有 Node/npm，则无法直接走 npm 入口，这种场景仍需要先装 Node

命令

codingplay-init
codingplay-init setup
codingplay-init --mode 1
codingplay-init --mode 2
codingplay-init --key sk-xxx
codingplay-init setup --key sk-xxx
codingplay-init doctor

Key 输入说明：

• 启动后会先选择配置模式：1 初次使用，2 老玩家配置
• 默认会提示输入 Key，输入框是普通明文输入
• 如果误按回车导致 Key 为空，程序会重新提示，不会直接退出
• 也可以使用 CODINGPLAY_SETUP_MODE / --mode 和 CODING_API_KEY / --key 参数跳过交互输入

Windows 一键脚本

如果用户机器已有 Node/npm，可以直接运行：

npx --yes --registry=https://registry.npmjs.org @codingplay/codex-init@latest

如果用户机器没有 Node/npm，需要先下载本包脚本再执行；该脚本会安装 Node LTS，但不会自动下载 Git：

$v="0.1.21"; $d="$env:TEMP\codingplay-init"; Remove-Item $d -Recurse -Force -ErrorAction SilentlyContinue; New-Item -ItemType Directory -Path $d | Out-Null; Invoke-WebRequest "https://registry.npmjs.org/@codingplay/codex-init/-/codex-init-$v.tgz" -OutFile "$d\pkg.tgz"; tar -xzf "$d\pkg.tgz" -C $d; powershell -ExecutionPolicy Bypass -File "$d\package\scripts\install.ps1"

本地源码脚本调试：

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1