在 TRAE 中接入 OmniDino， 用自己的 API Key 驱动 AI 编程。
TRAE 是桌面端 AI IDE。通过自定义 OpenAI 模型配置，可以将 OmniDino 的 Chat Completions 接口加入模型列表，在 Chat、Agent 和项目工作流中使用你的模型与余额。
TRAE 是什么？
它是一款以 AI 编程为核心的桌面 IDE，适合从代码补全到多步骤 Agent 开发任务。
编辑器和 Agent 住在同一个工作区里。
TRAE 可以导入现有项目、读取代码上下文、在聊天中解释代码，也可以让 Agent 修改文件和执行命令。使用 OmniDino 自定义模型时，建议先在测试 Git 分支中验证模型的工具调用与代码质量。
bytedance/trae-agent，它是基于 Python 的通用软件工程 Agent，可通过 YAML 配置自定义 Base URL，包括 OmniDino。
官方客户端与 GitHub 开源辅助工具。
TRAE IDE
桌面端 AI IDE。客户端本身不是完整开源项目，因此安装包应从官方页面获取。
TRAE Agent
ByteDance 开源的软件工程 Agent，支持 OpenAI、Anthropic、Gemini、OpenRouter、Ollama 和自定义 Base URL。
Git
用于版本控制、分支、Diff 和回滚，强烈建议在 Agent 修改代码前安装。
Visual Studio Code
开源代码编辑器，可作为备用编辑器，也方便对比 TRAE 修改后的文件和扩展兼容性。
Node.js
运行部分 MCP Server、前端项目和 npm 工具时需要的开源 Runtime。
MCP SDK 与参考服务器
为 TRAE Agent 或自定义 Agent 开发工具时，可使用官方 MCP SDK 与参考服务器。
安装并导入你的第一个项目。
Windows
从 TRAE 官方网站下载安装程序，安装完成后导入本地 Git 项目。
src
app.js
api.js
public
README.md
package.json
macOS
下载对应架构版本，将 TRAE 拖入 Applications，并允许系统打开。
components
Header.js
Footer.js
styles
README.md
package.json
四步添加自定义 OpenAI 模型。
TRAE 的设置名称可能随版本变化，但核心字段保持一致。
打开设置与模型页面
进入 TRAE 主界面，打开右上角设置入口，进入 Models、AI Services 或模型管理区域。
点击“添加模型”
选择添加自定义模型，并将服务商设置为 OpenAI。
填写 OmniDino 信息
模型 ID 必须复制自 OmniDino 模型广场；API Key 使用你的 OmniDino Key；请求地址填写完整 Chat Completions URL。
保存并在聊天区切换模型
保存配置后，回到 Chat 或 Agent 界面，手动选择刚刚添加的模型，再发送最小测试消息。
OmniDino 配置参数
按照 TRAE 自定义模型弹窗逐项填写。
https://api.omnidino.com/v1。
服务商：OpenAI
模型：自定义模型
模型 ID：填写 OmniDino 实际模型名称
API 密钥：粘贴 OmniDino API Key
自定义请求地址：
https://api.omnidino.com/v1/chat/completions先验证链路，再让 Agent 修改代码。
请只回复：
OmniDino TRAE connection successful.
不要读取文件，不要运行命令，也不要修改项目。检查返回内容
模型应正常回复，不出现认证失败、404 或模型不存在。
检查当前模型
确认聊天区选择的是自定义模型，而不是 TRAE 默认模型。
检查 OmniDino 记录
打开控制台确认出现对应请求、模型名和用量扣费。
不同模式应该如何使用？
Chat 模式
适合解释代码、生成片段、分析日志和讨论方案，风险最低。
Agent 模式
适合多文件任务和命令执行。必须使用 Git 分支并审阅 Diff。
SOLO 模式
适合更自主的产品和工程流程，可结合 AI Services 与工具集成。
MCP 工具
为自定义 Agent 添加数据库、浏览器、GitHub 或内部业务工具。
Max Mode
适合更长上下文和复杂工具调用，但通常会增加模型用量。
项目规则
为 Agent 写清技术栈、禁止操作、测试命令和输出格式。
TRAE 配置边界速查。
| 场景 | 推荐配置 | 说明 |
|---|---|---|
| OmniDino 对话模型 | /v1/chat/completions | 使用 OpenAI 自定义模型和完整请求地址。 |
| OmniDino Responses 模型 | 不建议直接用于此配置 | TRAE 自定义模型页面主要按 Chat Completions 接入。 |
| Claude 原生 Messages | 视 TRAE Provider 选项而定 | 不要把 Messages 地址填进 OpenAI Chat Completions 配置。 |
| 图片生成 | 不属于普通 Chat 模型 | /v1/images/generations 不能当聊天模型地址使用。 |
| 模型 ID | 复制实际模型名称 | 不要自行改名或填写展示名称。 |
| API Key | 独立 TRAE Key | 建议设置单独额度，方便控制风险和统计。 |
需要完全开源时，使用 TRAE Agent。
TRAE Agent 是独立的 CLI 项目，不需要安装 TRAE IDE，并支持自定义 Base URL。
TRAE Agent + OmniDino
官方仓库支持 YAML 配置和 OpenAI Provider 的自定义 base_url。
model_providers:
omnidino:
api_key: "粘贴你的OmniDino API Key"
provider: openai
base_url: "https://api.omnidino.com/v1"
models:
omnidino_model:
model_provider: omnidino
model: "填写实际模型名称"
max_tokens: 4096
temperature: 0.3
agents:
trae_agent:
model: omnidino_model
max_steps: 80
tools:
- bash
- str_replace_based_edit_tool
- sequentialthinking
- task_done连接失败时逐项排查。
TRAE 仍然无法连接 OmniDino？
请提供 TRAE 版本、操作系统、模型 ID、自定义请求地址、HTTP 状态码和完整错误提示。请隐藏 API Key，不要发送完整密钥截图。
[email protected]