Archon 工作流节点等待首个事件超时first-event timeout怎么处理【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon在 Archon 中运行工作流时你可能会遇到这样一种情况某个工作流节点没有产生任何输出跑了一段时间后整个节点以 first-event timeout首个事件超时失败。官方文档把这归因于环境过慢——冷启动的模型、配置受限的机器都可能让 AI provider 的第一个事件超出默认的 60 秒等待窗口。解决办法只有一个把首事件超时调到更大的毫秒数再重新执行工作流。症状与错误信息文档描述的症状是工作流节点无输出最终因 first-event timeout 失败。对应到运行层面当 Claude 子进程在超时时间内没有任何输出时Archon 会中止该进程并抛出如下错误Claude Code subprocess produced no output within 60000ms. See logs for claude.first_event_timeout diagnostic dump.错误信息中的毫秒数会跟随你设置的超时值变化文档示例输出中显示的是默认值 60000ms。同时日志里会有一条claude.first_event_timeout的诊断记录其中包含子进程环境变量键、父进程中的CLAUDECODE/CLAUDE_CODE_*/ANTHROPIC_*相关变量、模型名、平台、UID 和 TTY 状态等上下文可结合 provider 实现 了解诊断字段的具体内容。超时逻辑本身在 provider.ts 中第一次next()调用必须在超时窗口内返回否则中止并抛出上述错误超时值由环境变量ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS解析必须是正数解析失败时回落到 60000ms见 getFirstEventTimeoutMs。处理办法调大 ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS配置参考 中对该变量的定义是变量说明默认值ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MSClaude 子进程被判定为挂起前的超时时间毫秒超时会抛出错误并输出诊断日志60000官方 故障排查文档 给出的修复方式是在执行工作流时通过环境变量把超时提到 120000ms120 秒ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS120000 archon workflow run ...其中...是你原本的工作流参数。结合 CLI 参考 中workflow run name [message]的用法实际命令形如ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS120000 archon workflow run assist --cwd /path/to/repo 你的任务描述注意这个环境变量只在当次命令的进程内生效VARvalue command的前缀写法是一次性调整如果希望长期生效需要把它写进你启动 Archon 的 shell 环境或部署环境文档没有给出其他持久化配置项。验证是否解决判断标准很简单用提高后的超时重新运行工作流节点不再出现 no output within …ms 的首事件超时错误并且节点正常产出后续输出。反过来如果 120 秒后节点仍然首事件超时说明环境延迟超过了你设置的窗口需要继续调大该值再试此时可先看日志中的claude.first_event_timeout诊断记录确认当时的模型与环境变量状态。相关说明与边界文档特别注明在 Claude Code 会话或其他编码 agent内部直接运行archon是被支持的正常用法Archon 不再为此发出警告——如果你看到首事件超时不要首先怀疑嵌套运行本身。该变量属于 AI Providers → Claude 一节对应 Claude 子进程的首事件等待文档中为 Codex、Copilot 等其他 provider 没有列出同类超时变量。文档还给出了一条指向上游 issue 的说明链接写在错误信息中说明该错误的完整背景可在仓库的 issue #1067 中追溯。【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考