nanocoder

环境要求

• 已安装 Node.js 与 npm（用于全局安装）
• 准备一个模型提供方：本地 Ollama 服务，或任意 OpenAI 兼容 API（如 OpenRouter、Anthropic、Google）
• 云端 provider 需自备对应 API 密钥

安装与启动步骤

1. 1全局安装 CLI

   通过 npm 全局安装 @nanocollective/nanocoder 包，安装完成后终端即可直接调用 nanocoder 命令。

   npm install -g @nanocollective/nanocoder

   复制

2. 2启动交互界面

   不带任何参数运行，进入交互式编程代理界面，按提示选择 provider 与模型后即可开始对话。

   nanocoder

   复制

3. 3指定提供方与模型

   用 --provider 和 --model 直接指定后端，示例为本地 Ollama 的 llama3.1，避免每次手动选择。

   nanocoder --provider ollama --model llama3.1

   复制

4. 4非交互执行任务

   用 run 子命令一次性执行任务，参数可放在 run 前或后，示例让模型分析指定源码文件。

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

   复制

5. 5非交互重构代码

   同样是 run 子命令，只指定 provider、由模型自行决定，适合脚本化调用。

   nanocoder run --provider openrouter "refactor database module"

   复制

关键配置

如何确认成功

终端成功进入 nanocoder 交互界面，且带 --provider/--model 的 run 命令能返回模型结果，即表示安装与配置成功。

常见问题

注意事项

• 命令中的 provider 与 model 取值需替换为你实际可用的服务与模型名。
• README 中 --mode 的示例被截断，实际可选值为 normal、auto-accept、yolo、plan，其中 yolo 为全自动模式请谨慎使用。
• 除 npm 外还提供 Homebrew 与 Nix Flakes 安装方式，详见官方安装文档 https://docs.nanocollective.org/nanocoder 。
• 本项目开源无付费分层，使用云 API 时的费用由所选服务商收取。