agentty 是一款面向终端环境的开源编程智能体，使用 C++26 编写，以单个静态二进制文件形式提供，旨在作为 Claude Code 的替代方案。其核心设计理念是快速、轻量且不绑定特定模型厂商。
用途
agentty 用于在终端中进行 AI 结对编程，帮助开发者完成代码编写、修改、调试、重构等任务。它适合希望避免 Node/Python 运行时依赖、追求快速启动、需要灵活切换多种大模型、或需要在沙箱或气隙环境中安全运行编码智能体的开发者。
主要能力
- 原生性能：单个静态二进制文件约 16.7 MB，冷启动约 3 毫秒，无 Node、Python、npm 或 node_modules 依赖。
- 模型无关：支持 Claude Pro/Max（OAuth 登录）、OpenAI、Groq、OpenRouter、Cerebras、DeepSeek、xAI（Grok）、Mistral、Gemini、Fireworks 以及本地 Ollama 模型，可通过 ^P 实时切换。
- 检索增强生成（RAG）：内置完全本地的检索引擎，采用混合 BM25 + 稠密嵌入、RRF 融合、重排序、MMR 多样化、压缩、父文档扩展、GraphRAG 文档图扩展等，只发送相关代码片段，据称可减少 80% 以上的上下文。提供 search_docs 和 search_code 两个工具。
- 默认沙箱：所有 shell 调用在操作系统级沙箱中运行（Linux 使用 seccomp + landlock + cgroup2，macOS 使用 seatbelt + rlimits），凭证文件被屏蔽，文件工具拒绝工作区外的路径。
- 气隙模式：可通过 SSH 在无互联网的主机上运行，TLS 端到端固定。
- 脚本与 CI：支持 agentty run "prompt" 单次执行，提供 --json、--timeout、--events jsonl、--read-only --no-network 等选项。
- 完整工具套件：read、write、edit、bash、grep、glob、git、web、search_docs、search_code、task，每个工具配有专用界面组件。
- 学习代码库：支持 Agent Skills 和 remember/forget 记忆，结合本地 RAG 引擎，可跨会话记住项目约定。
- Smart Mode：编排器-工作者设计，旗舰模型规划，较便宜模型执行子任务，按复杂度调整努力程度，并跨会话学习。
- 编辑器集成：通过 Agent Client Protocol（ACP）在 Zed 编辑器中运行。
- 循环发送：^B 可自动重复发送同一提示，直到再次按下 ^B。
- 代码块执行：^G 列出上一条回复中的代码块，可在真实终端中交互执行，支持 sudo 密码提示，输出可附加到输入框。
- 技能系统：支持 SKILL.md 文件，兼容 Claude Code 的 .claude/skills/ 格式，可声明 effects: [exec, net] 并通过 agentty skill add 安装。
使用方式
首次启动会打开认证界面，可粘贴 API 密钥（如 Anthropic sk-ant-… 或其他提供商密钥），或使用无需密钥的本地 Ollama 模型，也可使用 Claude Pro/Max OAuth 登录。之后直接输入提示并按 Enter 即可。
安装方式包括：从发布页面下载预编译二进制文件（文件名包含版本号），或使用安装脚本自动解析版本；在 Termux/Android 上可通过安装脚本安装到 $PREFIX/bin；也可从源码编译，需要 C++26 工具链（GCC 14+、较新 Clang 或 MSVC），提供 debug、release、ci、sanitizer 等 CMake 预设。
在 Zed 中集成时，需在 Zed 设置中添加 ACP 配置。
适用场景
- 终端内快速编码辅助，无需安装 Node/Python 环境。
- 需要在多个模型提供商之间灵活切换或使用本地模型。
- 对安全性有要求，需要沙箱隔离或气隙运行。
- 在 CI 或脚本中自动化执行编码任务。
- 在 Zed 编辑器内使用 AI 编程助手。
- 在 Android/Termux 环境中使用（shell/构建工具在未 root 的 Android 上不沙箱运行）。
限制
- 需要 C++26 工具链才能从源码编译。
- 在未 root 的 Android 上，shell/构建工具不沙箱运行（Bubblewrap 需要用户命名空间，Android 不授予）。
- 部分高级 RAG 功能（如查询扩展、HyDE、GraphRAG 社区摘要）默认关闭，需通过环境变量启用，且可能消耗模型调用。
- 语义检索部分需要本地 Ollama 服务器提供嵌入，否则回退到仅关键词搜索。
- 具体收费、价格、平台支持细节、效果数据等暂未提供。
