8router

🚀 RTK Token 节省器

工具输出（git diff、grep、find、ls、tree、日志转储...）通常占用 30-50% 的提示词预算。RTK 在请求到达 LLM 之前检测并应用智能、无损压缩：

• 过滤器： git-diff、git-status、grep、find、ls、tree、dedup-log、smart-truncate、read-numbered、search-list
• 自动检测： 无需配置 — RTK 检查每个 tool_result 的前 1KB，选择合适的过滤器。
• 安全设计： 如果过滤器失败、抛出异常或使输出变大，RTK 会静默保留原始文本。错误永远不会中断你的请求。
• 通用兼容： 适用于所有格式（OpenAI、Claude、Gemini、Cursor、Kiro、OpenAI Responses），因为它在任何格式转换之前运行。
• 默认开启： 可随时在控制面板 → 端点设置中切换。

不使用 RTK：47K tokens 发送给 LLM
使用 RTK：    28K tokens 发送给 LLM   (节省 40% · 相同上下文 · 相同答案)

🎯 智能三层切换

创建具有自动切换功能的组合：

组合："my-coding-stack"
  1. cc/claude-opus-4-6        （你的订阅）
  2. glm/glm-4.7               （低价备份，$0.6/1M）
  3. if/kimi-k2-thinking       （免费备选）

→ 配额用完或出错时自动切换

📊 实时配额追踪

• 每个提供商的 token 消耗
• 重置倒计时（5小时、每日、每周）
• 付费等级的成本估算
• 月度支出报告

🔄 格式转换

格式间无缝转换：

• OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro ↔ Vertex ↔ Antigravity ↔ Ollama ↔ OpenAI Responses
• 你的 CLI 工具发送 OpenAI 格式 → 9Router 转换 → 提供商接收原生格式
• 适用于任何支持自定义 OpenAI 端点的工具

👥 多账户支持

• 每个提供商添加多个账户
• 自动轮询或基于优先级的路由
• 当一个账户达到配额时切换到下一个

🔄 自动 Token 刷新

• OAuth token 在过期前自动刷新
• 无需手动重新认证
• 所有提供商的无缝体验

🎨 自定义组合

• 创建无限模型组合
• 混合订阅、低价和免费等级
• 为组合命名以便访问
• 使用云同步跨设备共享组合

📝 请求日志

• 启用调试模式获取完整请求/响应日志
• 追踪 API 调用、请求头和载荷
• 排查集成问题
• 导出日志进行分析

💾 云同步

• 跨设备同步提供商、组合和设置
• 自动后台同步
• 安全加密存储
• 从任何地方访问你的设置

云运行时说明

• 生产环境中优先使用服务端云变量：
  • BASE_URL（云同步调度程序使用的内部回调 URL）
  • CLOUD_URL（云同步端点基础 URL）
• NEXT_PUBLIC_BASE_URL 和 NEXT_PUBLIC_CLOUD_URL 仍用于兼容性/UI，但服务端运行时现在优先使用 BASE_URL/CLOUD_URL。
• 云同步请求现在使用超时 + 快速失败行为，以避免云 DNS/网络不可用时 UI 挂起。

📊 使用分析

• 追踪每个提供商和模型的 token 使用量
• 成本估算和支出趋势
• 月度报告和洞察
• 优化你的 AI 支出

💡 重要 - 了解控制面板成本：

使用分析中显示的"成本"仅用于追踪和比较目的。 9Router 本身永远不会向你收费。你只直接向提供商付款（如果使用付费服务）。

示例： 如果你的控制面板显示使用 iFlow 模型时"总成本 $290"，这代表你如果直接使用付费 API 需要支付的金额。你的实际成本 = $0（iFlow 免费无限量）。

把它想象成一个"节省追踪器"，展示你通过使用免费模型或通过 9Router 路由节省了多少钱！

🌐 任意部署

• 💻 本地 - 默认，离线可用
• ☁️ VPS/云 - 跨设备共享
• 🐳 Docker - 一键部署
• 🚀 Cloudflare Workers - 全球边缘网络

控制面板追踪你的 token 使用情况，并显示估算成本，如同你直接使用付费 API。这不是实际计费 — 它是一个参考，展示你通过使用免费模型或通过 9Router 路由现有订阅节省了多少钱。

示例：

• 控制面板显示： "$290 总成本"
• 实际情况： 你在使用 iFlow（免费无限量）
• 你的实际成本： $0.00
• $290 的含义： 你通过使用免费模型而不是付费 API 节省的金额！

成本显示是一个"节省追踪器"，帮助你了解使用模式和优化机会。

