TRAE Work 配置指南

TRAE Work 是字节跳动推出的 AI 智能体（Agent）工作台，支持接入自定义大模型 API，用于办公问答、文档处理、代码编写等场景。TRAE Work 同时兼容 OpenAI Chat Completions 协议 与 Anthropic Messages 协议，只需填入请求地址、API 密钥和模型 ID，即可接入魔芋AI（MoyuAI）平台，使用平台上的 GPT、Claude、Gemini、豆包等各类模型。

本文以「魔芋AI」平台为例，讲解如何在 TRAE Work 中添加并一键切换自定义大模型，以及如何路由到其他模型。

1. 安装 TRAE Work

前往官方页面下载对应系统的安装包：

下载地址：https://www.trae.cn/work

支持平台：Windows、macOS

前置条件：需要拥有魔芋AI的 API Key（形如 sk-XXXXXX，在平台「令牌管理」页面创建），以及服务地址 https://www.moyu.cn。

安装后打开 TRAE Work，界面左侧为功能导航栏，点击模型进入模型管理页面。

2. 添加自定义模型

2.1 点击设置，打开「添加模型」

在左侧导航栏点击模型，进入模型管理页。

点击 添加模型，弹出「添加模型」窗口， 滚动到列表最底部，选择右下角的 「自定义配置」。

注意：不要选择 DeepSeek、腾讯云、火山引擎等预置厂商，否则会进入对应厂商的接入流程，而不是自定义配置界面。

2.2 选择 API 格式

进入自定义配置后，顶部有 模型服务商 / 自定义配置 两个标签页，切换到 「自定义配置」。

第一项 API 格式 决定使用哪种协议，魔芋AI 两种都支持，二选一即可：

API 格式	适用模型	自定义请求地址	自动补全路径
OpenAI Chat Completions 格式（推荐）	GPT、Claude、Gemini、豆包、DeepSeek 等全部模型	`https://www.moyu.cn/v1`	`/chat/completions`
Anthropic Messages 格式	Claude 系列原生协议	`https://www.moyu.cn`	`/v1/messages`

魔芋AI 已将各家模型统一转换为 OpenAI 格式，推荐首选 OpenAI Chat Completions 格式，一套配置即可路由到平台全部模型；仅当你需要 Claude 原生 Anthropic 协议时，才选择 Anthropic Messages 格式。

3. 填写核心配置

3.1 方式一：OpenAI Chat Completions 格式（推荐）

配置项	填写内容	说明
API 格式	`OpenAI Chat Completions 格式`	从下拉列表选择
自定义请求地址	`https://www.moyu.cn/v1`	魔芋AI 的 OpenAI 兼容地址，不要以斜杠结尾；`/chat/completions` 会自动补到末尾
完整 URL	关闭（默认）	保持关闭，让客户端自动补全路径
模型 ID	如 `DeepSeek-V4.1-flash`、`glm-5.3`	必须与魔芋AI平台支持的模型 ID 完全一致（含大小写与连字符）
多模态	按模型能力开启	多模态模型（支持图片输入）可开启此开关
API 密钥	`sk-XXXXXX`	你的魔芋AI API 密钥，粘贴后检查首尾是否有多余空格

3.2 方式二：Anthropic Messages 格式

配置项	填写内容	说明
API 格式	`Anthropic Messages 格式`	从下拉列表选择
自定义请求地址	`https://www.moyu.cn`	不带 `/v1`、不以斜杠结尾；`/v1/messages` 会自动补到末尾
完整 URL	关闭（默认）	保持关闭，让客户端自动补全路径
模型 ID	如 `claude-opus-4-8`	必须为魔芋AI平台支持的 Claude 模型 ID
多模态	按需开启	Claude 支持图片输入，可开启
API 密钥	`sk-XXXXXX`	你的魔芋AI API 密钥

