TRAE 支持两种方式添加自己的模型:选择预设服务商,或者完全自定义配置。
入口
在 IDE 模式下,点右上角的设置图标,进入左侧导航的 模型,然后点 添加模型。
新版本对自定义模型的界面做过调整,入口名称可能略有不同,以你当前版本为准。
方式一:预设服务商
- 在服务商列表中选择一个(如 DeepSeek、火山引擎、阿里云百炼、OpenRouter、Anthropic 等,列表以实际界面为准)
- 选择要使用的模型
- 按提示填入该服务商的 API Key
方式二:自定义配置
服务商不在列表里,或者要接入公司内网的模型服务时,使用自定义配置,需要填写:
| 字段 | 说明 |
|---|---|
| API 格式 | 一般选 OpenAI;只提供 Anthropic 协议的服务选 Anthropic |
| 请求地址 | 服务的接口地址,注意确认是否需要带 /chat/completions 之类的后缀 |
| 模型 ID | 服务商那边的模型名,例如 deepseek-chat |
| 鉴权信息 | API Key |
TRAE 目前兼容 /v1/chat/completions 格式。
保存与校验
点击添加后,TRAE 会调用服务商的接口检测 Key 是否有效:
- 连接成功:模型出现在模型列表里,在对话框的模型选择器中就能选中
- 连接失败:窗口里会显示错误信息和服务商返回的日志,按提示检查地址、模型 ID 和 Key
常见问题
- 报 404:多半是请求地址的后缀多了或少了,对照服务商文档调整
- 报 401:Key 错误或已过期
- 模型不会调用工具:智能体模式依赖工具调用(function calling),请选择支持工具调用的模型