除了使用 Trae 内置的模型，你还可以将自己的第三方模型 API 接入 Trae，从而调用自己申请的模型服务。这样做通常出于几种考虑：使用特定厂商的模型、控制调用成本、满足数据合规要求，或者接入本地部署的私有模型。
配置入口
- 打开 Trae 的设置页面（独立客户端：左下角齿轮 → “设置”；VS Code 插件：侧边栏面板右上角齿轮 → “AI 设置”；JetBrains：
Settings → Tools → Trae）。 - 在设置中找到 “模型” 或 “AI 模型” 区域，通常会看到“自定义模型”或“添加第三方模型”相关的按钮或卡片。
- 点击 “添加自定义模型” 或类似的入口，进入配置界面。
需要填写的信息
配置一个自定义 API 模型通常需要提供以下几项信息：
- 供应商/服务商名称：可以自定义一个便于自己辨识的名称，例如“我的 OpenAI”、“公司内网 DeepSeek”等，它仅仅显示在模型切换列表中，不影响实际调用。
- API 端点（Base URL）：模型服务的 API 地址，要求支持 OpenAI 兼容接口（即
/v1/chat/completions）。常见的例子： - OpenAI 官方：
https://api.openai.com/v1 - 其他兼容服务（如 DeepSeek、Moonshot、零一万物等）：按照对应服务商文档填写，一般也是以
/v1结尾。 - 本地私有部署（如 Ollama、vLLM、LocalAI）：通常为
http://localhost:11434/v1或http://127.0.0.1:8000/v1等，注意本地地址要确保 Trae 所在环境能访问到。 - API 密钥（API Key）：服务商分配的身份凭证，用于鉴权和计费。填写后 Trae 会加密存储，不会明文暴露在日志或界面中。请妥善保管，泄露后需及时在服务商后台重建。
- 模型 ID / 名称：实际调用的模型名称，例如
gpt-4o、deepseek-chat、claude-3-5-sonnet-20240620等。注意某些服务商会在文档中列出可用的模型 ID，必须准确填写，否则接口会返回模型不存在的错误。 - 其他可选参数（可先留空）：
- 请求超时：默认值一般足够，如果模型响应很慢可适当调大。
- 最大上下文长度：通常模型会自动从接口能力中获取，若遇到上下文超限错误，可在此手动限制。
- 温度参数：影响输出随机性，通常使用服务商默认值即可。
保存并验证
填写完毕后，点击 “测试连接” 或 “保存” 按钮。如果配置正确，一般会显示“连接成功”或类似消息。之后在模型切换的下拉列表中就能看到你刚才添加的自定义模型。
常见连接失败原因：
- API 端点填写错误（常见是少写
/v1，或多写了后缀如/v1/chat/completions，应该只到/v1）。 - API Key 无效或已过期（可以到服务商后台重新生成）。
- 网络无法访问目标地址：如果是本地模型，确认 Trae 能访问
localhost；如果是云服务，检查防火墙或代理设置。 - 模型 ID 不正确（大小写敏感，注意服务商提供的精确名称）。
使用注意事项
- 功能兼容性：大部分 AI 功能（行内补全、侧边栏对话、一键处理等）都能使用自定义模型，但某些 Trae 特色功能（如
@引用文件时将上下文内联注入）依赖模型的上下文窗口和指令跟随能力。如果模型能力较弱，可能会出现效果不佳的情况。 - 费用与配额：使用自定义 API 会直接向你的服务商产生费用，Trae 本身不对此计费。注意控制调用频率，避免意外高额账单。
- 性能与稳定性：私有模型或某些第三方服务的延迟可能高于内置模型，请根据实际体验取舍。
- 隐私：数据将发送到你指定的 API 端点，因此选用私有部署模型可以确保代码不离开内部网络，满足严格的数据安全需求。
配置完成后，你可以在实际编码中对比内置模型和自定义模型的效果，为不同类型任务选择最合适的模型，这本身也是一种提高产出的策略（详细选型建议见第 4.5.2 节）。