跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
概述

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 的「自定义模型」能力接入 API易后，你可以获得：

🔌 双协议覆盖

同时配置 OpenAI 与 Anthropic 协议，一把令牌驱动两套服务商

🤖 400+ 主流模型

GPT、Claude、Gemini、DeepSeek、Doubao、Qwen 等一站打通

💰 ClaudeCode 95 折

创建令牌时选择 ClaudeCode 分组，Claude 系列享 95 折，可叠加充值优惠

🛡️ 国内外稳定直连

免去自建翻墙/代理网关，主域名 api.apiyi.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 + 自定义请求地址——这正是把 API易 接进 Trae 的关键入口。
为什么要接 API易：Trae 自带模型受地区与版本限制，且没法一键叠加上下游账单。接 API易 后，一个令牌同时覆盖 OpenAI / Anthropic 两套协议，模型切换不再需要回到设置面板换 Provider，直接在 Trae 顶部模型下拉里选即可。

​
快速开始

​
第一步：安装 Trae

访问 www.trae.cn 下载，支持 macOS 与 Windows。国内版内置豆包、DeepSeek 等模型，账号登录用手机号。

​
第二步：获取 API易 令牌

  1. 访问 API易 控制台令牌页面：api.apiyi.com/token
  2. 点击「新建令牌」
  3. 如果主要使用 Claude 系列：选择 【ClaudeCode】分组，可享 95 折优惠（可叠加充值赠送 10%-20%）
  4. 如果混用 GPT/Gemini/DeepSeek 等：选择 【Default】默认分组 即可
  5. 复制以 sk- 开头的密钥备用

​
第三步：在 Trae 中打开「自定义模型」入口

  • IDE 模式下：点击右上角 ⚙️ 设置图标 → 左侧导航 模型 → 点击「添加模型」/「自定义模型」
  • SOLO 模式下：点击对话面板右上角 ⚙️ → 模型 → 添加

​
第四步：添加 OpenAI 协议入口（GPT / Gemini / DeepSeek / Doubao 等）

按下图填写，自定义请求地址末尾必须带 /v1/chat/completions 完整路径，不是只填域名： Trae 自定义模型 - OpenAI 协议对接 API易，自定义请求地址 https://api.apiyi.com/v1/chat/completions
字段填写值说明
服务商OpenAI选择 OpenAI 预设
模型自定义模型下拉里选最末尾的「自定义模型」
模型 ID如 gpt-5.1、deepseek-v4-flash、gemini-3-pro-preview填写要使用的模型完整 ID
API 密钥sk-...粘贴上一步获取的 API易 令牌
自定义请求地址https://api.apiyi.com/v1/chat/completions必须含 /v1/chat/completions
Base URL 必须带完整路径：Trae 从 v3.3.51 起的自定义模型 baseURL 字段要求填完整接口路径，只填 https://api.apiyi.com 或 https://api.apiyi.com/v1 都会报错。

​
第五步：添加 Anthropic 协议入口（Claude 系列）

如果你要用 Claude Opus 4.6 / Sonnet 4.6 / Haiku 4.5 等，再添加一个 Anthropic 服务商条目： Trae 自定义模型 - Anthropic 协议对接 API易，自定义请求地址 https://api.apiyi.com/v1/messages
字段填写值说明
服务商Anthropic选择 Anthropic 预设
模型Claude-Sonnet-4.6（或下拉里其他 Claude 版本）直接选官方预设，不必走「自定义模型」
API 密钥sk-...粘贴 API易 令牌（建议用 ClaudeCode 分组的令牌）
自定义请求地址https://api.apiyi.com/v1/messages必须含 /v1/messages，注意不是 /v1/chat/completions
两套协议的差别：OpenAI 协议走 /v1/chat/completions，Anthropic 协议走 /v1/messages。API易 同时托管两套端点，所以同一把令牌可以在 Trae 里同时绑两个服务商条目，互不干扰。

​
第六步：切换模型开干

回到编辑器，点击顶部模型下拉框，刚才添加的两个服务商和它们下面的模型都会出现在列表里。选中即可开始对话或进入 Builder 模式。

​
推荐模型搭配

日常编程（性价比）

Claude Sonnet 4.6（Anthropic 协议）+ GPT-5.1（OpenAI 协议）Sonnet 4.6 编程能力极强、性价比高；GPT-5.1 在 Chat 模式回复更快

复杂架构（旗舰）

Claude Opus 4.6（Anthropic 协议）复杂重构、跨文件分析、架构决策首选；建议配合 Builder 模式

深度推理

Claude Sonnet 4.6 Thinking / GPT-5.1 Thinking强制启用思维链，适合算法题、逻辑推理、安全审计

国产高性价比

DeepSeek V4 / Doubao 1.5 Pro / Qwen3 Coder走 OpenAI 协议接入，单价低、中文输出自然

查看完整模型列表与编程模型推荐

API易 通过统一接口提供 400+ 主流模型，模型推荐页持续更新最新性能与价格对比。

