CodeRelay
概览 功能 架构 上手 FAQ 下载
概览

CodeRelay 工作台界面复刻

以上为 CodeRelay 工作台界面的 HTML / CSS 复刻展示，数据为演示用占位内容。

为什么需要它

账号一多，麻烦就从四个方向涌进来

把分散的账号、Key 与配置收敛进一个工作台，是 CodeRelay 存在的全部理由。

没有它的时候

账号只能手动切换

哪个账号还有余量，全靠自己记；换账号就要重配一遍客户端。

额度与冷却不可见

不知道谁在冷却、谁快用尽，只能等请求失败才发现。

每个客户端各配一份 Key

多一个客户端就多一处密钥散落，轮换时逐台更新。

出了故障不可观测

看不到请求去了哪个账号、花了多少 Token、卡在哪一步。

有了 CodeRelay

一个端点 + 一个 Key

所有客户端指向 127.0.0.1:11435，剩下的事交给账号池调度。

健康度一览

可用、冷却、需处理三类状态在首页直接展开，额度按账号呈现。

Key 绑定账号范围

每个 sk- Key 可限定可用账号与可用模型，按需启用或禁用。

请求可追溯

请求数、Token、缓存命中率、Credit 与逐条日志都留在本地。

核心功能

八件事，一个工作台

从账号接入到 Key 分发，从调度策略到统计导出，全部在同一个本地应用里完成。

账号池管理

浏览器认证、手动粘贴 Token、导入配置文件三种方式添加账号；健康状态、冷却、额度与绑定关系一览，支持长按拖拽排序与账号导出备份。

API Key 管理

签发 sk-* 前缀的 Key，可绑定账号范围、限制可用模型、设置别名并随时启用或禁用。

模型管理

从在线接口同步模型清单并本地缓存，跨重启保留；支持别名与禁用，同步失败时逐账号回退并给出可见的错误提示。

本地反代服务

默认监听 127.0.0.1:11435，手动启动与停止，支持多账号调度策略与会话亲和。

局域网接入

访问范围可切换为「本机 + 局域网」，界面自动识别并展示局域网地址，一键复制并附防火墙放行命令。

统计与日志

总请求数、Token、缓存命中率、Credit 消耗与按小时柱状图；日志当日保留，支持筛选、详情与 JSON 导出。

系统托盘与通知

最小化到托盘，在托盘里启动或停止反代、退出应用；启动失败与服务异常时发送 Windows 系统通知。

更新检测

查询 GitHub 最新 Release 并与当前版本比对，发现新版本时提示并可打开发布页；不会自动下载或安装。

架构与可信度

三层各司其职，数据面不离开本机

界面、桌面壳与反代引擎分开构建：前端负责呈现，Rust 负责进程与状态，Go sidecar 只做转发与调度。

前端 React 19 + TypeScript

React 19 · Vite

工作台界面与状态管理，通过 Tauri invoke 与事件与桌面壳通信。

Tauri invoke / 事件

桌面壳 Tauri 2 + Rust

Tauri 2 · Rust

管理 sidecar 进程与状态机、注入配置与凭据、解析结构化事件，并负责窗口、托盘与更新检测。

拉起 sidecar + stdout 事件

反代引擎 Go sidecar

Go · 127.0.0.1:11435

本地 HTTP 服务、账号调度、协议转换与模型清单同步；只处理请求转发，并通过标准输出回传生命周期与请求事件。

本地优先

账号凭据、Token 与 sk-* Key 仅保存在本机，不上传；请求日志只保留当天，统计按天聚合后持久化。

多协议兼容

同一端口同时提供 OpenAI、Anthropic Messages、Gemini、Ollama、图像生成与 Codex 实时端点，客户端不必改协议。

可诊断调度

一次请求依次经过范围绑定、可用性判断、模型排除、额度保留、策略排序与会话亲和；没有可用账号时，逐账号给出拦截原因。

三步上手

装好之后，四条命令都用不上

安装包、双击、启动服务，然后把客户端指向本地地址即可。

添加账号

在「账号池」里用浏览器认证、手动粘贴 Token 或导入配置文件的方式添加上游账号。

创建 API Key

在「API Key」页面创建一个 sk-* 开头的 Key，并绑定可用的账号范围。

启动服务

在「服务配置」或底部状态栏手动启动反代服务；服务不会随软件自启。

客户端接入示例 
curl http://127.0.0.1:11435/v1/chat/completions \
  -H "Authorization: Bearer sk-cr-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'

OpenAI 兼容 base_url： http://127.0.0.1:11435/v1

常见问题

下载之前，你可能想先确认这些

会自动更新吗？

不会。CodeRelay 只查询 GitHub 最新 Release 与当前版本比对，发现新版本时在界面里提示，并打开发布页由你自己下载安装包；它不会自动下载或安装更新。

会上传我的凭据吗？

不会。账号凭据、Token 与 API Key 只保存在本机，本项目不收集、不上传任何凭据。反代服务本身仍需联网访问上游服务。

支持 macOS 或 Linux 吗？

不支持。CodeRelay 是仅面向 Windows 10 / 11 的桌面应用，安装包为桌面安装程序。

和上游服务的官方有关系吗？

没有。CodeRelay 是独立的第三方工具，与任何上游服务的官方主体都没有关联，也未获得其背书。

许可证是什么？

MIT with Commons Clause：在 MIT 许可的基础上附加 Commons Clause 条件，允许使用、修改与分发，但禁止将本软件以收费形式提供。

请求日志会保留多久？

当日保留。请求日志跨天自动清零，统计结果按天聚合后持久化，因此历史数据仍可在统计视图里回看。

能让局域网里的其它设备接入吗？

可以。在「服务配置 → 网络 → 访问范围」切换到「本机 + 局域网」，界面会展示局域网接入地址并给出一条 Windows 防火墙放行命令；放行后手机、平板等设备即可访问。

服务会随软件自启吗？

不会。反代服务需要你在「服务配置」或底部状态栏手动启动。