0router

中文文档
0.4.72发布于 2026/05/26MIT

0Router CLI - Start and manage 0Router server

原始使用文档
文档目录8 节
  1. 🤔 Why 0Router?
  2. ⚡ Quick Start
  3. 🚀 CLI Options
  4. 🛠️ Supported CLI Tools
  5. 💾 Data Location
  6. 📚 Documentation
  7. 🙏 Acknowledgments
  8. 📄 License

0Router - FREE AI Router & Token Saver

Never stop coding. Save 20-40% tokens with RTK + auto-fallback to FREE & cheap AI models.

Connect All AI Code Tools (Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw...) to 40+ AI Providers & 100+ Models.

npm Downloads Docker Pulls GHCR License

zcuss%2F0router | Trendshift

🌐 Website • 📖 Full Docs


🤔 Why 0Router?

Stop wasting money, tokens and hitting limits:

  • ❌ Subscription quota expires unused every month
  • ❌ Rate limits stop you mid-coding
  • ❌ Tool outputs (git diff, grep, ls...) burn tokens fast
  • ❌ Expensive APIs ($20-50/month per provider)

0Router solves this:

  • ✅ RTK Token Saver - Auto-compress tool_result, save 20-40% tokens
  • ✅ Maximize subscriptions - Track quota, use every bit before reset
  • ✅ Auto fallback - Subscription → Cheap → Free, zero downtime
  • ✅ Multi-account - Round-robin between accounts per provider
  • ✅ Universal - Works with any OpenAI/Claude-compatible CLI

⚡ Quick Start

Option 1 — npm (recommended for desktop):

npm install -g 0router
0router

# Or run directly with npx
npx 0router

Option 2 — Docker (server/VPS):

docker run -d --name 0router -p 20128:20128 \
  -v "$HOME/.0router:/app/data" -e DATA_DIR=/app/data \
  zcuss/0router:latest

Published image: GHCR (multi-platform amd64/arm64).

🎉 Dashboard opens at http://localhost:20128

2. Connect a FREE provider (no signup needed):

Dashboard → Providers → Connect Kiro AI (free Claude unlimited) or OpenCode Free (no auth) → Done!

3. Use in your CLI tool:

Claude Code/Codex/OpenClaw/Cursor/Cline Settings:
  Endpoint: http://localhost:20128/v1
  API Key:  [copy from dashboard]
  Model:    kr/claude-sonnet-4.5

That's it! Start coding with FREE AI models.


🚀 CLI Options

0Router                    # Start with default settings
0Router --port 8080        # Custom port
0Router --no-browser       # Don't open browser
0Router --skip-update      # Skip auto-update check
0Router --help             # Show all options

Dashboard: http://localhost:20128/dashboard


🛠️ Supported CLI Tools

Claude-Code • OpenClaw • Codex • OpenCode • Cursor • Antigravity • Cline • Continue • Droid • Roo • Copilot • Kilo Code • Gemini CLI • Qwen Code • iFlow • Crush • Crusher • Aider

Any tool supporting OpenAI/Claude-compatible API works.


💾 Data Location

  • macOS/Linux: ~/.0Router/db/data.sqlite
  • Windows: %APPDATA%/0Router/db/data.sqlite
  • Docker: /app/data/db/data.sqlite (mount $HOME/.0Router to persist)

📚 Documentation

Full docs, advanced setup, video tutorials & development guide:


🙏 Acknowledgments

📄 License

MIT License - see LICENSE for details.

版本与发布记录

0router 共发布 5 个版本,首次发布于 2026/05/23;过去 12 个月发布了 5 个版本。

版本发布日期距今
0.4.72latest2026/05/265 个月前
0.4.712026/05/265 个月前
0.4.702026/05/235 个月前
0.4.692026/05/235 个月前
0.4.612026/05/235 个月前

关于 0router 的常见问题

0router 是什么?

0Router命令行-启动和管理0Router服务器

如何安装 0router?

在项目目录运行 npm install 0router,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 0router,可以用 npx 0router 直接运行。

0router 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/0router 是否存在。

0router 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

0router 可以商用吗?

0router 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

0router 还在维护吗?

最新版本 0.4.72 发布于 2026/05/26(5 个月前);至今共发布 5 个版本,其中过去 12 个月发布了 5 个;首次发布于 2026/05/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。