Trae

准备 API

在配置之前，请确保已获取以下信息

API Key

以 magik- 开头的字符串。

Base URL (接口地址)

地址：https://api.magikcloud.cn/v1

重要：务必包含末尾的 /v1

模型名称

请在模型广场复制完整模型名称，如：DeepSeek-V4-Pro

---

安装 Trae

通过 Trae 官网 下载并安装 Trae。

---

接入 Trae

添加自定义模型

1. 打开设置中心：
2. IDE 模式界面： 点击界面右上角的设置图标

3. SOLO 模式界面： 点击对话面板右上角的设置图标

4. 在左侧导航栏中，选择 "+ 添加模型"

选择模型服务商

在服务商列表中选择 "OpenAI"（用于接入 OpenAI 兼容接口）

如果列表中没有合适的选项，也可选择 "OpenRouter" 等其他支持自定义地址的服务商。

填写鉴权信息

1. 点击列表中的 "使用其他模型"，在输入框中填写模型 ID（如 GLM-5.1 / DeepSeek-V4-Pro / MiniMax-M2.7）

2. 填写 API 密钥（以 magik- 开头的字符串）

自定义请求地址

1. 在 "自定义请求地址" 中填入：https://api.magikcloud.cn/v1/chat/completions

   若为空，系统将默认使用该服务商的默认地址，因此务必填写。

2. 点击 "添加模型" 完成配置

验证结果

Trae 会自动调用接口检测 API 密钥是否有效：

• 连接成功 → 自定义模型添加完成
• 连接失败 → 查看弹窗中的错误信息和日志进行排查

启用模型

在模型面板中，确保刚添加的模型已启用（启用后才会出现在模型选择列表中）

使用模型

在 AI 对话输入框的右下角，点击当前模型名称，打开模型列表，选择你添加的模型

---

管理自定义模型

在 模型 面板中，你可以对自定义模型进行管理：

• 编辑模型 — 点击编辑图标，修改服务商、模型名称、API 密钥等信息
• 删除模型 — 点击删除图标，二次确认后移除模型
• 禁用模型 — 暂时不使用但不删除，禁用后模型不会出现在选择列表中