LESSON 03 · 动手实战

再装一个,OpenAI Codex

动手实战 · 第 3 课

Why this lesson · 为什么值得学

学完这一课,你能

知道 Codex 是什么、它和 Claude Code 是「同类」,理解为什么会有好几个类似工具

用和上一课一模一样的办法,让 WorkBuddy 一句话帮你把它装好

建立「工具不用只挑一个」的心态——手里有好几把刀,用顺手的那把

核心洞察:你已经装过一次 Claude Code 了。这一课的重点不是「又一个新东西」,而是让你体会到一件更重要的事——装第二个同类工具,流程几乎一模一样。当你发现「原来套路是通用的」,你就真正入门了,以后再遇到任何命令行 AI 工具,你都不慌。

最新动态:OpenAI 正把独立的 Codex 桌面 / 手机 App 逐步并入 ChatGPT 桌面端——官方说明这是按计划和账户逐步推出的,以你自己的 ChatGPT 里实际显示为准,不是所有账户同一天都有。但别慌:我们这一课装的是它的命令行版 Codex CLI,始终独立可用(当前版本见 Codex 配置说明页);而且 Codex 已开放「自定义模型服务商」,能直接接 DeepSeek / Qwen / Kimi 等——对国内用户是重大利好(配置步骤见说明页)。

Tool 03 · 终端里的 AI 编程搭档

OpenAI Codex(ChatGPT 同门)

和 Claude Code 是同一类:活在终端里、能读你的项目、帮你写代码改文件。区别只是背后换成了 OpenAI。

Codex 是什么?它和 Claude Code 什么关系?

简单说:Codex 是 OpenAI(做 ChatGPT 那家公司)出的 AI 编程工具。它和上一课的 Claude Code 是「同一类东西」——都能理解你的整个项目、帮你写和改代码。要分清两层:独立的 Codex App 正逐步并入 ChatGPT 桌面端(按官方计划分批推出,以你账户实际显示为准);但我们这一课装的是它的命令行版 Codex CLI,它始终独立运行、照常用——所以下面内容不受影响。

你可能会问:既然功能这么像,为什么要有两个?

打个比方

就像可乐有可口可乐和百事可乐,手机有苹果和安卓。Claude Code 背后是 Anthropic,Codex 背后是 OpenAI。两家公司各做各的,风格、脾气、擅长的活儿略有不同。你不用现在就分出高下——先都装上、都试试,哪个用着顺手就多用哪个。

它俩到底怎么选?

Claude Code

OpenAI Codex

零基础的正确心态:别纠结「哪个更好」。这个阶段,你的目标是「都会装、都敢用」。真正用起来之后,你自然会形成偏好——那才是有意义的选择。

最省事的装法:又是那一句话

还记得上一课的魔法吗?装 Codex 用完全一样的套路。你不用记它的具体命令,打开 WorkBuddy,把要装的东西告诉它就行。

现在就试:把这句发给 WorkBuddy

帮我在这台电脑上安装 OpenAI Codex 命令行工具。需要的前置环境你一并帮我装好。装完之后,用最简单的话告诉我怎么启动、怎么登录。

剩下的还是那件事:它请求权限时,看一眼,点「同意」。看不懂就让它先解释给你听。

WorkBuddy 背后帮你做了什么(你不用记)

1

检查环境

看你电脑上有没有 Codex 需要的运行环境(如 Node.js),缺什么补什么。

2

执行安装

替你运行安装命令,把 Codex 装好。你只需在它询问时点同意。

3

告诉你怎么用

装完后告诉你:在终端输入 codex 启动,第一次用可用 OpenAI 账号登录,也可按本节末尾配置国内模型服务商(如 SiliconFlow)绕过海外账号。

想自己动手?(进阶,可跳过)

如果哪天你想自己来,装法和 Claude Code 几乎一样,也是一行命令(同样需要 Node.js 环境):

# 安装 OpenAI Codex 命令行工具(全局)
npm install -g @openai/codex

# 启动
codex

看出来了吗?和上一课的命令长得几乎一模一样,只是把 @anthropic-ai/claude-code 换成了 @openai/codex。这就是「套路通用」的意思。

