[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-decolua--9router":3,"tool-decolua--9router":64},[4,17,26,36,44,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",144730,2,"2026-04-07T23:26:32",[13,14,15],"开发框架","Agent","语言模型","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":10,"last_commit_at":23,"category_tags":24,"status":16},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[25,13],"插件",{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":16},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,3,"2026-04-06T11:19:32",[15,35,14,13],"图像",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":10,"last_commit_at":42,"category_tags":43,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,15],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85013,"2026-04-06T11:09:19",[35,52,53,25,14,54,15,13,55],"数据工具","视频","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":32,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[14,35,13,15,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":76,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":76,"owner_website":76,"owner_url":78,"languages":79,"stars":96,"forks":97,"last_commit_at":98,"license":99,"difficulty_score":10,"env_os":100,"env_gpu":101,"env_ram":101,"env_deps":102,"category_tags":107,"github_topics":108,"view_count":10,"oss_zip_url":76,"oss_zip_packed_at":76,"status":16,"created_at":114,"updated_at":115,"faqs":116,"releases":152},5379,"decolua\u002F9router","9router","Connect All AI Code Tools (Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw...) to 40+ AI Providers & 100+ Models","9Router 是一款专为开发者设计的智能 AI 路由中间件，旨在将各类主流 AI 编程助手（如 Claude Code、Cursor、Copilot、Cline 等）无缝连接至全球 40 多家服务商和 100 多种大模型。它核心解决了开发者在编码过程中常遇到的订阅额度浪费、请求频率限制以及高昂 API 成本等痛点。\n\n通过独特的“分层自动故障转移”机制，9Router 能优先使用已付费的订阅额度，当额度耗尽或触发限流时，自动无感切换至低价或免费模型（如 GLM、MiniMax 或 Qwen），确保编码工作流永不中断。此外，它还支持多账号轮询、配额实时监控以及不同模型接口格式（如 OpenAI 与 Claude 协议）的自动转换。\n\n用户只需在本地部署 9Router 并配置简单的代理地址，即可让现有的 CLI 工具或编辑器插件透明地调用最优模型资源，无需手动切换后端服务。无论是希望最大化利用现有订阅的专业工程师，还是寻求低成本实验环境的学生与研究人员，9Router 都能帮助以更经济、高效的方式释放 AI 编程潜力，实现“永不停止编码”的目标。","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_62b2dcb0408e.png\" alt=\"9Router Dashboard\" width=\"800\"\u002F>\n  \n  # 9Router - Free AI Router\n  \n  **Never stop coding. Auto-route to FREE & cheap AI models with smart fallback.**\n  \n  **Connect All AI Code Tools (Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw...) to 40+ AI Providers & 100+ Models.**\n  \n  [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F9router.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F9router)\n  [![Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F9router.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F9router)\n  [![License](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fl\u002F9router.svg)](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fblob\u002Fmain\u002FLICENSE)\n  \n  [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Setup](#-setup-guide) • [🌐 Website](https:\u002F\u002F9router.com)\n\n  [🇻🇳 Tiếng Việt](.\u002Fi18n\u002FREADME.vi.md) • [🇨🇳 中文](.\u002Fi18n\u002FREADME.zh-CN.md) • [🇯🇵 日本語](.\u002Fi18n\u002FREADME.ja-JP.md)\n\u003C\u002Fdiv>\n\n---\n\n## 🤔 Why 9Router?\n\n**Stop wasting money and hitting limits:**\n\n- ❌ Subscription quota expires unused every month\n- ❌ Rate limits stop you mid-coding\n- ❌ Expensive APIs ($20-50\u002Fmonth per provider)\n- ❌ Manual switching between providers\n\n**9Router solves this:**\n\n- ✅ **Maximize subscriptions** - Track quota, use every bit before reset\n- ✅ **Auto fallback** - Subscription → Cheap → Free, zero downtime\n- ✅ **Multi-account** - Round-robin between accounts per provider\n- ✅ **Universal** - Works with Claude Code, Codex, Gemini CLI, Cursor, Cline, any CLI tool\n\n---\n\n## 🔄 How It Works\n\n```\n┌─────────────┐\n│  Your CLI   │  (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)\n│   Tool      │\n└──────┬──────┘\n       │ http:\u002F\u002Flocalhost:20128\u002Fv1\n       ↓\n┌─────────────────────────────────────────┐\n│           9Router (Smart Router)        │\n│  • Format translation (OpenAI ↔ Claude) │\n│  • Quota tracking                       │\n│  • Auto token refresh                   │\n└──────┬──────────────────────────────────┘\n       │\n       ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI\n       │   ↓ quota exhausted\n       ├─→ [Tier 2: CHEAP] GLM ($0.6\u002F1M), MiniMax ($0.2\u002F1M)\n       │   ↓ budget limit\n       └─→ [Tier 3: FREE] iFlow, Qwen, Kiro (unlimited)\n\nResult: Never stop coding, minimal cost\n```\n\n---\n\n## ⚡ Quick Start\n\n**1. Install globally:**\n\n```bash\nnpm install -g 9router\n9router\n```\n\n🎉 Dashboard opens at `http:\u002F\u002Flocalhost:20128`\n\n**2. Connect a FREE provider (no signup needed):**\n\nDashboard → Providers → Connect **Claude Code** or **Antigravity** → OAuth login → Done!\n\n**3. Use in your CLI tool:**\n\n```\nClaude Code\u002FCodex\u002FGemini CLI\u002FOpenClaw\u002FCursor\u002FCline Settings:\n  Endpoint: http:\u002F\u002Flocalhost:20128\u002Fv1\n  API Key: [copy from dashboard]\n  Model: if\u002Fkimi-k2-thinking\n```\n\n**That's it!** Start coding with FREE AI models.\n\n**Alternative: run from source (this repository):**\n\nThis repository package is private (`9router-app`), so source\u002FDocker execution is the expected local development path.\n\n```bash\ncp .env.example .env\nnpm install\nPORT=20128 NEXT_PUBLIC_BASE_URL=http:\u002F\u002Flocalhost:20128 npm run dev\n```\n\nProduction mode:\n\n```bash\nnpm run build\nPORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http:\u002F\u002Flocalhost:20128 npm run start\n```\n\nDefault URLs:\n- Dashboard: `http:\u002F\u002Flocalhost:20128\u002Fdashboard`\n- OpenAI-compatible API: `http:\u002F\u002Flocalhost:20128\u002Fv1`\n\n---\n\n## 🎥 Video Tutorial\n\n\u003Cdiv align=\"center\">\n  \n### 📺 Complete Setup Guide - 9Router + Claude Code FREE\n  \n[![9Router + Claude Code Setup](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c1797c4fb7b2.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=raEyZPg5xE0)\n\n**🎬 Watch the complete step-by-step tutorial:**\n- ✅ 9Router installation & setup\n- ✅ FREE Claude Sonnet 4.5 configuration\n- ✅ Claude Code integration\n- ✅ Live coding demonstration\n\n**⏱️ Duration:** 20 minutes | **👥 By:** Developer Community\n\n[▶️ Watch on YouTube](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=o3qYCyjrFYg)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🛠️ Supported CLI Tools\n\n9Router works seamlessly with all major AI coding tools:\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3ad4c120ed4f.png\" width=\"60\" alt=\"Claude Code\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Claude-Code\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_b0911dab9b3e.png\" width=\"60\" alt=\"OpenClaw\"\u002F>\u003Cbr\u002F>\n        \u003Cb>OpenClaw\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_64de00e34e82.png\" width=\"60\" alt=\"Codex\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Codex\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_a49c1ff46de4.png\" width=\"60\" alt=\"OpenCode\"\u002F>\u003Cbr\u002F>\n        \u003Cb>OpenCode\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c22ce711db4d.png\" width=\"60\" alt=\"Cursor\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Cursor\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_6c238a266a2c.png\" width=\"60\" alt=\"Antigravity\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Antigravity\u003C\u002Fb>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_9ff528de617e.png\" width=\"60\" alt=\"Cline\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Cline\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_83b323446533.png\" width=\"60\" alt=\"Continue\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Continue\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c98812688ef7.png\" width=\"60\" alt=\"Droid\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Droid\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_1199fa40ce16.png\" width=\"60\" alt=\"Roo\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Roo\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_fe6d29a8dfc5.png\" width=\"60\" alt=\"Copilot\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Copilot\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_e6a2360892cb.png\" width=\"60\" alt=\"Kilo Code\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Kilo Code\u003C\u002Fb>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n---\n\n## 🌐 Supported Providers\n\n### 🔐 OAuth Providers\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3ad4c120ed4f.png\" width=\"60\" alt=\"Claude Code\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Claude-Code\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_6c238a266a2c.png\" width=\"60\" alt=\"Antigravity\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Antigravity\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_64de00e34e82.png\" width=\"60\" alt=\"Codex\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Codex\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_fe6d29a8dfc5.png\" width=\"60\" alt=\"GitHub\"\u002F>\u003Cbr\u002F>\n        \u003Cb>GitHub\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c22ce711db4d.png\" width=\"60\" alt=\"Cursor\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Cursor\u003C\u002Fb>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n### 🆓 Free Providers\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_ab757d9499a8.png\" width=\"70\" alt=\"iFlow\"\u002F>\u003Cbr\u002F>\n        \u003Cb>iFlow AI\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>8+ models • Unlimited\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_261714209af8.png\" width=\"70\" alt=\"Qwen\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Qwen Code\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>3+ models • Unlimited\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_43f96254a435.png\" width=\"70\" alt=\"Gemini CLI\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Gemini CLI\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>180K\u002Fmonth FREE\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_651fb5b97f31.png\" width=\"70\" alt=\"Kiro\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Kiro AI\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>Claude • Unlimited\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n### 🔑 API Key Providers (40+)\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_d00e7a5ada98.png\" width=\"50\" alt=\"OpenRouter\"\u002F>\u003Cbr\u002F>\n        \u003Csub>OpenRouter\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c6691efd612c.png\" width=\"50\" alt=\"GLM\"\u002F>\u003Cbr\u002F>\n        \u003Csub>GLM\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_e52081f9336c.png\" width=\"50\" alt=\"Kimi\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Kimi\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_95bf752a9557.png\" width=\"50\" alt=\"MiniMax\"\u002F>\u003Cbr\u002F>\n        \u003Csub>MiniMax\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_d45cee72b40c.png\" width=\"50\" alt=\"OpenAI\"\u002F>\u003Cbr\u002F>\n        \u003Csub>OpenAI\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_1fe88ec77a42.png\" width=\"50\" alt=\"Anthropic\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Anthropic\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_ba829324e325.png\" width=\"50\" alt=\"Gemini\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Gemini\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_dd0e65365c5b.png\" width=\"50\" alt=\"DeepSeek\"\u002F>\u003Cbr\u002F>\n        \u003Csub>DeepSeek\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c4d96c487c18.png\" width=\"50\" alt=\"Groq\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Groq\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_2dd6287e8f47.png\" width=\"50\" alt=\"xAI\"\u002F>\u003Cbr\u002F>\n        \u003Csub>xAI\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3a7215f6bfd7.png\" width=\"50\" alt=\"Mistral\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Mistral\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_d6c7beaaf2c5.png\" width=\"50\" alt=\"Perplexity\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Perplexity\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3fdf6c434a46.png\" width=\"50\" alt=\"Together\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Together AI\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_b28549f92b24.png\" width=\"50\" alt=\"Fireworks\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Fireworks\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_8bcac2a0949a.png\" width=\"50\" alt=\"Cerebras\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Cerebras\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c546feba60f1.png\" width=\"50\" alt=\"Cohere\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Cohere\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_71da7e36f829.png\" width=\"50\" alt=\"NVIDIA\"\u002F>\u003Cbr\u002F>\n        \u003Csub>NVIDIA\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_2789196b578e.png\" width=\"50\" alt=\"SiliconFlow\"\u002F>\u003Cbr\u002F>\n        \u003Csub>SiliconFlow\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n  \u003Cp>\u003Ci>...and 20+ more providers including Nebius, Chutes, Hyperbolic, and custom OpenAI\u002FAnthropic compatible endpoints\u003C\u002Fi>\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n---\n\n## 💡 Key Features\n\n| Feature | What It Does | Why It Matters |\n|---------|--------------|----------------|\n| 🎯 **Smart 3-Tier Fallback** | Auto-route: Subscription → Cheap → Free | Never stop coding, zero downtime |\n| 📊 **Real-Time Quota Tracking** | Live token count + reset countdown | Maximize subscription value |\n| 🔄 **Format Translation** | OpenAI ↔ Claude ↔ Gemini seamless | Works with any CLI tool |\n| 👥 **Multi-Account Support** | Multiple accounts per provider | Load balancing + redundancy |\n| 🔄 **Auto Token Refresh** | OAuth tokens refresh automatically | No manual re-login needed |\n| 🎨 **Custom Combos** | Create unlimited model combinations | Tailor fallback to your needs |\n| 📝 **Request Logging** | Debug mode with full request\u002Fresponse logs | Troubleshoot issues easily |\n| 💾 **Cloud Sync** | Sync config across devices | Same setup everywhere |\n| 📊 **Usage Analytics** | Track tokens, cost, trends over time | Optimize spending |\n| 🌐 **Deploy Anywhere** | Localhost, VPS, Docker, Cloudflare Workers | Flexible deployment options |\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📖 Feature Details\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 🎯 Smart 3-Tier Fallback\n\nCreate combos with automatic fallback:\n\n```\nCombo: \"my-coding-stack\"\n  1. cc\u002Fclaude-opus-4-6        (your subscription)\n  2. glm\u002Fglm-4.7               (cheap backup, $0.6\u002F1M)\n  3. if\u002Fkimi-k2-thinking       (free fallback)\n\n→ Auto switches when quota runs out or errors occur\n```\n\n### 📊 Real-Time Quota Tracking\n\n- Token consumption per provider\n- Reset countdown (5-hour, daily, weekly)\n- Cost estimation for paid tiers\n- Monthly spending reports\n\n### 🔄 Format Translation\n\nSeamless translation between formats:\n- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI Responses**\n- Your CLI tool sends OpenAI format → 9Router translates → Provider receives native format\n- Works with any tool that supports custom OpenAI endpoints\n\n### 👥 Multi-Account Support\n\n- Add multiple accounts per provider\n- Auto round-robin or priority-based routing\n- Fallback to next account when one hits quota\n\n### 🔄 Auto Token Refresh\n\n- OAuth tokens automatically refresh before expiration\n- No manual re-authentication needed\n- Seamless experience across all providers\n\n### 🎨 Custom Combos\n\n- Create unlimited model combinations\n- Mix subscription, cheap, and free tiers\n- Name your combos for easy access\n- Share combos across devices with Cloud Sync\n\n### 📝 Request Logging\n\n- Enable debug mode for full request\u002Fresponse logs\n- Track API calls, headers, and payloads\n- Troubleshoot integration issues\n- Export logs for analysis\n\n### 💾 Cloud Sync\n\n- Sync providers, combos, and settings across devices\n- Automatic background sync\n- Secure encrypted storage\n- Access your setup from anywhere\n\n#### Cloud Runtime Notes\n\n- Prefer server-side cloud variables in production:\n  - `BASE_URL` (internal callback URL used by sync scheduler)\n  - `CLOUD_URL` (cloud sync endpoint base)\n- `NEXT_PUBLIC_BASE_URL` and `NEXT_PUBLIC_CLOUD_URL` are still supported for compatibility\u002FUI, but server runtime now prioritizes `BASE_URL`\u002F`CLOUD_URL`.\n- Cloud sync requests now use timeout + fail-fast behavior to avoid UI hanging when cloud DNS\u002Fnetwork is unavailable.\n\n### 📊 Usage Analytics\n\n- Track token usage per provider and model\n- Cost estimation and spending trends\n- Monthly reports and insights\n- Optimize your AI spending\n\n> **💡 IMPORTANT - Understanding Dashboard Costs:**\n> \n> The \"cost\" displayed in Usage Analytics is **for tracking and comparison purposes only**. \n> 9Router itself **never charges** you anything. You only pay providers directly (if using paid services).\n> \n> **Example:** If your dashboard shows \"$290 total cost\" while using iFlow models, this represents \n> what you would have paid using paid APIs directly. Your actual cost = **$0** (iFlow is free unlimited).\n> \n> Think of it as a \"savings tracker\" showing how much you're saving by using free models or \n> routing through 9Router!\n\n### 🌐 Deploy Anywhere\n\n- 💻 **Localhost** - Default, works offline\n- ☁️ **VPS\u002FCloud** - Share across devices\n- 🐳 **Docker** - One-command deployment\n- 🚀 **Cloudflare Workers** - Global edge network\n\n\u003C\u002Fdetails>\n\n---\n\n## 💰 Pricing at a Glance\n\n| Tier | Provider | Cost | Quota Reset | Best For |\n|------|----------|------|-------------|----------|\n| **💳 SUBSCRIPTION** | Claude Code (Pro) | $20\u002Fmo | 5h + weekly | Already subscribed |\n| | Codex (Plus\u002FPro) | $20-200\u002Fmo | 5h + weekly | OpenAI users |\n| | Gemini CLI | **FREE** | 180K\u002Fmo + 1K\u002Fday | Everyone! |\n| | GitHub Copilot | $10-19\u002Fmo | Monthly | GitHub users |\n| **💰 CHEAP** | GLM-4.7 | $0.6\u002F1M | Daily 10AM | Budget backup |\n| | MiniMax M2.1 | $0.2\u002F1M | 5-hour rolling | Cheapest option |\n| | Kimi K2 | $9\u002Fmo flat | 10M tokens\u002Fmo | Predictable cost |\n| **🆓 FREE** | iFlow | $0 | Unlimited | 8 models free |\n| | Qwen | $0 | Unlimited | 3 models free |\n| | Kiro | $0 | Unlimited | Claude free |\n\n**💡 Pro Tip:** Start with Gemini CLI (180K free\u002Fmonth) + iFlow (unlimited free) combo = $0 cost!\n\n---\n\n### 📊 Understanding 9Router Costs & Billing\n\n**9Router Billing Reality:**\n\n✅ **9Router software = FREE forever** (open source, never charges)  \n✅ **Dashboard \"costs\" = Display\u002Ftracking only** (not actual bills)  \n✅ **You pay providers directly** (subscriptions or API fees)  \n✅ **FREE providers stay FREE** (iFlow, Kiro, Qwen = $0 unlimited)  \n❌ **9Router never sends invoices** or charges your card\n\n**How Cost Display Works:**\n\nThe dashboard shows **estimated costs** as if you were using paid APIs directly. This is **not billing** - it's a comparison tool to show your savings.\n\n**Example Scenario:**\n```\nDashboard Display:\n• Total Requests: 1,662\n• Total Tokens: 47M\n• Display Cost: $290\n\nReality Check:\n• Provider: iFlow (FREE unlimited)\n• Actual Payment: $0.00\n• What $290 Means: Amount you SAVED by using free models!\n```\n\n**Payment Rules:**\n- **Subscription providers** (Claude Code, Codex): Pay them directly via their websites\n- **Cheap providers** (GLM, MiniMax): Pay them directly, 9Router just routes\n- **FREE providers** (iFlow, Kiro, Qwen): Genuinely free forever, no hidden charges\n- **9Router**: Never charges anything, ever\n\n---\n\n## 🎯 Use Cases\n\n### Case 1: \"I have Claude Pro subscription\"\n\n**Problem:** Quota expires unused, rate limits during heavy coding\n\n**Solution:**\n```\nCombo: \"maximize-claude\"\n  1. cc\u002Fclaude-opus-4-6        (use subscription fully)\n  2. glm\u002Fglm-4.7               (cheap backup when quota out)\n  3. if\u002Fkimi-k2-thinking       (free emergency fallback)\n\nMonthly cost: $20 (subscription) + ~$5 (backup) = $25 total\nvs. $20 + hitting limits = frustration\n```\n\n### Case 2: \"I want zero cost\"\n\n**Problem:** Can't afford subscriptions, need reliable AI coding\n\n**Solution:**\n```\nCombo: \"free-forever\"\n  1. gc\u002Fgemini-3-flash         (180K free\u002Fmonth)\n  2. if\u002Fkimi-k2-thinking       (unlimited free)\n  3. qw\u002Fqwen3-coder-plus       (unlimited free)\n\nMonthly cost: $0\nQuality: Production-ready models\n```\n\n### Case 3: \"I need 24\u002F7 coding, no interruptions\"\n\n**Problem:** Deadlines, can't afford downtime\n\n**Solution:**\n```\nCombo: \"always-on\"\n  1. cc\u002Fclaude-opus-4-6        (best quality)\n  2. cx\u002Fgpt-5.2-codex          (second subscription)\n  3. glm\u002Fglm-4.7               (cheap, resets daily)\n  4. minimax\u002FMiniMax-M2.1      (cheapest, 5h reset)\n  5. if\u002Fkimi-k2-thinking       (free unlimited)\n\nResult: 5 layers of fallback = zero downtime\nMonthly cost: $20-200 (subscriptions) + $10-20 (backup)\n```\n\n### Case 4: \"I want FREE AI in OpenClaw\"\n\n**Problem:** Need AI assistant in messaging apps (WhatsApp, Telegram, Slack...), completely free\n\n**Solution:**\n```\nCombo: \"openclaw-free\"\n  1. if\u002Fglm-4.7                (unlimited free)\n  2. if\u002Fminimax-m2.1           (unlimited free)\n  3. if\u002Fkimi-k2-thinking       (unlimited free)\n\nMonthly cost: $0\nAccess via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...\n```\n\n---\n\n## ❓ Frequently Asked Questions\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📊 Why does my dashboard show high costs?\u003C\u002Fb>\u003C\u002Fsummary>\n\nThe dashboard tracks your token usage and displays **estimated costs** as if you were using paid APIs directly. This is **not actual billing** - it's a reference to show how much you're saving by using free models or existing subscriptions through 9Router.\n\n**Example:**\n- **Dashboard shows:** \"$290 total cost\"\n- **Reality:** You're using iFlow (FREE unlimited)\n- **Your actual cost:** **$0.00**\n- **What $290 means:** Amount you **saved** by using free models instead of paid APIs!\n\nThe cost display is a \"savings tracker\" to help you understand your usage patterns and optimization opportunities.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>💳 Will I be charged by 9Router?\u003C\u002Fb>\u003C\u002Fsummary>\n\n**No.** 9Router is free, open-source software that runs on your own computer. It never charges you anything.\n\n**You only pay:**\n- ✅ **Subscription providers** (Claude Code $20\u002Fmo, Codex $20-200\u002Fmo) → Pay them directly on their websites\n- ✅ **Cheap providers** (GLM, MiniMax) → Pay them directly, 9Router just routes your requests\n- ❌ **9Router itself** → **Never charges anything, ever**\n\n9Router is a local proxy\u002Frouter. It doesn't have your credit card, can't send invoices, and has no billing system. It's completely free software.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🆓 Are FREE providers really unlimited?\u003C\u002Fb>\u003C\u002Fsummary>\n\n**Yes!** Providers marked as FREE (iFlow, Kiro, Qwen) are genuinely unlimited with **no hidden charges**. \n\nThese are free services offered by those respective companies:\n- **iFlow**: Free unlimited access to 8+ models via OAuth\n- **Kiro**: Free unlimited Claude models via AWS Builder ID  \n- **Qwen**: Free unlimited access to Qwen models via device auth\n\n9Router just routes your requests to them - there's no \"catch\" or future billing. They're truly free services, and 9Router makes them easy to use with fallback support.\n\n**Note:** Some subscription providers (Antigravity, GitHub Copilot) may have free preview periods that could become paid later, but this would be clearly announced by those providers, not 9Router.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>💰 How do I minimize my actual AI costs?\u003C\u002Fb>\u003C\u002Fsummary>\n\n**Free-First Strategy:**\n\n1. **Start with 100% free combo:**\n   ```\n   1. gc\u002Fgemini-3-flash (180K\u002Fmonth free from Google)\n   2. if\u002Fkimi-k2-thinking (unlimited free from iFlow)\n   3. qw\u002Fqwen3-coder-plus (unlimited free from Qwen)\n   ```\n   **Cost: $0\u002Fmonth**\n\n2. **Add cheap backup** only if you need it:\n   ```\n   4. glm\u002Fglm-4.7 ($0.6\u002F1M tokens)\n   ```\n   **Additional cost: Only pay for what you actually use**\n\n3. **Use subscription providers last:**\n   - Only if you already have them\n   - 9Router helps maximize their value through quota tracking\n\n**Result:** Most users can operate at $0\u002Fmonth using only free tiers!\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📈 What if my usage suddenly spikes?\u003C\u002Fb>\u003C\u002Fsummary>\n\n9Router's smart fallback prevents surprise charges:\n\n**Scenario:** You're on a coding sprint and blow through your quotas\n\n**Without 9Router:**\n- ❌ Hit rate limit → Work stops → Frustration\n- ❌ Or: Accidentally rack up huge API bills\n\n**With 9Router:**\n- ✅ Subscription hits limit → Auto-fallback to cheap tier\n- ✅ Cheap tier gets expensive → Auto-fallback to free tier\n- ✅ Never stop coding → Predictable costs\n\n**You're in control:** Set spending limits per provider in dashboard, and 9Router respects them.\n\n\u003C\u002Fdetails>\n\n---\n\n## 📖 Setup Guide\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🔐 Subscription Providers (Maximize Value)\u003C\u002Fb>\u003C\u002Fsummary>\n\n### Claude Code (Pro\u002FMax)\n\n```bash\nDashboard → Providers → Connect Claude Code\n→ OAuth login → Auto token refresh\n→ 5-hour + weekly quota tracking\n\nModels:\n  cc\u002Fclaude-opus-4-6\n  cc\u002Fclaude-sonnet-4-5-20250929\n  cc\u002Fclaude-haiku-4-5-20251001\n```\n\n**Pro Tip:** Use Opus for complex tasks, Sonnet for speed. 9Router tracks quota per model!\n\n### OpenAI Codex (Plus\u002FPro)\n\n```bash\nDashboard → Providers → Connect Codex\n→ OAuth login (port 1455)\n→ 5-hour + weekly reset\n\nModels:\n  cx\u002Fgpt-5.2-codex\n  cx\u002Fgpt-5.1-codex-max\n```\n\n### Gemini CLI (FREE 180K\u002Fmonth!)\n\n```bash\nDashboard → Providers → Connect Gemini CLI\n→ Google OAuth\n→ 180K completions\u002Fmonth + 1K\u002Fday\n\nModels:\n  gc\u002Fgemini-3-flash-preview\n  gc\u002Fgemini-2.5-pro\n```\n\n**Best Value:** Huge free tier! Use this before paid tiers.\n\n### GitHub Copilot\n\n```bash\nDashboard → Providers → Connect GitHub\n→ OAuth via GitHub\n→ Monthly reset (1st of month)\n\nModels:\n  gh\u002Fgpt-5\n  gh\u002Fclaude-4.5-sonnet\n  gh\u002Fgemini-3-pro\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>💰 Cheap Providers (Backup)\u003C\u002Fb>\u003C\u002Fsummary>\n\n### GLM-4.7 (Daily reset, $0.6\u002F1M)\n\n1. Sign up: [Zhipu AI](https:\u002F\u002Fopen.bigmodel.cn\u002F)\n2. Get API key from Coding Plan\n3. Dashboard → Add API Key:\n   - Provider: `glm`\n   - API Key: `your-key`\n\n**Use:** `glm\u002Fglm-4.7`\n\n**Pro Tip:** Coding Plan offers 3× quota at 1\u002F7 cost! Reset daily 10:00 AM.\n\n### MiniMax M2.1 (5h reset, $0.20\u002F1M)\n\n1. Sign up: [MiniMax](https:\u002F\u002Fwww.minimax.io\u002F)\n2. Get API key\n3. Dashboard → Add API Key\n\n**Use:** `minimax\u002FMiniMax-M2.1`\n\n**Pro Tip:** Cheapest option for long context (1M tokens)!\n\n### Kimi K2 ($9\u002Fmonth flat)\n\n1. Subscribe: [Moonshot AI](https:\u002F\u002Fplatform.moonshot.ai\u002F)\n2. Get API key\n3. Dashboard → Add API Key\n\n**Use:** `kimi\u002Fkimi-latest`\n\n**Pro Tip:** Fixed $9\u002Fmonth for 10M tokens = $0.90\u002F1M effective cost!\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🆓 FREE Providers (Emergency Backup)\u003C\u002Fb>\u003C\u002Fsummary>\n\n### iFlow (8 FREE models)\n\n```bash\nDashboard → Connect iFlow\n→ iFlow OAuth login\n→ Unlimited usage\n\nModels:\n  if\u002Fkimi-k2-thinking\n  if\u002Fqwen3-coder-plus\n  if\u002Fglm-4.7\n  if\u002Fminimax-m2\n  if\u002Fdeepseek-r1\n```\n\n### Qwen (3 FREE models)\n\n```bash\nDashboard → Connect Qwen\n→ Device code authorization\n→ Unlimited usage\n\nModels:\n  qw\u002Fqwen3-coder-plus\n  qw\u002Fqwen3-coder-flash\n```\n\n### Kiro (Claude FREE)\n\n```bash\nDashboard → Connect Kiro\n→ AWS Builder ID or Google\u002FGitHub\n→ Unlimited usage\n\nModels:\n  kr\u002Fclaude-sonnet-4.5\n  kr\u002Fclaude-haiku-4.5\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🎨 Create Combos\u003C\u002Fb>\u003C\u002Fsummary>\n\n### Example 1: Maximize Subscription → Cheap Backup\n\n```\nDashboard → Combos → Create New\n\nName: premium-coding\nModels:\n  1. cc\u002Fclaude-opus-4-6 (Subscription primary)\n  2. glm\u002Fglm-4.7 (Cheap backup, $0.6\u002F1M)\n  3. minimax\u002FMiniMax-M2.1 (Cheapest fallback, $0.20\u002F1M)\n\nUse in CLI: premium-coding\n\nMonthly cost example (100M tokens):\n  80M via Claude (subscription): $0 extra\n  15M via GLM: $9\n  5M via MiniMax: $1\n  Total: $10 + your subscription\n```\n\n### Example 2: Free-Only (Zero Cost)\n\n```\nName: free-combo\nModels:\n  1. gc\u002Fgemini-3-flash-preview (180K free\u002Fmonth)\n  2. if\u002Fkimi-k2-thinking (unlimited)\n  3. qw\u002Fqwen3-coder-plus (unlimited)\n\nCost: $0 forever!\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🔧 CLI Integration\u003C\u002Fb>\u003C\u002Fsummary>\n\n### Cursor IDE\n\n```\nSettings → Models → Advanced:\n  OpenAI API Base URL: http:\u002F\u002Flocalhost:20128\u002Fv1\n  OpenAI API Key: [from 9router dashboard]\n  Model: cc\u002Fclaude-opus-4-6\n```\n\nOr use combo: `premium-coding`\n\n### Claude Code\n\nEdit `~\u002F.claude\u002Fconfig.json`:\n\n```json\n{\n  \"anthropic_api_base\": \"http:\u002F\u002Flocalhost:20128\u002Fv1\",\n  \"anthropic_api_key\": \"your-9router-api-key\"\n}\n```\n\n### Codex CLI\n\n```bash\nexport OPENAI_BASE_URL=\"http:\u002F\u002Flocalhost:20128\"\nexport OPENAI_API_KEY=\"your-9router-api-key\"\n\ncodex \"your prompt\"\n```\n\n### OpenClaw\n\n**Option 1 — Dashboard (recommended):**\n\n```\nDashboard → CLI Tools → OpenClaw → Select Model → Apply\n```\n\n**Option 2 — Manual:** Edit `~\u002F.openclaw\u002Fopenclaw.json`:\n\n```json\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"9router\u002Fif\u002Fglm-4.7\"\n      }\n    }\n  },\n  \"models\": {\n    \"providers\": {\n      \"9router\": {\n        \"baseUrl\": \"http:\u002F\u002F127.0.0.1:20128\u002Fv1\",\n        \"apiKey\": \"sk_9router\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"if\u002Fglm-4.7\",\n            \"name\": \"glm-4.7\"\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n> **Note:** OpenClaw only works with local 9Router. Use `127.0.0.1` instead of `localhost` to avoid IPv6 resolution issues.\n\n### Cline \u002F Continue \u002F RooCode\n\n```\nProvider: OpenAI Compatible\nBase URL: http:\u002F\u002Flocalhost:20128\u002Fv1\nAPI Key: [from dashboard]\nModel: cc\u002Fclaude-opus-4-6\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🚀 Deployment\u003C\u002Fb>\u003C\u002Fsummary>\n\n### VPS Deployment\n\n```bash\n# Clone and install\ngit clone https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router.git\ncd 9router\nnpm install\nnpm run build\n\n# Configure\nexport JWT_SECRET=\"your-secure-secret-change-this\"\nexport INITIAL_PASSWORD=\"your-password\"\nexport DATA_DIR=\"\u002Fvar\u002Flib\u002F9router\"\nexport PORT=\"20128\"\nexport HOSTNAME=\"0.0.0.0\"\nexport NODE_ENV=\"production\"\nexport NEXT_PUBLIC_BASE_URL=\"http:\u002F\u002Flocalhost:20128\"\nexport NEXT_PUBLIC_CLOUD_URL=\"https:\u002F\u002F9router.com\"\nexport API_KEY_SECRET=\"endpoint-proxy-api-key-secret\"\nexport MACHINE_ID_SALT=\"endpoint-proxy-salt\"\n\n# Start\nnpm run start\n\n# Or use PM2\nnpm install -g pm2\npm2 start npm --name 9router -- start\npm2 save\npm2 startup\n```\n\n### Docker\n\n```bash\n# Build image (from repository root)\ndocker build -t 9router .\n\n# Run container (command used in current setup)\ndocker run -d \\\n  --name 9router \\\n  -p 20128:20128 \\\n  --env-file \u002Froot\u002Fdev\u002F9router\u002F.env \\\n  -v 9router-data:\u002Fapp\u002Fdata \\\n  -v 9router-usage:\u002Froot\u002F.9router \\\n  9router\n```\n\nPortable command (if you are already at repository root):\n\n```bash\ndocker run -d \\\n  --name 9router \\\n  -p 20128:20128 \\\n  --env-file .\u002F.env \\\n  -v 9router-data:\u002Fapp\u002Fdata \\\n  -v 9router-usage:\u002Froot\u002F.9router \\\n  9router\n```\n\nContainer defaults:\n- `PORT=20128`\n- `HOSTNAME=0.0.0.0`\n\nUseful commands:\n\n```bash\ndocker logs -f 9router\ndocker restart 9router\ndocker stop 9router && docker rm 9router\n```\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `JWT_SECRET` | `9router-default-secret-change-me` | JWT signing secret for dashboard auth cookie (**change in production**) |\n| `INITIAL_PASSWORD` | `123456` | First login password when no saved hash exists |\n| `DATA_DIR` | `~\u002F.9router` | Main app database location (`db.json`) |\n| `PORT` | framework default | Service port (`20128` in examples) |\n| `HOSTNAME` | framework default | Bind host (Docker defaults to `0.0.0.0`) |\n| `NODE_ENV` | runtime default | Set `production` for deploy |\n| `BASE_URL` | `http:\u002F\u002Flocalhost:20128` | Server-side internal base URL used by cloud sync jobs |\n| `CLOUD_URL` | `https:\u002F\u002F9router.com` | Server-side cloud sync endpoint base URL |\n| `NEXT_PUBLIC_BASE_URL` | `http:\u002F\u002Flocalhost:3000` | Backward-compatible\u002Fpublic base URL (prefer `BASE_URL` for server runtime) |\n| `NEXT_PUBLIC_CLOUD_URL` | `https:\u002F\u002F9router.com` | Backward-compatible\u002Fpublic cloud URL (prefer `CLOUD_URL` for server runtime) |\n| `API_KEY_SECRET` | `endpoint-proxy-api-key-secret` | HMAC secret for generated API keys |\n| `MACHINE_ID_SALT` | `endpoint-proxy-salt` | Salt for stable machine ID hashing |\n| `ENABLE_REQUEST_LOGS` | `false` | Enables request\u002Fresponse logs under `logs\u002F` |\n| `AUTH_COOKIE_SECURE` | `false` | Force `Secure` auth cookie (set `true` behind HTTPS reverse proxy) |\n| `REQUIRE_API_KEY` | `false` | Enforce Bearer API key on `\u002Fv1\u002F*` routes (recommended for internet-exposed deploys) |\n| `HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`, `NO_PROXY` | empty | Optional outbound proxy for upstream provider calls |\n\nNotes:\n- Lowercase proxy variables are also supported: `http_proxy`, `https_proxy`, `all_proxy`, `no_proxy`.\n- `.env` is not baked into Docker image (`.dockerignore`); inject runtime config with `--env-file` or `-e`.\n- On Windows, `APPDATA` can be used for local storage path resolution.\n- `INSTANCE_NAME` appears in older docs\u002Fenv templates, but is currently not used at runtime.\n\n### Runtime Files and Storage\n\n- Main app state: `${DATA_DIR}\u002Fdb.json` (providers, combos, aliases, keys, settings), managed by `src\u002Flib\u002FlocalDb.js`.\n- Usage history and logs: `~\u002F.9router\u002Fusage.json` and `~\u002F.9router\u002Flog.txt`, managed by `src\u002Flib\u002FusageDb.js`.\n- Optional request\u002Ftranslator logs: `\u003Crepo>\u002Flogs\u002F...` when `ENABLE_REQUEST_LOGS=true`.\n- Usage storage currently follows `~\u002F.9router` path logic and is independent from `DATA_DIR`.\n\n\u003C\u002Fdetails>\n\n---\n\n## 📊 Available Models\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>View all available models\u003C\u002Fb>\u003C\u002Fsummary>\n\n**Claude Code (`cc\u002F`)** - Pro\u002FMax:\n- `cc\u002Fclaude-opus-4-6`\n- `cc\u002Fclaude-sonnet-4-5-20250929`\n- `cc\u002Fclaude-haiku-4-5-20251001`\n\n**Codex (`cx\u002F`)** - Plus\u002FPro:\n- `cx\u002Fgpt-5.2-codex`\n- `cx\u002Fgpt-5.1-codex-max`\n\n**Gemini CLI (`gc\u002F`)** - FREE:\n- `gc\u002Fgemini-3-flash-preview`\n- `gc\u002Fgemini-2.5-pro`\n\n**GitHub Copilot (`gh\u002F`)**:\n- `gh\u002Fgpt-5`\n- `gh\u002Fclaude-4.5-sonnet`\n\n**GLM (`glm\u002F`)** - $0.6\u002F1M:\n- `glm\u002Fglm-4.7`\n\n**MiniMax (`minimax\u002F`)** - $0.2\u002F1M:\n- `minimax\u002FMiniMax-M2.1`\n\n**iFlow (`if\u002F`)** - FREE:\n- `if\u002Fkimi-k2-thinking`\n- `if\u002Fqwen3-coder-plus`\n- `if\u002Fdeepseek-r1`\n\n**Qwen (`qw\u002F`)** - FREE:\n- `qw\u002Fqwen3-coder-plus`\n- `qw\u002Fqwen3-coder-flash`\n\n**Kiro (`kr\u002F`)** - FREE:\n- `kr\u002Fclaude-sonnet-4.5`\n- `kr\u002Fclaude-haiku-4.5`\n\n\u003C\u002Fdetails>\n\n---\n\n## 🐛 Troubleshooting\n\n**\"Language model did not provide messages\"**\n- Provider quota exhausted → Check dashboard quota tracker\n- Solution: Use combo fallback or switch to cheaper tier\n\n**Rate limiting**\n- Subscription quota out → Fallback to GLM\u002FMiniMax\n- Add combo: `cc\u002Fclaude-opus-4-6 → glm\u002Fglm-4.7 → if\u002Fkimi-k2-thinking`\n\n**OAuth token expired**\n- Auto-refreshed by 9Router\n- If issues persist: Dashboard → Provider → Reconnect\n\n**High costs**\n- Check usage stats in Dashboard\n- Switch primary model to GLM\u002FMiniMax\n- Use free tier (Gemini CLI, iFlow) for non-critical tasks\n\n**Dashboard opens on wrong port**\n- Set `PORT=20128` and `NEXT_PUBLIC_BASE_URL=http:\u002F\u002Flocalhost:20128`\n\n**First login not working**\n- Check `INITIAL_PASSWORD` in `.env`\n- If unset, fallback password is `123456`\n\n**No request logs under `logs\u002F`**\n- Set `ENABLE_REQUEST_LOGS=true`\n\n---\n\n## 🛠️ Tech Stack\n\n- **Runtime**: Node.js 20+\n- **Framework**: Next.js 16\n- **UI**: React 19 + Tailwind CSS 4\n- **Database**: LowDB (JSON file-based)\n- **Streaming**: Server-Sent Events (SSE)\n- **Auth**: OAuth 2.0 (PKCE) + JWT + API Keys\n\n---\n\n## 📝 API Reference\n\n### Chat Completions\n\n```bash\nPOST http:\u002F\u002Flocalhost:20128\u002Fv1\u002Fchat\u002Fcompletions\nAuthorization: Bearer your-api-key\nContent-Type: application\u002Fjson\n\n{\n  \"model\": \"cc\u002Fclaude-opus-4-6\",\n  \"messages\": [\n    {\"role\": \"user\", \"content\": \"Write a function to...\"}\n  ],\n  \"stream\": true\n}\n```\n\n### List Models\n\n```bash\nGET http:\u002F\u002Flocalhost:20128\u002Fv1\u002Fmodels\nAuthorization: Bearer your-api-key\n\n→ Returns all models + combos in OpenAI format\n```\n\n## 📧 Support\n\n- **Website**: [9router.com](https:\u002F\u002F9router.com)\n- **GitHub**: [github.com\u002Fdecolua\u002F9router](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router)\n- **Issues**: [github.com\u002Fdecolua\u002F9router\u002Fissues](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues)\n\n---\n\n## 👥 Contributors\n\nThanks to all contributors who helped make 9Router better!\n\n[![Contributors](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_88114f6fe51d.png)](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fgraphs\u002Fcontributors)\n\n---\n\n## 📊 Star Chart\n\n[![Star Chart](https:\u002F\u002Fstarchart.cc\u002Fdecolua\u002F9router.svg?variant=adaptive)](https:\u002F\u002Fstarchart.cc\u002Fdecolua\u002F9router)\n\n\n\n## 🔀 Forks\n\n**[OmniRoute](https:\u002F\u002Fgithub.com\u002Fdiegosouzapw\u002FOmniRoute)** — A full-featured TypeScript fork of 9Router. Adds 36+ providers, 4-tier auto-fallback, multi-modal APIs (images, embeddings, audio, TTS), circuit breaker, semantic cache, LLM evaluations, and a polished dashboard. 368+ unit tests. Available via npm and Docker.\n\n---\n\n## 🙏 Acknowledgments\n\nSpecial thanks to **CLIProxyAPI** - the original Go implementation that inspired this JavaScript port.\n\n---\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Csub>Built with ❤️ for developers who code 24\u002F7\u003C\u002Fsub>\n\u003C\u002Fdiv>\n\n","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_62b2dcb0408e.png\" alt=\"9Router仪表盘\" width=\"800\"\u002F>\n  \n  # 9Router - 免费AI路由器\n  \n  **永不停止编码。智能回退，自动路由至免费与低价AI模型。**\n  \n  **将所有AI代码工具（Claude Code、Cursor、Antigravity、Copilot、Codex、Gemini、OpenCode、Cline、OpenClaw等）连接到40多家AI服务提供商及100多种模型。**\n  \n  [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F9router.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F9router)\n  [![下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F9router.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F9router)\n  [![许可证](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fl\u002F9router.svg)](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fblob\u002Fmain\u002FLICENSE)\n  \n  [🚀 快速入门](#-quick-start) • [💡 特性](#-key-features) • [📖 设置指南](#-setup-guide) • [🌐 官网](https:\u002F\u002F9router.com)\n\n  [🇻🇳 越南语](.\u002Fi18n\u002FREADME.vi.md) • [🇨🇳 中文](.\u002Fi18n\u002FREADME.zh-CN.md) • [🇯🇵 日语](.\u002Fi18n\u002FREADME.ja-JP.md)\n\u003C\u002Fdiv>\n\n---\n\n## 🤔 为什么选择9Router？\n\n**停止浪费金钱和遭遇限制：**\n\n- ❌ 每月订阅配额未用完就过期\n- ❌ 速率限制让你在编码途中被迫中断\n- ❌ 昂贵的API费用（每家服务商每月20–50美元）\n- ❌ 需要手动切换不同服务商\n\n**9Router帮你解决这些问题：**\n\n- ✅ **最大化利用订阅**：追踪配额使用情况，在重置前用尽每一分资源\n- ✅ **自动回退机制**：先用订阅额度 → 再用低价模型 → 最后转为免费模型，全程无中断\n- ✅ **多账号支持**：在同一服务商下轮询使用多个账号\n- ✅ **通用兼容性**：适用于Claude Code、Codex、Gemini CLI、Cursor、Cline以及任何命令行工具\n\n---\n\n## 🔄 工作原理\n\n```\n┌─────────────┐\n│ 你的命令行工具 │  (Claude Code、Codex、Gemini CLI、OpenClaw、Cursor、Cline...)\n│   工具      │\n└──────┬──────┘\n       │ http:\u002F\u002Flocalhost:20128\u002Fv1\n       ↓\n┌─────────────────────────────────────────┐\n│           9Router（智能路由器）        │\n│  • 格式转换（OpenAI ↔ Claude）         │\n│  • 配额追踪                           │\n│  • 自动刷新Token                      │\n└──────┬──────────────────────────────────┘\n       │\n       ├─→ [第一层：订阅] Claude Code、Codex、Gemini CLI\n       │   ↓ 配额用尽\n       ├─→ [第二层：低价] GLM（0.6美元\u002F100万token）、MiniMax（0.2美元\u002F100万token）\n       │   ↓ 预算耗尽\n       └─→ [第三层：免费] iFlow、Qwen、Kiro（无限使用）\n\n结果：永不中断编码，成本极低\n```\n\n---\n\n## ⚡ 快速入门\n\n**1. 全局安装：**\n\n```bash\nnpm install -g 9router\n9router\n```\n\n🎉 仪表盘将在`http:\u002F\u002Flocalhost:20128`打开。\n\n**2. 连接一个免费服务商（无需注册）：**\n\n仪表盘 → 服务商 → 连接**Claude Code**或**Antigravity** → OAuth登录 → 完成！\n\n**3. 在你的命令行工具中使用：**\n\n```\nClaude Code\u002FCodex\u002FGemini CLI\u002FOpenClaw\u002FCursor\u002FCline 设置：\n  端点：http:\u002F\u002Flocalhost:20128\u002Fv1\n  API密钥：从仪表盘复制\n  模型：if\u002Fkimi-k2-thinking\n```\n\n**就是这样！** 开始使用免费AI模型进行编码吧。\n\n**另一种方式：从源码运行（本仓库）：**\n\n本仓库中的包是私有的（`9router-app`），因此直接从源码或Docker容器运行是推荐的本地开发方式。\n\n```bash\ncp .env.example .env\nnpm install\nPORT=20128 NEXT_PUBLIC_BASE_URL=http:\u002F\u002Flocalhost:20128 npm run dev\n```\n\n生产模式：\n\n```bash\nnpm run build\nPORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http:\u002F\u002Flocalhost:20128 npm run start\n```\n\n默认URL：\n- 仪表盘：`http:\u002F\u002Flocalhost:20128\u002Fdashboard`\n- OpenAI兼容API：`http:\u002F\u002Flocalhost:20128\u002Fv1`\n\n---\n\n## 🎥 视频教程\n\n\u003Cdiv align=\"center\">\n  \n### 📺 完整设置指南 - 9Router + Claude Code免费版\n  \n[![9Router + Claude Code设置](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c1797c4fb7b2.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=raEyZPg5xE0)\n\n**🎬 观看完整步骤教程：**\n- ✅ 9Router的安装与设置\n- ✅ 免费Claude Sonnet 4.5配置\n- ✅ Claude Code集成\n- ✅ 实时编码演示\n\n**⏱️ 时长：** 20分钟 | **👥 制作：** 开发者社区\n\n[▶️ 在YouTube观看](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=o3qYCyjrFYg)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🛠️ 支持的命令行工具\n\n9Router可无缝对接各大主流AI编程工具：\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3ad4c120ed4f.png\" width=\"60\" alt=\"Claude Code\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Claude-Code\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_b0911dab9b3e.png\" width=\"60\" alt=\"OpenClaw\"\u002F>\u003Cbr\u002F>\n        \u003Cb>OpenClaw\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_64de00e34e82.png\" width=\"60\" alt=\"Codex\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Codex\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_a49c1ff46de4.png\" width=\"60\" alt=\"OpenCode\"\u002F>\u003Cbr\u002F>\n        \u003Cb>OpenCode\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c22ce711db4d.png\" width=\"60\" alt=\"Cursor\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Cursor\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_6c238a266a2c.png\" width=\"60\" alt=\"Antigravity\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Antigravity\u003C\u002Fb>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_9ff528de617e.png\" width=\"60\" alt=\"Cline\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Cline\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_83b323446533.png\" width=\"60\" alt=\"Continue\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Continue\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c98812688ef7.png\" width=\"60\" alt=\"Droid\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Droid\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_1199fa40ce16.png\" width=\"60\" alt=\"Roo\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Roo\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_fe6d29a8dfc5.png\" width=\"60\" alt=\"Copilot\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Copilot\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_e6a2360892cb.png\" width=\"60\" alt=\"Kilo Code\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Kilo Code\u003C\u002Fb>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n---\n\n## 🌐 支持的服务商\n\n### 🔐 OAuth服务商\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3ad4c120ed4f.png\" width=\"60\" alt=\"Claude Code\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Claude-Code\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_6c238a266a2c.png\" width=\"60\" alt=\"Antigravity\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Antigravity\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_64de00e34e82.png\" width=\"60\" alt=\"Codex\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Codex\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_fe6d29a8dfc5.png\" width=\"60\" alt=\"GitHub\"\u002F>\u003Cbr\u002F>\n        \u003Cb>GitHub\u003C\u002Fb>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"120\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c22ce711db4d.png\" width=\"60\" alt=\"Cursor\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Cursor\u003C\u002Fb>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n### 🆓 免费提供商\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_ab757d9499a8.png\" width=\"70\" alt=\"iFlow\"\u002F>\u003Cbr\u002F>\n        \u003Cb>iFlow AI\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>8+ 模型 • 无限使用\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_261714209af8.png\" width=\"70\" alt=\"Qwen\"\u002F>\u003Cbr\u002F>\n        \u003Cb>通义千问代码模型\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>3+ 模型 • 无限使用\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_43f96254a435.png\" width=\"70\" alt=\"Gemini CLI\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Gemini CLI\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>每月18万次免费调用\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"150\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_651fb5b97f31.png\" width=\"70\" alt=\"Kiro\"\u002F>\u003Cbr\u002F>\n        \u003Cb>Kiro AI\u003C\u002Fb>\u003Cbr\u002F>\n        \u003Csub>Claude • 无限使用\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n### 🔑 API密钥提供商（40+）\n\n\u003Cdiv align=\"center\">\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_d00e7a5ada98.png\" width=\"50\" alt=\"OpenRouter\"\u002F>\u003Cbr\u002F>\n        \u003Csub>OpenRouter\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c6691efd612c.png\" width=\"50\" alt=\"GLM\"\u002F>\u003Cbr\u002F>\n        \u003Csub>GLM\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_e52081f9336c.png\" width=\"50\" alt=\"Kimi\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Kimi\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_95bf752a9557.png\" width=\"50\" alt=\"MiniMax\"\u002F>\u003Cbr\u002F>\n        \u003Csub>MiniMax\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_d45cee72b40c.png\" width=\"50\" alt=\"OpenAI\"\u002F>\u003Cbr\u002F>\n        \u003Csub>OpenAI\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_1fe88ec77a42.png\" width=\"50\" alt=\"Anthropic\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Anthropic\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_ba829324e325.png\" width=\"50\" alt=\"Gemini\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Gemini\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_dd0e65365c5b.png\" width=\"50\" alt=\"DeepSeek\"\u002F>\u003Cbr\u002F>\n        \u003Csub>DeepSeek\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c4d96c487c18.png\" width=\"50\" alt=\"Groq\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Groq\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_2dd6287e8f47.png\" width=\"50\" alt=\"xAI\"\u002F>\u003Cbr\u002F>\n        \u003Csub>xAI\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3a7215f6bfd7.png\" width=\"50\" alt=\"Mistral\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Mistral\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_d6c7beaaf2c5.png\" width=\"50\" alt=\"Perplexity\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Perplexity\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_3fdf6c434a46.png\" width=\"50\" alt=\"Together\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Together AI\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_b28549f92b24.png\" width=\"50\" alt=\"Fireworks\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Fireworks\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_8bcac2a0949a.png\" width=\"50\" alt=\"Cerebras\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Cerebras\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_c546feba60f1.png\" width=\"50\" alt=\"Cohere\"\u002F>\u003Cbr\u002F>\n        \u003Csub>Cohere\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_71da7e36f829.png\" width=\"50\" alt=\"NVIDIA\"\u002F>\u003Cbr\u002F>\n        \u003Csub>NVIDIA\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"100\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_2789196b578e.png\" width=\"50\" alt=\"SiliconFlow\"\u002F>\u003Cbr\u002F>\n        \u003Csub>SiliconFlow\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n  \u003Cp>\u003Ci>…以及包括 Nebius、Chutes、Hyperbolic 和自定义 OpenAI\u002FAnthropic 兼容端点在内的 20 多家其他提供商\u003C\u002Fi>\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n---\n\n## 💡 核心功能\n\n| 功能 | 作用 | 重要性 |\n|---------|--------------|----------------|\n| 🎯 **智能三层回退机制** | 自动路由：订阅 → 廉价 → 免费 | 编码不间断，零停机 |\n| 📊 **实时配额跟踪** | 实时令牌计数 + 重置倒计时 | 最大化订阅价值 |\n| 🔄 **格式转换** | OpenAI ↔ Claude ↔ Gemini 无缝切换 | 适用于任何 CLI 工具 |\n| 👥 **多账户支持** | 每个提供商可添加多个账户 | 负载均衡 + 冗余 |\n| 🔄 **自动令牌刷新** | OAuth 令牌自动刷新 | 无需手动重新登录 |\n| 🎨 **自定义组合** | 创建无限种模型组合 | 根据需求定制回退策略 |\n| 📝 **请求日志记录** | 带完整请求\u002F响应日志的调试模式 | 轻松排查问题 |\n| 💾 **云同步** | 在不同设备间同步配置 | 无论在哪里都能保持一致设置 |\n| 📊 **使用情况分析** | 跟踪令牌、成本及趋势 | 优化支出 |\n| 🌐 **随处部署** | 本地主机、VPS、Docker、Cloudflare Workers | 灵活的部署选项 |\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📖 功能详情\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 🎯 智能三层回退机制\n\n创建带有自动回退功能的组合：\n\n```\n组合：“my-coding-stack”\n  1. cc\u002Fclaude-opus-4-6        （您的订阅）\n  2. glm\u002Fglm-4.7               （廉价备份，0.6美元\u002F100万次调用）\n  3. if\u002Fkimi-k2-thinking       （免费回退）\n\n→ 当配额用尽或发生错误时自动切换\n```\n\n### 📊 实时配额跟踪\n\n- 各提供商的令牌消耗量\n- 重置倒计时（5小时、每日、每周）\n- 付费层级的成本估算\n- 每月支出报告\n\n### 🔄 格式转换\n\n在以下格式之间无缝转换：\n- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI 响应**\n- 您的 CLI 工具发送 OpenAI 格式 → 9Router 转换 → 提供商接收原生格式\n- 适用于所有支持自定义 OpenAI 端点的工具\n\n### 👥 多账户支持\n\n- 可为每个提供商添加多个账户\n- 自动轮询或按优先级路由\n- 当一个账户达到配额时自动切换到下一个账户\n\n### 🔄 自动令牌刷新\n\n- OAuth 令牌会在到期前自动刷新\n- 不需要手动重新认证\n- 在所有提供商之间实现无缝体验\n\n### 🎨 自定义组合\n\n- 可创建无限种模型组合\n- 混合订阅、廉价和免费层级\n- 为组合命名以便于访问\n- 通过云同步在不同设备间共享组合\n\n### 📝 请求日志记录\n\n- 启用调试模式以获取完整的请求\u002F响应日志\n- 跟踪 API 调用、头信息和负载\n- 排查集成问题\n- 导出日志进行分析\n\n### 💾 云同步\n\n- 在不同设备间同步提供者、组合和设置\n- 自动后台同步\n- 安全加密存储\n- 随时随地访问你的配置\n\n#### 云运行时说明\n\n- 生产环境中优先使用服务器端云变量：\n  - `BASE_URL`（同步调度器使用的内部回调 URL）\n  - `CLOUD_URL`（云同步端点基础地址）\n- `NEXT_PUBLIC_BASE_URL` 和 `NEXT_PUBLIC_CLOUD_URL` 仍为兼容性和 UI 目的而保留，但服务器运行时现在会优先使用 `BASE_URL`\u002F`CLOUD_URL`。\n- 云同步请求现采用超时 + 快速失败机制，以避免在云端 DNS 或网络不可用时导致 UI 卡死。\n\n### 📊 使用分析\n\n- 跟踪每个提供者和模型的 Token 使用情况\n- 成本估算与支出趋势\n- 每月报告与洞察\n- 优化你的 AI 支出\n\n> **💡 重要提示 - 理解仪表板成本：**\n> \n> 使用分析中显示的“成本”**仅用于跟踪和比较**。  \n> 9Router 本身**从不向你收费**。你只需直接向各提供者支付费用（如果使用的是付费服务）。\n> \n> **示例：** 如果你的仪表板显示使用 iFlow 模型时“总成本 $290”，这代表如果你直接使用付费 API 所需支付的金额。而你的实际成本 = **$0**（iFlow 是免费且无限制的）。\n> \n> 可以把它理解为一个“节省追踪器”，展示你通过使用免费模型或经由 9Router 路由所节省的金额！\n\n### 🌐 部署于任何地方\n\n- 💻 **本地主机** - 默认模式，可离线使用\n- ☁️ **VPS\u002F云服务器** - 多设备共享\n- 🐳 **Docker** - 一键部署\n- 🚀 **Cloudflare Workers** - 全球边缘网络\n\n\u003C\u002Fdetails>\n\n---\n\n## 💰 价格一览\n\n| 层级 | 提供者 | 成本 | 配额重置 | 最适合 |\n|------|----------|------|-------------|----------|\n| **💳 订阅** | Claude Code (Pro) | $20\u002F月 | 5 小时 + 每周 | 已订阅用户 |\n| | Codex (Plus\u002FPro) | $20-200\u002F月 | 5 小时 + 每周 | OpenAI 用户 |\n| | Gemini CLI | **免费** | 18 万\u002F月 + 1 千\u002F天 | 人人适用！ |\n| | GitHub Copilot | $10-19\u002F月 | 每月 | GitHub 用户 |\n| **💰 廉价** | GLM-4.7 | $0.6\u002F100 万 | 每日上午 10 点 | 预算备份 |\n| | MiniMax M2.1 | $0.2\u002F100 万 | 每 5 小时滚动重置 | 最便宜选择 |\n| | Kimi K2 | $9\u002F月 固定 | 每月 1000 万 Token | 成本可预测 |\n| **🆓 免费** | iFlow | $0 | 无限量 | 8 模型免费 |\n| | Qwen | $0 | 无限量 | 3 模型免费 |\n| | Kiro | $0 | 无限量 | Claude 免费 |\n\n**💡 专家提示：** 从 Gemini CLI（每月免费 18 万）+ iFlow（无限免费）组合开始，成本为 $0！\n\n---\n\n### 📊 理解 9Router 的成本与计费\n\n**9Router 计费真相：**\n\n✅ **9Router 软件 = 永远免费**（开源，从不收费）  \n✅ **仪表板“成本”= 仅用于显示和跟踪**（并非实际账单）  \n✅ **你直接向提供者付款**（订阅费或 API 费）  \n✅ **免费提供者始终免费**（iFlow、Kiro、Qwen = $0 无限量）  \n❌ **9Router 从不发送发票**或扣款\n\n**成本显示原理：**\n\n仪表板显示的是**估算成本**，假设你直接使用了付费 API。这**不是真正的计费**，而是一个用来对比并显示你节省了多少的工具。\n\n**示例场景：**\n```\n仪表板显示：\n• 总请求数：1,662\n• 总 Token 数：4700 万\n• 显示成本：$290\n\n实际情况：\n• 提供者：iFlow（免费且无限量）\n• 实际支付：$0.00\n• $290 的含义：你因使用免费模型而节省的金额！\n```\n\n**支付规则：**\n- **订阅类提供者**（Claude Code、Codex）：直接通过其官网支付\n- **廉价提供者**（GLM、MiniMax）：直接支付给对应提供者，9Router 只负责路由\n- **免费提供者**（iFlow、Kiro、Qwen）：真正永久免费，无任何隐藏费用\n- **9Router**：永远不收取任何费用\n\n---\n\n## 🎯 使用场景\n\n### 场景 1：“我有 Claude Pro 订阅”\n\n**问题：** 配额未用完就过期，高强度编码时经常遇到速率限制\n\n**解决方案：**\n```\n组合：“maximize-claude”\n  1. cc\u002Fclaude-opus-4-6        （充分利用订阅配额）\n  2. glm\u002Fglm-4.7               （当配额用尽时的廉价备份）\n  3. if\u002Fkimi-k2-thinking       （免费应急兜底）\n\n月度成本：$20（订阅）+ ~$5（备份）= 总计 $25  \n vs. $20 并不断遭遇限流 = 极大困扰\n```\n\n### 场景 2：“我想完全零成本”\n\n**问题：** 无力承担订阅费用，但需要可靠的 AI 编码助手\n\n**解决方案：**\n```\n组合：“free-forever”\n  1. gc\u002Fgemini-3-flash         （每月免费 18 万）\n  2. if\u002Fkimi-k2-thinking       （无限免费）\n  3. qw\u002Fqwen3-coder-plus       （无限免费）\n\n月度成本：$0  \n质量：生产级可用模型\n```\n\n### 场景 3：“我需要 24\u002F7 不间断编码”\n\n**问题：** 截止日期紧迫，无法承受任何停机时间\n\n**解决方案：**\n```\n组合：“always-on”\n  1. cc\u002Fclaude-opus-4-6        （最佳质量）\n  2. cx\u002Fgpt-5.2-codex          （第二份订阅）\n  3. glm\u002Fglm-4.7               （廉价，每日重置）\n  4. minimax\u002FMiniMax-M2.1      （最便宜，每 5 小时重置）\n  5. if\u002Fkimi-k2-thinking       （免费且无限）\n\n结果：五层兜底保障 = 零停机  \n月度成本：$20-200（订阅）+ $10-20（备份）\n```\n\n### 场景 4：“我想在 OpenClaw 中使用免费 AI”\n\n**问题：** 需要在消息应用（WhatsApp、Telegram、Slack 等）中使用完全免费的 AI 助手\n\n**解决方案：**\n```\n组合：“openclaw-free”\n  1. if\u002Fglm-4.7                （无限免费）\n  2. if\u002Fminimax-m2.1           （无限免费）\n  3. if\u002Fkimi-k2-thinking       （无限免费）\n\n月度成本：$0  \n可通过：WhatsApp、Telegram、Slack、Discord、iMessage、Signal… 访问\n```\n\n---\n\n## ❓ 常见问题\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📊 为什么我的仪表板显示高额费用？\u003C\u002Fb>\u003C\u002Fsummary>\n\n仪表板会跟踪您的 Token 使用情况，并以**估算费用**的形式展示，就好像您直接使用了付费 API 一样。这**并非实际账单**——它只是一个参考，用来显示您通过 9Router 使用免费模型或现有订阅节省了多少费用。\n\n**示例：**\n- **仪表板显示：** “总费用 $290”\n- **实际情况：** 您正在使用 iFlow（免费无限量）\n- **您的实际费用：** **$0.00**\n- **$290 的含义：** 如果您没有使用免费模型而改用付费 API，您将节省的金额！\n\n费用显示是一个“节省追踪器”，旨在帮助您了解自己的使用模式和优化机会。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>💳 9Router 会向我收费吗？\u003C\u002Fb>\u003C\u002Fsummary>\n\n**不会。** 9Router 是一款免费的开源软件，运行在您自己的电脑上。它绝不会向您收取任何费用。\n\n**您只需支付：**\n- ✅ **订阅服务提供商**（Claude Code $20\u002F月，Codex $20–200\u002F月）→ 直接在它们的官网上付款\n- ✅ **低价服务提供商**（GLM、MiniMax）→ 直接向它们付款，9Router 只是路由您的请求\n- ❌ **9Router 本身** → **永远不会收费**\n\n9Router 是一个本地代理\u002F路由器，它不保存您的信用卡信息，无法发送账单，也没有任何计费系统。它完全是一款免费软件。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🆓 免费的服务提供商真的无限量吗？\u003C\u002Fb>\u003C\u002Fsummary>\n\n**是的！** 标记为 FREE 的服务提供商（iFlow、Kiro、Qwen）确实是真正意义上的无限量，**没有任何隐藏费用**。\n\n这些是由相应公司提供的免费服务：\n- **iFlow：** 通过 OAuth 提供 8+ 种模型的免费无限访问权限\n- **Kiro：** 通过 AWS Builder ID 提供 Claude 模型的免费无限访问权限\n- **Qwen：** 通过设备认证提供 Qwen 模型的免费无限访问权限\n\n9Router 只是将您的请求路由到这些服务提供商处——不存在任何“陷阱”或未来的收费。它们确实是真正的免费服务，而 9Router 让您能够轻松使用这些服务，并提供后备支持。\n\n**注意：** 一些订阅服务提供商（Antigravity、GitHub Copilot）可能会有免费试用期，之后转为付费，但这种情况会由这些服务提供商明确告知，而不是由 9Router 宣布。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>💰 如何最大限度地降低我的 AI 实际成本？\u003C\u002Fb>\u003C\u002Fsummary>\n\n**“免费优先”策略：**\n\n1. **从 100% 免费组合开始：**\n   ```\n   1. gc\u002Fgemini-3-flash（Google 提供每月 18 万次免费调用）\n   2. if\u002Fkimi-k2-thinking（iFlow 提供的免费无限模型）\n   3. qw\u002Fqwen3-coder-plus（Qwen 提供的免费无限模型）\n   ```\n   **成本：$0\u002F月**\n\n2. **仅在需要时添加低价备份：**\n   ```\n   4. glm\u002Fglm-4.7（每 100 万 Token 仅需 $0.6）\n   ```\n   **额外成本：仅按实际用量付费**\n\n3. **最后才使用订阅服务提供商：**\n   - 仅在您已经拥有这些服务的情况下使用\n   - 9Router 通过配额跟踪帮助您最大化其价值\n\n**结果：** 大多数用户仅使用免费层级即可实现零成本运行！\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📈 如果我的使用量突然激增怎么办？\u003C\u002Fb>\u003C\u002Fsummary>\n\n9Router 的智能回退机制可以防止意外产生高额费用：\n\n**场景：** 您正在进行编码冲刺，迅速耗尽了所有配额。\n\n**如果没有 9Router：**\n- ❌ 达到速率限制 → 工作停止 → 极度沮丧\n- ❌ 或者：不小心产生巨额 API 费用\n\n**有了 9Router：**\n- ✅ 订阅服务达到限制 → 自动回退到低价层级\n- ✅ 低价层级费用过高 → 自动回退到免费层级\n- ✅ 编码工作从未中断 → 成本可控\n\n**您可以完全掌控：** 在仪表板中为每个服务提供商设置支出上限，9Router 会严格遵守这些限制。\n\n\u003C\u002Fdetails>\n\n---\n\n## 📖 设置指南\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🔐 订阅服务提供商（最大化价值）\u003C\u002Fb>\u003C\u002Fsummary>\n\n### Claude Code (Pro\u002FMax)\n\n```bash\n仪表板 → 服务提供商 → 连接 Claude Code\n→ OAuth 登录 → 自动刷新 Token\n→ 5 小时 + 每周配额跟踪\n\n模型：\n  cc\u002Fclaude-opus-4-6\n  cc\u002Fclaude-sonnet-4-5-20250929\n  cc\u002Fclaude-haiku-4-5-20251001\n```\n\n**实用技巧：** 对于复杂任务使用 Opus，对于速度要求高的任务使用 Sonnet。9Router 会分别跟踪每个模型的配额！\n\n### OpenAI Codex (Plus\u002FPro)\n\n```bash\n仪表板 → 服务提供商 → 连接 Codex\n→ OAuth 登录（端口 1455）\n→ 5 小时 + 每周重置\n\n模型：\n  cx\u002Fgpt-5.2-codex\n  cx\u002Fgpt-5.1-codex-max\n```\n\n### Gemini CLI（每月免费 18 万次调用！）\n\n```bash\n仪表板 → 服务提供商 → 连接 Gemini CLI\n→ Google OAuth\n→ 每月 18 万次完成 + 每日 1 千次\n\n模型：\n  gc\u002Fgemini-3-flash-preview\n  gc\u002Fgemini-2.5-pro\n```\n\n**最佳选择：** 海量的免费额度！请务必先使用这一层级，再考虑付费层级。\n\n### GitHub Copilot\n\n```bash\n仪表板 → 服务提供商 → 连接 GitHub\n→ 通过 GitHub 进行 OAuth 登录\n→ 每月 1 日重置\n\n模型：\n  gh\u002Fgpt-5\n  gh\u002Fclaude-4.5-sonnet\n  gh\u002Fgemini-3-pro\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>💰 低价服务提供商（备用方案）\u003C\u002Fb>\u003C\u002Fsummary>\n\n### GLM-4.7（每日重置，每 100 万 Token $0.6）\n\n1. 注册：[Zhipu AI](https:\u002F\u002Fopen.bigmodel.cn\u002F)\n2. 从 Coding Plan 获取 API 密钥\n3. 仪表板 → 添加 API 密钥：\n   - 服务提供商：`glm`\n   - API 密钥：`your-key`\n\n**使用：** `glm\u002Fglm-4.7`\n\n**实用技巧：** Coding Plan 提供 3 倍配额，但价格仅为原价的七分之一！每天上午 10 点重置。\n\n### MiniMax M2.1（5 小时重置，每 100 万 Token $0.20）\n\n1. 注册：[MiniMax](https:\u002F\u002Fwww.minimax.io\u002F)\n2. 获取 API 密钥\n3. 仪表板 → 添加 API 密钥\n\n**使用：** `minimax\u002FMiniMax-M2.1`\n\n**实用技巧：** 长上下文（100 万 Token）的最佳廉价选择！\n\n### Kimi K2（每月固定 $9）\n\n1. 订阅：[Moonshot AI](https:\u002F\u002Fplatform.moonshot.ai\u002F)\n2. 获取 API 密钥\n3. 仪表板 → 添加 API 密钥\n\n**使用：** `kimi\u002Fkimi-latest`\n\n**实用技巧：** 每月固定 $9 即可获得 1000 万 Token，相当于每 100 万 Token 仅需 $0.90！\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🆓 免费服务提供商（紧急备用）\u003C\u002Fb>\u003C\u002Fsummary>\n\n### iFlow（8 种免费模型）\n\n```bash\n仪表板 → 连接 iFlow\n→ iFlow OAuth 登录\n→ 无限量使用\n\n模型：\n  if\u002Fkimi-k2-thinking\n  if\u002Fqwen3-coder-plus\n  if\u002Fglm-4.7\n  if\u002Fminimax-m2\n  if\u002Fdeepseek-r1\n```\n\n### Qwen（3 种免费模型）\n\n```bash\n仪表板 → 连接 Qwen\n→ 设备代码授权\n→ 无限量使用\n\n模型：\n  qw\u002Fqwen3-coder-plus\n  qw\u002Fqwen3-coder-flash\n```\n\n### Kiro（Claude 免费版）\n\n```bash\n仪表板 → 连接 Kiro\n→ AWS Builder ID 或 Google\u002FGitHub\n→ 无限量使用\n\n模型：\n  kr\u002Fclaude-sonnet-4.5\n  kr\u002Fclaude-haiku-4.5\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🎨 创建组合\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 示例 1：最大化订阅服务 → 低价备份\n\n```\n仪表板 → 组合 → 新建\n\n名称：premium-coding\n模型：\n  1. cc\u002Fclaude-opus-4-6（订阅服务主模型）\n  2. glm\u002Fglm-4.7（低价备份，每 100 万 Token $0.6）\n  3. minimax\u002FMiniMax-M2.1（最便宜的回退选项，每 100 万 Token $0.20）\n\n在 CLI 中使用：premium-coding\n\n每月费用示例（100 万 Token）：\n  80 万次通过 Claude（订阅服务）：无需额外费用\n  15 万次通过 GLM：$9\n  5 万次通过 MiniMax：$1\n  总计：$10 加上您的订阅费用\n```\n\n### 示例 2：纯免费组合（零成本）\n\n```\n名称：free-combo\n模型：\n  1. gc\u002Fgemini-3-flash-preview（每月 18 万次免费调用）\n  2. if\u002Fkimi-k2-thinking（无限量）\n  3. qw\u002Fqwen3-coder-plus（无限量）\n\n成本：永远 $0！\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🔧 CLI 集成\u003C\u002Fb>\u003C\u002Fsummary>\n\n### Cursor IDE\n\n```\n设置 → 模型 → 高级：\n  OpenAI API 基础 URL：http:\u002F\u002Flocalhost:20128\u002Fv1\n  OpenAI API 密钥：[来自 9router 仪表板]\n  模型：cc\u002Fclaude-opus-4-6\n```\n\n或者使用组合：`premium-coding`\n\n### Claude Code\n\n编辑 `~\u002F.claude\u002Fconfig.json`：\n\n```json\n{\n  \"anthropic_api_base\": \"http:\u002F\u002Flocalhost:20128\u002Fv1\",\n  \"anthropic_api_key\": \"your-9router-api-key\"\n}\n```\n\n### Codex CLI\n\n```bash\nexport OPENAI_BASE_URL=\"http:\u002F\u002Flocalhost:20128\"\nexport OPENAI_API_KEY=\"your-9router-api-key\"\n\ncodex \"your prompt\"\n```\n\n### OpenClaw\n\n**选项 1 — 控制面板（推荐）：**\n\n```\n控制面板 → CLI 工具 → OpenClaw → 选择模型 → 应用\n```\n\n**选项 2 — 手动：** 编辑 `~\u002F.openclaw\u002Fopenclaw.json`：\n\n```json\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"9router\u002Fif\u002Fglm-4.7\"\n      }\n    }\n  },\n  \"models\": {\n    \"providers\": {\n      \"9router\": {\n        \"baseUrl\": \"http:\u002F\u002F127.0.0.1:20128\u002Fv1\",\n        \"apiKey\": \"sk_9router\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"if\u002Fglm-4.7\",\n            \"name\": \"glm-4.7\"\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n> **注意：** OpenClaw 只适用于本地的 9Router。为避免 IPv6 解析问题，请使用 `127.0.0.1` 而不是 `localhost`。\n\n### Cline \u002F Continue \u002F RooCode\n\n```\n提供商：兼容 OpenAI\n基础 URL：http:\u002F\u002Flocalhost:20128\u002Fv1\nAPI 密钥：[来自控制面板]\n模型：cc\u002Fclaude-opus-4-6\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🚀 部署\u003C\u002Fb>\u003C\u002Fsummary>\n\n### VPS 部署\n\n```bash\n# 克隆并安装\ngit clone https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router.git\ncd 9router\nnpm install\nnpm run build\n\n# 配置\nexport JWT_SECRET=\"your-secure-secret-change-this\"\nexport INITIAL_PASSWORD=\"your-password\"\nexport DATA_DIR=\"\u002Fvar\u002Flib\u002F9router\"\nexport PORT=\"20128\"\nexport HOSTNAME=\"0.0.0.0\"\nexport NODE_ENV=\"production\"\nexport NEXT_PUBLIC_BASE_URL=\"http:\u002F\u002Flocalhost:20128\"\nexport NEXT_PUBLIC_CLOUD_URL=\"https:\u002F\u002F9router.com\"\nexport API_KEY_SECRET=\"endpoint-proxy-api-key-secret\"\nexport MACHINE_ID_SALT=\"endpoint-proxy-salt\"\n\n# 启动\nnpm run start\n\n# 或者使用 PM2\nnpm install -g pm2\npm2 start npm --name 9router -- start\npm2 save\npm2 startup\n```\n\n### Docker\n\n```bash\n# 构建镜像（从仓库根目录）\ndocker build -t 9router .\n\n# 运行容器（当前设置中使用的命令）\ndocker run -d \\\n  --name 9router \\\n  -p 20128:20128 \\\n  --env-file \u002Froot\u002Fdev\u002F9router\u002F.env \\\n  -v 9router-data:\u002Fapp\u002Fdata \\\n  -v 9router-usage:\u002Froot\u002F.9router \\\n  9router\n```\n\n便携式命令（如果您已经在仓库根目录下）：\n\n```bash\ndocker run -d \\\n  --name 9router \\\n  -p 20128:20128 \\\n  --env-file .\u002F.env \\\n  -v 9router-data:\u002Fapp\u002Fdata \\\n  -v 9router-usage:\u002Froot\u002F.9router \\\n  9router\n```\n\n容器默认值：\n- `PORT=20128`\n- `HOSTNAME=0.0.0.0`\n\n常用命令：\n\n```bash\ndocker logs -f 9router\ndocker restart 9router\ndocker stop 9router && docker rm 9router\n```\n\n### 环境变量\n\n| 变量 | 默认值 | 描述 |\n|----------|---------|-------------|\n| `JWT_SECRET` | `9router-default-secret-change-me` | 用于控制面板认证 Cookie 的 JWT 签名密钥（**生产环境中请更改**） |\n| `INITIAL_PASSWORD` | `123456` | 当没有保存的哈希时，首次登录密码 |\n| `DATA_DIR` | `~\u002F.9router` | 主应用程序数据库位置 (`db.json`) |\n| `PORT` | 框架默认值 | 服务端口（示例中为 `20128`） |\n| `HOSTNAME` | 框架默认值 | 绑定主机（Docker 默认为 `0.0.0.0`） |\n| `NODE_ENV` | 运行时默认值 | 部署时设置为 `production` |\n| `BASE_URL` | `http:\u002F\u002Flocalhost:20128` | 服务器端内部基础 URL，用于云同步任务 |\n| `CLOUD_URL` | `https:\u002F\u002F9router.com` | 服务器端云同步端点基础 URL |\n| `NEXT_PUBLIC_BASE_URL` | `http:\u002F\u002Flocalhost:3000` | 向后兼容\u002F公开的基础 URL（建议在服务器运行时使用 `BASE_URL`） |\n| `NEXT_PUBLIC_CLOUD_URL` | `https:\u002F\u002F9router.com` | 向后兼容\u002F公开的云 URL（建议在服务器运行时使用 `CLOUD_URL`） |\n| `API_KEY_SECRET` | `endpoint-proxy-api-key-secret` | 用于生成 API 密钥的 HMAC 密钥 |\n| `MACHINE_ID_SALT` | `endpoint-proxy-salt` | 用于稳定机器 ID 哈希的盐 |\n| `ENABLE_REQUEST_LOGS` | `false` | 在 `logs\u002F` 目录下启用请求\u002F响应日志 |\n| `AUTH_COOKIE_SECURE` | `false` | 强制使用 `Secure` 认证 Cookie（在 HTTPS 反向代理后设置为 `true`） |\n| `REQUIRE_API_KEY` | `false` | 对 `\u002Fv1\u002F*` 路由强制要求 Bearer API 密钥（建议在面向互联网的部署中启用） |\n| `HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`, `NO_PROXY` | 空 | 上游提供商调用的可选出站代理 |\n\n注：\n- 小写代理变量同样支持：`http_proxy`, `https_proxy`, `all_proxy`, `no_proxy`。\n- `.env` 文件不会被烘焙到 Docker 镜像中（`.dockerignore`）；请使用 `--env-file` 或 `-e` 注入运行时配置。\n- 在 Windows 上，可以使用 `APPDATA` 来解析本地存储路径。\n- `INSTANCE_NAME` 出现在旧版文档\u002F环境模板中，但目前在运行时并未使用。\n\n### 运行时文件和存储\n\n- 主应用程序状态：`${DATA_DIR}\u002Fdb.json`（提供商、组合、别名、密钥、设置），由 `src\u002Flib\u002FlocalDb.js` 管理。\n- 使用历史和日志：`~\u002F.9router\u002Fusage.json` 和 `~\u002F.9router\u002Flog.txt`，由 `src\u002Flib\u002FusageDb.js` 管理。\n- 可选的请求\u002F翻译日志：当 `ENABLE_REQUEST_LOGS=true` 时，位于 `\u003Crepo>\u002Flogs\u002F...`。\n- 使用存储目前遵循 `~\u002F.9router` 路径逻辑，与 `DATA_DIR` 独立。\n\n\u003C\u002Fdetails>\n\n---\n\n## 📊 可用模型\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看所有可用模型\u003C\u002Fb>\u003C\u002Fsummary>\n\n**Claude Code (`cc\u002F`)** - Pro\u002FMax：\n- `cc\u002Fclaude-opus-4-6`\n- `cc\u002Fclaude-sonnet-4-5-20250929`\n- `cc\u002Fclaude-haiku-4-5-20251001`\n\n**Codex (`cx\u002F`)** - Plus\u002FPro：\n- `cx\u002Fgpt-5.2-codex`\n- `cx\u002Fgpt-5.1-codex-max`\n\n**Gemini CLI (`gc\u002F`)** - 免费：\n- `gc\u002Fgemini-3-flash-preview`\n- `gc\u002Fgemini-2.5-pro`\n\n**GitHub Copilot (`gh\u002F`)**：\n- `gh\u002Fgpt-5`\n- `gh\u002Fclaude-4.5-sonnet`\n\n**GLM (`glm\u002F`)** - $0.6\u002F1M：\n- `glm\u002Fglm-4.7`\n\n**MiniMax (`minimax\u002F`)** - $0.2\u002F1M：\n- `minimax\u002FMiniMax-M2.1`\n\n**iFlow (`if\u002F`)** - 免费：\n- `if\u002Fkimi-k2-thinking`\n- `if\u002Fqwen3-coder-plus`\n- `if\u002Fdeepseek-r1`\n\n**Qwen (`qw\u002F`)** - 免费：\n- `qw\u002Fqwen3-coder-plus`\n- `qw\u002Fqwen3-coder-flash`\n\n**Kiro (`kr\u002F`)** - 免费：\n- `kr\u002Fclaude-sonnet-4.5`\n- `kr\u002Fclaude-haiku-4.5`\n\n\u003C\u002Fdetails>\n\n---\n\n## 🐛 故障排除\n\n**“语言模型未提供消息”**\n- 提供商配额已用尽 → 检查控制面板的配额跟踪器\n- 解决方案：使用组合回退或切换到更便宜的层级\n\n**速率限制**\n- 订阅配额用尽 → 回退到 GLM\u002FMiniMax\n- 添加组合：`cc\u002Fclaude-opus-4-6 → glm\u002Fglm-4.7 → if\u002Fkimi-k2-thinking`\n\n**OAuth 令牌过期**\n- 9Router 会自动刷新\n- 如果问题仍然存在：控制面板 → 提供商 → 重新连接\n\n**成本过高**\n- 检查控制面板中的使用统计信息\n- 将主模型切换到 GLM\u002FMiniMax\n- 对于非关键任务，使用免费层级（Gemini CLI、iFlow）\n\n**控制面板打开在错误的端口上**\n- 设置 `PORT=20128` 和 `NEXT_PUBLIC_BASE_URL=http:\u002F\u002Flocalhost:20128`\n\n**首次登录不起作用**\n- 检查 `.env` 中的 `INITIAL_PASSWORD`\n- 如果未设置，回退密码为 `123456`\n\n**`logs\u002F` 目录下没有请求日志**\n- 设置 `ENABLE_REQUEST_LOGS=true`\n\n---\n\n## 🛠️ 技术栈\n\n- **运行时**: Node.js 20+\n- **框架**: Next.js 16\n- **UI**: React 19 + Tailwind CSS 4\n- **数据库**: LowDB（基于 JSON 文件）\n- **流式传输**: 服务器发送事件 (SSE)\n- **认证**: OAuth 2.0 (PKCE) + JWT + API 密钥\n\n---\n\n## 📝 API 参考\n\n### 聊天补全\n\n```bash\nPOST http:\u002F\u002Flocalhost:20128\u002Fv1\u002Fchat\u002Fcompletions\nAuthorization: Bearer your-api-key\nContent-Type: application\u002Fjson\n\n{\n  \"model\": \"cc\u002Fclaude-opus-4-6\",\n  \"messages\": [\n    {\"role\": \"user\", \"content\": \"写一个函数来...\"}\n  ],\n  \"stream\": true\n}\n```\n\n### 列出模型\n\n```bash\nGET http:\u002F\u002Flocalhost:20128\u002Fv1\u002Fmodels\nAuthorization: Bearer your-api-key\n\n→ 返回所有模型及组合，格式与 OpenAI 一致\n```\n\n## 📧 支持\n\n- **官网**: [9router.com](https:\u002F\u002F9router.com)\n- **GitHub**: [github.com\u002Fdecolua\u002F9router](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router)\n- **问题追踪**: [github.com\u002Fdecolua\u002F9router\u002Fissues](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues)\n\n---\n\n## 👥 贡献者\n\n感谢所有帮助使 9Router 更加完善的贡献者！\n\n[![贡献者](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_readme_88114f6fe51d.png)](https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fgraphs\u002Fcontributors)\n\n---\n\n## 📊 星级图\n\n[![星级图](https:\u002F\u002Fstarchart.cc\u002Fdecolua\u002F9router.svg?variant=adaptive)](https:\u002F\u002Fstarchart.cc\u002Fdecolua\u002F9router)\n\n\n\n## 🔀 分支\n\n**[OmniRoute](https:\u002F\u002Fgithub.com\u002Fdiegosouzapw\u002FOmniRoute)** — 9Router 的一个功能齐全的 TypeScript 分支。新增了 36 多个提供商、四层自动回退机制、多模态 API（图像、嵌入、音频、TTS）、熔断器、语义缓存、LLM 评估以及一个精美的仪表盘。包含 368 多个单元测试，并可通过 npm 和 Docker 获取。\n\n---\n\n## 🙏 致谢\n\n特别感谢 **CLIProxyAPI** - 这是最初的 Go 实现，启发了本次 JavaScript 移植工作。\n\n---\n\n## 📄 许可证\n\nMIT 许可证 - 详情请参阅 [LICENSE](LICENSE)。\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Csub>专为全天候编码的开发者打造 ❤️\u003C\u002Fsub>\n\u003C\u002Fdiv>","# 9Router 快速上手指南\n\n9Router 是一款免费的 AI 路由工具，旨在帮助开发者将各类 AI 编程助手（如 Claude Code、Cursor、Cline 等）连接至 40+ 提供商和 100+ 模型。它支持智能故障转移（从订阅版自动降级至廉价或免费模型），最大化利用配额，确保持续编码不中断。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Windows、macOS 或 Linux\n*   **前置依赖**：已安装 [Node.js](https:\u002F\u002Fnodejs.org\u002F) (建议版本 v18 或更高) 和 `npm` 包管理器\n*   **网络环境**：需能访问目标 AI 提供商接口（若使用国内模型如 Kimi、GLM、Qwen 等通常无需特殊网络配置；若使用海外服务请自行解决网络连通性）\n\n## 安装步骤\n\n推荐使用 npm 全局安装，以便在任何终端直接调用。\n\n1.  **全局安装 9Router**：\n    ```bash\n    npm install -g 9router\n    ```\n    > 💡 **国内加速提示**：如果下载速度较慢，可临时切换至国内镜像源：\n    > ```bash\n    > npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n    > npm install -g 9router\n    > ```\n\n2.  **启动服务**：\n    安装完成后，运行以下命令启动 9Router：\n    ```bash\n    9router\n    ```\n\n3.  **访问管理面板**：\n    服务启动后，在浏览器打开默认仪表盘地址：\n    `http:\u002F\u002Flocalhost:20128`\n\n## 基本使用\n\n完成安装后，只需三步即可让您的 AI 工具用上免费或低成本模型：\n\n### 第一步：连接提供商\n在打开的 Dashboard (`http:\u002F\u002Flocalhost:20128`) 中：\n1.  点击左侧菜单 **Providers**。\n2.  选择 **Connect** 一个免费提供商（例如 **Claude Code**、**Antigravity** 或 **iFlow**）。\n3.  按照提示完成 OAuth 登录授权（部分免费提供商无需注册即可直接使用）。\n\n### 第二步：获取配置信息\n在 Dashboard 首页或 API Keys 页面，复制生成的 **API Key**。\n\n### 第三步：配置您的 AI 编程工具\n在您常用的 CLI 工具（如 Claude Code, Cursor, Cline, Codex 等）的设置中，修改以下三项：\n\n*   **Endpoint (API 地址)**: `http:\u002F\u002Flocalhost:20128\u002Fv1`\n*   **API Key**: `[粘贴从 Dashboard 复制的 Key]`\n*   **Model**: 输入您想使用的模型名称（例如 `if\u002Fkimi-k2-thinking` 或 `qwen\u002Fqwen-2.5-coder`）\n\n**配置示例 (以 Claude Code 为例):**\n```bash\nclaude config set endpoint http:\u002F\u002Flocalhost:20128\u002Fv1\nclaude config set api_key \u003Cyour_copied_key>\nclaude config set model if\u002Fkimi-k2-thinking\n```\n\n配置完成后，即可开始使用。9Router 会自动监控配额，当当前模型用完时，无缝切换至下一梯队的廉价或免费模型，确保您的编码工作流永不中断。","某全栈开发者正利用 Claude Code 和 Cursor 进行高强度的夜间项目冲刺，需要在有限预算下连续生成大量代码并修复复杂 Bug。\n\n### 没有 9router 时\n- **编码频繁中断**：主力账号的订阅配额在深夜耗尽，触发速率限制，导致自动补全和对话突然停止，打断心流。\n- **资金浪费严重**：每月支付的昂贵订阅费因用量不均而有剩余，同时为了应对突发需求又不得不额外购买按量付费额度。\n- **手动切换繁琐**：为了继续工作，必须手动停止当前任务，登录不同平台切换账号或寻找免费替代模型，重启上下文极其耗时。\n- **成本不可控**：在多个 AI 提供商之间分散投入，每月固定支出高达数百元，且无法智能利用低价或免费模型来分摊压力。\n\n### 使用 9router 后\n- **零中断持续开发**：9router 自动监测配额，当主账号用尽时毫秒级无缝切换到廉价的 GLM 或免费的 Qwen 模型，确保编码过程永不卡顿。\n- **订阅价值最大化**：智能调度策略优先耗尽已付费的订阅额度，仅在必要时才动用备用方案，彻底消除“付了钱没用完”的浪费。\n- **统一入口自动化**：只需将 CLI 工具指向 9router 本地端口，它自动处理不同模型间的格式转换与路由，开发者无需再手动干预任何切换操作。\n- **极致成本优化**：通过轮询多账号和优先调用免费层级，将原本高昂的 API 调用成本降低 90% 以上，实现近乎免费的无限编码体验。\n\n9router 通过智能路由与自动降级机制，将分散昂贵的 AI 资源整合为一条永不断流、成本极低的开发流水线。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdecolua_9router_c1797c4f.jpg","decolua",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fdecolua_33f95322.png","https:\u002F\u002Fgithub.com\u002Fdecolua",[80,84,88,92],{"name":81,"color":82,"percentage":83},"JavaScript","#f1e05a",99.7,{"name":85,"color":86,"percentage":87},"CSS","#663399",0.2,{"name":89,"color":90,"percentage":91},"Dockerfile","#384d54",0.1,{"name":93,"color":94,"percentage":95},"Shell","#89e051",0,1893,495,"2026-04-08T00:07:48","MIT","Linux, macOS, Windows","未说明",{"notes":103,"python":101,"dependencies":104},"该工具是一个基于 Node.js 的路由服务，需通过 npm 安装。运行后默认在本地 20128 端口启动 Dashboard 和 API 服务。支持 Docker 部署或源码运行（需配置 .env 文件）。无需 GPU 或特定 Python 环境，主要依赖 Node.js 运行时。",[105,106],"Node.js (npm)","9router (npm package)",[15,25],[109,110,111,67,112,113],"antigravity","claude-code","vibecoding","cursor","openclaw","2026-03-27T02:49:30.150509","2026-04-08T13:01:12.551135",[117,122,127,132,137,142,147],{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},24394,"IFlow AI 提供商无法使用 Google 账号登录，提示需要中国手机号怎么办？","IFlow AI 已更改登录策略，不再支持 Gmail 直接登录。解决方案如下：\n1. 尝试使用手机号登录：在选择国家代码时，可以选择非中国区号（如 +33），然后输入你的电话号码（记得去掉号码首位的 0）。\n2. 尝试使用 Apple ID 登录。\n3. 如果上述方法无效，可以考虑切换到 Kiro 提供商，它提供许多免费且高质量的模型。","https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues\u002F213",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},24395,"Antigravity 提供商中不同模型（如 Sonnet 和 Gemini）的用量限制是独立的吗？","是的，Antigravity 的用量限制是基于 Token 计算的（类似于 Claude 订阅制），而不是基于请求次数。不同模型通常共享账户的总资源池，但具体可用量取决于平台当时的资源分配情况。目前官方正在开发一个仪表盘功能，用于显示每个模型和池的具体 Token 用量及重置时间，以便用户更清晰地了解剩余额度。","https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues\u002F15",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},24396,"使用 Antigravity + Claude Opus 模型时偶尔遇到'Prompt 太长\u002F超过 Token 限制'的错误如何解决？","该问题可能已由上游修复或缓解：\n1. Antigravity 已将 Opus 模型的上下文限制提升至 100 万 Token。\n2. 客户端（如 Cursor）现已具备自动截断上下文的功能，当接近限制时会自动处理，而不再直接抛出 HTTP 400 错误。\n如果遇到此错误，请确保你的客户端软件已更新到最新版本以支持自动截断功能。","https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues\u002F287",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},24397,"在使用免费的 iFlow 模型时，仪表盘显示的'总费用'是真实扣费吗？","仪表盘显示的费用通常仅为估算值或演示数据，并非实际扣费。如果你是通过 OAuth 连接 iFlow 提供商，且使用的是标记为'Free Unlimited'的模型（如 if\u002Fqwen3-coder-plus），只要你的账户未绑定支付方式且未超出免费额度，就不会产生实际账单。建议定期检查提供商官方的用量页面以确认无额外收费。","https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues\u002F132",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},24398,"9Router 在低配置服务器（如 2C2G）上运行一段时间后频繁崩溃并自动重启，疑似内存溢出（OOM）怎么办？","这通常是由于数据日志记录（Data Logging）功能在处理大负载（特别是包含图片 Base64 数据的请求）时导致内存泄漏。临时解决方案包括：\n1. 升级服务器内存（建议 4GB 以上）。\n2. 减少高并发或包含大量图片的请求。\n维护者已确认该问题与观测性模块中的 JSON 序列化和图片数据处理有关，并计划在后续版本中针对小内存部署进行优化修复。在修复发布前，尽量避免在低配服务器上开启全量日志记录。","https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues\u002F503",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},24399,"如何在受限网络环境下让 9Router 的出站请求通过上游代理（如 Clash）访问？","9Router 支持通过环境变量配置上游代理，以便在受限网络下正常访问 Codex、OpenAI 或 Google OAuth 等服务。请在启动 9Router 时设置以下环境变量：\n- HTTP_PROXY\n- HTTPS_PROXY\n- NO_PROXY\n例如：export HTTPS_PROXY=http:\u002F\u002F127.0.0.1:7890。配置后，所有出站 API 请求和 Token 刷新操作都将通过指定的代理服务器转发。","https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues\u002F21",{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},24400,"Linux 系统下安装或运行 9Router 时出现光标异常或其他兼容性问题如何处理？","如果在 Linux（如 Ubuntu 22.04）上遇到界面光标异常或运行错误，请执行以下检查：\n1. 确认是否从源码运行或通过 npm 安装，不同方式依赖环境不同。\n2. 确保已合并最新的修复补丁（参考 PR #341，提交哈希 8312af7）。\n3. 如果是特定 IDE 集成问题，尝试更新宿主软件或检查系统图形库依赖。若问题依旧，请提供具体的报错日志以便进一步排查。","https:\u002F\u002Fgithub.com\u002Fdecolua\u002F9router\u002Fissues\u002F313",[153,158,163,168,173,178,183,188,193,198,203,208,213,218,223,228,233],{"id":154,"version":155,"summary_zh":156,"released_at":157},153931,"v0.3.75","修复：\n- 原生 CLI 工具（Claude Code、Codex、Gemini CLI、Antigravity）的无损直通——仅替换模型和 Bearer 令牌\n- 修复 AG 提供商的思考签名（重命名为 DEFAULT_THINKING_AG_SIGNATURE）\n- 为 Gemini CLI 和 Vertex 提供商添加正确的默认签名\n- 修复 Vertex 流式响应为空的问题（缺少响应转换器）","2026-04-04T17:40:12",{"id":159,"version":160,"summary_zh":161,"released_at":162},153932,"v0.3.47","功能：\n- 新增 Ollama Cloud 和 Ollama Local 提供者\n- 新增 Claude Code 请求名称过滤器，以节省令牌和请求次数","2026-03-13T03:46:49",{"id":164,"version":165,"summary_zh":166,"released_at":167},153933,"v0.3.42","特性：\n- 为 Kiro Code 添加模型\n- 添加基于提供商的轮询策略，并支持粘性限制\n- 改进账户日志记录，使用连接名称而非 ID","2026-03-11T11:07:00",{"id":169,"version":170,"summary_zh":171,"released_at":172},153934,"v0.3.34","功能：\n- 增加了国际化支持：新增越南语（vi）和简体中文（zh-CN）翻译\n- 为模型路由增加了 GitHub Copilot MITM 代理支持\n- 修复了 README 翻译中的 HTML 渲染问题\n- 更新了 CLI 工具支持文档，包含完整的工具列表（共 12 款工具）\n- 改进了提供商表格布局，提升可读性\n\n错误修复：\n- 修复了与 OpenAI\u002FAnthropic 兼容的自定义提供商的 MITM 模型映射选择问题\n- 防止占位符模型选择被持久化\n- 通过使用唯一的占位符 ID，避免 React 键冲突","2026-03-06T10:05:49",{"id":174,"version":175,"summary_zh":176,"released_at":177},153935,"v0.3.17","v0.3.17 版本更新内容：\n- 为 OAuth + 提供商请求添加出站 HTTP 代理支持（可通过“设置 → 网络”进行配置）\n- 为提供商添加自定义模型支持\n- 实时使用情况跟踪","2026-02-28T03:27:30",{"id":179,"version":180,"summary_zh":181,"released_at":182},153936,"v0.2.89","功能：\n- 重新设计的使用概览：椭圆节点图、实时最近请求、SSE 优化\n- 新增隧道功能：通过 Cloudflare 隧道实现对外部工具的远程访问\n- 移除云同步功能","2026-02-21T09:49:23",{"id":184,"version":185,"summary_zh":186,"released_at":187},153937,"v0.2.79","- 恢复 iFlow 模型：Kimi K2 Thinking、Kimi K2.5、DeepSeek V3.2 Chat、MiniMax M2.1、GLM 4.7\n- 添加带有 HMAC-SHA256 签名的 IFlowExecutor\n- 新增 GLM Coding（中国）提供商\n- 新增按 API Key 统计使用量功能\n- 将 GPT-3.5 Turbo、GPT-4、GPT-4o、GPT-4o mini 加入 GitHub Copilot 提供商","2026-02-11T08:53:45",{"id":189,"version":190,"summary_zh":191,"released_at":192},153938,"v0.2.71","特性：\n- 将反重力工具与中间人攻击支持集成\n- 更新命令行工具","2026-02-08T09:55:33",{"id":194,"version":195,"summary_zh":196,"released_at":197},153939,"v0.2.70","功能：\n- 为 Claude 和 Antigravity 提供商添加 claude-opus-4-6-thinking 模型支持\n- OpenClaw 提供商的设置与配置\n- 免费 AI 提供商支持，并增强错误处理\n- Docker 运行时设置及部署文档\n\n改进：\n- 更完善的提供商连接错误处理\n- 增强的 Docker 部署文档","2026-02-07T04:43:38",{"id":199,"version":200,"summary_zh":201,"released_at":202},153940,"v0.2.67","特性：\n- 将 OpenClaw 工具卡片添加到 CLI 工具仪表板\n- 添加对 Droid 模型的支持\n- 增强 ClaudeToolCard 和 CodexToolCard，使其能够显示当前的基础 URL","2026-02-06T14:11:25",{"id":204,"version":205,"summary_zh":206,"released_at":207},153941,"v0.2.56","## What's New in v0.2.56\r\n\r\n### System Tray Support\r\n- Added system tray icon with menu (Open Dashboard, Auto-start toggle, Quit)\r\n- New `--tray` flag to run in background mode\r\n- \"Hide to Tray\" option in TUI menu\r\n- Auto-startup on OS boot (macOS\u002FWindows\u002FLinux)","2026-02-04T04:39:42",{"id":209,"version":210,"summary_zh":211,"released_at":212},153942,"v0.2.52","Features:\n- Support multiple OpenAI-compatible providers with custom prefix\u002FbaseUrl\n- Provider nodes CRUD (create\u002Fread\u002Fupdate\u002Fdelete)\n- URL building: baseUrl + \u002Fchat\u002Fcompletions or \u002Fresponses\n- Model import from \u002Fmodels endpoint\n- API key validation\n- Usage type safety across all translators\n- OAuth token auto-refresh","2026-02-02T12:58:46",{"id":214,"version":215,"summary_zh":216,"released_at":217},153943,"v0.2.43","Bug Fixes:\n- Fix Kiro OAuth and API compatibility issues\n- Fix Antigravity schema validation errors (cornerRadius, fillColor, fontFamily, etc.)\n- Improve Gemini helper schema filtering\n- Add translator page and API endpoints\n- Enhance request logging and streaming","2026-01-27T04:24:27",{"id":219,"version":220,"summary_zh":221,"released_at":222},153944,"v0.2.36","Features:\n- \u002Fv1\u002Fmodels endpoint for OpenAI-compatible clients\n- Codex streaming support (Responses API → OpenAI)\n- HTTP_PROXY\u002FHTTPS_PROXY\u002FALL_PROXY\u002FSOCKS proxy support\n- NO_PROXY bypass patterns","2026-01-20T07:13:32",{"id":224,"version":225,"summary_zh":226,"released_at":227},153945,"v0.2.31","Fix Bug Kiro version 0.2.31","2026-01-18T15:17:51",{"id":229,"version":230,"summary_zh":231,"released_at":232},153946,"v0.2.27","## Features\n- Added Kiro Provider with generous free quota\n\n## Bug Fixes\n- Fixed Codex Provider bugs","2026-01-15T11:42:27",{"id":234,"version":235,"summary_zh":236,"released_at":237},153947,"v0.2.21","Update ReadMe\r\nFix bug antigravity","2026-01-12T10:02:46"]