TRAE SOLO 自定义模型配置教程：接入 OpenAI Compatible API（Base URL 与 API Key）
更新于
在 TRAE SOLO 里添加一个 OpenAI 兼容的自定义服务商，指向 API 快连，就能在 TRAE 里使用 GPT、Claude 等模型。这篇给出要填的值、操作顺序、验证方法和常见报错处理。
📌
一句话答案：服务商类型选 OpenAI 兼容（OpenAI Compatible / 自定义），Base URL 填
https://apikl.ai/v1，API Key 填控制台创建的 sk-...，模型先填 gpt-5.6-sol 测通。准备工作
- 在 控制台 创建一把密钥。想用 GPT 模型选 GPT 类分组，想用 Claude 模型选 Claude 类分组。
- TRAE SOLO 是图形界面软件，菜单名称会随版本调整，下文按 TRAE 官方社区教程（2026-05 的 v4.0 版）描述，找不到时在设置里搜索「模型」。
配置步骤
- 打开 TRAE SOLO，进入 设置 → 模型 → 添加模型（也可以在对话框的模型列表里点「添加模型」）。
- 选择 自定义配置，API 格式选 OpenAI。
- 按下表填写 Base URL、API Key 和模型名。
- 保存后在对话框里选中这个模型，发一句「你好」验证。
TRAE SOLO
Provider : OpenAI CompatibleBase URL : https://apikl.ai/v1API Key : sk-你的密钥Model : gpt-5.6-sol # Claude 分组密钥可填 claude-sonnet-5-5
💡
Base URL 必须带
/v1，末尾不要加 /chat/completions；「完整URL」开关保持关闭（打开它才需要填带 /chat/completions 的完整地址）。模型名要和 模型广场 里的写法完全一致。怎么选模型
- 日常编码先用
gpt-5.6-sol或claude-sonnet-5-5，速度快、单价低。 - 复杂任务换
gpt-6.1-sol或claude-opus-5-5。 - 密钥绑定分组：GPT 分组的密钥只能调 GPT 模型，要同时用两类模型就建两个服务商、各填一把密钥。
常见报错
- 401 invalid_api_key：Base URL 可能还是官方地址，或密钥没复制完整。看 401 排查。
- model not found：模型名写错，或密钥所在分组没有这个模型。看 模型不存在排查。
- 404：Base URL 多写了路径。
- 返回网页或「Unexpected token <」：Base URL 填成了网页地址（如控制台、文档站），或写成了 http://、www.。
团队使用建议
多人共用时，给每个人或每个项目单独建密钥，并在控制台设置额度上限；不要把同一把密钥发到群里。
✅