尧图网页设计 
9Router 快速上手5 分钟接入 Claude Code、Cursor、Codex 等 AI 编码工具【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router9Router 是一个本地 AI 基础设施网关把 Claude Code、Codex、Cursor、Cline、Copilot 等编码工具统一指向http://localhost:20128通过 40 提供商订阅制、按量付费、免费自动路由请求。本文基于官方西班牙语文档 gitbook/content/es/getting-started/quick-start.md 编写读完你将掌握从安装、连接提供商、配置 CLI 工具到用 Combos 实现自动故障转移与成本优化的完整实战链路。1. 前置要求与环境检查9Router 需要 Node.js 20建议同时使用 npm 10支持 macOS、Linux、Windows官方文档推荐 WSL磁盘空间约 200MB。安装前先验证环境node --version # 应输出 v20.x.x 或更高 npm --version # 应输出 10.x.x 或更高更详细的安装、环境变量与排错内容见官方安装指南 gitbook/content/es/getting-started/installation.md。2. 安装 9Router三种方式方式一全局安装推荐可从任意目录直接运行9router命令npm install -g 9router 9router后续可用npm update -g 9router完成自更新。方式二项目内本地安装版本隔离、不污染全局命名空间mkdir my-9router cd my-9router npm install 9router npx 9router方式三从源码运行适合想体验开发版特性或参与贡献的场景详见仓库根目录 package.json 与 start.sh。3. 首次启动Dashboard、默认密码与 API Key执行9router后服务在http://localhost:20128启动浏览器自动打开 Dashboard数据目录创建于~/.9router数据库、API keys、日志自动生成 API key格式形如9r_1234567890abcdef1234567890abcdef。默认登录密码为123456务必第一时间在 Dashboard → Settings → Change Password 中修改。端口20128在源码中有多处引用例如 src/shared/constants/config.js 中UPDATER_CONFIG.appPort: 20128如需更换端口可通过PORT环境变量或9router --port 3000指定。4. 连接 AI 提供商三种方式Dashboard 中进入Providers页面9Router 将提供商按认证方式分为三类。方式 AOAuth 连接订阅制提供商适用场景Claude Code、Codex、Gemini CLI、GitHub Copilot 等订阅制账号。Dashboard → Providers → Connect [Provider] → Login OAuth → 自动刷新 token → 配额跟踪已启用Claude Code 示例点击 Connect Claude Code → 用 Claude 账号登录 → 授权 9Router → 即可使用cc/claude-opus-4-5-20251101等模型。OAuth 连接的 token 会自动刷新并带配额跟踪源码中 iFlow 等免费提供商同样走 OAuth 流程见 open-sse/providers/registry/iflow.js含clientId、authorizeUrl、tokenUrl等完整 OAuth 配置。方式 BAPI Key 连接按量付费提供商适用场景GLM、MiniMax、Kimi、OpenRouter 等低价按量计费服务。Dashboard → Providers → Add API Key → 选择提供商 → 粘贴 API key → 保存GLM-4.7 示例前往智谱 AI 开放平台注册并申请 Coding Plan 的 API key → Dashboard → Add API Key → Provider 选择glm→ 粘贴 key → 即可使用glm/glm-4.7。源码中 open-sse/providers/registry/glm.js 展示了 GLM 的多端点设计同一glm提供商同时提供 OpenAI 格式https://api.z.ai/api/coding/paas/v4/chat/completions与 Claude 格式https://api.z.ai/api/anthropic/v1/messages两个 transport9Router 会按客户端请求格式自动选择从而跳过不必要的格式翻译。方式 C连接免费提供商零成本适用场景iFlow、Qwen、Kiro 等免费额度提供商通常走 Device Code 或 OAuth。Dashboard → Providers → Connect [Free Provider] → Device code 或 OAuth → 无限使用iFlow 示例点击 Connect iFlow → 登录 iFlow 账号 → 授权 → 即可使用if/kimi-k2-thinking、if/qwen3-coder-plus等 8 个免费模型。这些免费模型同样注册在提供商 registry 中例如 open-sse/providers/registry/iflow.js 中的deepseek-r1、glm-4.7、kimi-k2等。5. 将 CLI 编码工具指向 9Router核心思路把所有工具的 Base URL 指向 9Routerhttp://localhost:20128API Key 用 Dashboard 生成的 key模型名用 9Router 的统一命名如cc/claude-opus-4-5-20251101。Cursor IDESettings → Models → Advanced: OpenAI API Base URL: http://localhost:20128/v1 OpenAI API Key: [从 9Router dashboard 获取] Model: cc/claude-opus-4-5-20251101Claude Desktop编辑~/.claude/config.json{ anthropic_api_base: http://localhost:20128/v1, anthropic_api_key: your-9router-api-key }Cline / Continue / RooCodeProvider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [从 dashboard 获取] Model: cc/claude-opus-4-5-20251101Codex CLIexport OPENAI_BASE_URLhttp://localhost:20128 export OPENAI_API_KEYyour-9router-api-key codex your prompt6. 智能组合Combos自动故障转移Combos 是 9Router 的核心能力把多个模型串成一条 fallback 链按顺序依次尝试配额耗尽或出错时自动切换下一个实现零停机。Dashboard → Combos → Create New Name: premium-coding Models: 1. cc/claude-opus-4-5-20251101主订阅 2. glm/glm-4.7低价备用$0.6/1M 3. if/kimi-k2-thinking免费兜底 CLI 中使用Model 填 premium-coding工作原理优先尝试 Claude Opus你已有的订阅→ 配额耗尽切 GLM-4.7 → 预算触顶切 iFlow免费→ 全程自动切换、零停机。源码层面combos 的 fallback 与能力匹配逻辑位于 open-sse/services/combo.js其中reorderByCapabilities会按请求所需能力视觉、PDF、音频等硬能力优先对 combo 内模型做稳定重排但从不丢弃模型、保证 fallback 链完整遇到不支持工具调用的模型时还会把工具调用历史扁平化为纯文本保证上下文不丢失。官方文档 gitbook/content/es/features/combos.md 给出了 6 个完整组合示例订阅优先、预算优先、全免费、质量优先、多订阅、配额重置优化并支持为 combo 设置每日/每月预算上限触顶后自动跳过付费模型。7. 可用模型总览以下为官方文档列出的模型分层具体以 Dashboard 实际列表为准订阅制模型优先用满已有订阅Claude Codecc/Pro/Max 订阅cc/claude-opus-4-5-20251101Claude 4.5 Opus、cc/claude-sonnet-4-5-20250929Claude 4.5 Sonnet、cc/claude-haiku-4-5-20251001Claude 4.5 HaikuCodexcx/Plus/Pro 订阅cx/gpt-5.2-codex、cx/gpt-5.1-codex-maxGemini CLIgc/免费 180K/月gc/gemini-3-flash-preview、gc/gemini-2.5-proGitHub Copilotgh/订阅制gh/gpt-5、gh/claude-4.5-sonnet低价模型备用层GLMglm/$0.6/$2.2 每 1M tokensglm/glm-4.7每日 10AM 重置MiniMaxminimax/$0.20/$1.00 每 1M tokensminimax/MiniMax-M2.15 小时滚动重置Kimikimi/$9/月10M tokenskimi/kimi-latest免费模型紧急兜底层iFlowif/8 个免费模型含if/kimi-k2-thinking、if/qwen3-coder-plus、if/glm-4.7、if/deepseek-r1Qwenqw/3 个免费模型含qw/qwen3-coder-plus、qw/qwen3-coder-flashKirokr/2 个免费模型含kr/claude-sonnet-4.5、kr/claude-haiku-4.5这些模型 ID 与 open-sse/providers/registry 下的提供商注册文件一致如 qwen.js 中的qwen3-coder-plus、minimax.js 中的MiniMax-M2.1、claude.js 中的claude-haiku-4-5-20251001格式为提供商前缀/模型名。8. 成本优化策略月度预算 $10-20 方案官方文档给出的分层思路免费额度打底 → 用满已有订阅 → 低价按量兜底 → 免费模型应急。1. 快速任务用 Gemini CLI 免费层180K/月 2. 用满 Claude Code 订阅配额反正已付费 3. 配额耗尽后 fallback 到 GLM$0.6/1M 4. 应急用 MiniMax M2.1$0.20/1M或 iFlow免费 参考示例100M tokens/月 60M 走 Gemini CLI$0免费层 30M 走 Claude Code$0已有订阅 8M 走 GLM$4.80 2M 走 MiniMax$0.40 合计$5.20/月 已有订阅配额重置节奏策略不同提供商的配额重置周期不同Claude 5 小时窗口、Gemini 每日、GLM 每日 10AM、MiniMax 5 小时滚动可据此安排一天的编码节奏1. 上午Claude Code 新配额窗口5h 重置 2. 下午切 Gemini CLI1K/天 3. 晚上GLM 当日配额次日 10AM 重置 4. 深夜MiniMax5h 滚动或 iFlow免费值得注意的是源码 src/shared/constants/config.js 中还存在QUOTA_AUTOPING_CONFIG9Router 会在配额窗口重置后自动发送一次极小的 ping如 Claude 用claude-haiku-4-5-20251001、Codex 用gpt-5.5maxTokens: 1来预热窗口让 5h 配额窗口始终保持可用状态进一步减少人工干预。9. 验证安装与问题排查服务启动后可用 curl 快速验证# 健康检查 curl http://localhost:20128/health # 列出可用模型 curl http://localhost:20128/v1/models -H Authorization: Bearer your-api-key # 测试一次 chat completion curl http://localhost:20128/v1/chat/completions \ -H Authorization: Bearer your-api-key \ -H Content-Type: application/json \ -d { model: cc/claude-opus-4-5-20251101, messages: [{role: user, content: Hello!}] }常见问题端口被占用EADDRINUSE、npm 权限EACCES、Node 版本过旧、Dashboard 打不开、提供商连接失败、内存占用偏高等的完整排查步骤、环境变量JWT_SECRET、INITIAL_PASSWORD、DATA_DIR、PORT、NODE_ENV以及 Docker / Nginx 反向代理注意关闭proxy_buffering以支持 SSE 流式输出部署方案见 gitbook/content/es/getting-started/installation.md。10. 下一步安装细节与排错 —— 系统要求、环境变量、Docker 部署功能特性 —— 配额跟踪、Combos、智能路由FAQ —— 常见问题解答Troubleshooting —— 问题排查【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 9Router 快速上手：5 分钟接入 Claude Code、Cursor、Codex 等 AI 编码工具
9Router 快速上手5 分钟接入 Claude Code、Cursor、Codex 等 AI 编码工具【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router9Router 是一个本地 AI 基础设施网关把 Claude Code、Codex、Cursor、Cline、Copilot 等编码工具统一指向http://localhost:20128通过 40 提供商订阅制、按量付费、免费自动路由请求。本文基于官方西班牙语文档 gitbook/content/es/getting-started/quick-start.md 编写读完你将掌握从安装、连接提供商、配置 CLI 工具到用 Combos 实现自动故障转移与成本优化的完整实战链路。1. 前置要求与环境检查9Router 需要 Node.js 20建议同时使用 npm 10支持 macOS、Linux、Windows官方文档推荐 WSL磁盘空间约 200MB。安装前先验证环境node --version # 应输出 v20.x.x 或更高 npm --version # 应输出 10.x.x 或更高更详细的安装、环境变量与排错内容见官方安装指南 gitbook/content/es/getting-started/installation.md。2. 安装 9Router三种方式方式一全局安装推荐可从任意目录直接运行9router命令npm install -g 9router 9router后续可用npm update -g 9router完成自更新。方式二项目内本地安装版本隔离、不污染全局命名空间mkdir my-9router cd my-9router npm install 9router npx 9router方式三从源码运行适合想体验开发版特性或参与贡献的场景详见仓库根目录 package.json 与 start.sh。3. 首次启动Dashboard、默认密码与 API Key执行9router后服务在http://localhost:20128启动浏览器自动打开 Dashboard数据目录创建于~/.9router数据库、API keys、日志自动生成 API key格式形如9r_1234567890abcdef1234567890abcdef。默认登录密码为123456务必第一时间在 Dashboard → Settings → Change Password 中修改。端口20128在源码中有多处引用例如 src/shared/constants/config.js 中UPDATER_CONFIG.appPort: 20128如需更换端口可通过PORT环境变量或9router --port 3000指定。4. 连接 AI 提供商三种方式Dashboard 中进入Providers页面9Router 将提供商按认证方式分为三类。方式 AOAuth 连接订阅制提供商适用场景Claude Code、Codex、Gemini CLI、GitHub Copilot 等订阅制账号。Dashboard → Providers → Connect [Provider] → Login OAuth → 自动刷新 token → 配额跟踪已启用Claude Code 示例点击 Connect Claude Code → 用 Claude 账号登录 → 授权 9Router → 即可使用cc/claude-opus-4-5-20251101等模型。OAuth 连接的 token 会自动刷新并带配额跟踪源码中 iFlow 等免费提供商同样走 OAuth 流程见 open-sse/providers/registry/iflow.js含clientId、authorizeUrl、tokenUrl等完整 OAuth 配置。方式 BAPI Key 连接按量付费提供商适用场景GLM、MiniMax、Kimi、OpenRouter 等低价按量计费服务。Dashboard → Providers → Add API Key → 选择提供商 → 粘贴 API key → 保存GLM-4.7 示例前往智谱 AI 开放平台注册并申请 Coding Plan 的 API key → Dashboard → Add API Key → Provider 选择glm→ 粘贴 key → 即可使用glm/glm-4.7。源码中 open-sse/providers/registry/glm.js 展示了 GLM 的多端点设计同一glm提供商同时提供 OpenAI 格式https://api.z.ai/api/coding/paas/v4/chat/completions与 Claude 格式https://api.z.ai/api/anthropic/v1/messages两个 transport9Router 会按客户端请求格式自动选择从而跳过不必要的格式翻译。方式 C连接免费提供商零成本适用场景iFlow、Qwen、Kiro 等免费额度提供商通常走 Device Code 或 OAuth。Dashboard → Providers → Connect [Free Provider] → Device code 或 OAuth → 无限使用iFlow 示例点击 Connect iFlow → 登录 iFlow 账号 → 授权 → 即可使用if/kimi-k2-thinking、if/qwen3-coder-plus等 8 个免费模型。这些免费模型同样注册在提供商 registry 中例如 open-sse/providers/registry/iflow.js 中的deepseek-r1、glm-4.7、kimi-k2等。5. 将 CLI 编码工具指向 9Router核心思路把所有工具的 Base URL 指向 9Routerhttp://localhost:20128API Key 用 Dashboard 生成的 key模型名用 9Router 的统一命名如cc/claude-opus-4-5-20251101。Cursor IDESettings → Models → Advanced: OpenAI API Base URL: http://localhost:20128/v1 OpenAI API Key: [从 9Router dashboard 获取] Model: cc/claude-opus-4-5-20251101Claude Desktop编辑~/.claude/config.json{ anthropic_api_base: http://localhost:20128/v1, anthropic_api_key: your-9router-api-key }Cline / Continue / RooCodeProvider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [从 dashboard 获取] Model: cc/claude-opus-4-5-20251101Codex CLIexport OPENAI_BASE_URLhttp://localhost:20128 export OPENAI_API_KEYyour-9router-api-key codex your prompt6. 智能组合Combos自动故障转移Combos 是 9Router 的核心能力把多个模型串成一条 fallback 链按顺序依次尝试配额耗尽或出错时自动切换下一个实现零停机。Dashboard → Combos → Create New Name: premium-coding Models: 1. cc/claude-opus-4-5-20251101主订阅 2. glm/glm-4.7低价备用$0.6/1M 3. if/kimi-k2-thinking免费兜底 CLI 中使用Model 填 premium-coding工作原理优先尝试 Claude Opus你已有的订阅→ 配额耗尽切 GLM-4.7 → 预算触顶切 iFlow免费→ 全程自动切换、零停机。源码层面combos 的 fallback 与能力匹配逻辑位于 open-sse/services/combo.js其中reorderByCapabilities会按请求所需能力视觉、PDF、音频等硬能力优先对 combo 内模型做稳定重排但从不丢弃模型、保证 fallback 链完整遇到不支持工具调用的模型时还会把工具调用历史扁平化为纯文本保证上下文不丢失。官方文档 gitbook/content/es/features/combos.md 给出了 6 个完整组合示例订阅优先、预算优先、全免费、质量优先、多订阅、配额重置优化并支持为 combo 设置每日/每月预算上限触顶后自动跳过付费模型。7. 可用模型总览以下为官方文档列出的模型分层具体以 Dashboard 实际列表为准订阅制模型优先用满已有订阅Claude Codecc/Pro/Max 订阅cc/claude-opus-4-5-20251101Claude 4.5 Opus、cc/claude-sonnet-4-5-20250929Claude 4.5 Sonnet、cc/claude-haiku-4-5-20251001Claude 4.5 HaikuCodexcx/Plus/Pro 订阅cx/gpt-5.2-codex、cx/gpt-5.1-codex-maxGemini CLIgc/免费 180K/月gc/gemini-3-flash-preview、gc/gemini-2.5-proGitHub Copilotgh/订阅制gh/gpt-5、gh/claude-4.5-sonnet低价模型备用层GLMglm/$0.6/$2.2 每 1M tokensglm/glm-4.7每日 10AM 重置MiniMaxminimax/$0.20/$1.00 每 1M tokensminimax/MiniMax-M2.15 小时滚动重置Kimikimi/$9/月10M tokenskimi/kimi-latest免费模型紧急兜底层iFlowif/8 个免费模型含if/kimi-k2-thinking、if/qwen3-coder-plus、if/glm-4.7、if/deepseek-r1Qwenqw/3 个免费模型含qw/qwen3-coder-plus、qw/qwen3-coder-flashKirokr/2 个免费模型含kr/claude-sonnet-4.5、kr/claude-haiku-4.5这些模型 ID 与 open-sse/providers/registry 下的提供商注册文件一致如 qwen.js 中的qwen3-coder-plus、minimax.js 中的MiniMax-M2.1、claude.js 中的claude-haiku-4-5-20251001格式为提供商前缀/模型名。8. 成本优化策略月度预算 $10-20 方案官方文档给出的分层思路免费额度打底 → 用满已有订阅 → 低价按量兜底 → 免费模型应急。1. 快速任务用 Gemini CLI 免费层180K/月 2. 用满 Claude Code 订阅配额反正已付费 3. 配额耗尽后 fallback 到 GLM$0.6/1M 4. 应急用 MiniMax M2.1$0.20/1M或 iFlow免费 参考示例100M tokens/月 60M 走 Gemini CLI$0免费层 30M 走 Claude Code$0已有订阅 8M 走 GLM$4.80 2M 走 MiniMax$0.40 合计$5.20/月 已有订阅配额重置节奏策略不同提供商的配额重置周期不同Claude 5 小时窗口、Gemini 每日、GLM 每日 10AM、MiniMax 5 小时滚动可据此安排一天的编码节奏1. 上午Claude Code 新配额窗口5h 重置 2. 下午切 Gemini CLI1K/天 3. 晚上GLM 当日配额次日 10AM 重置 4. 深夜MiniMax5h 滚动或 iFlow免费值得注意的是源码 src/shared/constants/config.js 中还存在QUOTA_AUTOPING_CONFIG9Router 会在配额窗口重置后自动发送一次极小的 ping如 Claude 用claude-haiku-4-5-20251001、Codex 用gpt-5.5maxTokens: 1来预热窗口让 5h 配额窗口始终保持可用状态进一步减少人工干预。9. 验证安装与问题排查服务启动后可用 curl 快速验证# 健康检查 curl http://localhost:20128/health # 列出可用模型 curl http://localhost:20128/v1/models -H Authorization: Bearer your-api-key # 测试一次 chat completion curl http://localhost:20128/v1/chat/completions \ -H Authorization: Bearer your-api-key \ -H Content-Type: application/json \ -d { model: cc/claude-opus-4-5-20251101, messages: [{role: user, content: Hello!}] }常见问题端口被占用EADDRINUSE、npm 权限EACCES、Node 版本过旧、Dashboard 打不开、提供商连接失败、内存占用偏高等的完整排查步骤、环境变量JWT_SECRET、INITIAL_PASSWORD、DATA_DIR、PORT、NODE_ENV以及 Docker / Nginx 反向代理注意关闭proxy_buffering以支持 SSE 流式输出部署方案见 gitbook/content/es/getting-started/installation.md。10. 下一步安装细节与排错 —— 系统要求、环境变量、Docker 部署功能特性 —— 配额跟踪、Combos、智能路由FAQ —— 常见问题解答Troubleshooting —— 问题排查【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考