
LunaRoute
LunaRoute 是一个高性能的本地代理,适用于 Claude Code、OpenAI Codex CLI 和 OpenCode 等 AI 编码助手,它提供对每个 LLM 交互的完全可见性,具有零开销直通、全面的会话记录和强大的调试功能。
https://github.com/erans/lunaroute?ref=producthunt&utm_source=aipure

产品信息
更新于:2025年11月03日
什么是 LunaRoute
LunaRoute 是一个专为 AI 编码助手设计的开源本地代理,充当开发工具和 AI 服务之间的透明桥梁。它使开发人员能够监控、调试和分析他们的 AI 交互,而不会影响性能或安全性。该工具需要最少的配置 - 用户可以在几秒钟内启动它,甚至不需要提供 API 密钥,因为它与 AI 编码助手现有的身份验证方法无缝协作。
LunaRoute 的主要功能
LunaRoute 是一个高性能的 AI 编码助手本地代理,提供对 LLM 交互的全面可见性和控制。它提供零开销的直通模式、详细的会话记录、PII 保护和强大的调试功能,同时支持多种 AI 助手,如 Claude Code、OpenAI Codex CLI 和 OpenCode。该工具能够跟踪令牌使用情况、性能指标和具有内置隐私功能和合规性控制的对话历史记录。
零开销直通模式: 仅增加 0.1-0.2 毫秒的延迟和 100% 的 API 准确性,允许透明地代理请求,而不会影响性能
全面会话记录: 以 JSONL 和 SQLite 格式记录所有对话、令牌和工具调用,并具有可自定义的保留策略和 PII 保护
高级 PII 检测与密文处理: 在存储之前,使用多种密文处理模式自动检测和密文处理敏感信息,如电子邮件、SSN 和信用卡
实时监控与分析: 提供 Prometheus 指标、会话统计信息和一个 Web UI,用于分析 AI 交互和性能指标
LunaRoute 的使用场景
开发调试: 通过提供对令牌使用情况和性能瓶颈的可见性,帮助开发人员跟踪和调试昂贵的 AI 对话
团队协作: 使多个团队成员能够共享一个代理,同时使用不同的 API 密钥,并具有集中式日志记录和监控
合规性与安全性: 通过提供自动 PII 密文和 AI 交互的全面审计跟踪来支持受监管的行业
性能优化: 通过详细的性能指标和分析来识别和优化缓慢的工具调用或低效的 AI 交互
优点
以亚毫秒级的开销实现最小的性能影响
全面的可见性和调试功能
强大的隐私和合规性功能
易于设置,无需配置
缺点
目前仅限于本地开发环境
Web UI 功能仍在开发中
73% 的测试覆盖率有待提高
如何使用 LunaRoute
安装 LunaRoute: 从 GitHub Releases 页面下载最新版本并解压:'tar -xzf lunaroute-server-*.tar.gz' 然后使其可执行:'chmod +x lunaroute-server'
添加到 PATH(可选): 将二进制文件移动到系统路径:'sudo mv lunaroute-server /usr/local/bin/'
启动 LunaRoute 服务器: 只需运行 'lunaroute-server' 即可使用默认配置启动。服务器将在端口 8081 上启动
配置 AI 工具: 对于 Claude Code,设置:'export ANTHROPIC_BASE_URL=http://localhost:8081'。对于 OpenAI Codex CLI,设置:'export OPENAI_BASE_URL=http://localhost:8081/v1'
访问会话记录: 会话会自动记录到 JSONL 格式的 ~/.lunaroute/sessions/ 目录和用于 SQLite 分析的 ~/.lunaroute/sessions.db
查看 Web 界面: 访问 http://localhost:8082 上的内置 Web UI 以浏览和分析记录的会话
实时监控: 使用以下命令实时观看会话:'tail -f ~/.lunaroute/sessions/$(date +%Y-%m-%d)/session_*.jsonl | jq'
配置 PII 保护(可选): 将 PII 编辑设置添加到配置文件,以自动检测和编辑敏感信息,如电子邮件、SSN 和信用卡号
查看指标(可选): 访问 http://localhost:8081/metrics 上的 Prometheus 指标,以监控请求速率、延迟、令牌使用情况等
开始使用 AI 工具: 开始正常使用您的 AI 编码助手 - 所有交互现在都将通过 LunaRoute 路由,具有完全的可见性和记录
LunaRoute 常见问题
LunaRoute 是一个高性能的本地代理,适用于 Claude Code、OpenAI Codex CLI 和 OpenCode 等 AI 编码助手。它提供对每个 LLM 交互的完全可见性,具有零开销的直通、会话记录和调试功能。