不会。 9Router 是在你自己的电脑上运行的开源软件。它永远不会向你收取任何费用。

你只需支付：

• ✅ 订阅提供商（Claude Code $20/月、Codex $20-200/月）→ 在他们的网站上直接付款
• ✅ 低价提供商（GLM、MiniMax）→ 直接付款，9Router 只是路由你的请求
• ❌ 9Router 本身 → 永不收费，永远不会

9Router 是一个本地代理/路由器。它没有你的信用卡，不能发送发票，也没有计费系统。它是完全免费的软件。

是的！ 当前的免费提供商（Kiro、OpenCode Free、Vertex）是真正的免费，无隐藏费用。

这些是各公司提供的免费服务：

• Kiro AI：通过 AWS Builder ID / Google / GitHub OAuth 免费无限量使用 Claude 4.5 + GLM-5 + MiniMax
• OpenCode Free：无认证直连代理，模型从 opencode.ai/zen/v1/models 自动获取
• Vertex AI：新 Google Cloud 账户可获得 $300 免费额度（90 天）

9Router 只是路由你的请求到它们 — 没有"陷阱"或未来的计费。它们是真正的免费服务，9Router 让它们易于使用并支持切换。

已停止的免费等级（不再推荐）：

• ❌ iFlow：曾是免费无限量，现在改为付费（2026）
• ❌ Qwen Code：阿里巴巴于 2026-04-15 停止免费 OAuth 等级
• ❌ Gemini CLI：仍可用，但与非 CLI 工具（Claude、Codex、Cursor...）一起使用可能会导致账户被封 — 仅在你坚持使用 Gemini CLI 本身时才使用

免费优先策略：

1. 从 100% 免费组合开始：

   1. gc/gemini-3-flash (Google 每月 180K 免费)
   2. if/kimi-k2-thinking (iFlow 无限量免费)
   3. qw/qwen3-coder-plus (Qwen 无限量免费)
   

   成本：$0/月

2. 仅在需要时添加低价备份：

   4. glm/glm-4.7 ($0.6/1M tokens)
   

   额外成本：只为实际使用的部分付费

3. 最后使用订阅提供商：

   • 仅当你已有订阅时
   • 9Router 通过配额追踪帮助最大化其价值

结果： 大多数用户可以仅使用免费等级以 $0/月运行！

9Router 的智能切换可以防止意外费用：

场景： 你正在进行编码冲刺，用尽了配额

没有 9Router：

• ❌ 达到速率限制 → 工作停止 → 沮丧
• ❌ 或者：不慎累积大量 API 账单

有 9Router：

• ✅ 订阅达到限制 → 自动切换到低价等级
• ✅ 低价等级变得昂贵 → 自动切换到免费等级
• ✅ 编程永不停歇 → 可预测的成本

你掌控一切： 在控制面板中设置每个提供商的支出限制，9Router 会遵守它们。

Claude Code (Pro/Max)

控制面板 → 提供商 → 连接 Claude Code
→ OAuth 登录 → 自动 token 刷新
→ 5小时 + 每周配额追踪

模型：
  cc/claude-opus-4-7
  cc/claude-opus-4-6
  cc/claude-sonnet-4-6
  cc/claude-haiku-4-5-20251001

专业提示： 复杂任务使用 Opus，追求速度使用 Sonnet。9Router 按模型追踪配额！

OpenAI Codex (Plus/Pro)

控制面板 → 提供商 → 连接 Codex
→ OAuth 登录（端口 1455）
→ 5小时 + 每周重置

模型：
  cx/gpt-5.5
  cx/gpt-5.4
  cx/gpt-5.3-codex
  cx/gpt-5.2-codex

GitHub Copilot

控制面板 → 提供商 → 连接 GitHub
→ 通过 GitHub 进行 OAuth
→ 每月重置（每月 1 日）

模型：
  gh/gpt-5.4
  gh/claude-opus-4.7
  gh/claude-sonnet-4.6
  gh/gemini-3.1-pro-preview
  gh/grok-code-fast-1

Cursor IDE

控制面板 → 提供商 → 连接 Cursor
→ OAuth 登录
→ 每月订阅

模型：
  cu/claude-4.6-opus-max
  cu/claude-4.5-sonnet-thinking
  cu/gpt-5.3-codex

GLM-5.1 / GLM-4.7（每日重置，$0.6/1M）

1. 注册：Zhipu AI
2. 从编程计划获取 API key
3. 控制面板 → 添加 API Key：
   • 提供商：glm
   • API Key：your-key

