跳到主要内容
AI教程

通过 Infinite Claude Code 运行 Claude Code，支持流式传输、故障转移和本地回退

了解如何安装 Infinite Claude Code，验证其兼容 Anthropic 的本地路由器，启动 Claude Code，配置可选提供商，通过 HUD 监控请求，并将自主子代理分配到其模型池中。

AI我搜编辑部阅读约 12 分钟
通过 Infinite Claude Code 运行 Claude Code，支持流式传输、故障转移和本地回退

什么是 Infinite Claude Code？

Infinite Claude Code 是一个无依赖的 Node.js 代理，可将官方 Anthropic 客户端（包括 Claude Code CLI、Claude Desktop 以及受支持的 IDE 扩展）连接到 OpenAI 兼容模型提供商池。它在 /v1/messages 接收 Anthropic Messages API 请求，将其转换为提供商格式，再将响应转换回兼容 Anthropic 的实时 Server-Sent Events。

该项目优先使用免费云端模型，支持可选的提供商凭据，并可回退到本地 Ollama 实例。根据项目 README，路由器启动迅速，内存占用低于 30 MB，空闲时不占用 CPU。

该仓库将其预配置云端模型池描述为可免费使用。相关外部服务仍可能调整提供商可用性、速率限制、模型访问权限和定价，因此在将其用于持续性工作负载前，请查看各提供商当前的条款。

路由器的工作方式

本地路由器默认监听 127.0.0.1:20129。Claude Code 将 Anthropic 风格的请求发送到此端点，随后 Infinite Claude Code 对任务进行分类，选择合适的模型，转换工具调用，并将结果以流式方式返回给客户端。

  1. Claude Code、Claude Desktop 或 IDE 扩展向 /v1/messages 发送请求。

  2. 语义分类器检查提示词和可用工具。

  3. 调度器从优先级模型池中选择提供商和模型。

  4. 如果该提供商不可用或受到速率限制，路由器会切换到其他已配置的提供商。

  5. OpenAI 风格的函数调用会被转换为 Anthropic 工具使用消息。

  6. 响应令牌通过实时 SSE 流式传输返回。

  7. 如果云端路由不可用且已配置 Ollama，路由器可以使用本地模型。

主要功能

并发子代理调度

当 Claude Code 启动多个子代理或后台会话时，群集调度器可以将并发请求分配到不同的提供商，而不是将所有工作发送给一个模型。此设计旨在减少单一提供商造成的瓶颈和速率限制失败。

语义任务路由

路由器会根据推测的工作负载选择模型。文档所述的路由策略倾向于为架构任务使用 Nemotron 120B 或 Kimi K3 等推理模型，为代码生成和文件编辑使用 North Mini Code 或 Qwen Coder 等代码专用模型，并为快速命令使用 Nemotron Lightning。

工具调用修复

一些开放权重模型会在工具参数中生成格式错误的 JSON。Infinite Claude Code 包含一个基于 AST 的清理器，尝试在 Claude Code 执行工具调用前修复未转义引号或括号不完整等问题。

自动提供商故障转移

该项目支持一个按优先级排列的模型池，覆盖 OpenRouter、NVIDIA NIM、OmniRouter、9Router、Groq、Cerebras、Together AI、Google Gemini、Mistral AI、OpenAI、Anthropic 及其他可选服务。请求失败或受到速率限制时，可以通过其他可用提供商重试。

监控面板

基于浏览器的 HUD 会显示活跃子代理、提供商活动、生成的令牌数、延迟，以及根据官方 Claude 3.7 Sonnet API 定价估算的节省金额计数器。

离线回退

Ollama 可通过 qwen3:4b 或 deepseek-r1 等模型提供本地弹性支持。本地性能和工具可靠性取决于所选模型及你的硬件。

前置要求

  • Node.js 18 或更高版本。

  • 使用手动安装方式时需要 Git。

  • Claude Code CLI、Claude Desktop 或兼容的 IDE 集成。

  • Windows 上需要 PowerShell，macOS 和 Linux 上需要 Shell。

  • 只有在需要本地离线回退时才需要 Ollama。

项目本身不需要 Python 环境或额外的 Node.js 软件包。

安装 Infinite Claude Code

选项 1：Windows 单行安装程序

打开 PowerShell，然后运行仓库中的安装命令：

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/juanitogit/infinite-claude-code/main/install.ps1")))

由于此命令会下载并立即执行远程脚本，如果你的安全策略有此要求，请先查看 install.ps1。

选项 2：Windows 手动安装

git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
powershell -ExecutionPolicy Bypass -File .\install.ps1

选项 3：macOS 或 Linux 安装

git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
chmod +x install.sh && ./install.sh

选择安装模式

交互式安装程序提供两种模式：

  • 快速安装：配置文档所述的预配置免费层级，不询问可选的提供商凭据。

  • 自定义安装：要求输入其他提供商的 API 密钥。对于不想配置的提供商，按 Enter 跳过。

验证本地路由器

在仓库目录中检查服务状态：

node bin/infinite-claude.js status

健康的安装应报告 Infinite Claude Code 正在运行，识别本地 URL 为 http://127.0.0.1:20129，确认 SSE 流式传输，并列出模型池中的活跃提供商。

Infinite Claude Code 正在运行且状态正常！
URL: http://127.0.0.1:20129
流式传输：已启用（SSE 实时传输）
池中的活跃提供商：...

