Claude Code用户如何安装LoopX适配器：/loopx与/loop命令完整指南
Claude Code用户如何安装LoopX适配器/loopx与/loop命令完整指南【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX 是一个开源的长周期智能体控制平面运行在 Codex、Claude Code 等智能体运行时之上。本文面向新手手把手教你安装LoopX Claude Code 适配器从一行 pip 命令装好 LoopX 本体到在项目里启用/loopx命令再用 Claude Code 原生的/loop命令驱动任务循环完整走通全流程。 LoopX 适配器是什么为什么需要它一句话Claude Code 负责执行LoopX 负责治理。Claude Code 自带的/loop只是机械地反复执行脚本而 LoopX 适配器在它之上加了一层确定性的控制协议——每次循环开始前先问一句该不该跑should_run再决定领取哪个任务、如何收工。这样长任务就能跨天、跨重启持续运行且每一步都有状态和证据可查。关键设计适配器不使用Claude Code 内置的/goal它从对话记录判断完成度与 LoopX 的确定性门控冲突而是用原生/loop作为运行循环。 适配器官方说明loopx/claude_goal_mode/README.md 最快安装方法先装 LoopX 本体适配器依赖 LoopX 主程序请先确保环境满足Python 3.11Node.js 22.18 更佳然后在激活的虚拟环境中执行python3 -m pip install --upgrade loopx loopx workflow-skills --install loopx doctorloopx doctor会检查运行时状态看到ready即安装成功。系统 Python 是外部受管环境时可用pipx install loopx代替。 完整安装参考docs/guides/installing-loopx.md⚙️ 安装 Claude Code 适配器两种方式LoopX 适配器采用显式开启策略——正常安装器绝不会偷偷改动你的~/.claude配置必须你明确要求才会写入。方式一通过 LoopX 安装器用户级一条命令适合想让所有 Claude Code 项目都能用/loopx的用户git clone https://gitcode.com/GitHub_Trending/lo/loopx.git cd loopx LOOPX_INSTALL_CLAUDE1 scripts/install-local.sh它会以用户级安装 MCP 服务器和/loopx命令不装任何 hooks。去掉LOOPX_INSTALL_CLAUDE1环境变量时安装器会完全跳过适配器。方式二直接运行安装脚本推荐项目级隔离如果你只希望当前项目受影响这是更稳妥的选择# 仅当前项目推荐 python3 loopx/claude_goal_mode/scripts/install.py --scope project --project /path/to/project # 所有 Claude Code 项目安装时会明确提示影响范围 python3 loopx/claude_goal_mode/scripts/install.py --scope user # 先预览要写什么不实际落盘 python3 loopx/claude_goal_mode/scripts/install.py --scope project --project /path/to/project --dry-run 可选增强--harden 门控加一个参数即可启用项目级PreToolUse门控python3 loopx/claude_goal_mode/scripts/install.py --scope project --project /path/to/project --harden启用后每次工具调用会先过一道确定性检查只读工具Read/Glob/Grep直接放行写文件操作只允许落在write_scope范围内Bash命令按破坏性命令黑名单拦截探测不可达时拒绝优先fail-closed。注意它是策略层而非沙箱高风险任务仍建议在容器里运行。 /loopx 与 /loop 命令全流程安装完成后重启所有已打开的 Claude Code 会话让命令和 MCP 服务加载。之后流程只有三步第 1 步/loopx task 建立目标/loopx 为项目补齐单元测试并修复已知失败用例这条命令会注册目标goal/agent、写入项目内的.claude/loop.md执行脚本然后停下来——它只负责布防不干活。不带参数的裸/loopx则是查看/连接状态。/loopx命令的完整定义loopx/claude_goal_mode/commands/loopx.md第 2 步/loop 驱动执行循环/loop原生/loop开始执行.claude/loop.md每次 tick 都由 LoopX 的should_run/claim_task/complete_task三个 MCP 工具把关。需要固定节奏时可用/loop 10m每 10 分钟一轮。第 3 步status 查看、off 收工/loopx status # 查看目标、状态与 todo 清单 /loopx off # 删除 .claude/loop.md/loop 将无事可做 常见问题速查症状原因与解法/loopx无法识别没重启 Claude Code 会话或安装 scope 与当前项目不匹配loopx doctor报运行时异常检查 Node.js 版本 ≥ 22.18.0再用loopx doctor --deep验证/loop跑起来但没有受控行为确认.claude/loop.md已由/loopx task生成而非手写想确认适配器没被误装普通安装不会写~/.claude可用--dry-run预览 卸载适配器claude mcp remove --scope user|project loopx # 移除 MCP 服务器 rm scope/.claude/commands/loopx.md # 移除 /loopx 命令如果启用过--harden还需手动删除对应.claude/settings.json中的 loopxPreToolUse块和statusLine——安装器从不动你已有的权限规则。小结整个流程可以浓缩为一句话pip 装 LoopX → 显式装适配器 →/loopx task布防 →/loop开跑 →status/off管理收尾。装好之后Claude Code 的每一次循环都处在 LoopX 的确定性门控之下长任务从此可审查、可重启、可交接。【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考