Appearance
Trae
文档说明
字节跳动推出的 AI 原生 IDE，内置 Builder/Chat/Inline Chat 多模式智能体编程；通过自定义模型对接 FastAiToken，一键覆盖 OpenAI 与 Anthropic 两套协议、400+ 主流模型。
概述
Trae 是字节跳动于 2025 年 1 月推出的 AI 原生 IDE（AI-native IDE），定位为面向专业开发者的「Vibe Coding」生产力工具——用自然语言描述需求，AI 自动完成代码补全、缺陷修复、项目构建与一键预览。Trae 同时提供 国内版（trae.cn）与 国际版（trae.ai），并衍生出 SOLO 系列（SOLO Desktop / SOLO App / SOLO Web）让 AI 直接接管任务全流程。
通过 Trae 的「自定义模型」能力接入 FastAiToken后，你可以获得：
同时配置 OpenAI 与 Anthropic 协议，一把令牌驱动两套服务商 GPT、Claude、Gemini、DeepSeek、Doubao、Qwen 等一站打通 创建令牌时选择 ClaudeCode 分组，Claude 系列享 95 折，可叠加充值优惠 免去自建翻墙/代理网关，主域名 api.fastaitoken.com 国内可直连 产品信息
- 🔗 国内版官网：
www.trae.cn - 🔗 国际版官网：
www.trae.ai - 👥 开发方：字节跳动（ByteDance）
- 📅 首次发布：2025 年 1 月
- 🧩 内置模式：Builder（智能体）/ Chat（侧边栏对话）/ Inline Chat（行内对话）
- 🌐 兼容协议：OpenAI、Anthropic 等多种第三方接入
核心功能
三种交互模式
- Builder 模式：AI 智能体接管任务，自动读写多文件、执行命令、构建项目
- Chat 模式：侧边栏对话，类似 Cursor Chat / Cline，适合查询与代码片段生成
- Inline Chat：在编辑器内直接
Cmd/Ctrl + I唤起，行内补全和重构最快路径
MCP 与工具生态
- 内置 MCP（Model Context Protocol） 支持，可接入外部工具与 API
- 支持 Remote-SSH：远程开发场景与本地体验一致
.rules项目级规则文件，约束 AI 行为风格
自定义模型（本文重点）
Trae 国际版自带 Anthropic、OpenAI、Gemini、xAI、OpenRouter、Ollama、DeepSeek、火山引擎、阿里云、腾讯云、硅基流动、PPIO、Novita、BytePlus 等服务商预设，每个预设都允许填写自定义模型 ID + API Key + 自定义请求地址——这正是把 FastAiToken 接进 Trae 的关键入口。
为什么要接 FastAiToken：Trae 自带模型受地区与版本限制，且没法一键叠加上下游账单。接 FastAiToken 后，一个令牌同时覆盖 OpenAI / Anthropic 两套协议，模型切换不再需要回到设置面板换 Provider，直接在 Trae 顶部模型下拉里选即可。
快速开始
第一步：安装 Trae
访问 www.trae.cn 下载，支持 macOS 与 Windows。国内版内置豆包、DeepSeek 等模型，账号登录用手机号。 访问 www.trae.ai 下载，支持 macOS、Windows、Linux。国际版默认提供 GPT/Claude/Gemini 等海外模型预设。
第二步：获取 FastAiToken 令牌
- 访问 FastAiToken 控制台令牌页面：
api.fastaitoken.com/token - 点击「新建令牌」
- 如果主要使用 Claude 系列：选择 【ClaudeCode】分组，可享 95 折优惠（可叠加充值赠送 10%-20%）
- 如果混用 GPT/Gemini/DeepSeek 等：选择 【Default】默认分组 即可
- 复制以
sk-开头的密钥备用
第三步：在 Trae 中打开「自定义模型」入口
- IDE 模式下：点击右上角 ⚙️ 设置图标 → 左侧导航 模型 → 点击「添加模型」/「自定义模型」
- SOLO 模式下：点击对话面板右上角 ⚙️ → 模型 → 添加
第四步：添加 OpenAI 协议入口（GPT / Gemini / DeepSeek / Doubao 等）
按下图填写，自定义请求地址末尾必须带 /v1/chat/completions 完整路径，不是只填域名：
| 字段 | 填写值 | 说明 |
|---|---|---|
| 服务商 | OpenAI | 选择 OpenAI 预设 |
| 模型 | 自定义模型 | 下拉里选最末尾的「自定义模型」 |
| 模型 ID | 如 gpt-5.1、deepseek-v4-flash、gemini-3-pro-preview | 填写要使用的模型完整 ID |
| API 密钥 | sk-... | 粘贴上一步获取的 FastAiToken 令牌 |
| 自定义请求地址 | https://fastaitoken.com/v1/chat/completions | 必须含 /v1/chat/completions |
Base URL 必须带完整路径：Trae 从 v3.3.51 起的自定义模型 baseURL 字段要求填完整接口路径，只填 https://fastaitoken.com 或 https://fastaitoken.com/v1 都会报错。
第五步：添加 Anthropic 协议入口（Claude 系列）
如果你要用 Claude Opus 4.6 / Sonnet 4.6 / Haiku 4.5 等，再添加一个 Anthropic 服务商条目：
| 字段 | 填写值 | 说明 |
|---|---|---|
| 服务商 | Anthropic | 选择 Anthropic 预设 |
| 模型 | Claude-Sonnet-4.6（或下拉里其他 Claude 版本） | 直接选官方预设，不必走「自定义模型」 |
| API 密钥 | sk-... | 粘贴 FastAiToken 令牌（建议用 ClaudeCode 分组的令牌） |
| 自定义请求地址 | https://fastaitoken.com/v1/messages | 必须含 /v1/messages，注意不是 /v1/chat/completions |
两套协议的差别：OpenAI 协议走 /v1/chat/completions，Anthropic 协议走 /v1/messages。FastAiToken 同时托管两套端点，所以同一把令牌可以在 Trae 里同时绑两个服务商条目，互不干扰。
第六步：切换模型开干
回到编辑器，点击顶部模型下拉框，刚才添加的两个服务商和它们下面的模型都会出现在列表里。选中即可开始对话或进入 Builder 模式。
推荐模型搭配
Claude Sonnet 4.6（Anthropic 协议）+ GPT-5.1（OpenAI 协议）
text
Sonnet 4.6 编程能力极强、性价比高；GPT-5.1 在 Chat 模式回复更快Claude Opus 4.6（Anthropic 协议）
text
复杂重构、跨文件分析、架构决策首选；建议配合 Builder 模式Claude Sonnet 4.6 Thinking / GPT-5.1 Thinking
text
强制启用思维链，适合算法题、逻辑推理、安全审计DeepSeek V4 / Doubao 1.5 Pro / Qwen3 Coder
text
走 OpenAI 协议接入，单价低、中文输出自然FastAiToken 通过统一接口提供 400+ 主流模型，模型推荐页持续更新最新性能与价格对比。
使用技巧
OpenAI 与 Anthropic 两个入口建议都加上，这样切换 GPT/Gemini ↔ Claude 时不用回设置改 baseURL。 Trae 默认列出的官方模型号往往跟不上 FastAiToken 最新模型节奏。选「自定义模型」手动填模型 ID 是最稳妥的做法——以 FastAiToken 控制台 / 模型推荐页公布的 ID 为准。 Builder 智能体会自动多轮工具调用，Claude 系列（尤其是 Sonnet 4.6 / Opus 4.6）在指令跟随和工具调用稳定性上明显优于其他家。 模型 ID 后面加 -thinking 后缀（如 claude-sonnet-4-6-thinking），可强制启用思维链。在 Builder 模式做架构决策、安全审计时显著降低翻车率。 Claude 系列单独建一把 ClaudeCode 分组令牌（95 折）；GPT/Gemini/DeepSeek 用 Default 分组令牌。两把令牌分别贴到两个服务商条目，账单与配额一目了然。
常见问题
没差别——两个版本都支持自定义模型，且都允许同时添加 OpenAI 与 Anthropic 两类服务商条目。区别主要在内置预设模型不同（国内版主推豆包/DeepSeek，国际版主推 GPT/Claude/Gemini）。
text
选择建议：中国大陆网络环境优先国内版（`trae.cn`），全球团队协作或需要海外模型预设走国际版（`trae.ai`）。Trae 从 v3.3.51 起调整了自定义模型的 baseURL 解析规则：直接把这个字段拼到请求里，不再做「自动补 /chat/completions」的兼容处理。
text
所以正确写法：
* OpenAI 协议：`https://fastaitoken.com/v1/chat/completions`
* Anthropic 协议：`https://fastaitoken.com/v1/messages`
错误写法（会触发 404 或路由错误）：
* ❌ `https://fastaitoken.com`
* ❌ `https://fastaitoken.com/v1`可以。Trae 的 Anthropic 服务商条目同样支持「自定义模型」选项，填入 claude-opus-4-6 / claude-sonnet-4-6-thinking / claude-haiku-4-5-20251001 等具体模型 ID 即可。FastAiToken 的 /v1/messages 端点对官方模型 ID 完全兼容。 在 FastAiToken 控制台 api.fastaitoken.com/token 创建令牌时，分组选 ClaudeCode 即可自动享受 95 折优惠（5% off），可叠加充值赠送 10%-20%。
text
把这把 ClaudeCode 分组令牌粘到 Trae 的 Anthropic 服务商条目里，Claude 调用就自动走折扣。Trae 内置预设的模型号更新会滞后于实际供给方。最佳实践是直接选「自定义模型」手动填 ID——只要 FastAiToken 后端支持的模型，你就能在 Trae 里跑起来，不必等 Trae 客户端更新预设。 1. 优先用 Claude Sonnet 4.6 或 Opus 4.6：这两款在工具调用稳定性上明显领先 2. 避开非推理版本的小模型：DeepSeek-Chat / Qwen 系列做 Builder 容易死循环，建议切到带 thinking 后缀的推理版本 3. 检查上下文长度：单文件超长或多文件大改时切到 Opus 4.6（200K 上下文） 4. 观察 FastAiToken 实时动态：偶发的上游波动会影响所有客户端，确认是否为通道问题 Trae 是字节跳动开发的客户端，会按其官方隐私政策上传必要的遥测与对话数据。如果你对客户端遥测敏感，建议：
text
* 在企业网络出口做白名单控制
* 关键代码片段开 Builder 模式前做脱敏
* 选择 [`Claude Code`](/docs/scenarios/programming/claude-code) / [`Cline`](/docs/scenarios/programming/cline) 等开源/可审计客户端作为备选| 工具 | 类型 | Agent 模式 | 接 FastAiToken 难度 | 适合场景 | | --------------- | ---------- | --------- | -------------- | ---------------------------- | | Trae | 独立 IDE | ✅ Builder | 中（双协议两条目） | 想要 Cursor 体验但首选国产 IDE / 中文场景 | | Cursor | 独立 IDE | ❌（仅 Chat） | 易（仅 OpenAI 协议） | 注重补全和代码差异预览 | | Cline | VS Code 插件 | ✅ | 易 | 已是 VS Code 重度用户 | | Claude Code | CLI | ✅ | 易 | 终端流派、CI / 远程开发 |
text
详见各页面：[Cursor](/docs/scenarios/programming/cursor) · [Cline](/docs/scenarios/programming/cline) · [Claude Code](/docs/scenarios/programming/claude-code) · [Codex CLI](/docs/scenarios/programming/codex-cli)- 确认 API 密钥以
sk-开头且没有粘多余空格 2. 确认 baseURL 拼写正确，特别是末尾路径（/v1/chat/completionsvs/v1/messages） 3. 在 FastAiToken 控制台检查令牌状态是否启用、是否在分组里绑定了对应模型 4. 余额不足也会返回 401，确认账户余额
相关资源
400+ 模型的性能对比与编程场景推荐 创建令牌、查看用量、管理分组 另一款主流 AI IDE 的对接教程 VS Code 内功能完整的 Agent 模式插件 更多帮助：访问 FastAiToken 官网 api.fastaitoken.com 或加入官方社群获取技术支持。