人工智能技术应用课程讲义

第 27 次课：把 Codex 在国内跑通并用起来 ​

一、上节课回顾 ​

上节知识要点：

  • 上节课把重复任务做成自动化：五要素拆流程、先手动跑通、固化成任务说明、换数据复跑验证。
  • 课程里一直用 WorkBuddy 干活，这节课起认识三个和它不同的独立 AI Agent 工具。
  • 第一个工具是 Codex。它和 WorkBuddy 一样能读写文件、执行任务，但在国内装上它、让它用上模型，本身就是第一道坎。

二、本节课任务与安排 ​

本课交付

这节课不写代码案例，专攻「装得上、连得上、用得动」三件事。

你会得到一台能正常使用 Codex 的电脑：离线安装包装好、国产模型接通、三种模式亲自切换过、特色功能跑过一遍。

顺序环节学生产出时间
回顾回顾上节课想起自动化四步5分钟
交付看跑通后的 Codex 演示知道本课交四样3分钟
理论理论基础：Codex 是什么，怎么用能说出它和 WorkBuddy 的区别15分钟
案例1🔧 案例1：离线安装包装好 CodexCodex 启动并进入对话12分钟
案例2🔧 案例2：CCSwitch 接上国产模型DeepSeek 回复正常15分钟
案例3🔧 案例3：三种模式逐个体验切过三种模式并留记录13分钟
案例4🔧 案例4：特色功能逐个验证特色功能各有一样产出12分钟
收尾回扣跑通三步法能复述跑通路径2分钟
机动等待与排错补齐必做成果3分钟
扩展扩展任务：给国产模型做一份档案卡（选做）档案卡一张10分钟

上课前完成课前准备，按老师发的离线安装包开始安装。

环境与准备：Windows 10/11；本机课程目录 D:\AIGC\lesson-27；离线安装包由教师统一发放。教师侧准备项见 [课前演练补充]。

三、理论基础：Codex 是什么，怎么用 ​

今天最大的关口不在功能，在「装不上、连不上」：国内直连 OpenAI 的服务经常失败。今天整节课就是一条跑通链路——装得上、连得上、用得动，三关过了后面都好办。

Codex 是 OpenAI 的编程 Agent。 你用自然语言下任务，它自己读文件、改代码、跑命令、看结果、再修。它和 WorkBuddy 的区别：WorkBuddy 装完就能用，Codex 要先接上模型才能说话。Codex 本身是 ChatGPT 家族的编程工具，但它只是一个壳，里面跑什么模型取决于你怎么配。

国内跑通的完整链路。 三步：装上 Codex 本体、接通模型服务、用它干活。装的时候会遇到「国内直连不上」的问题，解法是社区打包的离线安装包；接模型时解法是 CCSwitch，把 DeepSeek、Kimi 这些国产模型接进来。这条链路跑通了，后面两个工具就都好办了。

Codex 的独特优势。 它能接管电脑上的浏览器替你操作网页、能直接操作电脑里的软件（Computer Use）、还有配套的浏览器插件能在网页上直接调用。这些是 WorkBuddy 没有的能力，后面案例逐个验证。

四、实操环节 ​

案例1：离线安装包装好 Codex ​

任务目标：

双击社区打包的离线安装包，把 Codex 装到电脑上并启动。这个安装包不需要代理，是国内用户打包的免翻墙版本。使用教师统一发放的安装包。

实操步骤

  1. 找到教师发放的 Codex离线安装包.exe，一般保存在桌面或下载文件夹。执行后你会看到：文件图标存在，右键「属性」能看到文件大小在几十到几百 MB 之间。

  2. 双击安装包运行。如果 Windows SmartScreen 弹出「Windows 已保护你的电脑」，点「更多信息」，再点「仍要运行」。执行后你会看到：安装向导窗口弹出，或安装程序开始自动安装。

  3. 按向导点「下一步」直到「安装」，等进度条走完。如果系统提示「未知发行者」或杀毒软件拦截，选「允许」或「信任」。执行后你会看到：桌面或开始菜单出现 Codex 图标。

  4. 双击桌面 Codex 图标启动。首次启动可能要加载几秒。执行后你会看到：Codex 主界面打开，显示对话输入框。

  5. 在输入框随便发一句「你好」，顺便核对安装信息：

    text
    你好，请告诉我你目前的版本号和可用功能列表。
