agentty：终端里的 AI 编程助手

项目简介

agentty 是一个用 C++26 编写的开源终端 AI 编程代理，可作为 Claude Code 的替代品使用。它以单个静态二进制分发（16.7 MB，冷启动约 3 ms），不需要安装 Node、Python 或 npm，下载即可运行。和把整个仓库内容反复塞进提示词的做法不同，它内置本地检索（RAG）引擎，只把与当前任务相关的小段代码发给模型。项目采用 MIT 许可证。

主要功能

• 单一原生二进制：无运行时依赖，读写工具与模型输出并行执行，只读工具在模型还在生成时就开始工作。
• 不绑定厂商：支持 Claude（API key 或 Pro/Max OAuth）、OpenAI、Groq、OpenRouter、Cerebras、DeepSeek、xAI Grok、Mistral、Gemini、Fireworks，以及本地 Ollama；应用内用 ^P 实时切换。
• 默认沙箱：每个 shell 调用都在操作系统级沙箱内运行，凭据文件默认被遮蔽，文件工具拒绝工作区之外的路径。
• 气隙模式：可在无网络的机器上运行，由本机通过 SSH 中继流量。
• 脚本与 CI：agentty run "fix the failing test" 只输出答案，支持 --json、--timeout、--events jsonl，以及面向不可信代码的 --read-only --no-network。
• 完整工具集：read、write、edit、bash、grep、glob、git、web、search_docs、search_code、task。
• 本地 RAG：search_code 按功能语义找代码，search_docs 搜索 ./docs（或 AGENTTY_DOCS_DIR）、已安装技能和记住的事实；结果带来源标签与文件行号。
• Smart Mode：^S 开启编排者-工作者模式，强模型规划、较便宜的模型执行，并按工作区在本地学习。
• 记忆：Agent Skills 与 remember/forget，让后续会话沿用项目约定。

安装与使用

curl -fsSL https://raw.githubusercontent.com/agentty-org/agentty/master/install.sh | sh
cd your-project
agentty

首次启动会进入认证：粘贴 API key（如 Anthropic 的 sk-ant-…），或使用无需 key 的本地 Ollama 模型，也可以选择 Claude Pro/Max OAuth 登录。

指定模型提供方：

agentty --provider openai -m gpt-4o
agentty --provider ollama -m qwen2.5-coder

--provider 会被持久化，也可在应用内用 ^P 切换。开启按语义检索只需拉取本地嵌入模型：

ollama pull qwen3-embedding:0.6b

agentty 会自动发现 localhost 上的 Ollama，agentty diagnostics 可查看探测状态（probe: ok）。

常用快捷键：Enter 发送/排队、Esc 取消、^K 命令面板、^J 线程列表、^P 提供方选择、^/ 模型选择、^S Smart Mode、^R 查看改动、^C 退出。

注意事项

• Windows 上的沙箱由 AppContainer + 受限令牌 + job object 实现；当宿主机无法建立隔离时，启动时会明确提示，命令将在无约束条件下运行。
• Smart Mode 关闭时是严格的空操作，不增加 token 与延迟；学习数据只保存在本地 .agentty/ 目录，可清除。
• RAG 的若干可选阶段（伪相关反馈、GraphRAG、纠错重试、多查询扩展、HyDE）默认关闭，需要用 AGENTTY_RAG_* 环境变量显式开启，建议先测量再启用。
• 官方给出的检索评测中，search_code 配合 qwen3-embedding 首条命中率为 63-78%，前 8 条为 93-97%；仅关键词模式为 57-60% 与 92-95%。可用 agentty rag-eval 在自己的仓库上测量。

---

本作品整理自 GitHub 开源项目 agentty-org/agentty，原作者 @agentty-org，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。