第 01 模块 · 1 节

什么是 Codex 与云端 Agent 编程

《Codex 基础入门》01 认识 Codex · 本节时长 18 分钟

不止程序员本课面向所有以文档、数据、流程为工作对象的人——哪怕你一行代码都不会写。课程全程用「描述需求 → 看它干活 → 验收结果」的方式推进,不需要编程基础。

和聊天工具不一样的「执行型」AI

你可能用过不少 AI 工具,多半是聊天框:你问,它回文字,给出「建议」。至于要不要做、怎么做,还得你自己去改代码。

Codex 不是聊天框。它是一个云端 Agent 编程助手:你说需求,它在一个隔离的云端环境里自己读代码、改文件、跑命令、看结果,再把成果给你。它是执行者,不是建议者。

维度 聊天工具 Codex
工作位置 网页 云端沙箱
能否读代码 不能(只看到你粘的) 能(读整个项目)
能否改文件 不能
能否跑命令 不能 能(隔离环境)
你的角色 把代码复制给它 描述需求 + 审查结果

一句话:你用自然语言「下单」,它在云端「接单干活」。

贯穿项目整门课我们会一起做一个真实工具:一个叫 text-tools 的「云端沙箱里的文本处理工具」——输入一段文本,它能做大小写转换、统计字数、查找替换、去重等操作。每学一节技能,我们都会把它用在这个项目上,最后在 Codex 的沙箱里做出一个真正能跑的文本工具。你现在只需要记住目标,不用动手。

两个关键点:云端 + Agent

Codex 有两个核心特征,先记住:

  • 云端:它在远程的沙箱环境里干活,不占你本地
  • Agent:它是「自主行动」的助手,能多步执行,而不只是单次问答

这里先体会一下「云端」对你的实际意义:你的电脑再破、再没装环境,Codex 也能在云端把活干完,只把结果给你。这和「跑在你电脑上的工具」是两种完全不同的体验——你不用先配好环境,才敢让 AI 动手


什么是「Agent 编程」

Agent 编程是让 AI 以「智能体」的方式干活:你给它一个目标,它自己拆解成步骤、自己执行、自己检查,遇到问题自己调整。

典型协作节奏:

  1. 你用自然语言描述需求
  2. Codex 理解后,规划怎么做
  3. 它动手:读代码、改文件、跑命令
  4. 它把结果和过程汇报给你
  5. 你审查,指出问题,它再改

这个「描述 → 执行 → 审查 → 迭代」的循环,就是 Agent 编程的核心。

你负责「说清楚要什么」,它负责「动手做出来」。

云端的「边界」:它在远端,不在你电脑上

记住「云端」还有另一面:Codex 干活的沙箱在远端,它看得见的是你让它看的工作区,而不是你整台电脑。

  • 它能读/改的,通常限于你指定的工作目录
  • 你本机没授权的东西,它默认碰不到
  • 它跑的命令,跑在沙箱环境里,不是你的系统

这对你是个安全边界,也是分工:你负责把「它该动的范围」说清楚,它在这个范围内放开手脚。


一个可复制的示例

一个最直观的可复制示例——第一次体会「给它一句话,它真去干」:

codex "帮我写一个 Python 脚本,打印 1 到 100 的和,并告诉我结果"

你会发现它不是回一段代码就算了,而是会真的创建文件、跑起来、把结果告诉你。


一个关键认知:工具 ≠ 模型

和 Claude Code 一样,Codex 是工具,背后用哪个模型由你配置:

  • 可以用官方模型
  • 也可以(本课程重点)接 DeepSeek 等国内大模型

工具是「骨架」,模型是「大脑」,两者分开。所以哪怕不依赖境外服务,你也能用 Codex 干出实活——这正是「无需翻墙、全国内网络」的立足点。

换个角度想:工具决定了「它能做什么」,模型决定了「它做得多聪明」。你换一个模型,等于给它换了一个更聪明或更快的大脑,但操作方式、工作目录、沙箱这些都没变。所以先把「工具」这一层用熟,模型随时可以换。


Codex 适合做什么

  • 从零写功能:描述需求,它实现
  • 改 bug:给它报错和上下文,它定位修复
  • 写脚本/工具:重复的、机械的活,交给它
  • 读懂代码:让它解释某个模块在干嘛
想清楚Codex 擅长「动手」,不擅长替你「做决定」。需求怎么定、架构怎么选,依然是你的事。

落地练习:把 text-tools 的「第一句话」说出来

不用装任何东西,先在纸面上想一件事就够了——这是全程会反复用到的技能:把你的目标说成一个能被「执行」的要求。这个工具就是我们的 text-tools

跟着这三步走:

  1. 用一句话写下「最终要得到什么」——比如「做一个在云端沙箱里能处理文本的工具,输入一段话,能统计字数、转换大小写」
  2. 把它拆成 2-3 个可以交给 Codex 的小步骤——比如「先做出『统计字数』这一个功能」
  3. 想想你希望 Codex 在哪个环境里做(提示:Codex 的活都在云端沙箱,不是你的本机)

怎么判断做对了?——如果你能把这句「需求」清晰地说给一个同事听,让 TA 不用追问就能动手,就算过关。能分清「Codex 在云端沙箱干活」而不是「跑在你电脑上」,理解就到位了。

卡住了怎么办? 想不出项目?就照抄本课的 text-tools。觉得「拆步骤」难?那就只写最终目标,我们后面每一节都会带你拆。


常见坑:把 Codex 当「高级百度」

新手最容易踩的坑,是把它当成「更聪明的搜索框」——丢一句话,等答案,自己完全不动。

真正的用法是你参与其中:它动手、你审查、你再决定下一步。如果你只是粘贴问题、复制答案,那你没在用 Agent 编程,只是换了个搜索工具。另一个常见误区是以为 Codex 活干在你电脑上——它干在云端沙箱,成果需要你验收后再同步回来。这两点全课都会反复强调。


小结

  1. Codex 是云端 + 执行型的 Agent 助手,不是聊天框
  2. Agent 编程 = 你给目标,它自己拆解、执行、调整
  3. 工具和模型分开,可以接国内大模型
  4. 你负责方向和判断,它负责动手
  5. 全程我们会一起做一个 text-tools 工具,把每节技能都用上

下一节,装好 Codex 并接上国内模型。