TRAE 接入 LYRouter：安装、配置与故障排查

TRAE 可以通过自定义模型服务接入 LYRouter。本文从安装前提开始，说明如何配置并完成第一次调用。

已安装应用？直接查看配置 LYRouter。

前提条件

准备 TRAE 账号、联网环境及本地安装权限。选择操作系统，检查系统版本和处理器架构，并确认客户端提供自定义模型配置入口。

Get-CimInstance Win32_OperatingSystem | Select-Object Caption, Version, OSArchitecture

cat /etc/os-release
uname -m

sw_vers -productVersion
uname -m

接入 LYRouter 还需要一把已启用的 API Key 和当前工作空间可用的模型。示例中的 MODEL_ID 必须替换为实际系统模型标识；工具账号与 LYRouter 账号是两个独立身份。

安装应用

1. 打开TRAE 下载中心。
2. 选择操作系统与架构对应的安装包，完成安装。
3. 首次启动选择语言与主题，并完成 TRAE 登录。
4. 在“关于”或更新信息中确认客户端版本，再打开一个测试项目。

配置 LYRouter

进入模型设置，添加自定义 / OpenAI 兼容模型：

保存后显式选择该自定义模型。TRAE 内置 Auto 不等同于 LYRouter Auto，也不保证使用自定义模型。

验证首次调用

启动应用，显式选择刚配置的模型，发送“请回复 OK”这样的最小任务。再到 LYRouter 的请求日志检查生成端点、状态和实际模型。连接测试成功不等于完整生成或工具调用已通过。

日常使用与故障排查

安装后无法启动应用，应该如何检查？

答： 按本页“前提条件”核对操作系统、处理器架构和安装权限，再按对应系统的安装指南检查安装结果。使用官方提供的安装包，具体系统要求以本页链接的官方资料为准。

自定义模型的 Base URL 应该怎么填？

答： 本页 OpenAI 兼容配置使用 https://api.lyrouter.com/v1，并填写 LYRouter API Key 和系统模型标识。不要重复追加 /v1，保存后在会话中显式选中自定义模型。

切换模型前需要检查什么？

答： 确认新模型已在当前工作空间启用、至少有一个有效服务来源，并支持应用所需的协议和工具能力。使用系统模型标识，不使用展示名称。

应用更新后，原来的配置为什么不生效？

答： 先核对当前应用版本和实际读取的配置位置，再对照本页“配置 LYRouter”检查提供商、地址、密钥和模型。不同版本的配置要求以本页链接的官方资料为准。

请求返回 401 / 403，应该先检查什么？

答： 确认填写的是已启用的 LYRouter API Key，并检查该 Key 所属工作空间的模型来源与访问策略。结合具体错误和日志判断拒绝来源，详见鉴权与权限 FAQ。

请求返回 429，反复重试有用吗？

答： 先确认是平台限制还是上游额度耗尽，再调整并发、调用频率或资源配置。使用有上限的退避重试，避免立即密集重试，详见限流与配额 FAQ。

应用有回复，但 LYRouter 日志里找不到请求，怎么办？

答： 确认会话选中了刚配置的自定义模型，而不是内置或 Auto 模式，再发送最小生成请求。在正确工作空间按时间和 Key 查询请求日志；刚结束的请求可能需要稍后刷新。

官方资料

下列要求和安装方式来自工具官方资料，后续版本以官方说明为准。

• 安装前提与步骤
• 自定义模型