TraeCode 配置方法
TraeCode 是字节跳动推出的 AI 开发产品，支持接入自定义模型，可以通过 OpenAI Chat Completions 兼容协议使用 wylon 新云已上线的对话模型。
1. 添加模型
- 安装并打开 TraeCode，登录后前往设置 → 模型。
- 点击添加模型。
- 在弹窗中切换到自定义配置，不要保留默认的「模型服务商」选项。
- 按下表填写模型信息。
- 可选：展开高级配置，按需设置展示名称、上下文窗口和工具调用轮次。模型系列保持默认。
- 点击添加模型完成配置。
| 界面字段 | 填写内容 |
|---|---|
| API 格式 | OpenAI Chat Completions 格式 |
| 完整 URL | 关闭 |
| 自定义请求地址 | https://api.wylon.cn/v1 |
| 模型 ID | wylon 提供的模型 ID，例如 ZhipuAI/GLM-5.3 |
| 多模态 | 关闭 |
| API 密钥 | <你的_wylon_API-Key> |
info
添加时会进行连接校验
TraeCode 会真实调用一次 wylon 接口来校验密钥、地址与模型 ID。连接成功后模型会进入列表；失败时弹窗会展示错误信息和服务端日志。
请求地址与“完整 URL”开关
TraeCode 通过“完整 URL”开关决定是否自动补全接口路径，以下两种配置方式二选一。
推荐：关闭“完整 URL”，填写基础地址
https://api.wylon.cn/v1备选：打开“完整 URL”，填写完整端点
https://api.wylon.cn/v1/chat/completions
warning
开关与地址必须匹配
打开“完整 URL”时不能只填写到
/v1；关闭开关时也不要填写完整的 /chat/completions 路径，否则可能形成错误或重复的请求路径并返回 404。
模型 ID
模型 ID 会原样作为 model 参数发送给 wylon API。请从 模型广场或 GET /v1/models 复制完整 ID，确保大小写和组织前缀与服务端一致。
多模态开关
高级配置中的支持图片输入参数默认开启，需要根据模型能力手动调整。例如，ZhipuAI/GLM-5.3 不具备视觉能力，应将该参数设置为“不支持”。
模型系列
模型系列会为特定模型预置 Prompt 与超参数。GPT-5、Gemini-3、Deepseek-4 等选项可能强制改写协议字段、超参数或 Thinking 模式，与 GLM 模型不匹配。
2. 选择模型并验证
- 在 AI 对话输入框右下角关闭 AUTO 模式。
- 打开模型列表，选择刚添加的自定义模型，例如
ZhipuAI/GLM-5.3。 - 先发送一条简单消息确认链路。模型正常返回内容，即表示请求地址、API 密钥和模型 ID 配置成功。
info
如果模型列表中找不到刚添加的模型，请前往设置 → 模型确认该模型没有被禁用。
3. 更换其他模型
- 访问 模型广场，或请求
GET https://api.wylon.cn/v1/models。 - 复制模型的完整 API ID。
- 在设置 → 模型中点击添加模型，新增一条自定义配置。
- 保留相同的请求地址和 API 密钥，只替换模型 ID。
info
切换模型后建议新建对话验证。涉及工具调用、长上下文或结构化输出时，应再运行一轮相应能力的回归测试，并根据新模型能力调整多模态开关。
