用途:安装或更新两个受支持的 CLI 智能体——Codex CLI 与 Claude Code。每个智能体单次执行:先安装,随后立即校验。
主要能力:按注册表执行安装命令并做健康检查。Codex 安装命令为 npm i -g @openai/codex,健康检查 codex --version;Claude 安装命令为 npm i -g @anthropic-ai/claude-code 或 claude update,健康检查 claude --version。交互入口为 codex 或 codex "prompt"、claude 或 claude "prompt";自动化使用 codex exec ... 与 claude -p ...。注意 codex 交互模式在 stdin 非终端时会被拒绝,非交互校验须用 codex exec ...。
使用方式:输入包括操作系统信息、各智能体禁用标记、dry_run 标记、可选 runId 与 summaryArtifactPath。流程为 PHASE_0_CONFIG、PHASE_1_INSTALL_VERIFY、PHASE_2_POST_CODEX_SANITY_CHECK、PHASE_3_WRITE_SUMMARY、PHASE_4_SELF_CHECK。输出结构化 env-agent-install 摘要,payload.status 为 completed/skipped/error,并含 targets、agents_processed、agents_skipped、versions、codex_drift_detected。提供 summaryArtifactPath 时写入该路径,否则内联返回;未提供 runId 时自行生成。
适用场景:需要统一安装或更新这两个 CLI 智能体的环境准备。
限制:仅支持 Codex 与 Claude,不添加其他智能体分支;仅全局安装,工具须在 PATH 中;不修改禁用标记;失败不自动重试,单个失败不阻塞另一个;不使用 sudo,权限问题建议 npm install -g --prefix ~/.local {pkg};不安装市场插件、不重写 Codex 市场布局或执行默认值,漂移仅报告并交由 ln-013-config-syncer 处理。需读取 references/coordinator_summary_contract.md、references/environment_worker_runtime_contract.md、references/worker_runtime_contract.md。版本 1.1.0,最后更新 2026-03-23。