使用： glm/glm-5.1、glm/glm-5、glm/glm-4.7

专业提示： 编程计划提供 3 倍配额，成本仅为 1/7！每日 10:00 AM 重置。

MiniMax M2.7（5小时重置，$0.20/1M）

1. 注册：MiniMax
2. 获取 API key
3. 控制面板 → 添加 API Key

使用： minimax/MiniMax-M2.7、minimax/MiniMax-M2.5

专业提示： 长上下文（1M tokens）的最便宜选项！

Kimi K2.5（$9/月固定）

1. 订阅：Moonshot AI
2. 获取 API key
3. 控制面板 → 添加 API Key

使用： kimi/kimi-k2.5、kimi/kimi-k2.5-thinking

专业提示： 每月 $9 固定费用获得 10M tokens = 实际成本 $0.90/1M！

Kiro AI（Claude 4.5 + GLM-5 + MiniMax 免费）

控制面板 → 连接 Kiro
→ AWS Builder ID、AWS IAM Identity Center、Google 或 GitHub
→ 无限量使用

模型：
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5
  kr/glm-5
  kr/MiniMax-M2.5
  kr/qwen3-coder-next
  kr/deepseek-3.2

专业提示： Claude 最佳免费选项。无需 API key，无需付款，完全无限量。

OpenCode Free（无需认证，自动获取模型）

控制面板 → 连接 OpenCode Free
→ 无需登录（直连代理）
→ 模型从 opencode.ai/zen/v1/models 自动获取

专业提示： 最快的设置。连接后即可开始编码。

Vertex AI（新 GCP 账户 $300 免费额度）

控制面板 → 连接 Vertex AI
→ 上传 Google Cloud 服务账户 JSON
→ 在你的 GCP 项目中启用 Vertex AI API

模型：
  vertex/gemini-3.1-pro-preview
  vertex/gemini-3-flash-preview
  vertex/gemini-2.5-flash

Vertex 合作伙伴（通过 Vertex 提供 Anthropic / DeepSeek / GLM / Qwen）：
  vertex-partner/glm-5-maas
  vertex-partner/deepseek-v3.2-maas
  vertex-partner/qwen3-next-80b-a3b-thinking-maas

专业提示： 新 Google Cloud 账户可获得 90 天内 $300 免费额度。足够日常编码使用。

示例 1：充分利用订阅 → 低价备份

控制面板 → 组合 → 创建新组合

名称：premium-coding
模型：
  1. cc/claude-opus-4-7 (订阅主用)
  2. glm/glm-5.1 (低价备份，$0.6/1M)
  3. minimax/MiniMax-M2.7 (最便宜的备选，$0.20/1M)

在 CLI 中使用：premium-coding

月度成本示例（100M tokens）：
  80M 通过 Claude（订阅）：$0 额外费用
  15M 通过 GLM：$9
  5M 通过 MiniMax：$1
  总计：$10 + 你的订阅费用

示例 2：仅免费（零成本）

名称：free-combo
模型：
  1. kr/claude-sonnet-4.5 (Claude 4.5 免费无限量)
  2. kr/glm-5 (通过 Kiro 免费使用 GLM-5)
  3. vertex/gemini-3.1-pro-preview ($300 免费额度)

成本：通过 RTK 永久 $0（+ 节省 20-40% tokens）！

Cursor IDE

设置 → 模型 → 高级：
  OpenAI API Base URL：http://localhost:20128/v1
  OpenAI API Key：[来自 9router 控制面板]
  Model：cc/claude-opus-4-7

或使用组合：premium-coding

Claude Code

编辑 ~/.claude/config.json：

{
  "anthropic_api_base": "http://localhost:20128/v1",
  "anthropic_api_key": "your-9router-api-key"
}

Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-9router-api-key"

codex "your prompt"

OpenClaw

选项 1 — 控制面板（推荐）：

控制面板 → CLI 工具 → OpenClaw → 选择模型 → 应用

选项 2 — 手动： 编辑 ~/.openclaw/openclaw.json：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "9router/kr/claude-sonnet-4.5"
      }
    }
  },
  "models": {
    "providers": {
      "9router": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_9router",
        "api": "openai-completions",
        "models": [
          {
            "id": "kr/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5 (Kiro Free)"
          }
        ]
      }
    }
  }
}

注意： OpenClaw 仅适用于本地 9Router。使用 127.0.0.1 而不是 localhost 以避免 IPv6 解析问题。

Cline / Continue / RooCode

Provider：OpenAI 兼容
Base URL：http://localhost:20128/v1
API Key：[来自控制面板]
Model：cc/claude-opus-4-7

