很多人对 Codex 的第一印象是「懵」:Codex APP、Codex CLI、Codex 插件到底是什么关系,一会儿听人说用 Claude Code,一会儿又说用 Codex,越看越晕。这恰恰是这份指南想解决的问题——它要回答的不是「Codex 怎么用」,而是更前置的那个问题:怎么「用上」。
难的不是用,是「用上」
这个项目从 5 月 1 号就开始断断续续做了,起因很朴素:当时连 Codex 的登录和充值都搞不定,问了一圈 AI、翻了一圈教程,全是废话;官方文档倒是有,但那是写给已经会的人看的。最后靠自己瞎试才摸出一条路。
那一刻的感受很真实——Codex 这东西,难点根本不在功能本身,而在账号、环境、网络这些破事上,绝大多数人是被这些门槛直接劝退的。把这些经验沉淀成一份从注册到实战的指南,本质上是在降低别人「用上」的成本。这是一个被严重低估、但真实存在的需求缺口。
按学习路线分层,而不是堆功能
CodexGuide 没有按工具罗列,而是按「认识入口 → 跑通任务 → 建立方法 → 团队沉淀」四层来组织。你可以从 CLI 入门,也可以从桌面端、ChatGPT 或云端任务切入,关键是先理解每个入口适合承载什么样的任务节奏。
入口地图会把不同端侧讲清楚:从 CLI 到桌面 APP,再到 IDE,一次性建立全貌认知。现阶段用得最多的是桌面端 APP,它的工程化能力很强,尤其是 computer use 和浏览器能力。从下载安装到订阅 Plus,指南都做了很细的教程——光是订阅 Plus 这一节,就能帮你省下找人代充的钱,而且用自己的号充值更稳定,毕竟那是属于你自己的账号。
手机端 Codex:离开电脑也能继续指挥
指南里基于亲身实践放了「手机端 Codex」远程执行任务的教程。这里要澄清一个常见误解:所谓「手机端 Codex」,准确说是 ChatGPT 手机 App 里的 Codex 入口,它既不是独立的手机 Codex App,也不是把手机变成远程桌面的鼠标键盘。
正确的理解是:桌面 App、远程开发机或其他已授权环境里正在运行 Codex,手机端负责连接这些环境,让你在离开电脑时继续查看、回复、审批、调整任务。换句话说,除了睡觉,你几乎随时都能 vibe coding——在任何地方用手机指挥跑在 mac mini 上的 Codex 干活。这种「人离开、任务不停」的模式,才是 Codex 工作流真正改变效率的地方。
实战案例:有手就行,轻松复刻
单纯的教程只能算入门,所以专门加了「实战案例」专栏,主打可复刻。目前已收集 13 个典型案例,后续会持续补充。几个值得上手的方向:
- Codex × Draw.io MCP:让 AI 自动绘制架构图
- Codex × GitHub Actions:CI 失败自动修复实测,开发场景强烈推荐试一试
- Codex × Obsidian:用 Codex × LLM Wiki,在 Obsidian 中搭建 AI 知识库,适合做知识管理的人
此外还专门加了资源入口,方便第一时间索引到官方资料,并让 Codex 定时检查,保证文档与官方同步、不至于延迟太多——毕竟 Codex 现在的更新速度非常快,文档的「保鲜」本身就是一种工程。
一点判断
把踩坑经验沉淀成结构化的指南,本质上是在做一件被低估的事:工具迭代越快,「入门成本」就越是被反复重置,而能把入门门槛一次性铺平的内容,价值反而在变高。这条路上目前还没看到真正的壁垒,靠的是持续更新和社区共建——所以与其等一份完美的教程,不如先用起来:挑一个最贴近你日常的案例(CI 自动修复或 Obsidian 知识库都行),照着跑通一次,比读十篇介绍都管用。完成比完美重要。