输入素材：
我刚用社区打包的离线安装包装好了 Codex，
安装包文件名 Codex离线安装包.exe，
由社区用户发布，不需要代理。
输入素材结束。

    执行后你会看到：回复可能报网络错误，或者提示需要配置模型。这属于正常现象，下一案例解决它。

    查什么合格的样子
    装得上桌面或开始菜单出现图标，双击能启动
    开得了对话输入框能输入，发送后有响应（报错也算）

扩展练习（选做）

想知道安装包里到底装了什么：

  1. 右键安装包看属性：文件名、版本号、发布方信息，记在扩展记录里。写明「社区用户打包」和官方版的区别：官方版要求代理，离线包不需要。
  2. 执行后你会看到：能向同学解释为什么这个包能离线装。时间不够直接进案例2。

案例2：CCSwitch 接上国产模型 ​

任务目标：

装 CCSwitch，把 DeepSeek 接进 Codex，替代默认的 OpenAI 接口。这是国内用 Codex 的核心一步，跑通了 Codex 才真正能用。

安装包来源：从 CCSwitch 官网或 GitHub Releases 下载，教师统一发放。版本要求：支持 Codex 的较新版本。

实操步骤

  1. 下载 CCSwitch 安装包（教师发放），双击安装，一路「下一步」。执行后你会看到：桌面或开始菜单出现 CCSwitch 图标。

  2. 打开 CCSwitch，首次启动它会自动扫描你电脑上已装的 Agent 工具。执行后你会看到：工具列表里能看到 Codex。

  3. 点「添加供应商」，在预设列表里找到 DeepSeek 官方，按下面填写后保存：

    text
    供应商类型：DeepSeek 官方
API Key：粘贴你自己的 Key
适用工具：Codex

    如果你还没有 Key，去 DeepSeek 开放平台注册并创建一个，粘贴进来。执行后你会看到：CCSwitch 的 DeepSeek 条目已保存，状态显示已启用。

  4. 在 CCSwitch 里把当前供应商切到 DeepSeek，让它写入 Codex 配置。执行后你会得到：CCSwitch 显示当前供应商为 DeepSeek。

  5. 回到 Codex，在对话里发送一句测试，素材已内嵌：

    text
    你好，请用一句话自我介绍。
输入素材：
当前供应商已通过 CCSwitch 切换到 DeepSeek 官方，
API Key 已配置，适用工具为 Codex。
输入素材结束。

    执行后你会看到：DeepSeek 模型返回正常回复，不再报网络错误。这一步通了，Codex 在国内就跑通了。

    查什么合格的样子
    接得上CCSwitch 里 DeepSeek 状态已启用
    用得动Codex 对话有正常回复，无网络报错
    配置不丢重启 Codex 后再次对话仍正常

扩展练习（选做）

CCSwitch 预设里还有 Kimi、GLM。挑一个也接上，切换一次供应商，感受一键切换：

  1. 回到 CCSwitch，选另一个预设供应商，填 API Key 并保存，然后切回去再切过来。
  2. 执行后你会看到：Codex 对话质量有变化。时间不够直接进案例3。

案例3：三种模式逐个体验 ​

任务目标：

Codex 对每一次操作有三种「放权程度」：只读、自动批准、完整访问。逐个体验它们的差别，知道什么时候该用哪种。

实操步骤

  1. 进入「只读模式」，复制下面这段直接发送，素材已内嵌：

    text
    请检查我的 D 盘课程文件夹里有哪些文件，列一个清单。
只列出，不要修改或新建任何东西。

    执行后你会看到：Codex 列出文件清单，没有创建或修改任何东西。

  2. 切到「自动批准模式」，发送同样的问题再观察一次：

    text
    请检查我的 D 盘课程文件夹里有哪些文件，列一个清单。
如果有 CCSwitch 安装包请标注文件大小。

    执行后你会看到：Codex 直接执行命令并给出清单，速度更快，没有逐步询问。

  3. 切到「完整访问模式」，发送：

    text
    请在课程文件夹里新建一个文件，文件名叫「模式测试.txt」，
里面写一行字：这是完整访问模式下创建的。
输入素材：
目标文件夹 D 盘 lesson-27 课程目录；
目标文件名「模式测试.txt」；
文件内容固定一行，写完后立即核对存在性。
输入素材结束。

    执行后你会看到：文件真的出现了，Codex 自己完成了建文件和写内容两步。

  4. 切回「自动批准模式」作为日常默认，删除刚才的测试文件：

    text
    请删除刚才创建的「模式测试.txt」。

    执行后你会得到：文件消失，同时你亲身体会到完整访问模式的威力与风险。

    查什么合格的样子
    只读只列出清单，没有改任何东西
    自动批准直接执行不再逐步询问
    完整访问文件真的被创建又被删除
    模式回切能顺利切回，日常保持自动批准

