AntigmaLabs/ante · 上手攻略
- 仓库：AntigmaLabs/ante
- 链接：https://github.com/AntigmaLabs/ante
- 分类：AI Agent · Coding Harness
- 作者：Tom
- 更新：2026-08-21
是什么
Ante（读作「anti」）是 Antigma Labs 开源的一个自包含（self-contained）终端编程智能体，核心定位是"Harness（工具架）优先，而非模型绑定"。作者观点鲜明：好用的 Agent 依赖的不只是模型，更是一套经过精细调校的执行框架（harness），而这套框架应该与模型解耦、可以自由替换。
一句话类比：Ante ≈ Claude Code / GitHub Copilot Workspace 的精简开源替代，但体积约 15 MB 单二进制、零外部依赖、macOS/Linux 开箱即用（Windows 建议走 WSL）。
解决什么问题
主流编程智能体（Claude Code、Copilot Workspace）通常： - 强绑定特定模型服务商（API Key 必须） - 依赖 Node.js/Python 运行时及一堆 npm/pip 包 - 需要互联网连接才能跑
Ante 的目标场景：
1. 本地离线推理：自带 pinned 版 llama.cpp，指定 GGUF 模型文件路径即可完全离线运行
2. 轻量化 CI/脚本集成：headless 模式 ante -p "..." 单次任务，不依赖任何服务
3. 多模型横向评测：同一套框架换不同 provider/model，对比实际表现差异
4. 资源受限环境：实测同任务比 Claude Code 峰值内存低约 7 倍、CPU 低约 9 倍
快速安装
# 推荐：一键安装（macOS / Linux）
curl -fsSL https://ante.run/install.sh | bash
# 安装 nightly 版本
curl -fsSL https://ante.run/install.sh | bash -s -- nightly
# 指定安装目录（已在 PATH 中时）
curl -fsSL https://ante.run/install.sh | ANTE_INSTALL_DIR=/usr/local/bin bash
安装完成直接运行 ante 即可启动交互式 TUI。
⚠️ Beta 阶段，可能有 breaking change；建议关注 GitHub Releases 跟进版本更新。
核心用法
四种运行模式
| 模式 | 命令 | 典型场景 |
|---|---|---|
| 交互式 TUI | ante |
日常开发，随时对话、查看文件、运行命令 |
| Headless 单次 | ante -p "任务描述" |
CI 集成、脚本自动化、管道处理 |
| Server | ante serve |
编辑器插件对接，JSONL 协议通信 |
| Gateway | ante gateway |
接入 Slack / Discord 作为 Bot |
基础命令示例
# 交互模式
ante
# 指定 provider + model
ante --provider openai --model gpt-5.5 -p "refactor the database module"
# 修复 bug（headless）
ante -p "find and fix the failing test in src/auth"
# 接入 API 凭证（需先登录 provider）
ante --connect # 交互式扫码/输入
# 恢复历史 session
ante --resume ses_01ARZ3NDEKTSV4RRFFQ69G5FAV -p "now add tests"
# 完全离线模式（指定本地 GGUF 文件）
ante --offline-model ~/.ante/models/Qwen3.5-9B-Q4_K_M.gguf \
-p "add error handling to src/main.rs"
# 通过 stdin 传入 diff 内容（适合 git hook）
git diff | ante -p "review this for security issues"
⚠️
gpt-5.5写法基于 README 示例；实际支持哪些模型需参考官方文档的 Models, Providers & Thinking 页面，README 中未列出完整模型清单，建议以此为准。
典型适用场景
适合用 Ante 的情况： - 已有 Claude Code / Copilot 但想用本地模型（如 Qwen、Llama）且不想装满屏依赖 - 需要在 CI 管道中调用 AI 辅助代码审查或修复（headless 模式天然适合） - 想横评同一个模型在不同 harness 下的实际表现（Terminal-Bench 2.1 公开评测体系） - 服务器资源有限、无法跑重型 Electron/Node.js 应用的场景
不适合用 Ante 的情况： - 需要完整的 GUI 编辑器集成（如 VS Code 插件直接内嵌）；此时 Claude Code 生态更成熟 - Windows 原生环境（非 WSL）；目前仅 macOS / Linux 官方支持 - 期望开箱即有中文文档；官方文档英文为主
坑与注意
- Beta 阶段，API 可能变化：README 明确警告 breaking changes，重要项目不要盲目追最新版，建议固定一个稳定版本
- Windows 建议走 WSL：原生不支持，硬要用可能遇到路径和子进程问题
- 离线模型需手动准备 GGUF 文件：不支持自动下载，需自己准备模型文件并指定路径
- Server 模式的 JSONL 协议：如果要做编辑器插件开发，需要读懂协议格式，有一定门槛
- 国内安装脚本可能需要网络条件：
ante.run域名访问若受限，可尝试 GitHub Releases 页面直接下载二进制
与同类对比
| 特性 | Ante | Claude Code | GitHub Copilot Workspace |
|---|---|---|---|
| 运行时依赖 | 单二进制，零依赖 | Node.js + 账号体系 | 云端为主 |
| 模型绑定 | 解耦，支持多 provider | 绑定 Anthropic | 绑定 OpenAI |
| 离线能力 | ✅ 原生支持 GGUF | ❌ 必须联网 | ❌ 必须联网 |
| 资源占用 | ~7× 更低（官方实测） | 较重 | 云端 |
| 平台支持 | macOS/Linux | macOS/Linux/Windows | Web + 桌面 |
| 开源 | ✅ Apache 2.0 | ❌ 闭源 | ❌ 闭源 |
| 中文支持 | 社区有限 | 一般 | 一般 |
简单说：如果你重视隐私、喜欢折腾模型、或者在服务器上跑，Ante 值得一试；如果要开箱即用的流畅 GUI 体验，Claude Code 仍是主流选择。
一句话推荐结论
Ante 是一个把"harness 和模型解耦"做到极致的开源编程智能体——如果你想用本地 GGUF 模型在终端里跑 AI 编程辅助，或者想在 CI 里轻量集成 AI 审查，它是目前门槛最低的方案之一；但如果你是 Windows 用户或追求开箱即用的 IDE 级体验，可以先跳过。
- 原始 README：https://github.com/AntigmaLabs/ante
- 官方文档：https://docs.antigma.ai
- Terminal-Bench 2.1 评测：https://antigma.ai/eval