两种格式请求地址不同：OpenAI 格式填 https://www.moyu.cn/v1（带 /v1），Anthropic 格式填 https://www.moyu.cn（不带 /v1）。这是最容易填错、导致 404 的地方。

3.3 高级配置

点击 高级配置 可展开更多选项，如：展示名称等配置：

展示名称：在对话列表中显示的名字，方便区分多个模型。

支持图片输入：特别注意，deepseek为纯文本模型，配置deepseek模型时，"支持图片输入"要勾选 不支持。

配置完成后点击确认保存。

4. 验证

保存后，在对话窗口 手动切换到刚配置的模型，发送一条测试消息（如"你好"），能正常对话即配置成功。

注意：保存后不会自动切换模型，必须在对话框手动选择新模型，否则配置看起来"不生效"。

5. 切换供应商 / 模型

配置好多个模型后，切换非常简单：

在对话框底部 点击当前模型名称，从列表中选择目标模型即可即时切换。

也可在模型页面管理、启用或停用各个自定义模型。

切换后当前对话即用新模型，无需重启 TRAE Work。

6. 模型路由配置（切换 / 指定其他模型）

魔芋AI平台已将各家模型统一转换为 OpenAI 格式，因此使用 OpenAI Chat Completions 格式 接入时，API 格式、请求地址、API 密钥保持不变，只需更换 模型 ID 即可路由到平台上的其他模型。

6.1 配置不同模型

在自定义配置中，将 模型 ID 改为目标模型 ID，其余配置保持不变，即可新增一个模型条目：

请以平台「模型广场」或 GET https://www.moyu.cn/v1/models 返回的实际模型名称为准。

6.2 按能力开启多模态

不同模型支持的能力不同：

多模态（图片输入）：多模态模型（如 gpt-4o、claude、gemini 系列）在配置中开启 多模态 开关。

纯文本模型：关闭多模态开关即可。

配置完成后点击确认，并在对话窗口手动切换到该模型即可使用。

7. 常见问题

Q：保存后模型没变化 / "不生效"？
A：TRAE Work 保存后不会自动切换，需在对话框底部 手动选择 新配置的模型再发送消息。

Q：提示 404 Not Found？
A：确认请求地址与所选 API 格式匹配——OpenAI 格式填 https://www.moyu.cn/v1，Anthropic 格式填 https://www.moyu.cn；两者都 不要以斜杠结尾，也不要手动加 /chat/completions 或 /v1/messages（客户端会自动补全）。若开启了「完整 URL」开关，请关闭它。

Q：提示 401 / 密钥无效？
A：检查 API Key 是否完整、有无多余空格；确认令牌未过期、账户额度充足。

Q：请求地址到底带不带 /v1？
A：取决于 API 格式。OpenAI Chat Completions 格式带 /v1（https://www.moyu.cn/v1）；Anthropic Messages 格式不带（https://www.moyu.cn）。

Q：「完整 URL」开关是干什么的？
A：开启后 TRAE Work 会把你填写的地址当作完整端点、不再自动补全路径。除非你要指定特殊路径，否则 保持关闭。

Q：提示 connect ETIMEDOUT？
A：说明网络无法连接到端点，检查网络环境或代理设置，确认 https://www.moyu.cn 可正常访问。

Q：多模态开关要不要开？
A：仅当目标模型支持图片等多模态输入时开启（如 gpt-4o、claude、gemini）；纯文本模型保持关闭。

1. 安装 TRAE Work#

2. 添加自定义模型#

2.1 点击设置，打开「添加模型」#

2.2 选择 API 格式#

3. 填写核心配置#

3.1 方式一：OpenAI Chat Completions 格式（推荐）#

3.2 方式二：Anthropic Messages 格式#

3.3 高级配置#

4. 验证#

5. 切换供应商 / 模型#

6. 模型路由配置（切换 / 指定其他模型）#

6.1 配置不同模型#

6.2 按能力开启多模态#

7. 常见问题#