Trae 集成

在字节 Trae IDE 中使用 Claude Code 扩展（含国内 Trae CN 离线安装指南）

Trae 集成¶

Trae 是字节跳动推出的 AI 原生 IDE，基于 VS Code 分支（fork）构建，既兼容绝大多数 VS Code 扩展，又内置了自家的 Builder / Chat 智能体。本指南介绍如何在 Trae（国际版）或 Trae CN（国内版）中安装并使用 Claude Code 扩展，通过 QCode.cc 调用 Claude、Codex 等模型。

前提条件¶

配置 Trae 扩展前，请确保：

1. Claude Code CLI 已安装并可正常使用

2. 参考 安装教程 完成安装

3. 参考 环境变量配置 完成配置

4. Trae 或 Trae CN 已安装至最新版

5. 国际版下载：trae.ai

6. 国内版 Trae CN 下载：trae.com.cn

什么时候用 Trae CN？ Trae CN 是针对中国大陆网络环境优化的版本；如果你身处海外或已有稳定的国际网络，推荐使用国际版。

安装步骤¶

步骤 1：安装 Claude Code 扩展¶

Trae 兼容大部分 VS Code 扩展。Claude Code 扩展有两种安装路径，按顺序尝试即可。

路径 A：从 Trae 内置扩展市场安装（推荐）¶

1. 打开 Trae，进入扩展面板（Ctrl+Shift+X / Cmd+Shift+X）

2. 搜索 "Claude Code"（发布者为 Anthropic）

3. 点击 安装

如果 Trae 扩展市场找不到 Claude Code（在 Trae CN 早期版本中较常见），请走路径 B。

路径 B：离线 .vsix 本地安装¶

这是对 Trae CN 用户最稳妥的方式：

1. 在浏览器打开 Claude Code 扩展页面

2. 在右侧栏找到 Download Extension 链接，下载 .vsix 文件

提示：国内网络访问 VS Code Marketplace 可能需要代理。若本机下载失败，可在有代理的环境下载 .vsix 后再拷贝回本机。

1. 在 Trae 中打开扩展面板 → 右上角 ⋯ 菜单 → 从 VSIX 安装（Install from VSIX），选择下载好的 .vsix 文件

或使用命令行：

bash trae --install-extension /path/to/claude-code-x.x.x.vsix

步骤 2：配置 primaryApiKey¶

这是关键步骤！Claude Code 扩展需要在配置文件中设置 primaryApiKey。

好消息：Trae 与 VS Code 共用同一个配置路径（~/.claude/config.json），之前已经在 VS Code 中配置过的用户无需重复操作。

{
  "primaryApiKey": "qcode"
}

mkdir -p ~/.claude

cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

mkdir -p ~/.claude

cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

注意：primaryApiKey 的值可以是任意内容（如 qcode），只要配置了这个字段即可。实际的 API 认证仍然使用你在环境变量中配置的 ANTHROPIC_AUTH_TOKEN。

重要：配置文件是 config.json，不是 settings.json。请仔细区分这两个文件。

步骤 3：重启 Trae¶

配置完成后，重启 Trae 使配置生效。

与 Trae 内置 AI 的关系¶

Trae 自带 Builder 和 Chat 两种 AI 模式，由字节自家后端驱动；Anthropic 官方的 Claude Code 扩展走你配置的 ANTHROPIC_BASE_URL（即 QCode.cc 代理）。两者完全独立、可共存：

如果你已购买 QCode.cc 服务，建议主要通过 Claude Code 扩展使用，以充分发挥套餐价值。

使用方法¶

快捷键¶

常用功能¶

1. 代码解释

2. 选中代码

3. 右键选择 "Ask Claude" 或使用快捷键

4. 输入问题，如 "解释这段代码"

5. 代码生成

6. 打开 Claude 面板

7. 描述你需要的功能

8. Claude 会生成代码并提供插入选项

9. 代码重构

10. 选中需要重构的代码

11. 让 Claude 帮助重构

12. 预览并应用更改

13. 错误修复

14. 当代码出现错误时

15. 选中错误代码或错误信息
16. 让 Claude 分析并提供修复方案

配置选项¶

在 Trae 设置中可以调整 Claude Code 扩展的行为（这些设置与 VS Code 共通）：

1. 打开设置（Ctrl+, / Cmd+,）

2. 搜索 "Claude Code"

3. 根据需要调整选项

常用设置¶

{
  "claude-code.autoSuggest": true,
  "claude-code.inlineChat": true
}

与终端 CLI 配合使用¶

Trae 扩展和终端 CLI 可以配合使用：

故障排除¶

扩展市场搜不到 Claude Code¶

症状：Trae 扩展面板搜索 "Claude Code" 无结果，或返回的不是 Anthropic 官方发布的版本。

解决：改走 路径 B：离线 .vsix 本地安装（参见上文步骤 1）。这是目前 Trae CN 用户最稳妥的方式。

Trae CN 下载 .vsix 连不上¶

症状：访问 marketplace.visualstudio.com 失败或下载速度为 0。

解决：

1. 通过稳定的海外网络或代理访问 Marketplace 下载 .vsix

2. 或向 QCode.cc 客服索取 Claude Code 扩展 .vsix 镜像链接

3. 下载后通过"从 VSIX 安装"方式加载

Claude Code 面板空白 / 启动无响应¶

1. 确认 ~/.claude/config.json 存在且 JSON 格式合法

2. 确认文件名是 config.json 而不是 settings.json（这是最常见的踩坑点）

3. 确认环境变量 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 已正确设置

4. 在终端运行 claude 确认 CLI 能正常工作

快捷键与 Trae 内置 AI 冲突¶

如果 Cmd+Esc / Ctrl+Esc 被 Trae 的 Builder / Chat 抢占：

1. 打开 Trae 设置 → 键盘快捷方式

2. 搜索 claude-code 或 Claude Code

3. 为 "Claude Code: Toggle Panel" 重新绑定一个无冲突的按键

连接超时¶

1. 检查网络是否能连通 https://asia.qcode.cc

2. 验证 ANTHROPIC_BASE_URL 环境变量设置

3. 国内用户在无代理环境下推荐使用 asia.qcode.cc 或 cn.qcode.cc 入口

下一步¶

• 探索 CLI 技巧 提升使用效率

• 学习 工作流技巧 优化开发流程

• 了解 VS Code 集成 如果你同时也在使用 VS Code