在 TRAE 中通过 连连智枢 网关进行 AI 编程。

TRAE 是字节跳动出品的 AI-native IDE，主打智能协作与 Agent 自动化。TRAE 支持通过 OpenAI 兼容 API 接入自定义模型，将请求地址指向 连连智枢 即可使用控制台 Key 与统一模型目录。

安装 TRAE

步骤 1 — 下载并安装

访问 TRAE 官网（国际版见 trae.ai）下载并安装 TRAE。

步骤 2 — 完成初始设置

首次启动时按引导完成语言、主题等初始配置。

步骤 3 — 登录 TRAE

使用 TRAE 账户登录。接入 连连智枢 前，请在控制台创建推理 API Key（见 API 密钥），并从 模型列表 确认要用的 id。

版本要求

自定义 Base URL 需 TRAE 较新版本（国内版约 3.3.51+、国际版约 3.5.51+，以官方发布为准）。若设置中看不到「自定义请求地址」，请先升级 TRAE。

在 TRAE 中使用 连连智枢

TRAE 通过 API Key + 自定义 OpenAI 端点 接入网关模型。

配置前提示

若 shell 中设置了 OPENAI_API_KEY / OPENAI_BASE_URL，可能干扰 TRAE 校验，建议先执行：

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

步骤 1 — 打开添加模型

任选一种入口：

• 在 AI 对话框右下角点击当前模型名 → 添加模型
• 或 头像 → AI 功能管理 → 模型 → 添加模型

步骤 2 — 选择 OpenAI 协议

在添加模型窗口中：

• API 格式 / 服务商 选择 OpenAI（OpenAI 兼容协议）
• 选择 自定义配置（若界面提供）

步骤 3 — 填写 Base URL 与模型 ID

关于 完整 URL 开关（不同 TRAE 版本文案可能略有差异）：

• 连连智枢 的 Base 为 含 /v1 的根地址（如 https://your-gateway/v1），一般关闭「完整 URL / 含 /chat/completions 尾缀」开关。
• 若连接失败，可尝试开启完整 URL，地址填 https://51kik.com/v1/chat/completions 再测一次。

详见 Base URL 与环境。

步骤 4 — 填写 API Key

在 API Key 输入框填入控制台创建的 连连智枢 推理 Key（非 OpenAI 官方 Key）。

步骤 5 — 完成添加

点击 添加模型。TRAE 会调用服务商接口检测 Key 是否有效：

• 连接成功：自定义模型出现在模型列表中，在 Chat / Agent 里选用即可。
• 连接失败：窗口会展示错误信息；可先在本机用 curl 验证（见 首次请求），再检查 Key、模型 id 与 Base URL。

多模态

仅当所选模型在目录中支持 vision / 图片输入时，才在 TRAE 中开启多模态相关选项；否则请保持关闭。

验证

1. 在 AI 对话框中选择刚添加的模型，发送一条简单问题。
2. 401 → 检查 Key；403 → 检查模型权限与余额（见 错误响应）。
3. 仍失败时，可通过 TRAE 帮助 → 开发者工具 → Network 查看请求 URL 与响应。

配置摘要

相关

• AI 工具概览
• Chat Completions
• 模型列表