Aegis 多宿主支持完整清单:Claude Code、Codex、OpenCode、Kimi 安装指南一文看懂

原创2026-10-12 14:58:141,643 阅读
文章标签:AI 技能人工智能dsh-plugin

Aegis 多宿主支持完整清单:Claude Code、Codex、OpenCode、Kimi 安装指南一文看懂

Aegis 是一套面向 AI 编程 Agent 的工程纪律方法包(Method Pack),它通过"基线先行、证据验证、漂移检查"让 Claude Code、Codex、OpenCode、Kimi Code CLI 等多种宿主上的 Agent 更可靠:改代码前对齐项目真实基线,宣告"完成"前必须给出新鲜验证证据,简单任务则走快速通道不打扰你。本文给出 Aegis 多宿主支持完整清单,以及各宿主的安装与验证步骤,新手照做即可完成全局安装。

Aegis 多宿主 AI 编程 Agent 方法包架构横幅图

Aegis 能帮你解决什么?

用一句话概括:Aegis 让你的 AI 编程助手像有纪律的工程师一样工作,而不用你全程盯着。

  • 少返工:Agent 动手前先对齐项目的负责人、契约与边界,不再靠猜。
  • 更安全:在冻结的 A/B 基准上,契约通过率从 61.67% 提升到 93.33%,不安全结果从 13.33% 降到 0%(有限参考证据,详见 基准结果表格)。
  • "完成"要有证据:结束声明附带新鲜验证证据、覆盖范围与剩余风险,你读的是证据而不是感觉。
  • 简单任务保持简单:琐事走快速路径,仪式只在真正需要时才出现。

更多方法细节可阅读 工作流指南 和速通秘籍(中文)。

Aegis 多宿主支持完整清单

Aegis 采用"一套方法包、所有宿主"的多宿主插件化分发策略。截至当前快照(2026-08-27),各宿主状态如下:

宿主 当前状态 官方安装指南
Codex ✅ 有最新主线冒烟证据,支持最佳 docs/README.codex.md
OpenCode ✅ 基础套件与集成闭环通过 docs/README.opencode.md
Claude Code 插件分发骨架就绪(marketplace 安装) docs/README.claude-code.md
Kimi Code CLI 原生插件 + sessionStart 自动入口 docs/README.kimi-code.md
GitHub Copilot 仓库 skills / instructions / hooks 路径 docs/README.copilot.md
Qoder 原生 SKILL.md 发现 + rules 面 docs/README.qoder.md
Trae 原生 SKILL.md 手动安装 docs/README.trae.md
CodeBuddy .codebuddy-plugin/ 骨架 + 手动安装 docs/README.codebuddy.md
DeepSeek-TUI / DeepSeek Harness 原生技能发现 / dsh.bundle 安装 README · Harness
CC GUI (JetBrains IDEA) 结构化 IDE 插件层支持 docs/README.cc-gui.md
Antigravity CLI / IDE / App CLI 为当前主攻闭环目标 docs/README.antigravity.md
Pi CLI / OMP / OpenClaw / Hermes Agent Agent Skills 结构适配 Pi · OMP · OpenClaw · Hermes
Gemini CLI ⛔ 已退役,不再提供适配器 兼容性矩阵
Warp 作为终端宿主无需独立适配器 —

📌 阅读顺序建议:先看宿主兼容性矩阵了解当前判定,再看已知限制。

最快安装方法:把一段提示词交给你的 Agent

如果你不确定自己宿主的具体路径,最快的方式是直接把下面这段提示词发给正在使用的 AI 编程 Agent(它会识别宿主、按对应指南安装并完成验证):

请阅读 Aegis 仓库,识别我当前使用的 AI 编程宿主,并按对应宿主指南全局安装 Aegis;
需要时重启宿主,然后从已安装的 Aegis method-pack 根目录运行完整安装验证。
只有当验证 JSON 包含 "ok": true、"workspaceSupport": "available"、
"configStatus": "configured" 时,才把安装视为完成。

下面再按宿主给出手动安装要点,方便你想亲手操作时参考。

Claude Code:插件市场三步安装

在 Claude Code 会话中依次执行:

