Trae 配置教程

更新于 2026-09-28

适用范围：TRAE 自定义模型页面；国内版/国际版及所用版本分别核对入口。

版本与验证：本机未安装 TRAE；当前国内版步骤及开关已按官方资料核验。Python requests 2.33.1 的 Chat / Messages 真实调用通过；TRAE 界面、Agent 与国际版尚未实测。

配置速查

配置项	填写内容	注意事项
完整 URL	`开启`	本教程选择完整路径模式，开关与地址必须匹配。
OpenAI 请求 URL	`https://api.apizt.com/v1/chat/completions`	仅在完整 URL 开关开启时按此填写。
Anthropic 请求 URL	`https://api.apizt.com/v1/messages`	按 apizt 原生 Messages 路由填写。
API Key	`apizt API Key`	在自定义模型凭据中填写。
Model Name	`协议匹配的可用模型 ID`	选择聊天或 Messages 协议后分别填写。

还没有 API Key？注册获取免费体验额度 · 已注册：进入控制台创建 API Key

为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。

第 1 步：安装并核对自定义模型入口

按官网提供的平台下载安装，在 Settings → Models 中查找 Custom Model。国内版、国际版与不同发行版本的入口和字段可能不同，先确认当前版本能编辑 API URL 与模型 ID。

TRAE 官方文档的添加模型入口 — TRAE 国内版官方资料图片，2026-09-28 核验；展示添加入口，非本机配置截图。

第 2 步：选择协议并填写接口

在「设置 → 模型 → 添加模型 → 自定义模型」选择 API 格式，并开启「完整 URL」开关。开启后填写完整请求路径：OpenAI 格式填写 https://api.apizt.com/v1/chat/completions；Anthropic 格式填写 https://api.apizt.com/v1/messages。如果当前版本字段明确要求 SDK 基础地址，应按该版本说明配置并核对最终请求路径，不能把完整 URL 作为所有版本的固定要求。

完整 URL 开关	应填写的地址	验证目标
开启 / OpenAI	`https://api.apizt.com/v1/chat/completions`	最终请求仍为此路径
开启 / Anthropic	`https://api.apizt.com/v1/messages`	不要选择 Chat 格式
关闭	按当前版本要求填写基础地址	检查客户端追加路径；不要把完整路径重复追加

第 3 步：保存令牌与目标模型

API Key 填 apizt 令牌。首次连通验证可选 gpt-4o（本次 Chat 接口验证模型）；其他模型包括 gpt-6-sol 需按该工具和分组的能力选择；Anthropic 格式选择当前令牌允许的 Messages 模型 ID。协议与模型能力需匹配，展示名称不能代替真实模型 ID。

第 4 步：在新对话验证请求

保存后选中自定义模型并新建对话，发送一个短问题。核对 apizt 调用日志的模型与请求时间，再测试代码上下文和工具功能。404 时查看实际请求 URL，尤其排除重复追加端点或缺少 /v1。

真实调用记录与验证范围

测试日期：2026-09-28（Asia/Shanghai）；macOS 26.3。查看脱敏记录、软件版本和真实生成图片。一次文本成功仅证明本次请求，不代表其他模型、工具执行、多轮上下文或桌面版均已通过。

POST https://api.apizt.com/v1/chat/completions
model: gpt-4o
Authorization: Bearer [REDACTED]
HTTP 200
output: tokenba_OK

此记录来自独立接口请求；进入 TRAE 后仍需选中自定义模型，发送同一提示，并对照控制台调用日志确认客户端使用了此提供商。

404：核对完整 URL 开关与最终请求路径。模型失败：核对模型权限与协议。

连接失败时按这几步排查

打开“完整 URL”时，Chat Completions 填 https://api.apizt.com/v1/chat/completions；Messages 填 https://api.apizt.com/v1/messages。关闭时由客户端拼接，必须检查最终路径。

确认正在使用的 TRAE 版本、国内或国际版本及自定义模型入口；记录“完整 URL”开关状态。
先按模型通道选择 OpenAI Chat Completions 或 Anthropic Messages，再配置对应完整 URL、Key 与模型 ID。
保存后选择该自定义模型，新建短会话；出现 empty content 时核对响应结构和流式事件，而不只看 HTTP 200。

容易混淆的情况

完整 URL 开启时填写 /v1 会请求到错误位置；关闭时粘贴完整端点可能造成路径重复。
模型校验成功不证明 Builder、工具调用和长上下文都可用；逐项测试需要的功能。

怎样确认修复成功

确认最终 URL 与选定 API 格式一致，返回有效文本且平台有对应日志；再验证一个最小工具任务。

记录所装客户端版本、模型 ID、请求时间、最终路径与脱敏状态。本节为配置核对指南，未新增客户端付费调用实测；保留原文已有验证记录的适用范围。

打开 TRAE 交互排错并下载检查记录 · 官方配置参考

怎样确认配置已生效

自定义模型验证通过并在会话中选中。
实际请求路径与所选协议相符。

接入失败时逐项检查

现象	检查与处理
自定义入口不可见	确认产品版本、地区和账户支持情况，按对应官方资料操作。
404	检查此字段是否要求完整请求 URL，按 apizt 接口文档核对路径。
能聊天但代码任务失败	分别验证工具调用和代码能力，不将聊天通过当作 Agent 验证。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。