如果服务状态不正常，请确认已安装 Node.js 18 或更高版本，并确认没有其他应用正在使用端口 20129。

启动 Claude Code

路由器运行且安装程序已配置客户端后，正常启动 Claude Code：

claude

然后，您可以在交互式会话中输入编码请求：

检查此项目，解释其架构，并确定最安全的首个重构任务。

该请求应通过本地代理进行路由，并在生成答案时将其流式传回。

尝试直接执行任务

Claude Code 也可以直接从终端接收提示：

claude "审查身份验证模块并提出重构计划"

对于不需要从空白交互式会话开始的聚焦工作，这种方式非常实用。模型选择由 Infinite Claude Code 的路由逻辑处理，而不是由命令本身处理。

在 Cyber HUD 中监控请求

路由器运行期间，打开以下本地地址：

http://localhost:20129/hud

HUD 会提供当前会话的实时遥测数据，包括：

  • 为每个请求提供服务的提供商。

  • 生成的令牌数量。

  • 以毫秒为单位的请求延迟。

  • 当前活跃的并发子代理数量。

  • 根据 Claude 3.7 Sonnet API 定价估算的节省金额计数器。

使用此仪表板确认请求正在配置的提供商池之间分发，并发现延迟异常高的提供商。

配置提供商和环境变量

您可以在 src/providers.js 中自定义提供商定义，或通过环境变量提供凭据和端点。README 记录了以下变量：

  • OPENROUTER_API_KEY：自定义 OpenRouter 凭据。文档中的默认值使用预配置的免费层级。

  • NVIDIA_API_KEY：自定义 NVIDIA NIM 凭据。代码库将预配置的 NIM 密钥记录为默认值。

  • OMNIROUTER_API_KEY：自定义 OmniRouter 凭据。

  • ROUTER9_API_KEY：自定义 9Router 凭据。

  • GROQ_API_KEY：可选的 Groq 凭据。

  • TOGETHER_API_KEY：可选的 Together AI 凭据。

  • OLLAMA_HOST：Ollama 端点，默认为 http://localhost:11434。

  • PORT：本地代理端口，默认为 20129。

例如，在 macOS 或 Linux shell 中，可以在启动路由器前将其指向其他 Ollama 主机和端口：

export OLLAMA_HOST="http://localhost:11434"
export PORT="20129"

在 PowerShell 中，对应的会话变量如下：

$env:OLLAMA_HOST = "http://localhost:11434"
$env:PORT = "20129"

将个人 API 密钥保存在源代码管理之外。不要提交包含密钥的 shell 配置文件、环境文件或修改后的提供商配置。

将 Ollama 设置为本地备用方案

Infinite Claude Code 支持将 Ollama 用作离线或紧急路由。README 列出了 qwen3:4b 和 deepseek-r1 作为本地模型示例。

  1. 单独安装并启动 Ollama。

  2. 在 Ollama 安装中准备所需模型。

  3. 将 OLLAMA_HOST 保持为 http://localhost:11434，或将其更改为自定义端点。

  4. 使用状态命令再次验证 Infinite Claude Code 路由器。

本地备用方案在网络中断期间尤其有用，但模型速度、上下文容量和编码质量取决于本地模型以及可用的 CPU、内存或 GPU 资源。

运行自主子代理

对于适合拆分的任务，请明确要求 Claude Code 创建并发子代理：

claude "拆分此任务，并使用并发子代理并行构建完整平台"

您也可以使用文档中的 --bg 选项分派后台任务：

claude --bg "重构身份验证模块并编写单元测试"

该路由器旨在将同时进行的子代理调用分发到不同的提供商。在任务运行期间查看 HUD，观察集群负载和提供商选择。

高级提示

根据提供商可用性匹配并发量

该项目支持较高的并发量，但外部提供商仍可能施加自己的速率限制或可用性限制。在启动大量后台任务前，请查看 HUD 和活跃提供商列表。

使用可选密钥扩展池

如果预配置的路由拥堵，Custom Install 可以添加 Groq 或 Together AI 等提供商。配置更广泛的提供商池可以为故障转移系统提供更多路由，但每项可选服务可能有独立的配额和条款。

在排查问题期间使用状态命令

在调试 Claude 客户端本身之前，运行 node bin/infinite-claude.js status。这可以快速区分本地路由器问题、模型提供商问题和客户端问题。

必要时更改端口

如果端口 20129 与其他服务冲突，请将 PORT 设置为其他值。更改后，确保 Anthropic 客户端配置指向相同的本地端点。

仔细检查提供商配置

高级用户可以修改 src/providers.js 以自定义模型。请保留预期的提供商格式，并在启动并发代理之前，先通过一个简单请求测试更改。

保护专有代码

通过云端路由的提示可能包含源代码、工具输出或项目上下文。在使用路由器处理机密代码仓库之前，请查看每个已启用提供商的隐私和数据处理政策。如果工作必须在本地完成，请优先使用 Ollama 路由。

结论

Infinite Claude Code 在 Anthropic 客户端与大量云端或本地模型之间提供了轻量级的翻译和路由层。运行安装程序后，验证服务状态，启动 claude，并使用 HUD 监控流式传输、故障转移和并发子代理。可选的提供商密钥和 Ollama 让你可以根据工作流程需要扩展模型池或增加本地容错能力。

该项目由 JuaneX 维护，并采用 MIT 许可证发布。源代码和安装脚本可在 Infinite Claude Code 仓库中获取。