VPS 部署

# 克隆并安装
git clone https://github.com/decolua/9router.git
cd 9router
npm install
npm run build

# 配置
export JWT_SECRET="your-secure-secret-change-this"
export INITIAL_PASSWORD="your-password"
export DATA_DIR="/var/lib/9router"
export PORT="20128"
export HOSTNAME="0.0.0.0"
export NODE_ENV="production"
export NEXT_PUBLIC_BASE_URL="http://localhost:20128"
export NEXT_PUBLIC_CLOUD_URL="https://9router.com"
export API_KEY_SECRET="endpoint-proxy-api-key-secret"
export MACHINE_ID_SALT="endpoint-proxy-salt"

# 启动
npm run start

# 或使用 PM2
npm install -g pm2
pm2 start npm --name 9router -- start
pm2 save
pm2 startup

Docker

# 构建镜像（从仓库根目录）
docker build -t 9router .

# 运行容器（当前设置使用的命令）
docker run -d \
  --name 9router \
  -p 20128:20128 \
  --env-file /root/dev/9router/.env \
  -v 9router-data:/app/data \
  -v 9router-usage:/root/.9router \
  9router

便携命令（如果你已经在仓库根目录）：

docker run -d \
  --name 9router \
  -p 20128:20128 \
  --env-file ./.env \
  -v 9router-data:/app/data \
  -v 9router-usage:/root/.9router \
  9router

容器默认值：

• PORT=20128
• HOSTNAME=0.0.0.0

常用命令：

docker logs -f 9router
docker restart 9router
docker stop 9router && docker rm 9router

环境变量

注意：

• 也支持小写代理变量：http_proxy、https_proxy、all_proxy、no_proxy。
• .env 不会打包到 Docker 镜像中（.dockerignore）；使用 --env-file 或 -e 注入运行时配置。
• 在 Windows 上，APPDATA 可用于本地存储路径解析。
• INSTANCE_NAME 出现在较旧的文档/环境变量模板中，但当前运行时未使用。

运行时文件和存储

• 主应用状态：${DATA_DIR}/db.json（提供商、组合、别名、密钥、设置），由 src/lib/localDb.js 管理。
• 使用历史和日志：${DATA_DIR}/usage.json 和 ${DATA_DIR}/log.txt，由 src/lib/usageDb.js 管理。
• 可选的请求/翻译器日志：ENABLE_REQUEST_LOGS=true 时位于 <repo>/logs/...。
• ${DATA_DIR} 和 ~/.9router 在 Docker 容器中解析到同一位置 — 符号链接 /root/.9router -> /app/data 在构建时创建。

Claude Code（cc/） - Pro/Max：

• cc/claude-opus-4-7
• cc/claude-opus-4-6
• cc/claude-sonnet-4-6
• cc/claude-sonnet-4-5-20250929
• cc/claude-haiku-4-5-20251001

Codex（cx/） - Plus/Pro：

• cx/gpt-5.5
• cx/gpt-5.4
• cx/gpt-5.3-codex
• cx/gpt-5.2-codex
• cx/gpt-5.1-codex-max

GitHub Copilot（gh/）：

• gh/gpt-5.4
• gh/claude-opus-4.7
• gh/claude-sonnet-4.6
• gh/gemini-3.1-pro-preview
• gh/grok-code-fast-1

Cursor（cu/） - 订阅：

• cu/claude-4.6-opus-max
• cu/claude-4.5-sonnet-thinking
• cu/gpt-5.3-codex
• cu/kimi-k2.5

GLM（glm/） - $0.6/1M：

• glm/glm-5.1
• glm/glm-5
• glm/glm-4.7

MiniMax（minimax/） - $0.2/1M：

• minimax/MiniMax-M2.7
• minimax/MiniMax-M2.5

Kimi（kimi/） - $9/月固定：

• kimi/kimi-k2.5
• kimi/kimi-k2.5-thinking

Kiro（kr/） - 免费无限量：

• kr/claude-sonnet-4.5
• kr/claude-haiku-4.5
• kr/glm-5
• kr/MiniMax-M2.5
• kr/qwen3-coder-next
• kr/deepseek-3.2

OpenCode Free（oc/） - 免费无需认证：

• 从 opencode.ai/zen/v1/models 自动获取

Vertex AI（vertex/） - $300 免费额度：

• vertex/gemini-3.1-pro-preview
• vertex/gemini-3-flash-preview
• vertex/gemini-2.5-flash
• vertex-partner/glm-5-maas
• vertex-partner/deepseek-v3.2-maas