Trae

Scope & Evidence

先确认当前版本有自定义 Base URL

Trae 的产品版本、地区和发布通道可能导致菜单名称或自定义模型能力不同。如果设置中没有自定义 Provider、Base URL 和模型 ID 输入项，本教程不能通过隐藏配置强行启用。

最后核验日期：2026-07-18。菜单路径属于高变化信息，页面刻意同时给出“字段判断标准”。

Install

从官方渠道安装并记录版本

1. 从 Trae 官方站点下载当前系统版本，核对签名、发布者和系统要求。
2. 首次启动先完成本地信任与隐私设置，不导入包含秘密的其他 IDE 配置。
3. 在 About / 关于页面记录版本、地区与更新通道，便于解释菜单差异。
4. 已有自定义模型时先截图脱敏字段并记录 Provider 名称；真实 Key 不进入截图。

Credential

每种 Provider 单独建 Key

1. 在 MuxLLM 控制台创建仅供 Trae 使用的独立 Key，设置额度和有效期。
2. 若同时测试 OpenAI 与 Anthropic，推荐为两种配置分别创建 Key，便于核对用量和快速停用。
3. 模型名必须从模型广场复制，不能使用 Trae 内置的官方模型别名代替。
4. 配置示例统一使用 YOUR_API_KEY 和 MODEL_NAME，页面不保存任何真实凭证。

Protocol Matrix

供应商类型、标签和地址必须成组匹配

OpenAI Compatible

配置 OpenAI 兼容模型

1. 进入 Settings / 设置中的 Models、AI Services 或 Provider 页面。
2. 选择 OpenAI Compatible、Custom OpenAI 或含义相同的自定义类型；不要选择官方账号登录。
3. Provider 名称填写 MuxLLM OpenAI，API Key 填写自己的独立 Key。
4. Base URL 精确填写 https://api.muxllm.com/v1；若界面另有 Path 字段，不重复添加 /v1。
5. 模型 ID 填写带 openai 标签的 MODEL_NAME，保存前逐字核对。

Anthropic

配置 Claude 原生模型

1. 新建另一条 Provider，类型选择 Anthropic、Claude API 或等价原生类型。
2. Provider 名称填写 MuxLLM Anthropic，不要复用 OpenAI 兼容条目。
3. Base URL 精确填写 https://api.muxllm.com，由 Trae 拼接 Messages 路径。
4. 模型 ID 只使用带 anthropic 标签的 MODEL_NAME。
5. 如果界面只有 OpenAI Compatible 类型，则当前版本不适用于本小节。

Acceptance

保存后只做一次短对话

1. 01连接测试

   若 UI 有 Test 按钮，先运行一次；它可能产生少量费用。

2. 02选择 Provider

   新建空对话并确认顶部显示目标 Provider 与模型。

3. 03短文本请求

   关闭 Agent、索引和工具，只请求一个短回复。

4. 04用量核对

   在控制台确认独立 Key、协议和模型一致。

Rollback

切回原 Provider 并删除测试凭证

1. 结束当前对话，切回执行前记录的 Provider 和模型。
2. 禁用或删除新建的 MuxLLM Provider；如果 Trae 支持导出，先生成不含真实 Key 的本地备份。
3. 清除应用可能保存的 Key，重启后确认 MuxLLM Provider 不再可用。
4. 控制台停用测试 Key，并检查测试期间的用量是否符合预期。

Troubleshooting

用最终请求路径判断字段是否填对

Security

IDE 权限比对话权限更大

• 首次验证使用无敏感文件的空目录，关闭自动执行、索引上传和不必要的 Agent 工具。
• 独立 Key 设置最小额度和有效期，不与生产服务共用。
• 截图只保留字段名、脱敏 Base URL 和错误码，完整 Key、账户与工作区内容必须遮盖。
• 不要安装来源不明的“解锁自定义模型”插件或修改 Trae 内部数据库。
• 疑似泄露时立即停用 Key，并检查应用日志、系统凭证存储和同步配置。

Official Sources

界面变化以 Trae 官方说明为准