人人都会AI编程

2.3 账号与模型配置

更新时间：2026-06-29

安装完成后，在使用 AI 功能之前，你需要完成账号登录并确认模型配置。Trae 的大部分智能能力都依赖云端模型，因此这一步是正常使用的前提。

2.3.1 账号登录与授权流程

无论是独立客户端还是 IDE 插件，首次使用 Trae 的 AI 功能（如行内补全、侧边栏对话）时，系统都会引导你登录账号。

登录入口

  • 独立客户端：启动后直接进入登录界面。
  • VS Code 插件：点击左侧活动栏的 Trae 图标，在侧边栏面板顶部点击“登录”按钮。
  • JetBrains 插件：打开 Trae 工具窗口，点击面板内的登录链接。

登录方式

Trae 通常提供以下两种方式，界面会显示对应的标签或按钮：

  1. 手机号登录
  • 输入你的手机号码，点击“获取验证码”。
  • 将收到的短信验证码填入，系统会自动校验并完成登录。
  • 如果未收到验证码，可检查手机信号、是否被拦截，或等待60秒后重新发送。
  1. 邮箱登录
  • 输入邮箱地址，点击“发送验证码”或“发送登录链接”。
  • 根据提示，在浏览器中打开邮箱，点击登录链接或填写验证码。部分版本支持“邮箱 + 密码”注册登录。
  • 注意有时邮件可能被归入垃圾箱，请留意检查。

授权确认

部分版本/网络环境可能要求进行额外的设备授权，例如在浏览器中确认登录操作。按页面提示完成即可。若遇到浏览器无法自动跳转，可手动复制页面提示的链接在浏览器中打开。

登录状态维持

登录成功后，一般不需要频繁重复登录。在客户端重启或插件重新加载后，登录状态通常会自动恢复。如果长时间未使用导致登录过期，系统会提示重新登录。

常见问题

  • 无法收到验证码：检查手机号/邮箱是否输入正确，确认网络通畅，避免短时间内多次请求触发限制。可尝试更换登录方式。
  • 登录后功能仍不可用：确认网络可以访问 Trae 的服务端点（部分企业网络可能拦截）。尝试退出账号重新登录，或者检查客户端版本是否需要更新。
  • 多设备登录：同一账号可在多个设备上使用，但注意用量和模型配额可能存在限制（参阅官方最新计费说明）。

2.3.2 内置模型切换方式

Trae 在云端部署了多种大语言模型，你可根据需要切换所用的模型。不同模型在代码生成质量、响应速度、上下文长度等方面各有侧重，切换模型能适应不同的任务场景。

切换步骤

  1. 打开 Trae 的设置/偏好界面：
  • 独立客户端：通常通过左下角齿轮图标或菜单 文件 → 首选项 → 设置，找到 AI 模型 相关页面。
  • VS Code 插件：点击侧边栏 Trae 面板右上角的设置图标，或在 VS Code 设置中搜索 “Trae”。
  • JetBrains 插件：在 Settings → Tools → Trae 中查找模型选项。
  1. 在“模型选择”或“默认模型”下拉菜单中，可以看到目前可用的内置模型列表，例如：
  • Claude 系列（Claude 3.5 Sonnet、Claude 3 Opus 等）
  • GPT 系列（GPT-4o、GPT-4 Turbo 等）
  • 其他专为代码优化的模型（名称会随版本更新）
  1. 选择你偏好的模型，更改立即生效。对于侧边栏对话，你也可以在对话面板顶部临时切换当前会话使用的模型，而不影响全局默认设置。

模型选择建议

  • 日常编码补全：通常建议选择速度较快、延迟低的模型，如 Claude 3.5 Sonnet 或 GPT-4o，以获得流畅的行内建议。
  • 复杂重构、长上下文理解：如果需要分析大段代码或跨文件推理，可以切换到上下文窗口更大的模型（如 Claude 3 Opus，128K tokens）。
  • 快速原型生成：选择默认模型通常已足够，若生成质量不理想可尝试换一个模型测试。

不同模型的配额和速率限制可能不同，具体以官方公告为准。如果频繁遇到“超出速率限制”提示，可考虑切换模型或降低请求频率。

2.3.3 自定义 API 模型接入配置

除了内置模型，Trae 允许你接入自己申请的第三方模型 API（如 OpenAI API 密钥、兼容 OpenAI 接口的其他服务），以满足特定需求：使用私有化部署的模型、控制成本或使用未内置的模型。

配置步骤

  1. 打开 Trae 设置页面，找到 模型配置 或 自定义模型 部分（名称可能为“自定义 API”或“第三方模型”）。
  2. 添加新的自定义模型供应商，通常需要填写以下信息：
  • 供应商类型：选择 “OpenAI Compatible” 或具体供应商名称（如果列表中有）。
  • API 端点（Base URL）：填写模型的 API 地址，例如 https://api.openai.com/v1，或私有化部署的地址 http://localhost:8000/v1。
  • API 密钥：填入你的 API Key。注意保密，Trae 会加密存储。
  • 模型 ID：填写要调用的具体模型名称，如 gpt-4o、deepseek-chat、my-local-model 等。
  • 可选参数如温度、最大 token 数等可保持默认，后续按需调整。
  1. 保存配置后，在模型切换列表中可能会出现你自定义的模型。选择它，即可在对话或补全中使用该模型。

注意事项

  • 自定义模型的质量取决于你提供的 API 服务，Trae 不保证其稳定性和代码生成效果。
  • 若连接失败，请检查端点地址是否可正常访问（可用 curl 测试）、API Key 是否有效、Model ID 是否正确。
  • 使用自定义 API 时，费用由你的服务商直接收取，与 Trae 的内置配额无关。
  • 某些模型可能无法支持 Trae 的全部高级功能（例如 @ 引用文件、多模态等），实际能力由模型自身决定。

安全提醒

自定义 API Key 属于敏感信息，请避免在共享环境或截图时泄露。如果怀疑密钥泄露，请在服务商后台及时吊销并重新生成。

完成账号登录和模型配置后，Trae 的 AI 能力就可以完整为你所用了。接下来，你可以进入下一节，设置界面布局、主题与一些基础编码规范，让后续的编码体验更加顺手。