5分钟跑通AutoresearchClaude Code/OpenCode/Codex三平台安装与首次运行完整指南【免费下载链接】autoresearchClaude Autoresearch Skill — Autonomous goal-directed iteration for Claude Code. Inspired by Karpathys autoresearch. Modify → Verify → Keep/Discard → Repeat forever.项目地址: https://gitcode.com/gh_mirrors/auto/autoresearchAutoresearch 是一款让 Claude Code、OpenCode 与 OpenAI Codex 变成自主改进引擎的技能Skill插件。安装后你只需给出目标Goal、范围Scope、指标Metric和验证命令Verify它就能自动执行修改 → 验证 → 保留/回滚 → 重复的循环直到目标达成。本指南带你 5 分钟完成 Autoresearch 安装与首次运行覆盖三平台一键安装脚本、命令语法差异和新手常见问题。Autoresearch 是什么永不停歇的自主迭代引擎Autoresearch 的核心思路源自 Karpathy 的 autoresearch 实践约束范围 机械指标 自主迭代 复利式改进。它不只是写代码的工具而是把持续优化这件事自动化了⚙️每轮只做一个改动——出问题能立刻定位原因机械验证——用可度量的指标说话拒绝看起来不错失败自动回滚——改坏了立即git revert进度只增不减Git 即记忆——每次迭代前都会读 git 历史吸取教训默认有界——/autoresearch默认只跑 25 轮不会失控除了经典指标循环v2.2 还内置了自主编排器Orchestrator直接用大白话描述目标它会自动拆解任务、选择子命令、循环推进直到完成。安装前准备确认 Node.js 与 Git 环境Autoresearch 的运行时需要Node.js 18 及以上版本安装脚本会先检测另外需要 Git 用于克隆仓库与迭代记录。在终端执行node -v # 需 ≥ v18 git --version若 Node 版本过低请先升级后再继续。第一步克隆 Autoresearch 仓库git clone https://gitcode.com/gh_mirrors/auto/autoresearch cd autoresearch 这个仓库同时是三平台的安装源内部目录分工非常清晰目录用途.claude/Claude Code 的技能与 14 个命令.opencode/OpenCode 的技能与命令下划线命名.agents/Codex 的技能包scripts/install.sh三平台引导式安装脚本第二步三平台一键安装 Autoresearch在autoresearch目录内根据你的平台执行对应的安装命令即可。Claude Code 安装 Autoresearch 技能./scripts/install.sh --claude --global安装脚本会自动完成这些事把技能主文件与 14 个子命令复制到~/.claude/skills/与~/.claude/commands/安装 9 个安全钩子拦截危险命令、隐私文件、上下文污染等安全合并钩子配置到~/.claude/settings.json不会覆盖你的现有配置全局安装默认对应在所有项目生效如果想只在当前项目使用加--local即可。直接运行./scripts/install.sh不加参数也会进入交互式菜单选择平台 → 选择全局/本地。OpenCode 安装 Autoresearch 技能./scripts/install.sh --opencode --global脚本会把技能与 14 个命令文件autoresearch_*.md复制到~/.config/opencode/支持XDG_CONFIG_HOME等环境变量覆盖。⚠️ 注意OpenCode 的命令使用下划线命名例如/autoresearch_debug、/autoresearch_fix。Codex 安装 Autoresearch 技能./scripts/install.sh --codex --global脚本会把.agents/skills/autoresearch/技能包复制到~/.codex/skills/autoresearch支持CODEX_HOME覆盖。⚠️ 注意Codex 使用$autoresearch提及语法调用子命令是关键词例如$autoresearch debug、$autoresearch plan。手动复制备选方案不想用脚本对照下表手动复制源目录即可平台源目录全局目标Claude Code.claude/skills/autoresearch~/.claude/skills/autoresearchOpenCode.opencode/skills/autoresearch~/.config/opencode/skills/autoresearchCodex.agents/skills/autoresearch~/.codex/skills/autoresearch提示安全钩子Hooks仅在 Claude Code 中生效OpenCode 与 Codex 提供完整的技能/命令/安装能力详见 guide/hooks.md。第三步首次运行 Autoresearch 并跑通第一个循环安装完成后请先开启一个新会话再运行——安装当次会话中引用文件无法解析这是平台限制。用 /autoresearch 跑一个有界迭代进入你自己的项目目录输入/autoresearch Goal: Increase test coverage from 72% to 90% Scope: src/**/*.test.ts, src/**/*.ts Metric: coverage % (higher is better) Verify: npm test -- --coverage | grep All files Iterations: 10五个要素的含义要素说明Goal你要达成的目标自然语言Scope允许修改的文件范围Metric机械指标输出一个数字越大/越小越好Verify验证命令每轮机械执行Iterations迭代轮数新手建议先写 10 试跑执行后Autoresearch 会先读取范围内文件、建立基线第 0 轮然后逐轮迭代每轮只改一处 → 提交 → 验证 → 变好就保留变差就回滚并把结果逐行写入 TSV 日志。跑完后检查日志方向对了再去掉Iterations限制放开跑。不知道指标怎么定用 /autoresearch:plan 自动生成配置/autoresearch:plan是最适合新手的第一步——它会把模糊目标转成经过验证的配置/autoresearch:plan Goal: Make the API respond faster它会走完 5 步捕获目标 → 划定范围 → 定义指标 → 确定优化方向 →对验证命令做 dry-run 验证全部通过后才产出可直接执行的配置。每一步都是机械校验范围必须能解析出文件、指标必须输出数字、验证命令必须试跑通过。三平台首次运行的命令语法对照平台根命令子命令示例Claude Code/autoresearch/autoresearch:fix、/autoresearch:debugOpenCode/autoresearch/autoresearch_fix、/autoresearch_debugCodex$autoresearch$autoresearch fix、$autoresearch plan14 个命令在三平台功能完全一致只是调用语法不同对应源文件见 .claude/commands/autoresearch.md 与 .opencode/commands/autoresearch.md。Autoresearch 启动后发生了什么每一轮迭代都在做同样的八件事审查现状 → 构思一个改动 → 只改一处 → git 提交 → 运行验证 → 运行防护(Guard) → 保留/丢弃 → 记录日志运行结束时你会得到一张*-results.tsv记录表iteration commit metric delta status description 0 a1b2c3d 85.2 0.0 baseline initial state 1 b2c3d4e 87.1 1.9 keep add tests for auth edge cases 2 - 86.5 -0.6 discard refactor test helpers (broke 2 tests)️ 两个值得知道的安全机制Guard防护网当你的指标不是测试套件时比如优化包体积加上Guard: npm test可以防止优化把现有功能改坏随时可停CtrlC或Iterations: N即可停止由于每轮改动先提交再验证最后一次成功状态永远在 Git 里首次运行常见问题FAQQ运行中如何停止CtrlC直接中断或一开始就写Iterations: N限制轮数。Q它把我的代码改坏了怎么办不用担心。每次改动先git commit再验证指标变差会自动git revert你的仓库只会向好演进。Q只支持 JavaScript 项目吗支持任何语言、任何框架。循环本身与语言无关验证命令适配你自己的工具链。Q能用于非代码任务吗可以。销售邮件、营销文案、HR 制度——凡是有可度量指标的事都能跑参考 guide/examples-by-domain.md。QOpenCode / Codex 上命令找不到确认已开新会话OpenCode 用下划线语法/autoresearch_fixCodex 用提及语法$autoresearch fix或/skills查看已装技能。下一步继续探索 Autoresearch跑通第一个循环只是开始这些资料值得收藏官方入门指南guide/getting-started.md自主编排器详解guide/autoresearch-orchestrator.md安全钩子参考guide/hooks.md命令链式组合guide/chains-and-combinations.md项目总览与命令表README.md 推荐尝试的进阶玩法/autoresearch:debug --fix先抓虫再自动修复、/autoresearch:predict --chain debug5 位专家先辩论再动手、或者直接用大白话目标体验 v2.2 自主编排器——设定目标然后去休息醒来收获结果。【免费下载链接】autoresearchClaude Autoresearch Skill — Autonomous goal-directed iteration for Claude Code. Inspired by Karpathys autoresearch. Modify → Verify → Keep/Discard → Repeat forever.项目地址: https://gitcode.com/gh_mirrors/auto/autoresearch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考