Nanocoder
开源、本地优先的终端编码代理,自带模型,数据留在本机。
证据显示项目强调本地优先、自带模型、无遥测,但未提供具体实现细节。扣分:缺少权限最小化、用户确认、数据流透明、敏感数据处理的具体机制;依赖安全有审计脚本但未提供结果;外部影响和回滚机制未明确;来源归属仅提及集体,未验证。
自洽性:README、package.json、CI 配置一致,但未提供运行时行为证据。依赖可用性:依赖列表完整,但未验证版本可用性。失败消息:未提供具体错误处理示例。扣分:静态审查无法验证运行时可靠性。
受众明确为开发者,场景覆盖安装、配置、功能等。能力边界:文档提及技能、子代理等,但未详细说明限制。触发精度:CLI 标志和模式有说明,但未深入。环境适配:支持多种安装方式,但未验证。扣分:能力边界和触发精度证据不足。
信息架构:文档结构清晰。安装说明:提供 npm、Homebrew、Nix 安装方式。命名稳定性:版本号明确,但未提供命名约定。示例和 FAQ:有示例,但无 FAQ。已知限制:未明确列出。许可证:MIT 许可证明确。版本和变更日志:有 changeset 流程,但未提供实际变更日志。维护责任:集体维护,但未明确。扣分:已知限制、命名稳定性、维护责任证据不足。
输出可用性:提供 CLI 和文档,但未验证实际输出。边际价值:强调本地优先、多提供商,但未量化。成本效益:免费开源,但未提供性能数据。扣分:静态审查无法验证实际效果。
声明可追溯性:README 中的声明未提供具体证据。跨来源佐证:仅依赖仓库内文件。事实与推断分离:未明确区分。扣分:缺乏外部验证和明确区分。
- 静态审查无法验证运行时行为,所有安全性和可靠性声明需实际测试确认。
- 依赖安全审计脚本存在,但未提供审计结果,需检查依赖漏洞。
- 未提供明确的权限最小化、用户确认和数据流透明机制,需审查源代码确认。
这个 Agent 能做什么,适合哪些场景?
Nanocoder 是一个面向终端的开源编码代理,由 Nano Collective 社区集体开发而非商业公司。它允许用户自带模型(BYOM),支持本地模型如 Ollama,或通过 OpenAI 兼容 API 接入 OpenRouter、Anthropic、Google 等。核心特性是隐私尊重、本地优先,代码和提示词都不会离开本地。安装通过 npm 全局安装 @nanocollective/nanocoder,启动命令为 nanocoder。它提供多种 CLI 标志,如 --provider、--model、--mode 和 --alt-screen。支持内联和全屏两种渲染模式。项目无付费层级,不使用遥测,路线图由社区驱动。文档齐全,包含快速入门、配置、特性、命令参考等。
Nanocoder 基于用户指定的模型执行编码任务。它通过 CLI 命令交互,例如 nanocoder --provider openrouter --model google/gemini-3.1-flash run "analyze src/app.ts" 在非交互模式下运行分析,或 nanocoder --provider ollama --model llama3.1 启动交互模式。它支持多种开发模式:normal、auto-accept、yolo、plan,以及全屏模式(--alt-screen)。它提供内置斜杠命令(如 /clear、/exit),以及内联或替代屏幕的渲染模式。它通过配置支持 MCP 服务器、偏好设置、日志和超时。它读入项目文件,执行命令,调用模型 API,生成代码修改或分析结果,并输出到终端。
- 开发者希望使用本地模型进行编码,同时确保代码不离开机器。
- 团队需要统一编码代理,但允许成员选择不同模型提供商(如 Ollama 或 OpenRouter)。
- 用户希望无任何付费层级限制地使用 AI 编码代理,且无需遥测。
- 维护多项目代码库的开发者,需要跨项目标准化的工具链。
- 贡献者希望参与社区驱动的 AI 工具建设,并影响路线图。
这个 Agent 有哪些优点和局限?
- 真正的本地优先,代码不离开机器。
- 多提供商支持(Ollama、OpenRouter、Anthropic、Google),避免锁定。
- 无付费层级,所有功能对社区开放。
- 社区集体治理,非公司驱动,路线图基于用户需求。
- 需要用户自带模型,可能产生 API 费用。
- 依赖 Node.js 环境,需安装 npm 包。
- 文档齐全但可能需要时间熟悉 CLI 和配置。
- 全屏模式仅在使用 --alt-screen 时可用,不是默认。
如何安装或部署这个 Agent?
通过 npm 全局安装:npm install -g @nanocollective/nanocoder。也可通过 Homebrew(macOS/Linux)和 Nix Flakes 安装。安装后运行 nanocoder 启动。需要 Node.js 环境。
如何使用这个 Agent?
运行 nanocoder 启动交互式会话。使用 --provider 和 --model 指定提供商和模型,例如 nanocoder --provider openrouter --model google/gemini-3.1-flash run "analyze src/app.ts"。可用模式包括 normal、auto-accept、yolo、plan,使用 --mode 指定。使用 --alt-screen 切换全屏模式。提供斜杠命令 /clear 和 /exit。
这个 Agent 与同类方案有什么区别?
相对于 Claude Code 和 Codex,Nanocoder 强调多提供商支持和本地优先,且无公司治理。