TRAE 国内版和国际版有什么区别？下载安装与自定义模型配置教程（2026）
本页目录
一句话说清：TRAE 是字节跳动推出的 AI 编程 IDE（编辑器），分国内版 TRAE CN（trae.cn，内置国产模型）和国际版 TRAE（trae.ai，内置 GPT、Gemini 等）。两个版本都能添加自定义模型：设置 → 模型 → 添加模型，选 API 格式、填请求地址、模型 ID 和密钥。
本文依据 TRAE 国内版和国际版 2026 年 10 月的官方文档整理。我们没有在电脑上实际安装 TRAE，界面以你看到的为准。
国内版和国际版的区别
| 国内版 TRAE CN | 国际版 TRAE | |
|---|---|---|
| 官网 | trae.cn | trae.ai |
| 内置模型（2026 年 10 月） | 豆包 Seed 系列、MiMo、Step、智谱 GLM-5.x、DeepSeek-V4、Kimi-K3、MiniMax-M3、通义千问 Qwen3.x | GPT-6 / GPT-5.x 系列、Gemini-3.1-Pro-Preview、Gemini-3-Flash-Preview、Kimi、GLM、DeepSeek、MiniMax、Seed |
| Claude | 内置列表里没有 | 内置列表里没有 |
| 登录方式 | 手机号、抖音、苹果账号、稀土掘金 | 以官网为准 |
| 自定义模型 | 支持 | 支持，步骤相同 |
怎么选：
- 主要用国产模型、在国内网络环境，选国内版。
- 想用 GPT、Gemini 等内置模型，选国际版。
- 想用 Claude，两个版本都要通过「添加自定义模型」接入提供 Claude 接口的服务。
下载和安装
从官网下载中心下载对应系统的安装包。国内版官方的系统要求：
| 系统 | 最低版本 | 架构 |
|---|---|---|
| macOS | 12.0 及以上 | Apple 芯片、Intel |
| Windows | Windows 10、Windows 11 | 64 位（x64） |
| Linux | Ubuntu 20.04+ / Debian 10+（.deb）；Fedora 42、RHEL 9.x（.rpm） |
x64、ARM64 |
macOS 低于 12 的电脑，官方文档提供了 3.3.25 之前的旧版本下载链接。
第一次启动按引导完成初始设置：
- 选主题和语言。
- 可以从 VS Code 或 Cursor 导入已有配置（插件、快捷键等）。
- 添加 TRAE 的命令行工具。
- 登录。
添加自定义模型（接任意服务商）
内置模型不够用，或者想用自己的 API 时，按这几步：
- 在 IDE 窗口或 Agent 窗口，进入 设置 → 模型，打开模型管理面板。
- 点 添加模型。
- 选一个 TRAE 预设的服务商，或者选 自定义模型。
方式一：选预设的服务商
| 参数 | 怎么填 |
|---|---|
| 服务商 | 默认是你上一步选的那家 |
| 配置方式 | 部分服务商要选计费方式：按量计费、Coding Plan 或 Agent Plan 套餐 |
| 模型 | 从列表选；要用别的型号，点「使用其他模型」填模型 ID |
| API 密钥 | 该服务商的密钥。输入框右上角的「获取 API 密钥」会跳到服务商平台 |
方式二：自定义模型（中转站、聚合平台都用这个）
| 参数 | 怎么填 |
|---|---|
| API 格式 | OpenAI Chat Completions 格式（对应 /v1/chat/completions，大多数服务都兼容）或 Anthropic Messages 格式（对应 /v1/messages，Claude 用这个） |
| 自定义请求地址 | 两种填法：打开「完整 URL」开关，填完整的请求地址；或者关闭开关，填基础地址，由 TRAE 按 API 格式自动拼接路径 |
| 模型 ID | 服务商的模型 ID，必须一字不差 |
| 模型展示名称 | 列表里显示的名字，不填就显示模型 ID |
| API 密钥 | 服务商给的密钥 |
建议打开「完整 URL」开关，直接填完整地址，不用猜 TRAE 会怎么拼接路径。以 api.foo 为例：
| 要用的模型 | API 格式 | 完整 URL |
|---|---|---|
| GPT、DeepSeek、Kimi 等 | OpenAI Chat Completions 格式 | https://api.foo/v1/chat/completions |
| Claude | Anthropic Messages 格式 | https://api.foo/v1/messages |
点「添加模型」后，TRAE 会实际调用一次服务商的接口检查密钥：
- 成功了模型才加入列表；
- 失败了窗口里会显示错误信息和服务商返回的日志，照着排查。
高级配置要不要填
展开「高级配置」可以设置这些。一般留空，TRAE 会用默认的最优值。
- 模型系列：TRAE 为特定系列优化了提示词和参数。
- 个人版能选：GPT-5 系列、Gemini-3 系列、DeepSeek-4 系列、默认。
- Kimi、GLM-5、GPT-6、Claude-4 系列只有企业版能选。个人版接这些模型，选「默认」。
- 上下文窗口：单次输入和输出的最大 token 数。
- 工具调用轮数：一次任务里最多调用工具几轮。
- 支持图片输入：模型本身能看图才有用。
- 思考模式：开了更擅长复杂问题，但更慢、更费 token。
- 采样参数：Temperature、Top P、Top K。
官方对选「GPT-5 系列」的说明里有个细节：GPT-5 要求用 MaxCompletionTokens 字段、Temperature 只能是 1，选了这个系列 TRAE 会自动处理；选「默认」可能因为参数不匹配而报错。用 GPT-5 系列模型时，记得选对。
用起来：切换模型
在 AI 对话输入框右下角点当前模型名，就能切换。鼠标悬停在模型名上，可以看它支持哪些能力。
Auto 模式只会调用 TRAE 的内置模型，不会用你添加的自定义模型。想用自己的模型，先在同一个菜单里关掉 Auto Mode，再手动选。
在模型管理面板里，自定义模型可以编辑、删除、启用 / 禁用。禁用的模型留在面板里，但不会出现在对话的模型列表中。
常见问题
添加模型时检测失败
看窗口里的报错和服务商日志，按这几项核对：
| 现象 | 常见原因 |
|---|---|
| 401、无效的令牌 | 密钥错了，或者密钥和地址不是同一家服务商 |
| 404 | 地址不对。打开「完整 URL」时要填到 /v1/chat/completions 或 /v1/messages |
| 模型不存在 | 模型 ID 和服务商的写法不一致 |
| 400，参数错误 | API 格式和服务商的接口对不上，或者 GPT-5 类模型没选对「模型系列」 |
更多报错见 报错排查大全。
加了模型，对话框里找不到
确认这个模型是「启用」状态，并且没有开着 Auto 模式。
相关阅读
常见问题
TRAE 国内版和国际版有什么区别？
国内版叫 TRAE CN，官网 trae.cn，内置的是豆包 Seed、DeepSeek、Kimi、智谱 GLM、通义千问、MiniMax 等国产模型，用手机号、抖音、苹果或稀土掘金账号登录；国际版官网 trae.ai，内置 GPT、Gemini、Kimi、GLM、DeepSeek 等模型。两个版本都支持添加自定义模型，添加方式相同。
TRAE 能用 Claude 吗？
截至 2026 年 10 月，国内版和国际版的内置模型列表里都没有 Claude。想用 Claude，可以在 TRAE 里添加自定义模型，API 格式选 Anthropic Messages，填写提供 Claude 接口的服务商地址和密钥。
TRAE 怎么添加自定义模型？
在 IDE 或 Agent 窗口进入设置 → 模型，点添加模型，选预设的服务商填 API 密钥，或者选自定义模型，填 API 格式、请求地址、模型 ID 和 API 密钥。TRAE 会先调用接口检测密钥，成功后模型才会加入列表。
为什么开了 Auto 模式，没有用我添加的模型？
Auto 模式只会调用 TRAE 的内置模型，不支持自定义模型。要用自己添加的模型，关闭 Auto 模式，在对话框右下角手动选择该模型。
TRAE 支持哪些系统？
国内版官方要求 macOS 12 及以上（Apple 芯片和 Intel 都支持）、64 位 Windows 10 / 11、Linux（Ubuntu 20.04+、Debian 10+ 的 deb 包，Fedora 42、RHEL 9 的 rpm 包，x64 和 ARM64）。macOS 低于 12 的可以下载官方提供的旧版本。
发现内容有误？发邮件到 [email protected] 告诉我们。