Skip to content

安装 Codex / Trae / Cursor / OpenCode 的基本流程

02-02 安装 Codex / Trae / Cursor / OpenCode 的基本流程

Section titled “02-02 安装 Codex / Trae / Cursor / OpenCode 的基本流程”

这一课带学员理解 AI 工作台工具安装的共同流程。

具体工具会变化,安装动作大体相似:确认官方入口、下载或执行官方命令、打开工具、登录账号、授权项目文件夹、做最小测试。学员掌握这条流程,以后换工具也不会重新恐慌。

这一课重点放在“可检查流程”上。学员不需要背工具差异,只需要知道每一步成功时是什么样,卡住时该把什么现场交给 AI。

  • 让学员理解安装主线工具的基本步骤。
  • 让学员知道官方下载入口的重要性。
  • 让学员看懂登录、授权、文件夹权限这些常见弹窗。
  • 让学员知道遇到安装报错时要截图或复制完整信息。
  • 让学员完成一份安装过程记录。
  • 建议时长:30 到 40 分钟。
  • 用课程主线工具完整演示一遍。
  • 弹窗出现时停下来讲,不要快速点过。
  • 终端命令出现时先解释含义,再执行。
  • 如果你选 Codex 做主线,可以补一句:Trae、Cursor、OpenCode 的具体入口会不同,安装心法相同。

你可以这样开场:

“安装软件最怕的是,一路点下一步,突然弹出一个英文提示,然后整个人停住。今天我们把安装拆成几个动作,每一步都能看懂。”

第一步,找到官方入口。

“工具安装尽量从官网或官方文档进入。搜索结果里可能会有广告、搬运站、旧版本。我们今天只认官方入口。你可以让 AI 帮你解释官方文档,但下载地址要自己确认来源。”

这里可以给学员一句协作文本:

我准备安装这个 AI 工作台工具。
这是我找到的安装页面:
请帮我判断这页主要让我做哪几步,并提醒我哪些地方要人工确认来源。

第二步,下载或执行官方命令。

“有些工具下载安装包,有些工具需要在终端里执行官方命令。终端命令看起来吓人,其实它只是另一种安装方式。你不确定命令含义时,先复制给 AI 解释,再决定是否执行。”

第三步,打开工具并登录。

“登录经常跳到浏览器。邮箱验证码、账号授权、打开本地应用,都属于正常流程。看到跳转不要慌,先看它是不是你刚才安装的工具。”

第四步,授权项目文件夹。

“工作台工具需要看项目文件,所以会请求访问某个文件夹。这里的原则是范围清楚:课程里只授权课程项目文件夹。你知道它能看哪里,心里就稳。”

第五步,做最小测试。

“安装成功不能只看图标亮了。最小测试有两个结果:AI 能正常回复,并且能看见你指定的项目文件夹。”

测试表达可以这样写:

请确认你现在能否读取当前项目文件夹。
如果能,请列出你看到的文件和文件夹。
如果不能,请告诉我还需要检查哪个设置。

如果安装中出错,交给 AI 时要带完整现场:

我正在安装 AI 工作台工具。
我的系统是:
我刚才做到哪一步:
这是弹窗或完整报错:
请先用大白话解释可能原因,再告诉我下一步怎么检查。

最后要强调:

“安装不靠勇敢硬点。安装靠记录、确认、测试。每一步都能留下痕迹,卡住时就有东西可以交给 AI。”

  1. 打开主线工具官网或官方文档。
  2. 标出下载入口或安装命令。
  3. 把安装说明复制给 AI,让它翻译成步骤。
  4. 下载工具或执行官方命令。
  5. 打开工具。
  6. 登录账号。
  7. 处理授权弹窗,说明它在请求什么。
  8. 授权课程项目文件夹。
  9. 发送最小测试表达。
  10. 保存安装过程记录。

让学员记录自己的安装过程:

  • 我从哪个官方入口进入。
  • 我执行了哪一步安装动作。
  • 我登录了哪个账号。
  • 我授权了哪个文件夹。
  • 我遇到了什么提示。
  • 我如何判断工具能用了。

练习完成后,让学员把记录交给 AI:

这是我的安装过程记录。
请帮我检查有没有漏掉关键步骤,尤其是官方入口、登录账号、文件夹授权和最小测试。
  • 下载入口太多:回到官网或官方文档。
  • 终端命令看着吓人:先复制给 AI 解释作用。
  • 权限弹窗紧张:确认它访问的是课程项目文件夹。
  • 登录跳转失败:检查浏览器、网络和邮箱。
  • 工具打开了但 AI 没反应:先做最小测试,确认模型和账号状态。
  • 安装报错看不懂:截图或复制完整报错,带上系统版本。

保存安装过程记录,并截一张“工具能正常回复且能看见项目文件夹”的图。

补充要求:

  • 记录官方入口。
  • 记录登录账号。
  • 记录授权文件夹。
  • 写下最小测试结果。
  • 第 1 页:标题“安装是一组可检查动作”
  • 第 2 页:官方入口
  • 第 3 页:下载或官方命令
  • 第 4 页:登录账号
  • 第 5 页:授权项目文件夹
  • 第 6 页:最小测试
  • 第 7 页:报错交给 AI
  • 第 8 页:安装过程记录