中国大陆用户,这段要看

老情况还在:Codex 默认连的是 OpenAI 的海外服务,直连登录和使用通常会卡住。但Codex 已开放「自定义模型服务商」——这正是国内用户的突破口:你可以给它配一个国内能用的模型服务商(如硅基流动 SiliconFlow)的 API Key,让它用 Qwen / DeepSeek / Kimi 等国产模型来跑,不用 OpenAI 海外账号也能用

具体的申请 Key、在 Codex 里怎么填、怎么让 WorkBuddy 帮你一键搞定,步骤会随版本变动——我单独放在 Codex 配置说明页 里持续更新,看那一页就够了,不用死记命令。

还是那句:卡住很正常,不丢人。零基础阶段,你能做到「知道有这个工具、会装、知道国内怎么绕」,就已经超过绝大多数人了。

自我检查

学完回忆一下(不用查)

  1. Codex 和 Claude Code 是什么关系?它们背后分别是哪家公司?
  2. 作为零基础,安装 Codex 最省事的办法是什么?和装 Claude Code 比,流程有多大区别?
  3. 在中国大陆用它,最可能卡在哪一步?该怎么办?

装第二个工具,你几乎没花新力气——因为套路是通用的。

你现在手里已经有三把「刀」了:WorkBuddy、Claude Code、Codex。
最后一课,我们认识一个更特别的——会「陪你一起成长」的 Hermes Agent。

高手心法 · 安全模式

审批模式,你说了算

Codex 有三种「放手程度」:Suggest(默认)只读文件、给出改动建议,真要改或跑命令前先问你——最适合新手;Auto Edit 自动改文件,但跑命令前仍会问;Full Auto 全自动,但只在断网的沙箱里动。零基础先老老实实用 Suggest,等熟悉了再放开。

国内平替 · 免翻墙

不用 OpenAI 账号,也能跑 Codex

Codex 支持「自定义模型服务商」:在配置里把 provider 换成 DeepSeek、硅基流动 SiliconFlow、通义千问 等国产接口,设好对应的 base_url 和 API Key 即可,命令完全一样。也就是说,不用海外账号、不翻墙,也能用上 Codex 这套终端工作流——对大陆用户是实打实的利好。

高手心法 · 必验收

改完一定看 git diff + 跑测试,再接受

AI 说「完成」不等于真的完成。每次改动后看它改了哪些文件(git diff),跑一遍 lint / test / build,确认没引入无关重写或破坏,再接受。

高手心法 · 护密钥

别把 API key、密码、客户资料贴给 AI

钥匙、数据库密码、个人隐私都不要直接贴进对话,也别让 AI 任意读敏感文件夹。泄露了第一时间去平台 revoke 旧 Key 换新。

REFERENCES · 参考资料

本课参考资料

  1. OpenAI《Codex CLI 上手指南》(Approval Modes)
  2. OpenAI Codex CLI 官方文档(Custom providers:deepseek / gemini / ollama 等)
  3. frankchiu.io《Claude Code 中文教学》避坑清单 / aicoding.club《Claude Code 新手指南》
  4. frankchiu.io《Claude Code 中文教学》避坑清单(不要把机密贴给 AI)大陆坑:Claude Code 需海外账号与网络;国内可用 Kimi / DeepSeek / 通义等国产模型 + 国产 IDE 插件平替,同样能「让 AI 帮你写代码」。
← 上一课 下一课:会成长的 Agent,Hermes →

推荐资源:OpenAI Codex 官方文档与仓库(github.com/openai/codex)——安装方式、命令用法都在这里。独立的 Codex App 正逐步并入 ChatGPT 桌面端,但 Codex CLI 始终独立维护(当前版本与第三方模型配置见 Codex 配置说明页),可接第三方模型。

国内用户提示:Codex 现已支持自定义模型服务商,可配置 SiliconFlow 等国内平台接入 Qwen / DeepSeek / Kimi,无需 OpenAI 海外账号。

有疑问?装或配置卡在任何一步,把报错原文或截图发给 WorkBuddy,让它替你诊断。