# 0router 中文文档

规范地址：https://npmcn.com/package/0router/

版本：0\.4\.72
npm 元数据更新时间：2026-05-26T10:16:47.412Z
中文译文更新时间：2026-10-31T13:49:57.122Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/0router
原文对照：https://npmcn.com/package/0router/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：46.2 MB，3025 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：5 个
- 首次发布：2026-05-23T07:58:40.970Z
- 最新版本发布：2026-05-26T10:16:47.304Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

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

## 安装

```sh
npm install 0router
```

也可以使用：`pnpm add 0router`、`yarn add 0router`、`bun add 0router`

## README

# 0路由器-免费的AI路由器和令牌保护程序

**永远不要停止编码。节省20-40%代币与RTK +自动回退到免费和廉价的AI模型。**

**将所有AI代码工具（Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw…）连接到40+ AI提供商和100+模型。**

[![npm](https://img.shields.io/npm/v/0router.svg)](https://www.npmjs.com/package/0router) [![Downloads](https://img.shields.io/npm/dm/0router.svg)](https://www.npmjs.com/package/0router) [![Docker Pulls](https://img.shields.io/docker/pulls/zcuss/0router.svg?logo=docker&label=Docker%20pulls)](https://hub.docker.com/r/zcuss/0router) [![GHCR](https://img.shields.io/badge/GHCR-zcuss%2F0router-blue?logo=github)](https://github.com/zcuss/0router/pkgs/container/0router) [![License](https://img.shields.io/npm/l/0router.svg)](https://github.com/zcuss/0router/blob/main/LICENSE)

[![zcuss%2F0router | Trendshift](https://trendshift.io/api/badge/repositories/22628)](https://trendshift.io/repositories/22628)

[🌐网站](https://0router.com/) • [📖完整文档](https://github.com/zcuss/0router)

* * *

## 🤔为什么是0Router？

**停止浪费金钱，代币和达到限制：**

-   ❌订阅配额每月到期未使用
-   ❌速率限制阻止您中途编码
-   ❌工具输出（git diff, grep, ls…）快速刻录令牌
-   ❌昂贵的api（每个提供商每月20-50美元）

**0Router解决了这个问题：**

-   ✅ **RTK令牌保护程序** -自动压缩tool\_result，保存20-40% token
-   ✅ **最大化订阅** —跟踪配额，在重置前使用全部配额
-   ✅ **自动回退** -订阅→便宜→免费，零停机时间
-   ✅ **Multi-account** -每个提供商的帐户之间的循环
-   ✅ **通用** -适用于任何OpenAI/ claude兼容的CLI

* * *

## ⚡快速入门

**选项1 - npm（推荐用于桌面）：**

```bash
npm install -g 0router
0router

# Or run directly with npx
npx 0router
```

**选项2 - Docker（服务器/VPS）：**

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

发布图片: [GHCR](https://github.com/zcuss/0router/pkgs/container/0router) (多平台amd64 / arm64)。

🎉仪表板在 `http://localhost:20128`

**2\. 连接免费提供商（无需注册）：**

仪表板→提供商→连接 **Kiro人工智能** （免费克劳德无限）或 **OpenCode免费** （no auth）→完成！

**3\. 在CLI工具中使用：**

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

这是它!开始用免费的AI模型编码。

* * *

## 🚀命令行选项

```bash
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
```

**指示板**： `http://localhost:20128/dashboard`

* * *

## 推荐：️支持的CLI工具

Claude-Code•OpenClaw•Codex•OpenCode•光标•反重力•Cline•Continue•Droid•Roo•副驾驶•Kilo Code•Gemini CLI•Qwen Code•iFlow•Crush•Crusher•Aider

任何支持OpenAI/ claude兼容API的工具都可以工作。

* * *

## 💾数据位置

-   **macOS / Linux**： `~/.0Router/db/data.sqlite`
-   **窗户**： `%APPDATA%/0Router/db/data.sqlite`
-   **码头工人**： `/app/data/db/data.sqlite` (山 `$HOME/.0Router` 坚持)

* * *

## 📚文档

完整的文档，高级设置，视频教程和开发指南：

-   **GitHub**： [https://github.com/zcuss/0router](https://github.com/zcuss/0router)
-   **完整的自述**： [https://github.com/zcuss/0router/blob/main/README.md](https://github.com/zcuss/0router/blob/main/README.md)
-   **网站**： [https://0Router.com](https://0router.com/)

* * *

## 🙏致谢

-   **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** -原始Go实现

## 📄许可证

MIT许可证-参见 [许可证](https://npmcn.com/package/0router/LICENSE) 获取详细信息。

## 常见问题

### 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 和提交记录判断。