---
title: "安装 Trae 国内版与 Claude Code 插件"
description: "从下载到验证：只从官网装 Trae 国内版，找到内置或扩展市场里的插件，登录后用一句话确认它能看见当前项目。附一张故障对照表。"
updated: 2026-11-13
canonical: https://docai.cc/learn/trae-claude-code-setup/
markdown_mirror: https://docai.cc/learn/trae-claude-code-setup.md
---
## 先分清要装的两样东西

你要装的是一个编辑器，加上它里面的一个 AI 插件。编辑器叫 Trae 国内版，负责打开文件夹、显示文件；插件负责读内容、改内容、跟你对话。把这两件事分开看，装完就不会不知道下一步点哪里。

动手前准备三样：一台能正常上网的电脑、几百 MB 空闲磁盘、一个能收验证码的手机号或邮箱。系统最低版本和安装包大小会随版本变化，以下载页当前标注的为准，不要照搬旧教程里的数字。

## 下载：只认官网

在搜索框里输入产品名，排在前面的结果不一定来自官方。点开前先看域名，再看下载按钮指向哪里；不确定就多开一个标签页对照。微软系统拿 `.exe`，苹果电脑拿 `.dmg`，不要从网盘、软件管家或所谓「绿色版」站点获取。

Mac 上双击安装包后，如果系统说这个来源未受信任，先走系统设置里的「隐私与安全性」，那里通常有「仍要打开」。不要为了省事去网上抄一段解除限制的命令，来源不明的命令比装不上更麻烦。

## 安装与第一次启动

Windows 双击安装包，向导里保持默认，等它写完文件；macOS 把图标拖进「应用程序」文件夹，再从那里启动，不要直接在下载目录里双击运行。

安装过程中，系统可能弹出一个权限询问，确认是否允许这个安装程序改动设备，这是正常提示。第一次启动还会问是否发送匿名使用数据、是否登录；前者按自己的偏好选，不影响主要功能，登录可以稍后再说。

启动后先打开一个具体的工作文件夹，别选整个磁盘。插件后面读写文件都围绕这个目录进行，范围给大了，误改的风险也跟着变大。

## 插件从哪来

有两种情况。第一种是版本已经内置，侧边栏或顶部有一个对话图标，点开就能用；第二种需要去扩展市场搜名字安装，装完重启编辑器。

先看侧边栏，没有再搜市场。找不到入口时，打开命令面板搜插件名，一般能重新调出来。命令面板的快捷键各版本不一样，在设置或帮助里能查到，不必背。

市场里同名条目可能不止一个，看清发布者再点安装。装完先重启一次编辑器，很多「点了没反应」只是插件还没加载完。

装完确认三件事：图标在、点了能打开面板、能看见当前项目。三件都成立，再谈登录。

## 登录与一次最小验证

有账号就按提示登录；没有账号可以跳过。第 2 章会讲怎么把模型换成国内的，不需要先解决海外账号问题。

验证只要一句话：

> 你好，用一句话说明你能帮我做什么。

看到正常回复就算通。没有回复时按顺序排查：插件是否启用、是否需要重启、网络是否可达、登录是否完成。四项里总有一项对得上。

| 现象 | 优先检查 |
|---|---|
| 点击图标没有反应 | 插件是否启用、编辑器是否需要重启 |
| 面板一直转圈 | 网络、代理、账号所在地区 |
| 提示未登录 | 登录流程是否走完 |
| 面板消失 | 用命令面板重新打开 |
| 提示连接失败 | 默认服务在境外，先看下一章的替换方案 |

## 装好之后的第一条规矩

先让它做只读的事：读一个文件、概括内容、指出结构。确认它看到的是你以为的那个文件，再让它动手改。权限弹窗出现时看清路径，拿不准就拒绝，重新描述一遍任务。

工具装好只是起点，界面里每个区域负责什么，下一节逐个拆开：[每个功能区的作用](/learn/claude-code-interface-tour/)。