Trae 配置教程

外接兼容说明

不同版本或地区的 Trae 可能开放不同的自定义模型入口。本教程按照当前可见的配置流程编写；如果你的版本没有自定义模型入口，请不要强行修改本地文件。

一、打开设置

打开 Trae，点击右上角的设置（齿轮）图标。

在设置页面点击左上角菜单，选择「模型」或「模型管理」，进入模型管理页面后点击「+ 添加模型」。

在「添加模型」对话框中，切换到「自定义配置」选项卡，按下面的内容填写：

配置项	填写内容
API 格式	OpenAI Chat Completions / OpenAI 兼容
自定义请求地址	`https://api.apixhm.com/v1`
模型 ID	从 Yuan API 模型与价格页面复制
API 密钥	你的 Yuan API Key

如果 Trae 页面会自动在末尾追加 /chat/completions，不要手动再填写资源路径。

如果页面提供高级配置，可按实际模型能力填写模型系列、上下文窗口、输出长度和工具调用轮次；不确定时保持默认。

添加成功后，在「模型管理 → 自定义」中找到刚添加的模型。回到右侧对话面板，点击底部模型选择器，在自定义模型分组下选择它，发送一条简单消息验证配置。

Claude 需要单独添加一个自定义模型，接口类型和请求地址与 GPT / Codex 不同。

Claude 地址不带 /v1。如果 Trae 会自动追加 /v1/messages，不要手动填写该路径。

回到右侧对话面板，在自定义模型分组下选择 Claude 模型，发送「你好」验证是否能够正常回复。

提示

Trae 的 GPT / Codex 和 Claude 必须分别选择不同的 API 格式与 Base URL：