/plugin marketplace add GanyuanRan/Aegis
/plugin install aegis@aegis-dev --scope user
/reload-plugins

Codex:clone + 软链接全局安装

Codex 原生扫描 ~/.agents/skills/ 发现技能,因此只需两步:

git clone https://gitcode.com/gh_mirrors/aegis21/Aegis ~/.codex/aegis
mkdir -p ~/.agents/skills && ln -s ~/.codex/aegis/skills ~/.agents/skills/aegis

重启 Codex 即可。Windows 用户可用 mklink /J 创建 junction 替代软链接(无需开发者模式)。using-aegis 技能会被自动发现并约束技能使用纪律,无需额外配置。详见 docs/README.codex.md。

OpenCode:一行插件配置

在 opencode.json(全局或项目级)的 plugin 数组中加入:

{
  "plugin": ["aegis@git+https://github.com/GanyuanRan/Aegis.git"]
}

重启 OpenCode 后,插件会自动安装、把 Aegis 技能镜像到 ~/.config/opencode/skills/ 发现路径并注入引导上下文。可以问一句 "Tell me about your aegis" 快速确认。详见 docs/README.opencode.md。

Kimi Code CLI:原生插件一步安装

Kimi 的默认安装路径是根目录 kimi.plugin.json 声明的原生 Aegis 插件,每个新会话自动以 using-aegis 作为路由入口:

/plugins install https://github.com/GanyuanRan/Aegis
/plugins info aegis
/reload

确认有且仅有一个启用的 aegis 插件即可;不要再额外暴露到 ~/.kimi-code/skills/ 或 ~/.agents/skills/(两条路径不能同时激活,否则会形成重复技能所有者)。详见 docs/README.kimi-code.md。

安装完成验证:一条命令确认

无论哪个宿主,安装完成后都应从已安装的 Aegis method-pack 根目录(注意:不要在目标项目目录里运行)执行:

python scripts/aegis-doctor.py --write-config --json

只有当输出同时满足以下条件,才算完整安装:

  • "ok": true
  • "workspaceSupport": "available"(项目工作区支持可用)
  • "configStatus": "configured"

该诊断脚本源码见 scripts/aegis-doctor.py。如果宿主有单独的 skill 发现目录,可追加 --discovery-root <path> 验证。

更新与激活模式:装好之后的日常操作

  • 更新 Aegis:安装并登记宿主后,直接用自然语言说 更新 Aegis,或显式请求 aegis:update,Agent 会通过宿主感知的本地路径调用 scripts/aegis-update.py 完成更新;更新所有已登记宿主需显式加 --all。Aegis 默认不做后台自动更新。
  • 激活模式:默认 auto(自动路由)。想改为"显式点名才生效",可在 method-pack 根目录运行 python scripts/aegis-doctor.py activation-mode explicit 后重启宿主,规则说明见 docs/current/AEGIS_ACTIVATION_MODE.md。
  • 日常使用:直接用自然语言即可,例如:
    • Why does this login failure happen? Diagnose it before changing code.
    • Aegis goal: Fix the auth refresh bug without rewriting the auth system.
    • Review this diff independently before I merge it.

常见问题

Q1:装好了但 Aegis 没有自动触发,怎么办? 按触发链路逐级排查:安装/版本可见性 → 宿主技能发现 → 激活模式 → using-aegis 路由 → 任务与技能匹配 → 上下文压力。诊断清单见 docs/current/AEGIS_TRIGGER_HEALTH_BASELINE.md。

Q2:Claude Code / Kimi 等有最新冒烟证据吗? 有最新证据的是 Codex 与 OpenCode;Claude Code、Kimi Code CLI 等宿主的安装指南已就绪,但 release 级新鲜宿主冒烟仍待补证——状态以宿主兼容性矩阵为准。

Q3:Aegis 会接管宿主或改变我的全局规则吗? 不会。Aegis 是独立方法包,不是运行时核心或后台进程;用户指令与目标项目规则始终优先于 Aegis 指引,产品边界见 docs/current/AEGIS_PRODUCT_BASELINE.md。

登录后查看全文
Aegis