代理服务

功能说明

代理服务在本地启动一个 HTTP 代理，所有 API 请求都通过代理转发。

主要用途：

• 记录请求日志
• 统计 API 用量
• 支持故障转移
• 集中管理多个应用的请求

启动代理

方式一：主界面开关

点击主界面顶部的 代理开关 按钮。

开关状态：

• 🔴 白色：代理未运行
• 🟢 绿色：代理运行中

方式二：设置页面

1. 打开「设置 → 高级 → 代理服务」
2. 点击右上角的开关

代理配置

基础配置

修改配置

1. 停止代理服务（必须先停止）
2. 修改监听地址或端口
3. 点击「保存」
4. 重新启动代理

⚠️ 修改地址/端口需要先停止代理服务

监听地址说明

运行状态

代理运行时，面板显示以下信息：

服务地址

http://127.0.0.1:15721

点击「复制」按钮可复制地址。

当前供应商

显示各应用当前使用的供应商：

Claude: PackyCode
Codex: AIGoCode
Gemini: Google 官方

统计数据

故障转移队列

代理面板会按应用类型显示故障转移队列：

Claude
├── 1. PackyCode      [当前使用] ●
├── 2. AIGoCode                  ●
└── 3. 备用供应商                 ○

Codex
├── 1. AIGoCode       [当前使用] ●
└── 2. 备用供应商                 ●

队列说明：

• 数字表示优先级顺序
• 「当前使用」标签表示正在使用的供应商
• 健康徽章显示供应商状态：
  • 🟢 绿色：健康（连续失败 0 次）
  • 🟡 黄色：降级（连续失败 1-2 次）
  • 🔴 红色：不健康（连续失败 ≥3 次）

工作原理

请求流程

sequenceDiagram
    participant CLI as CLI 工具 (Claude)
    participant Proxy as 本地代理 (Olenro)
    participant API as API 供应商 (Anthropic)
    participant DB as 数据存储 (Logger)

    CLI->>Proxy: 发送 API 请求
    Proxy->>DB: 记录请求日志/统计用量
    Proxy->>API: 转发请求
    API-->>Proxy: 返回响应
    Proxy-->>CLI: 返回响应

配置修改

启动代理并开启应用接管后，Olenro 会修改应用配置：

Claude：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
  }
}

Codex：

base_url = "http://127.0.0.1:15721/v1"

Gemini：

GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721

API 格式转换

代理支持为配置了非 Anthropic 格式的供应商自动进行 API 格式转换。这使你可以将仅支持 OpenAI 兼容 API 的供应商用于 Claude Code。

API 格式在添加或编辑 Claude 供应商时于高级选项中按供应商配置。

注意：格式转换需要代理运行并启用应用接管。转换同时支持流式和非流式请求。

停止代理

方式一：主界面开关

点击代理开关按钮关闭。

方式二：设置页面

在代理服务面板中关闭开关。

停止后的处理

停止代理时，Olenro 会：

1. 恢复应用配置到原始状态
2. 保存请求日志
3. 关闭所有连接

日志记录

开启日志

在代理面板中开启「启用日志」开关。

日志内容

每条请求记录包含：

查看日志

在「设置 → 用量」Tab 中查看请求日志。

常见问题

端口被占用

错误信息：Address already in use

解决方法：

1. 更换端口（如 5001）
2. 或关闭占用端口的程序

代理启动失败

检查：

• 端口是否被占用
• 是否有足够权限
• 防火墙是否阻止

请求超时

可能原因：

• 网络问题
• 供应商服务器问题
• 代理配置错误

解决方法：

• 检查网络连接
• 尝试直接访问供应商 API
• 检查供应商配置