Nanocoder
开源、本地优先的终端编码代理，自带模型，数据留在本机。
- Star 数
- ★ 2.5k
- 最近更新
- 今天
- License
- NOASSERTION
- 主语言
- TypeScript
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 开发者希望使用本地模型进行编码，同时确保代码不离开机器。
- 不适合
- 需要图形界面或 IDE 插件的用户
- 需要把 review 输出重定向到文件或管道的自动化流程
- 源码审查
- 50/100 · 缺口较多
这个 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？
通过 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 有哪些优点和局限？
- 真正的本地优先，代码不离开机器。
- 多提供商支持（Ollama、OpenRouter、Anthropic、Google），避免锁定。
- 无付费层级，所有功能对社区开放。
- 社区集体治理，非公司驱动，路线图基于用户需求。
- 需要用户自带模型，可能产生 API 费用。
- 依赖 Node.js 环境，需安装 npm 包。
- 文档齐全但可能需要时间熟悉 CLI 和配置。
- 全屏模式仅在使用 --alt-screen 时可用，不是默认。
这个 Agent 与同类方案有什么区别？
相对于 Claude Code 和 Codex，Nanocoder 强调多提供商支持和本地优先，且无公司治理。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Nanocoder 当前 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 2.5k | 今天 | TypeScript | OpenAI API · Claude API |
| OpenClaude — 通用终端 AI 编程代理 | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 34k | 今天 | TypeScript | Claude Code · OpenAI API · Claude API |
| pigo | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 481 | 1 个月前 | Go | OpenAI API · Claude API |
| Claude Council | 74 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 890 | 1 天前 | Shell | Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示项目强调本地优先、自带模型、无遥测，但未提供具体实现细节。扣分：缺少权限最小化、用户确认、数据流透明、敏感数据处理的具体机制；依赖安全有审计脚本但未提供结果；外部影响和回滚机制未明确；来源归属仅提及集体，未验证。
自洽性：README、package.json、CI 配置一致，但未提供运行时行为证据。依赖可用性：依赖列表完整，但未验证版本可用性。失败消息：未提供具体错误处理示例。扣分：静态审查无法验证运行时可靠性。
受众明确为开发者，场景覆盖安装、配置、功能等。能力边界：文档提及技能、子代理等，但未详细说明限制。触发精度：CLI 标志和模式有说明，但未深入。环境适配：支持多种安装方式，但未验证。扣分：能力边界和触发精度证据不足。
信息架构：文档结构清晰。安装说明：提供 npm、Homebrew、Nix 安装方式。命名稳定性：版本号明确，但未提供命名约定。示例和 FAQ：有示例，但无 FAQ。已知限制：未明确列出。许可证：MIT 许可证明确。版本和变更日志：有 changeset 流程，但未提供实际变更日志。维护责任：集体维护，但未明确。扣分：已知限制、命名稳定性、维护责任证据不足。
输出可用性：提供 CLI 和文档，但未验证实际输出。边际价值：强调本地优先、多提供商，但未量化。成本效益：免费开源，但未提供性能数据。扣分：静态审查无法验证实际效果。
声明可追溯性：README 中的声明未提供具体证据。跨来源佐证：仅依赖仓库内文件。事实与推断分离：未明确区分。扣分：缺乏外部验证和明确区分。
- 静态审查无法验证运行时行为，所有安全性和可靠性声明需实际测试确认。
- 依赖安全审计脚本存在，但未提供审计结果，需检查依赖漏洞。
- 未提供明确的权限最小化、用户确认和数据流透明机制，需审查源代码确认。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.31.0 nanocoder v1.31.0
发布说明摘录
What's Changed - Added a first-class provider template for Cheaper Inference, an OpenAI-compatible gateway, to the /settings providers wizard. Selecting it fills in the base URL (https://api.cheaperinference.com/v1) so only an API key and a model name are needed, and the wizard can fetch the account's model list over the standard /models endpoint. …在 GitHub 查看 ↗ -
v1.30.0 nanocoder v1.30.0
发布说明摘录
What's Changed - Added first-class provider template for Groq to the setup wizard. - Added first-class provider template for OrcaRouter to the setup wizard. - Added a /commit slash command that generates Conventional Commit messages from staged Git diffs using the active LLM client. Thanks to @DeepamJha. Closes #757. - Consolidated upload actions under a single '+' menu in the VS Code webview to reduce UI clutter and improve scalability for future attachment types. - Added context attachment functionality with UI for file/folder chips and drag-and-drop support. …在 GitHub 查看 ↗ -
v1.29.0 nanocoder v1.29.0
发布说明摘录
What's Changed - Added the ability to attach to a running subagent session from the terminal UI for interactive debugging. This feature allows users to inspect exactly what a subagent is doing in real-time, including streaming text and reasoning. You can press Ctrl+S while a subagent is running to attach to it, cycle between multiple running subagents, and press Esc to detach. …在 GitHub 查看 ↗