Trae 怎么配置 ChatGPT?

如果已经在 Codex CLI 里配置过模型,可以把同一套信息迁移到 Trae:从 config.toml 读取请求地址和模型 ID,再从 auth.json 读取 OPENAI_API_KEY,最后在 Trae 的自定义模型中保存。

本文使用的请求地址是:

https://llapi.org/v1

模型 ID 使用本机 config.toml 中的值:

gpt-5.6-luna

我实际在 Trae CN 中完成了保存,并发送“你好”测试,返回了“你好,有什么需要我帮你处理?”。

一、先查看两个配置字段

打开文件时只看需要的字段,不要把整个配置文件复制到文章、聊天或公共仓库。

1. 在 config.toml 找请求地址和模型 ID

配置文件一般位于:

%USERPROFILE%\.codex\config.toml

用编辑器打开后,找到 base_urlmodel。结构大致如下:

model = "gpt-5.6-luna"

[model_providers.custom]
base_url = "https://llapi.org/v1"

本次在 Trae 中填写:

自定义请求地址: https://llapi.org/v1
模型 ID:       gpt-5.6-luna

如果你自己的 config.toml 使用了其他模型,以文件中的实际值为准。地址末尾已经有 /v1 时,不要再重复拼接 /v1

2. 在 auth.json 找 API Key

认证文件一般位于:

%USERPROFILE%\.codex\auth.json

找到 OPENAI_API_KEY 对应的值:

{
  "OPENAI_API_KEY": "<YOUR_API_KEY>"
}

<YOUR_API_KEY> 只是占位符。实际操作时复制 Key 的值,不要复制字段名、引号或逗号,也不要把完整 Key 打印到终端。

二、从哪里打开 Trae 的模型配置

  1. 打开 Trae CN,进入主界面。
  2. 点击顶部工具栏的齿轮图标,进入“设置”。
  3. 在设置页点击左侧菜单按钮,选择“模型”。
  4. 在“模型管理”区域点击“添加模型”。

Trae 设置进入“模型管理”

图 1:从 Trae 设置进入“模型管理”,再点击“添加模型”。

在“添加模型”页面选择“自定义模型”。

三、填写自定义模型

自定义模型表单中选择以下内容:

  1. “API 格式”选择“OpenAI Chat Completions 格式”。
  2. “自定义请求地址”填写 https://llapi.org/v1
  3. “完整 URL”保持关闭,让 Trae 在地址后拼接 /chat/completions
  4. “模型 ID”填写 gpt-5.6-luna,或填写你在 config.toml 中看到的实际模型 ID。
  5. “模型展示名称”可以留空,也可以填写一个便于识别的名称。
  6. “API 密钥”粘贴 auth.jsonOPENAI_API_KEY 对应的值。

自定义模型表单

图 2:自定义模型表单。截图展示了端点和模型 ID,API 密钥仅显示为隐藏字符。

这里要注意,Trae 的“自定义请求地址”不是模型 ID。地址负责请求发送到哪里,模型 ID 负责告诉服务端使用哪个模型。两者都填错时,通常会出现 404 或 model not found

填完后点击右下角“添加模型”。Trae 会先做一次连通性测试;测试通过后,模型会出现在“自定义”列表中。

模型自定义列表

图 3:模型保存成功后,gpt-5.6-luna 出现在“自定义”列表中。

四、在编辑器里发送“你好”测试

模型保存后,按下面步骤测试:

  1. 点击顶部“编辑器”返回工作区。
  2. 点击底部模型名称下拉框。
  3. 在“自定义模型”区域选择 gpt-5.6-luna
  4. 在对话输入框输入:
你好
  1. 点击右下角发送按钮,等待回复。

在这里插入图片描述

图 4:使用已配置的 gpt-5.6-luna 发送“你好”,Trae 返回“你好,有什么需要我帮你处理?”。

这次测试只能说明当前地址、模型 ID 和 Key 的组合完成了连通性验证,不代表所有模型、长文本或工具调用都一定可用。

五、遇到错误先看这几项

  • 401403:检查 Key 是否复制完整、是否过期,以及服务端是否允许当前模型。
  • 404:检查地址是否重复拼接 /v1/chat/completions,并确认“完整 URL”开关是否符合服务端要求。
  • model not found:核对模型 ID,不要把 Trae 中的展示名称当成接口模型 ID。
  • connection refused:如果地址是 127.0.0.1,先确认本地服务是否启动;本文使用的是 https://llapi.org/v1
  • 能保存但不能对话:保存成功不等于每种请求都可用,先核对 API 格式、请求地址和模型 ID。

Key 安全提醒

不要截图完整 Key,不要点击显示按钮后截图,也不要把 auth.json 全文提交到 Git。文章和截图只保留字段名、占位符和隐藏字符。如果怀疑 Key 已经泄露,应在服务方后台撤销旧 Key 并重新生成。

我这次使用的是 llapi.org 的 OpenAI 兼容接口入口,具体支持的模型、使用规则和其他说明以官网当前页面为准。不同 Trae 版本的字段名称可能略有变化,配置时以实际界面为准。

Logo

AtomGit AI 社区提供模型库、数据集、Agent、Token等资源

更多推荐