工具安装手册
工具安装手册
Section titled “工具安装手册”安装 AI 工作台工具前的准备、四个主线工具的通用安装步骤、API Key 配置，以及常见报错。工具更新很快，本页只保留不依赖具体版本的操作骨架。
安装前准备（工坊体检）
Section titled “安装前准备（工坊体检）”安装按钮本身很少卡人，卡人的是安装前的小准备。先做四件事：
- 查系统版本：Mac 看”关于本机”，Windows 看”系统信息”。抄三样：系统名称、版本号、芯片或处理器。遇到安装问题把这三样发给 AI，问题立刻清楚一半。
- 确认浏览器可用：下载、登录、授权都会跳浏览器。先确认浏览器能打开官网、能登录邮箱、能复制验证码。
- 确认邮箱能收信：很多工具靠邮箱登录。提前打开邮箱，确认能收信、能复制验证码、知道垃圾邮件在哪。
- 找到下载文件夹：先打开一次下载文件夹，知道下载记录在哪、安装包通常落在哪、怎么从浏览器点”在文件夹中显示”。
四个主线工具：通用安装步骤
Section titled “四个主线工具：通用安装步骤”Codex、OpenCode、Trae、Cursor 的安装逻辑相同，都是四步：找官方入口 → 下载或执行官方命令 → 登录 → 验证能用。
第一步：找到官方入口
Section titled “第一步：找到官方入口”从官网或官方文档进入。搜索结果里可能有广告、搬运站、旧版本。只认官方入口。可以让 AI 帮你解释官方文档，但下载地址要自己确认来源。
我准备安装这个 AI 工作台工具。这是我找到的安装页面：请帮我判断这页主要让我做哪几步，并提醒我哪些地方要人工确认来源。第二步：下载或执行官方命令
Section titled “第二步：下载或执行官方命令”有的工具下载安装包，有的工具需要在终端执行官方命令。终端命令只是另一种安装方式。不确定命令含义时，先复制给 AI 解释，再决定是否执行。
第三步：登录
Section titled “第三步：登录”用邮箱或账号登录。安装到一半收不到验证码时，去垃圾邮件里找。登录后确认账号状态正常。
第四步：验证能用
Section titled “第四步：验证能用”安装完立刻验证，别等用的时候才发现有问题：
- 打开工具，确认界面正常进入。
- 发一条最简单的请求，确认能正常回复。
- 如果配了模型或 API Key，确认已选对模型。
API Key 配置
Section titled “API Key 配置”API Key 像一把访问钥匙，工具拿着它去调用模型。配置要点：
- 保管：别发群里，别写进公开项目，别截图发到公开笔记。
- 课程笔记：写”我使用 API Key 方式配置”即可，不要写完整 Key。
- 配置位置：通常在工具的设置或环境变量里。课程演示到哪里，就跟到哪里，不自己发明步骤。
- 验证：配置完立刻发一条请求测试，通了再继续。
常见安装报错处理
Section titled “常见安装报错处理”| 现象 | 处理 |
|---|---|
| 官网打不开 | 检查网络；换个浏览器；确认是否被代理或防火墙拦截 |
| 下载很慢 | 换网络环境；从官方镜像或国内官方渠道下载；不要在下载一半时关掉 |
| 下载完找不到安装包 | 打开下载文件夹；从浏览器”在文件夹中显示” |
| 安装包打不开 | 确认系统版本要求；确认下载完整（对比文件大小）；Mac 看是否需右键打开 |
| 登录收不到验证码 | 查垃圾邮件；重新发送；确认邮箱拼写 |
| 工具打不开 | 把系统版本、报错完整复制给 AI 或老师 |
| 发消息一直报错 | 先确认模型已选、额度正常、API Key 配置正确 |
报错要打包完整再求助：系统版本 + 你运行的命令 + 完整报错 + 你已尝试的动作。
- 安装前准备什么 工坊体检四件事
- 安装 Codex / Trae / Cursor / OpenCode 四步安装法
- 模型、API Key 和订阅 钥匙的保管边界
- 怎么判断工具已经能用了 安装完立刻验证