本页内容
Trae
在 Trae 添加自定义模型，按模型选对 API 格式并填写地址，通过 HiAPI 使用 Claude、GPT、DeepSeek 等模型。
Trae 可以通过自定义模型接入 HiAPI。Trae 的 API 格式 按协议区分，模型必须选对格式才能接通。下面各举一个例子：claude-opus-5-5 用 Anthropic Messages 格式，gpt-6-astra 用 OpenAI Chat Completions 格式。本教程已在 Trae 3.4.4 上验证。
1. 准备 HiAPI API Key
按 获取 API Key 准备好 Key，点密钥行旁的复制图标，复制完整的 HiAPI API Key，下面填到 Trae 里。
2. 选择 API 格式
| 协议 | Trae 里选 | 适合的模型 |
|---|---|---|
| Anthropic Messages | Anthropic Messages 格式 | Claude 系列 |
| OpenAI Chat Completions | OpenAI Chat Completions 格式 | GPT 系列、DeepSeek 系列 |
| OpenAI Responses | OpenAI Responses API 格式 | 需要 Responses 特性的场景 |
本页的示例模型都按上表实测过。换其他模型时先按上表选格式，保存后发一条消息试试；报 400 does not support this endpoint 就换另一种格式。
3. 接入 Claude（Anthropic Messages 格式）
3.1 打开入口
在 Trae 左下角进入设置，在左侧找到 模型，点 添加模型 → 自定义模型。
3.2 填写字段
以 claude-opus-5-5 为例：
| 字段 | 填写 |
|---|---|
| API 格式 | Anthropic Messages 格式 |
| 自定义请求地址 | https://api.hiapi.ai（不带 /v1） |
| 完整 URL | 关闭 |
| 模型 ID | claude-opus-5-5 |
| 模型展示名称 | 自己好认的名字，例如 claude-opus-5-5 (HiAPI) |
| API 密钥 | 你的 HiAPI API Key |
Trae 会在地址末尾自动补 /v1/messages，最终请求 https://api.hiapi.ai/v1/messages。
3.3 换用其他 Claude 模型
只把模型 ID 换成目标模型，其他字段不变。上下文长度和最大输出以模型页为准。
4. 接入 GPT、DeepSeek（OpenAI Chat Completions 格式）
同样从 添加模型 → 自定义模型 进入。以 gpt-6-astra 为例：
| 字段 | 填写 |
|---|---|
| API 格式 | OpenAI Chat Completions 格式 |
| 自定义请求地址 | https://api.hiapi.ai/v1 |
| 完整 URL | 关闭 |
| 模型 ID | gpt-6-astra |
| 模型展示名称 | 自己好认的名字，例如 GPT-6 Astra (HiAPI) |
| API 密钥 | 你的 HiAPI API Key |
Trae 会在地址末尾自动补 /chat/completions，最终请求 https://api.hiapi.ai/v1/chat/completions。
要用 Responses 格式时，API 格式选 OpenAI Responses API 格式，地址同样填 https://api.hiapi.ai/v1。这个格式只支持流式输出，记得保持流式输出开启。
5. 地址填法速查
Trae 补的路径随 API 格式变化，地址填错会直接 404：
| API 格式 | 填写 | Trae 自动补 | 最终地址 |
|---|---|---|---|
| Anthropic Messages | https://api.hiapi.ai | /v1/messages | /v1/messages |
| OpenAI Chat Completions | https://api.hiapi.ai/v1 | /chat/completions | /v1/chat/completions |
| OpenAI Responses | https://api.hiapi.ai/v1 | /responses | /v1/responses |
规则：看 Trae 补的路径里有没有 v1。补的带 v1，填的时候就不带；补的不带，就自己带上。完整 URL 开关保持关闭，让 Trae 自动补路径；打开时必须填完整的请求地址。
6. 验证
配置保存后，建议新建会话再测。
6.1 对话
切换到刚添加的模型，发送「你好，用一句话介绍你自己。」，能正常回复就说明接入成功。
6.2 工具调用
先在 Trae 打开的项目文件夹里新建一个 tool-call-test.txt，写一行 hello hiapi 并保存，再到任务 / Agent 页面发送「只允许调用一次文件读取工具，读取 tool-call-test.txt 的全部内容并原样返回。不要修改文件，不要读取其他文件，不要根据文件名猜测内容。」，出现工具调用并返回 hello hiapi 就说明通过。实测 claude-opus-5-5 和 gpt-6-astra 都能正常对话和调用工具。
本教程只讲文本模型接入；要让 Trae 调用 HiAPI 的图片、视频工具，看 MCP 接入教程 的 Trae 篇。
7. 常见问题
下面只列 Trae 特有的问题，401、404、429 等通用报错见 通用报错。
| 报错 | 原因 | 处理 |
|---|---|---|
| 404 | 地址多写或少写了 /v1 | 按第 5 节的表填写 |
400 This model does not support this endpoint | API 格式和模型对不上 | Claude 选 Anthropic Messages 格式；GPT、DeepSeek 选 OpenAI Chat Completions 格式 |
| 401 / invalid api key | HiAPI API Key 填错 | 重新粘贴，注意前后不要带空格 |
max_tokens 相关报错 | 没设置最大输出 Token | 在高级配置里设一个合理的值；gpt-6-astra 用 Chat Completions 时不要设 max_tokens 和 temperature |
stream: must be true | 该模型只支持流式输出 | 开启流式输出 |
| 一直转圈 / 超时 | 网络问题或 API 格式选错 | 检查网络，确认 API 格式选对 |