← 返回项目库

Claude API 智能转发器|本地预览与智能路由

面向 Claude API 兼容请求的本地智能转发器,提供端点健康检查、分组路由、故障重试和可视化运行监控。

它把多个上游 API 端点组织成可切换的服务组,在请求进入后按策略选择可用端点,并在异常时执行重试与切换。 内置 Web 管理界面展示服务状态、端点健康度、组状态、连接统计、请求趋势和系统日志,便于本地调试与日常运维。 交付包同时提供回环地址演示配置和本地适配器,可在不配置真实凭据的情况下验证完整的请求转发链路。

真实界面

项目截图

共 7 张

运行概览
数据可视化
端点状态
组管理
连接统计
系统日志
当前配置

Capabilities

核心功能

✓多端点配置与健康检查
✓按优先级或最快响应策略选择端点
✓端点分组与手动切换管理
✓请求失败自动重试与故障转移
✓请求挂起、恢复和超时统计
✓中文 Web 运行监控与本地 Canvas 图表
✓配置概览、系统日志和 Prometheus 指标

适用场景

本地开发时在多个 Claude API 兼容服务之间切换
为内部 AI 应用提供统一代理入口和健康状态面板
演示端点故障转移、重试和请求监控流程

适合谁

需要统一管理多个 Claude API 兼容端点的个人开发者、AI 应用团队、内部平台工程师和本地部署运维人员。

商业化思路

源码包交付与部署服务;按客户端点策略进行二次开发;为团队提供路由、健康检查和故障恢复的技术支持。

你会拿到什么

  • ✓Go 源码、配置示例与测试用例
  • ✓中文 Web 管理界面和本地 Canvas 图表渲染器
  • ✓回环地址演示适配器、演示配置和启动脚本
  • ✓README、构建命令与部署说明

部署流程

  1. 1安装 Go 1.23 或更高版本并执行 go mod download
  2. 2复制示例配置,替换端点地址、凭据和运行端口
  3. 3执行 go build 构建二进制并启动代理与 Web 管理界面
  4. 4先用 demo/run-preview.sh 验证本地链路,再接入真实上游服务

真实验证结果

已通过确定性 Go 构建、端点与代理单元测试、请求挂起/恢复核心集成测试、干净本地演示请求验证,以及 1440×900 浏览器绑定的 7 张中文功能状态截图。完整历史套件仍有一个与当前自动切换语义相冲突的性能子测试和一个脆弱的内存增长阈值测试,已记录为上游测试兼容性告警,不作为发布功能证据。

部署前须知

演示配置只绑定回环地址且不包含真实凭据;接入生产上游前必须自行完成授权、密钥管理、网络访问和负载策略配置。

部署难度

中等

最低配置

建议 1 vCPU、512 MB 内存;使用 Go 1.23 或更高版本构建,或直接运行对应平台的预编译二进制。真实上游 API 的网络与凭据由部署方提供。

开源许可证

上游未声明许可证

最后验证

2026-09-04

技术栈

GoGinHTML/CSS/JavaScriptCanvas 图表

授权说明

上游仓库未提供显式 LICENSE 文件,README 标注教育/开发用途。交付包保留来源说明与署名;商业再分发、网络服务或衍生使用前需取得上游授权并补充明确许可边界。

Release notes

版本记录

1 个已发布版本

v2.0.0-cn-998 当前推荐

中文化 Web 监控界面,加入本地演示适配器和内置 Canvas 图表,修复零间隔健康检查、默认重试、端点状态保留与请求挂起恢复统计问题。

部署要求:Go 1.23 或更高版本;生产运行需要可访问的 Claude API 兼容端点和由部署方管理的凭据。

已知问题:完整历史测试套件中保留两个与当前代码语义或测试阈值相关的告警;发布前应以目标环境的端到端流量和授权配置再次验证。

登录后领取