​
使用技巧

1

两个服务商条目同时保留

OpenAI 与 Anthropic 两个入口建议都加上，这样切换 GPT/Gemini ↔ Claude 时不用回设置改 baseURL。
2

模型 ID 找不到？

Trae 默认列出的官方模型号往往跟不上 API易 最新模型节奏。选「自定义模型」手动填模型 ID 是最稳妥的做法——以 API易 控制台 / 模型推荐页公布的 ID 为准。
3

Builder 模式优先选 Claude

Builder 智能体会自动多轮工具调用，Claude 系列（尤其是 Sonnet 4.6 / Opus 4.6）在指令跟随和工具调用稳定性上明显优于其他家。
4

复杂任务挂 Thinking 模型

模型 ID 后面加 -thinking 后缀（如 claude-sonnet-4-6-thinking），可强制启用思维链。在 Builder 模式做架构决策、安全审计时显著降低翻车率。
5

令牌按分组拆开管理

Claude 系列单独建一把 ClaudeCode 分组令牌（95 折）；GPT/Gemini/DeepSeek 用 Default 分组令牌。两把令牌分别贴到两个服务商条目，账单与配额一目了然。

​
常见问题

没差别——两个版本都支持自定义模型，且都允许同时添加 OpenAI 与 Anthropic 两类服务商条目。区别主要在内置预设模型不同（国内版主推豆包/DeepSeek，国际版主推 GPT/Claude/Gemini）。选择建议：中国大陆网络环境优先国内版（trae.cn），全球团队协作或需要海外模型预设走国际版（trae.ai）。
Trae 从 v3.3.51 起调整了自定义模型的 baseURL 解析规则：直接把这个字段拼到请求里，不再做「自动补 /chat/completions」的兼容处理。所以正确写法：
  • OpenAI 协议：https://api.apiyi.com/v1/chat/completions
  • Anthropic 协议：https://api.apiyi.com/v1/messages
错误写法（会触发 404 或路由错误）：
  • ❌ https://api.apiyi.com
  • ❌ https://api.apiyi.com/v1
可以。Trae 的 Anthropic 服务商条目同样支持「自定义模型」选项，填入 claude-opus-4-6 / claude-sonnet-4-6-thinking / claude-haiku-4-5-20251001 等具体模型 ID 即可。API易 的 /v1/messages 端点对官方模型 ID 完全兼容。
在 API易 控制台 api.apiyi.com/token 创建令牌时，分组选 ClaudeCode 即可自动享受 95 折优惠（5% off），可叠加充值赠送 10%-20%。把这把 ClaudeCode 分组令牌粘到 Trae 的 Anthropic 服务商条目里，Claude 调用就自动走折扣。
Trae 内置预设的模型号更新会滞后于实际供给方。最佳实践是直接选「自定义模型」手动填 ID——只要 API易 后端支持的模型，你就能在 Trae 里跑起来，不必等 Trae 客户端更新预设。
  1. 优先用 Claude Sonnet 4.6 或 Opus 4.6：这两款在工具调用稳定性上明显领先
  2. 避开非推理版本的小模型：DeepSeek-Chat / Qwen 系列做 Builder 容易死循环，建议切到带 thinking 后缀的推理版本
  3. 检查上下文长度：单文件超长或多文件大改时切到 Opus 4.6（200K 上下文）
  4. 观察 API易 实时动态：偶发的上游波动会影响所有客户端，确认是否为通道问题
Trae 是字节跳动开发的客户端，会按其官方隐私政策上传必要的遥测与对话数据。如果你对客户端遥测敏感，建议：
  • 在企业网络出口做白名单控制
  • 关键代码片段开 Builder 模式前做脱敏
  • 选择 Claude Code / Cline 等开源/可审计客户端作为备选
工具类型Agent 模式接 API易 难度适合场景
Trae独立 IDE✅ Builder中（双协议两条目）想要 Cursor 体验但首选国产 IDE / 中文场景
Cursor独立 IDE❌（仅 Chat）易（仅 OpenAI 协议）注重补全和代码差异预览
ClineVS Code 插件✅易已是 VS Code 重度用户
Claude CodeCLI✅易终端流派、CI / 远程开发
详见各页面：Cursor · Cline · Claude Code · Codex CLI
  1. 确认 API 密钥以 sk- 开头且没有粘多余空格
  2. 确认 baseURL 拼写正确，特别是末尾路径（/v1/chat/completions vs /v1/messages）
  3. 在 API易 控制台检查令牌状态是否启用、是否在分组里绑定了对应模型
  4. 余额不足也会返回 401，确认账户余额

​
相关资源

模型推荐

400+ 模型的性能对比与编程场景推荐

API易 控制台

创建令牌、查看用量、管理分组

Cursor 接入

另一款主流 AI IDE 的对接教程

Cline 插件接入

VS Code 内功能完整的 Agent 模式插件
更多帮助：访问 API易 官网 api.apiyi.com 或加入官方社群获取技术支持。