扩展练习（选做）

想试试计划模式的话，加做一步：

  1. 发送这句让 Codex 先出方案再动手：

    text
    我想给课程文件夹做一个目录清单网页。请先只出方案和步骤，
我确认后再执行。

  2. 执行后你会看到：Codex 先列出它打算做什么，等你确认才动。时间不够直接进案例4。

案例4：特色功能逐个验证 ​

任务目标：

逐一验证 Codex 区别于 WorkBuddy 的特色能力：浏览器控制、Computer Use、浏览器插件。每个功能跑一小段，看到效果就行。

实操步骤

  1. 浏览器控制。 在 Codex 对话框发送：

    text
    请打开浏览器访问 bilibili.com，在搜索框输入 AI Agent
并执行搜索，把前三个视频标题告诉我。
输入素材：
目标网站 bilibili.com；搜索词 AI Agent；取前三条结果。
输入素材结束。

    执行后你会看到：浏览器窗口被 Codex 自动打开，页面自动输入并搜索，Codex 汇报前三条结果。

  2. Computer Use。 发送：

    text
    请打开记事本，输入一行字：Codex 能操作我的电脑。
保存到桌面，文件名叫「Codex测试.txt」。

    执行后你会看到：记事本窗口自己打开，文字自己出现，桌面多了那个文件。

  3. 浏览器插件。 打开 Chrome 或 Edge，在 Codex 官网找到浏览器插件入口，按页面提示安装。装好后随便打开一个网页，点插件图标看它能做什么。执行后你会看到：插件出现在浏览器右上角，点开能看到当前页面的 AI 选项。

  4. 用 CCSwitch 里的配置备份功能，把今天调好的 Codex 配置导出备份一次。执行后你会得到：一份配置备份文件，下节课装 Hermes 时可以直接参照。

    查什么合格的样子
    浏览器控制页面自动搜索，Codex 汇报了前三条标题
    Computer Use记事本被打开并写入，桌面出现文件
    浏览器插件插件装上并能对当前页面操作
    配置已备份CCSwitch 里能看到配置备份记录

扩展练习（选做）

想把今天的能力串起来的，加做一步：

  1. 发送这个组合任务：

    text
    请用浏览器查一下今天北京的天气，
然后用记事本记录到桌面，文件名叫「天气记录.txt」。

  2. 执行后你会看到：浏览器查完、记事本写完，一次对话跑完两个工具。时间不够直接进课后巩固。

扩展任务：给国产模型做一份档案卡（选做） ​

任务目标：

案例2里接的 DeepSeek，和 Kimi、GLM 有什么差别？给每个接过的国产模型各做一张「档案卡」，下次换模型时知道挑哪个。

实操步骤

  1. 复制下面的提示词直接发送，素材已内嵌可直接运行：

    text
    我现在在 Codex 里接了三家国产模型供应商。
请帮我给每家做一张档案卡，格式：
模型名、擅长什么、不擅长什么、响应速度体感、价格档位、建议场景。
我测过的感受：DeepSeek 写代码最快；Kimi 长文本总结最细；
GLM 中文表达最自然。
输入素材：
深度求索 DeepSeek：数学和代码见长，API 便宜，响应快。
月之暗面 Kimi：长文本窗口最大，适合读长报告。
智谱 GLM：中文表达流畅，适合写报告和公文。
输入素材结束。

  2. 执行后你会看到：三张档案卡生成。以后想换模型时看卡片就能挑。

五、总结与巩固 ​

随机请两位同学 1 分钟展示：我的 Codex 现在能做什么、卡的哪一步是靠什么解决的。

回想本课跑通三步法：装得上 → 连得上 → 用得动。装不上的找离线包，连不上的用 CCSwitch 换国产模型，用不动的看官方文档和模式设置。

说一说：Codex 的三种模式你会默认选哪种？为什么？

这套「跑通思路」接下来两节课还要用：Hermes Agent 要配 provider，DeepSeek Harness 要手写配置，都是今天这套方法的延续。

六、资料与下载 ​

  • 课前准备：安装包来源、CCSwitch 下载、机房自查。
  • 课程资料：本课素材清单与 API Key 说明。

延伸视频

推荐观看：Codex 与 WorkBuddy 类 Agent 工具的能力差异。