常见问题

先确认 TeeProxy 已启动代理，监听地址与端口一致。401 通常需要检查 Agent 的 key 是否与「Agent 接入」中配置的本地 key 完全一致；用户 ID、平台身份和上游 token 都不能代替这个 key。连接被拒绝时，检查进程是否运行、端口是否被占用。

应先核对 Router 地址、对应的 TDX / SNP 策略、客户端版本、系统时间和网络连通性。查看验证诊断；升级部署后，使用经过确认的新策略。不要关闭验证或盲目放宽策略来消除报错。

重新从 TeeProxy 目录复制完整模型 ID，确认 Agent 协议与提供商对应。再检查余额、商户访问权限、固定池选择、倍率上限、开放模型和容量。提高倍率上限会影响费用，先确认价格再调整。

不同 Agent 会调用不同辅助接口。当前接入以 HTTP Responses / SSE 和 Anthropic Messages 为主；例如 /responses/compact、/messages/count_tokens 等接口不一定支持。核对 TeeProxy 的客户端兼容说明与版本，并使用本文的 HTTP 配置。

检查账号是否启用、测试是否通过、同步是否完成；随后检查该池的开放模型列表是否为空。仅创建空池、保存本地凭据或在目录里看到账号，都不代表已完成发布。

先核对该账号的网络代理是否可用，再按所属提供商的官方流程重新授权。检查服务是否持续运行，以及是否开启自动续期。只有 access token 而没有有效续期凭据时，过期后需要重新授权或更新导入信息。

本地身份与账号凭据包含受操作系统或本机密钥保护的数据。保留完整数据目录和原解密环境，按客户端提供的迁移方式操作；不要覆盖唯一备份。尤其在 Windows 上，复制受保护文件到另一台电脑并不会自动获得解密能力。