TEE Router /Docs
返回官网

TeeProxy 用户接入

注册身份、验证 Router,并启动本地 API。

让本地 Agent 通过已验证的 Router 调用模型。

你的 AgentTeeProxyTEE Router官方模型服务
1

下载客户端,注册本地 ID

  1. 从 TeeProxy Releases ↗ 下载 Windows x64 发行包,完整解压后运行 teeproxy.exe。
  2. 打开左侧「我的账户」,点击「注册新 ID」。已有本地 ID 时,从下拉框选择,再点击「使用此 ID」。
  3. 确认页面显示当前用户 ID。按需在「充值与提现」查看充值方式和余额,再进行付费调用。
TeeProxy 我的账户页面,上方提供本地 ID 选择、使用此 ID 和注册新 ID 按钮
01 / 我的账户先注册 ID,再把这份本地身份用于后续请求。点击截图可放大。

请保留客户端的数据目录和原有 Windows 用户环境。Windows 上的身份密钥受本机加密保护,仅复制文件到另一台电脑并不等于完成身份迁移。

2

核对连接信息,完成 TEE 验证

  1. 进入「连接与验证」,核对实际部署的 Router HTTPS 地址。
  2. 按 Router 的类型使用对应的 TDX 或 SNP 信任策略。优先使用发行包配套、经过核对的策略;手动配置时,从项目认可的发行说明或部署方取得对应文件。
  3. 保存配置,点击页面中的验证操作。确认验证成功,再启动代理;失败时先查看诊断信息。
这里验证什么?客户端校验 TEE 证明、平台安全状态和策略允许的软件度量,并确认正在连接的 TLS 端点与证明绑定。信任策略表达的是“允许运行什么”,不能为了通过验证而照抄未知节点的度量值。
TeeProxy 连接与验证页面,包含 Router HTTPS 地址、TDX 和 SNP 策略文件以及验证操作
02 / 连接与验证图中的 router.example 和策略文件名是占位示例,请换成实际部署信息。
3

选择模型,设置路由规则

打开「账号池与模型」查看商户、模型 ID、池倍率和可用状态。将完整模型 ID 复制下来,后面填入 Agent;不要只填写展示名称。

  • 指定账号池:使用界面的应用操作,固定到你选定的商户池。
  • 自动匹配:在「路由策略」设置倍率上限和优先规则,保存后由 Router 按规则选择。
  • 核对价格:池倍率会影响实际费用;仅浏览或选中一行,不等于已经应用路由。
TeeProxy 路由策略页面,可配置固定账号池、自动匹配、倍率上限及路由偏好
03 / 路由策略保存规则后再发起请求;模型、授权和可用容量也会影响匹配结果。
4

启动本地 API

  1. 进入「Agent 接入」。Agent 与 TeeProxy 在同一台电脑时,监听 IP 使用 127.0.0.1,默认端口为 8899。
  2. 点击「生成 API key」,再用「复制 API key」保存到 Agent 配置中。也可自行设置 16–256 个可见 ASCII 字符;两端必须使用同一个值,不要使用截图中的演示 key。
  3. 保存配置并启动代理,确认页面显示正在监听的地址。运行 Agent 时保持 TeeProxy 运行。
TeeProxy Agent 接入页面,显示本地监听 IP、端口、API key 以及启动代理按钮
04 / Agent 接入API key 只用于 Agent 到 TeeProxy 的本地认证;截图中的值为演示数据。
5

配置 Agent

查看 Codex 与 Claude Code 的配置示例 →

6

确认首次调用成功

先检查本地 API 是否可访问。把 key 占位符替换为你设置的值,再运行:

PowerShell · 读取模型目录
Invoke-RestMethod -Uri 'http://127.0.0.1:8899/v1/models' -Headers @{
  Authorization = 'Bearer YOUR_TEEPROXY_API_KEY'
}

能读到目录说明本地接口已响应。接着让 Agent 发出一条简短请求,确认收到回答;再去「运行记录」查看连接情况,在「消费明细」核对模型、用量和费用。实际模型请求会按平台规则计费。

接入完成TEE 验证通过 · 本地 API 已启动 · Agent 收到模型响应