安装 Agent 工具

本章目标：将 Trae、Claude Code CLI、Codex 三款 Agent 工具安装到本地并验证可用。如果你只打算使用其中一款，跳过其余部分即可。

1. 前置条件

依赖	版本要求	用途
Node.js	≥ 20.x	Claude Code CLI 和 Codex 的运行时环境
Git	任意近期版本	克隆仓库、版本管理
网络	视工具而定	Claude Code CLI / Codex 需外网；Trae 国内直连

仅使用 Trae 的用户

如果你只安装 Trae，不需要 Node.js。Trae 是独立桌面应用，无 Node.js 依赖。但后续部署 Skill 时会用到 git clone 命令，请确保 Git 可用。

Node 和 git

安装包请见下载中心处的百度网盘分享。

2. 安装 Trae

Trae 是独立桌面应用，安装流程与常规软件一致。

2.1 下载

访问 Trae 官网下载页，选择 Trae IDE Windows 版下载。

支持平台：Windows（x64）、macOS（Intel / Apple Silicon）、Linux（x64）。

2.2 安装

Windows：

1. 运行下载的 .exe 安装包
2. 按向导提示完成安装（默认选项即可）

macOS：

1. 打开 .dmg 文件
2. 将 Trae 图标拖入 Applications 文件夹

Linux：

按照官网提供的对应发行版安装指引操作。

2.3 启动与登录

1. 启动 Trae
2. 使用手机号或邮箱注册并登录

登录后主界面左侧可见 AI 对话面板，即可开始使用。

2.4 验证

启动后能正常进入主界面并看到 AI 对话入口，即为安装成功。

启动失败排查

• 闪退：确认系统内存 ≥ 8GB（Trae 基于 VS Code 内核，内存需求较高）
• 权限问题：Windows 下尝试「以管理员身份运行」
• 杀毒拦截：部分安全软件会拦截未知应用，将 Trae 加入白名单
• 安装包损坏：重新从官网下载覆盖安装

3. 安装 Claude Code CLI

Claude Code CLI 通过 npm 全局安装，依赖 Node.js 运行时。

3.1 安装 Node.js

已安装 Node.js 20+ 可跳过

前往 Node.js 官网 下载 LTS 版本（≥ 20.x）。

Windows：

下载 .msi 安装包，运行向导完成安装。

⚠️ 安装路径不要包含中文或空格，否则后续 npm 全局安装可能出现路径解析问题。

macOS：

brew install node

或下载 .pkg 安装包手动安装。

Linux（Debian/Ubuntu）：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装：

node --version   # 应输出 v20.x.x 或更高
npm --version    # 应输出 10.x.x 或更高

npm 镜像源配置（可选，国内用户推荐）：

npm config set registry https://registry.npmmirror.com

3.2 安装 CLI

npm install -g @anthropic-ai/claude-code

-g 表示全局安装，安装后可在任意目录调用 claude 命令。

权限问题处理

• Windows：以管理员身份运行终端
• macOS / Linux：命令前加 sudo，或配置 npm 全局目录到用户空间（参考 npm 官方指南）

但因为 claude 是国外的软件，国内访问时通常网络不好，安装很慢很卡，那么可以在 CMD 中使用下面命令切换到国内镜像源下载：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

安装完成后，验证是否安装成功：

在命令行上执行 claude -v，输出版本号即安装成功。

claude -v

输出版本号即安装成功。如果提示 command not found，通常是 npm 全局目录不在系统 PATH 中——关闭并重新打开终端即可。

4. 安装 Codex

Codex 是 OpenAI 的 AI 编码命令行工具，安装方式与 Claude Code CLI 类似。

4.1 安装

npm install -g @openai/codex

网络问题处理

如果遇到 ETIMEDOUT 或 ECONNREFUSED：

• 检查网络连接是否可达外网
• 尝试配置 npm 镜像源：npm config set registry https://registry.npmmirror.com
• 公司内网环境可能需要配置 HTTP 代理

4.2 登录认证

codex login

执行后会自动打开浏览器，完成 OpenAI 账号授权。如果浏览器未自动打开，终端会输出一个 URL，手动复制到浏览器中打开。

TIP

需要 OpenAI 账号且已开通 API 权限。如尚未注册：https://platform.openai.com/

4.3 验证安装

codex --version

输出版本号即安装成功。

5. 安装验证清单

工具	验证方式	预期结果
Trae	启动应用	正常进入主界面，AI 对话面板可用
Claude Code CLI	claude --version	输出版本号
Codex	codex --version	输出版本号

注意

• 至少有一款工具验证通过即可进入下一步
• 三款工具功能重叠，无需全部安装
• 如果某款工具因网络原因无法安装，先跳过，后续有条件时再补

---

安装完成后，Agent 工具已经可以正常工作——但它还不具备 TI 芯片的专业知识。下一步，将天巧星 Skill 部署到 Agent 中，使其获得 MSPM0 平台的开发能力。