从装好到跑通第一个任务

Aiglade 是一个 Windows 桌面软件，把 Claude Code、Codex CLI、Hermes、OpenClaw 这些 AI 装进一个窗口。它带中文向导：下载安装后跟着向导走，不用会编程就能开始用。多个 AI 工具的 API Key 在 aiglade 里配置一次即可共用，适合 Windows 本机开发、希望用中文界面统一管理多个命令行 AI 的用户。

最后更新：2026-11-04

Aiglade 本身不产出智能——它是个调度台。真正干活的是你机器上已经装好的那些命令行 Agent。所以第一件事是确认它们装好了。

不会编程怎么用 Aiglade？第一步：先确认 Agent 能单独跑

Aiglade 启动后会检测本机有哪些可用的 Agent，列在界面上。装没装过、装在哪，它是自己看的。

一个实用建议：先在终端里单独把某个 Agent 跑通一次，确认它能正常回答，再去 Aiglade 里用它。不这么做的话，如果 Aiglade 里报错，你分不清是 Aiglade 的问题还是 Agent 本身没配好。

为什么 Aiglade 装好后要先单独跑通一个 Agent？

先让一个 Agent 单独跑通，再谈编排，环境问题才不会混进任务问题里。编排器接手之后，出错的原因会变多，可能是任务本身提得不清楚，也可能是底下某个 Agent 的环境没准备好。先把单个 Agent 跑通，等于先排掉一类原因，之后再出问题，排查范围就小得多。

判断单个 Agent 是否跑通，可以看三条标准。能连续完成一轮，中间没有因为环境原因停下来。退出码正常，没有报错退出。输出落在预期目录，文件能打开，内容和任务要求对得上。三条都满足，再把任务交给编排器。

如果单个 Agent 还没跑通就直接上编排，很容易把时间花在错误的地方。任务改了几遍还是失败，看起来像任务提得不好，其实是环境缺了东西。反过来，环境没问题，任务本身的问题才会露出来，改任务才有针对性。

Aiglade 第一次派活：派什么样的简单任务？

第一次别拿真实项目试。找一个无关紧要的目录，给它一个明确的小任务。

什么样的算好任务：

不建议第一个任务就上「重构这个模块」——目标越大，你越难判断它做得对不对。

Aiglade 派活时，任务描述怎么写 Agent 才不用猜？

任务提得越具体，Agent 越不用猜，返工越少。任务描述可以拆成三句，每句只讲一件事。目标句讲要产出什么，输入句讲拿什么材料做，验收句讲做到什么程度算完成。三句写清楚，Agent 执行时不用反复猜意图，验收时也不用凭感觉判断。

一个可复制的任务模板如下：

• 目标：把这份会议纪要整理成待办清单。
• 输入：会议纪要原文。
• 验收：每条待办都有负责人和截止时间，清单可以直接拿去分派。

正例一：目标是把草稿改成对外发布的版本，输入是草稿全文，验收是改动处都有标注，原文结构不动。

正例二：目标是把这批文件按主题归档，输入是待归档的文件夹，验收是每个文件都有归属主题，归档后能按主题找回。

反例一：让它「优化一下项目」。没说优化哪部分，也没说改完长什么样，Agent 只能猜，猜错了还得重来。

反例二：让它「把这个写好一点」。好一点没有标准，验收时说不清算不算完成，来回改几遍也定不下来。

Aiglade 任务派出去后，第一轮要盯着看什么？

派出去之后先别走开。看它怎么拆解任务、怎么选动作，你对它的脾气会有个直观印象：它是先看再动手，还是一上来就改；卡住时是停下来问，还是自己换个方向继续试。

这个观察比读文档有用。不同的 Agent 性格差别很大，同一个任务可能一个谨慎一个激进。

Aiglade 跑完一轮，怎么看过程、产物、记录三处？

跑完一轮先看过程、产物、记录，三处都对得上，这一轮才算跑完。只看产物对不对，容易漏掉过程中的问题。只看过程顺不顺，又可能漏掉产物本身的毛病。三处分开看，出问题能定位到哪一环。

看过程，看 Agent 是不是按预期步骤走完，中间有没有停下来等人工确认。如果中途停下，要分清是正常等审批，还是真的卡住了。需要人工确认的动作，可以看审批一页的说明。

看产物，看文件是不是落在预期目录，内容是不是完整。文件位置不对，后面找起来费事。内容缺了一块，可能是某一步没执行完，也可能是输入本身就不全。

看记录，看每一步有没有留下记录，出问题能不能顺着记录找到原因。记录和过程对不上，说明执行过程本身有疑问，先别急着重跑。如果跑完发现卡住了，可以对照任务卡住一页先判断类型。

Aiglade 新手最容易卡住的地方有哪些？

Aiglade 里 Agent 装了但检测不到怎么办？

多半是装在了 Aiglade 找不到的路径，或者装的时候用的是不同用户。检查一下它是不是在当前用户的 PATH 里——在终端里直接敲它的命令名，能跑起来就说明在。

Aiglade 任务派出去没反应，是卡住了还是在等确认？

先看它是不是在等你确认。有风险的动作会被拦下来，界面上会出现待确认项——这是设计如此，不是卡死。

同一个任务给两个 Agent 结果不一样正常吗？

正常。不同 Agent 背后的模型、上下文组织方式都不同，同一个需求的理解会有差别。这反而是并行派发的好处：拿两个方案比一比。

Aiglade 装好后跑不通，先按什么顺序排查？

跑不通先别重装，按顺序查，查到哪一步停住，问题就在哪一步。第一步看 Agent 本身能不能在终端里单独跑起来，单独跑不起来，先修 Agent 自己的安装和配置，再谈 Aiglade 里的事。第二步看 Aiglade 里能不能检测到它，检测不到，多半是装在了当前用户找不到的路径，或者装的时候用的不是当前用户。第三步看任务派出去之后的状态：是在等你确认，还是真的卡住了。等确认是设计如此，点确认就继续；真卡住了，再看过程记录停在哪一步。

这个顺序的好处是每一步只排除一类原因。跳过前面直接改任务描述，改几遍也可能改不到点子上；跳过前面直接重装，重装完也可能还是同一个原因。按顺序查一遍，花的时间反而最少。

Aiglade 跑通第一个任务后，下一步看什么？

跑通一个之后，可以看这两篇：

• 让几个 Agent 分工干活——哪些任务适合并行
• 审批门是什么——哪些操作会被拦，怎么配才不烦人
• 把自己已有的 key 接进来——填完不通时的四个卡点，报错都看不出真因
• 怎么验证它真做完了——三种静默的假成功，「没报错」什么都不说明
• 任务卡住或失败了怎么办——分清在跑、在等、还是已经死了