Trae IDE 接入 ClaudeAPI 完整配置教程（2026）
字节跳动出品的 AI 编程 IDE，免费使用 Claude 顶级模型， 5 分钟完成配置，国内直连无障碍。
什么是 Trae
Trae（原名 Trea）是字节跳动推出的 AI 原生 IDE，基于 VS Code 内核， 内置 AI 对话、代码补全、智能重构等功能。与 Cursor 定位类似， 但对国内用户更友好，且基础功能完全免费。
为什么要接入 ClaudeAPI？
Trae 内置模型能力有限，接入 Claude Sonnet / Opus 后：
- 代码生成质量大幅提升
- 复杂重构任务更可靠
- 长上下文理解更准确
准备工作
获取 ClaudeAPI 密钥
- 访问 console.claudeapi.com 注册
- 进入「API 密钥」页面 → 创建新密钥
- 复制保存（仅显示一次）
第一步：下载安装 Trae
前往官网下载：trae.ai
选择对应系统版本（Windows / macOS），安装完成后启动。
第二步：进入模型配置
windows：下载cline扩展
勾选第三个[Bring my own API Key] 确定，进入api配置界面。
mac：
- 打开 Trae，点击左下角 设置图标 ⚙️
- 选择「AI 配置」或「Model Settings」
- 找到「自定义模型」/「Custom Provider」选项
第三步：配置 ClaudeAPI
在自定义模型配置中，按以下信息填写：
| 配置项 | 填写内容 |
|---|---|
| 供应商类型 | Anthropic / Claude |
| API Base URL | https://gw.claudeapi.com |
| API Key | 你的 ClaudeAPI 密钥 |
| 默认模型 | claude-sonnet-4-6 |
⚠️ 如果只有 OpenAI Compatible 选项，Base URL 填
https://gw.claudeapi.com/v1
第四步：选择模型
ClaudeAPI 可用模型：
| 模型名称 | 定价（输入/输出） | 推荐场景 |
|---|---|---|
claude-sonnet-4-6 |
$2.40 / $12 | 日常编程、代码审查（推荐） |
claude-opus-4-7 |
$4 / $20 | 复杂架构、高难度 Debug |
claude-haiku-4-5-20251001 |
$0.80 / $4 | 快速补全、简单问答 |
新用户推荐从 claude-sonnet-4-6 开始，性价比最高。
第五步：验证配置
- 点击「保存」或「Test Connection」
- 打开任意项目文件
- 使用快捷键唤起 AI 对话（通常是
Ctrl/Cmd + L） - 输入测试问题：
解释一下这个文件的主要功能
解释一下这个文件的主要功能
模型正常返回即配置成功 ✅
核心功能使用
1. AI 对话（Chat）
快捷键 Ctrl/Cmd + L 打开对话面板，可以：
- 询问代码问题
- 生成代码片段
- 解释复杂逻辑
2. 内联编辑（Inline Edit）
选中代码 → 按 Ctrl/Cmd + K → 输入指令：
- 「优化这段代码的性能」
- 「添加错误处理」
- 「转换为 TypeScript」
3. 代码补全（Autocomplete）
正常编码时，Claude 会自动提供智能补全建议，按 Tab 接受。
4. 引用上下文
在对话中使用 @ 符号引用：
@file- 引用当前文件@folder- 引用整个文件夹@selection- 引用选中代码
进阶配置
切换模型
在对话面板顶部，点击模型名称可快速切换：
- 简单问题 → Haiku（快速响应）
- 日常开发 → Sonnet（平衡）
- 复杂任务 → Opus（最强）
自定义 System Prompt
部分版本支持在设置中配置默认 System Prompt：
你是一名资深软件工程师，擅长 Python 和 TypeScript。
回答要简洁，代码要有注释，优先考虑可读性和可维护性。
你是一名资深软件工程师，擅长 Python 和 TypeScript。
回答要简洁，代码要有注释，优先考虑可读性和可维护性。
配置文件位置
Trae 配置文件通常位于：
- Windows:
%APPDATA%\Trae\settings.json - macOS:
~/Library/Application Support/Trae/settings.json
常见问题
Q：提示 API Key 无效？
检查以下几点：
- 密钥是否完整复制（无多余空格）
- Base URL 是否正确（
https://gw.claudeapi.com） - ClaudeAPI 账户余额是否充足
Q：对话响应很慢？
- 切换至 Haiku 模型，响应速度最快
- 检查网络连接
- 减少引用的上下文文件数量
Q：代码补全不生效？
- 确认已在设置中启用「AI Autocomplete」
- 部分文件类型可能默认关闭，需手动开启
- 检查模型是否正确配置
Q：Trae 和 Cursor 怎么选？
| 维度 | Trae | Cursor |
|---|---|---|
| 价格 | 免费 | Pro $20/月 |
| 国内访问 | 更友好 | 需要稳定网络 |
| 自定义 API | 支持 | 需插件（Roo Code） |
| 生态成熟度 | 较新 | 更成熟 |
预算有限或国内用户 → 推荐 Trae 追求极致体验 → Cursor + Roo Code
总结
| 步骤 | 操作 |
|---|---|
| 1 | 注册 ClaudeAPI，获取密钥 |
| 2 | 下载安装 Trae |
| 3 | 设置 → AI 配置 → 自定义模型 |
| 4 | 填入 Base URL + API Key + 模型名 |
| 5 | 测试对话确认配置成功 |
Trae + ClaudeAPI 组合，让你免费获得顶级 AI 编程体验， 国内直连无障碍，按量付费更灵活。
开始使用
支付宝 / 微信充值，注册即有体验额度。
