Nanocoder

由 Nano Collective 构建的本地优先 CLI 编码代理——这是一个非营利性社区组织，致力于为社区打造 AI 工具。我们构建的每一项产品都开放、透明，并由使用者共同驱动。这才是正确的 AI 打造方式。

Nanocoder 将 Claude Code 和 Gemini CLI 等代理式编码工具的强大功能引入本地模型或受控 API（如 OpenRouter）。它以隐私和控制为核心设计，支持多家 AI 提供商，并提供文件操作和命令执行等工具支持。

---

快速入门

npm install -g @nanocollective/nanocoder
nanocoder

也可通过 Homebrew 和 Nix Flakes 安装。

CLI 标志

直接指定提供商和模型：

# 非交互模式，使用特定提供商/模型
nanocoder --provider openrouter --model google/gemini-3.1-flash run "analyze src/app.ts"

# 交互模式，从特定提供商开始
nanocoder --provider ollama --model llama3.1

# 标志可以出现在 'run' 命令之前或之后
nanocoder run --provider openrouter "refactor database module"

文档

完整文档可在线上 docs.nanocollective.org 或在 docs/ 文件夹中找到：

• 入门指南 —— 安装、设置及第一步操作
• 配置 —— AI 提供商、MCP 服务器、偏好设置、日志记录、超时等
• 特性 —— 自定义命令、检查点、开发模式、任务管理等
• 命令参考 —— 内置斜杠命令的完整列表
• 键盘快捷键 —— 完整快捷键参考
• 社区 —— 贡献、Discord 社区及如何参与帮助

社区

Nano Collective 是一个非营利性的社区组织，专注于为社区构建 AI 工具。我们非常欢迎您的参与！

• 贡献：请参阅 CONTRIBUTING.md，了解开发环境搭建及贡献指南
• Discord：加入我们的服务器 discord.gg/ktPDV6rekE，与其他用户和贡献者交流
• GitHub：在我们的仓库中提交问题或参与讨论

Nanocoder 快速上手指南

Nanocoder 是一款由 Nano Collective 社区打造的“本地优先”命令行 AI 编程助手。它支持连接本地模型（如 Ollama）或受控 API（如 OpenRouter），在提供强大智能编码能力的同时，确保数据隐私与控制权。

环境准备

• 系统要求：支持 macOS、Linux 及 Windows（需安装 Node.js 环境）。
• 前置依赖：
  • 已安装 Node.js (建议 LTS 版本) 和 npm。
  • （可选）若使用本地模型，请预先安装并运行 Ollama 或其他兼容的本地推理服务。
  • （可选）若使用云端模型，请准备好相应的 API Key（如 OpenRouter Key）。

提示：国内开发者若遇到 npm 安装缓慢问题，可临时切换至国内镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

推荐使用 npm 进行全局安装：

npm install -g @nanocollective/nanocoder

其他安装方式：macOS/Linux 用户也可通过 Homebrew 或 Nix Flakes 安装（详见官方文档）。

基本使用

安装完成后，即可在终端直接使用 nanocoder 命令。

1. 启动交互式模式

直接输入命令进入交互界面，根据提示选择提供商和模型：

nanocoder

2. 指定提供商与模型启动

你可以直接在命令行指定 AI 提供商和模型名称启动：

使用本地模型 (Ollama):

nanocoder --provider ollama --model llama3.1

使用云端 API (OpenRouter):

nanocoder --provider openrouter --model google/gemini-3.1-flash

3. 执行单次任务（非交互模式）

直接让 Nanocoder 执行特定指令并输出结果，无需进入交互界面：

nanocoder --provider openrouter --model google/gemini-3.1-flash run "analyze src/app.ts"

或者将 run 命令放在前面：

nanocoder run --provider openrouter "refactor database module"

启动后，你可以利用其文件操作和命令执行能力，通过自然语言让 AI 协助你编写、重构或分析代码。