爆肝兩週,我把 Codex 最全實戰指南開源了
整理版優先睇
作者蒼何開源《Codex 實戰指南》,從註冊到實戰一站式避坑,助你快速上手 Codex
呢篇文章係蒼何嘅原創,佢分享咗自己由零開始用 Codex 嘅經歷。因為官方文檔對新手唔友好,佢自己踩咗好多坑,最終決定由註冊到實戰,親自踩完再鋪平路,開源咗呢份《Codex 實戰指南》。佢發現 Codex 最難嘅位唔係用,而係「用上」,好多人卡在賬號、環境、網絡呢啲問題上,直接勸退。
成個指南按「認識入口、跑通任務、建立方法、團隊沉澱」四層組織,覆蓋桌面端 CLI、桌面 App、IDE 同埋手機端(即係 ChatGPT App 入面嘅 Codex 入口)。桌面 App 嘅工程化能力最強,特別係 computer use 同瀏覽器能力;手機端就唔係獨立 App,而係連接已經授權嘅環境,方便你離開電腦時繼續控制任務。指南仲有詳細嘅 Plus 訂閲教程,自己充值比代充更穩定。
實戰案例方面,目前收集咗 13 個典型 case,例如 Codex × Draw.io MCP 自動繪製架構圖、Codex × GitHub Actions 修復 CI 失敗、Codex × Obsidian 搭建 AI 知識庫等。蒼何話佢呢兩週日日同 Codex 對線,踩嘅坑比寫嘅 code 仲多,希望呢份指南可以令你少走彎路。佢強調完成比完美重要,歡迎社區共建。
- Codex 入門最大障礙係賬號同環境配置,唔係工具本身;官方文檔對新手唔友好,需要一份由零開始嘅實戰指南。
- 指南按「認識入口、跑通任務、建立方法、團隊沉澱」四層組織,可以從 CLI、桌面 App、ChatGPT 或雲端任務揀一個切入。
- 桌面端 APP 嘅工程化能力最強,特別係 computer use 同瀏覽器能力;手機端係遠程連接已授權環境,唔係獨立 App。
- 實戰案例(如 Codex × Draw.io MCP、Codex × GitHub Actions、Codex × Obsidian)可以顯著提升開發效率,有手就行。
- 建議自己訂閲 Plus 帳號,跟住指南嘅充值教程,比代充更穩定;然後逐步實戰,將 Codex 融入日常工作流程。
開源項目誕生:由踩坑到鋪路
蒼何係一位原創作者,佢喺 5 月 1 號開始搞呢個項目,因為佢自己連 Codex 嘅登錄同充值都搞唔掂,問 AI 同翻教程都係廢話,最後靠瞎試先摸出一條路。佢發現好多人唔係唔想用,而係卡喺賬號、環境、網絡呢啲問題,直接畀勸退咗。
靠自己瞎試,先摸出一條路
難嘅唔係用,而係「用上」
所以佢決定親自踩一次坑,由註冊到實戰完整鋪平路,再開源畀大家。佢話呢兩週日日同 Codex 對線,踩嘅坑比寫嘅 code 仲多,與其爛喺聊天記錄,不如沉澱落嚟。
踩嘅坑比寫嘅 code 仲多
與其爛喺聊天記錄,不如沉澱落嚟
四層組織與多端入口指南
指南按「認識入口、跑通任務、建立方法、團隊沉澱」四層組織,你可以由 CLI 入手,都可以由桌面端、ChatGPT 或雲端任務開始,關鍵係先理解每個入口適合承載嘅任務節奏。
認識入口、跑通任務、建立方法、團隊沉澱
光係訂閲 Plus 嘅教程,已經可以幫你慳返唔少代充嘅錢;自己充值更加穩定,因為係屬於你自己嘅號。手機端 Codex 準確啲講係 ChatGPT 手機 App 入面嘅 Codex 入口,唔係獨立 App,係用嚟連接桌面 App 或遠程開發機,方便你離開電腦時繼續查看、回覆、審批同調整任務。
自己充值更加穩定
手機端 Codex 係遠程連接已授權環境
蒼何而家幾乎除咗瞓覺,都會用手機隨處 vibe coding,指揮 mac mini 上嘅 Codex 工作。
用手機隨處可以 vibe coding
實戰案例:從自動繪圖到 CI 修復
蒼何仲加咗一個「實戰案例」專欄,目前收集咗 13 個典型 case,主打有手就行,輕鬆復刻。以下係幾個重點案例:
- 1 Codex × Draw.io MCP:令 AI 自動繪製架構圖,非常有用嘅 case。
- 2 Codex × GitHub Actions:CI 失敗自動修復,對於開發場景好推薦。
- 3 Codex × Obsidian:用 LLM Wiki 喺 Obsidian 入面搭建 AI 知識庫,適合知識管理愛好者。
有手就行,輕鬆復刻
CI 失敗自動修復
搭建 AI 知識庫
如果你對配置感到痛苦,指南入面都有答案;仲有資源入口連到官方資料,而且蒼何會定時檢查確保同步。
Codex 更新速度非常快
更多實用案例會之後不斷完善蒐集
大家好,我係蒼何。
今日,我哋正式推出 CodexGuide。
呢份係《Codex 實戰指南》,而且已經喺 GitHub 上開源咗。

佢係完全免費、開源嘅。

為咗更好嘅閲讀,我仲整咗個在線網站:

今日,正式宣發喇:

我相信好多人同之前嘅我一樣,對 Codex APP、Codex Cli 同 Codex 插件會有啲懵。
一時話用 Claude Code,一時話用 Codex,搞到人頭都暈。
所以,由學習路線開始,CodexGuide 按「認識入口、跑通任務、建立方法、團隊沉澱」四層組織。你可以由 CLI 入門,都可以由桌面端、ChatGPT 或者雲端任務開始;關鍵在於先理解每個入口適合承載嘅任務節奏。

現階段大家用得最多嘅係 Codex 嘅桌面端 APP,佢嘅工程化能力非常好,特別係 computer use 同瀏覽器能力。
由 Codex 桌面 App 下載安裝到訂閲 Plus,CodexGuide 都做好仔細嘅教程。

淨係訂閲 Plus 呢個教程,講真,已經可以幫你慳返唔少揾人代充嘅錢,哈哈。

自己個號充值會更加穩定啲,畢竟係屬於你自己嘅號:

同埋點樣用手機端 Codex 嚟遠程執行任務,我都根據親身經驗放咗教程。
呢度講嘅「手機端 Codex」,準確啲講,係 ChatGPT 手機 App 裏面嘅 Codex 入口。佢唔係獨立嘅手機 Codex App,亦唔係將手機變成遠端桌面滑鼠鍵盤。你可以咁理解:桌面 App、遠端開發機或者其他已授權環境入面嘅 Codex 正在運行,手機端負責連接呢啲環境,令你離開電腦嗰陣都可以繼續睇、回覆、審批同調整任務。

我而家差唔多除咗瞓覺,隨時都可以 vibe coding,用手機喺邊度都好方便指揮我部 mac mini 上面嘅 Codex 做嘢。

遲啲,我都會將我更多嘅 Codex 實踐放上嚟。
喺入口地圖入面會介紹唔同端側嘅入口,由 cli 到桌面 APP,再到 IDE,帶你一次過瞭解 Codex。

如果你對 Codex 嘅配置覺得好頭痛,都冇問題,你點都會揾到答案。

我仲特別加咗資源入口,方便大家第一時間揾到官方嘅資料做索引,不過我會叫 Codex 定時檢查,確保文檔更新同官方同步,至少唔會落後太多。
畢竟而家 Codex 嘅更新速度,非常非常快。

齋教程只能夠簡單入門,我仲提議加咗一個專欄,就係「實戰案例」

會收集比較多 Codex 有趣嘅案例,主打一個有手就得,輕鬆復刻。
例如用 Codex × Draw.io MCP 令 AI 自動畫架構圖。

咁有用嘅 case,冇寶子會拒絕掛。

不過,我哋而家淨係收集咗 13 個典型嘅案例,更多實用案例,之後會繼續完善收集。
好似 Codex × GitHub Actions:CI 失敗自動修復實測,呢啲開發場景嘅 case 好推薦大家試下。等自己嘅 Codex 起飛嘅一部分。

如果你比較鍾意知識管理,咁你一定唔可以錯過 Codex+Obsidian 呢個案例,佢教你用 Codex × LLM Wiki,喺 Obsidian 入面建立 AI 知識庫。

講真,呢個項目 5 月 1 號就開始搞,斷斷續續喺度完善。
原因好簡單,我當時連 Codex 嘅登入同充值都搞唔掂,問曬一圈 AI,睇曬一圈教程,全部係廢話。
最後靠自己亂試,先摸到一條路。
嗰一刻我就明咗:Codex 呢樣嘢,難嘅唔係用,係「用上」。
好多人唔係唔想用,係卡喺賬號、環境、網絡呢啲麻煩嘢,直接嚇走咗。
官方文檔係有,但你懂的,嗰啲係寫俾已經識用嘅人睇嘅。
所以我就諗,不如自己整一份,由註冊到實戰,將啲坑全部踩一次,再鋪平俾後面嘅人行。
仲有個私心,我最近用 Codex 用到上癮,日日同佢對線,踩嘅坑仲多過寫嘅 code。
與其俾呢啲經驗爛喺聊天記錄度,不如沉澱落嚟,當係俾自己一個交代。
如果呢份教程可以令你少行一個彎路,咁我呢兩個禮拜嘅黑眼圈就冇白捱。
最後多謝一齊參與呢個開源教程共建嘅各位小夥伴,亦歡迎社區一齊共建,一齊打磨。
雖然佢仲未完美,但完成比完美重要。
多謝你鍾意我嘅文章,我哋下一期再見啦。
大家好,我是蒼何。
今天,我們正式推出 CodexGuide。
這是一份《Codex 實戰指南》,並已經在 GitHub 上開源。

它是完全免費的、開源的。

為了更好的閲讀,我還搭了個在線網站:

今天,正式宣發了:

我相信很多人和之前的我一樣,對 Codex APP、Codex Cli 以及 Codex 插件會有點懵。
一會兒說用 Claude Code,一會兒說用 Codex,人會變得暈頭轉向。
所以,從學習路線開始,CodexGuide 按“認識入口、跑通任務、建立方法、團隊沉澱”四層組織。你可以從 CLI 入門,也可以從桌面端、ChatGPT 或雲端任務開始;關鍵在於先理解每個入口適合承載的任務節奏。

現階段大家用的最多的是 Codex 的桌面端 APP,他的工程化能力非常好,特別是 computer use 和瀏覽器能力。
從 Codex 桌面 App 下載與安裝到訂閲 Plus,CodexGuide 都非常細緻的做了教程。

光訂閲 Plus 這個教程,說實話,就能幫你省不少找人代充的錢,哈哈。

自己的號充值會更加穩定些,畢竟那是屬於你自己的號:

以及如何用手機端 Codex 來遠程執行任務,我也基於親身實踐放了教程。
這裏說的“手機端 Codex”,更準確地說,是 ChatGPT 手機 App 裏的 Codex 入口。它不是單獨的手機 Codex App,也不是把手機變成遠程桌面鼠標鍵盤。你可以把它理解成:桌面 App、遠程開發機或其他已授權環境里正在運行 Codex,手機端負責連接這些環境,讓你在離開電腦時繼續查看、回覆、審批和調整任務。

我現在幾乎除了睡覺,都能隨時 vibe coding 了,用手機在哪裏都很方便指揮我的 mac mini 上的 Codex 來工作。

後面,我也會把我的更多 Codex 實踐放上來。
在入口地圖中會介紹不同端側的入口,從 cli 到桌面 APP,再到 IDE,帶你一次性瞭解 Codex。

如果你對 Codex 的配置感到痛苦,也沒關係,你都能找到答案。

我還特意加了資源入口,方便大家第一時間找到官方的資料做索引,不過我會讓 Codex 定時的檢查,保證文檔的更新和官方是同步的,至少不會延遲太多。
畢竟現在 Codex 的更新速度,非常非常快。

單純的教程只能是簡單的入門,我還提議加了一個專欄,就是「實戰案例」

會蒐集比較多的 Codex 有意思的案例,主打一個有手就行,輕鬆復刻。
就比如用 Codex × Draw. io MCP 讓AI 自動繪製架構圖。

這樣有用的 case,沒有寶子會拒絕吧。

不過,我們現在僅僅蒐集了 13 個典型的案例,更多的實用案例,也會在之後不斷完善蒐集。
像 Codex × GitHub Actions:CI 失敗自動修復實測,這樣對於開發場景類的還是非常推薦大家上手試一試的。讓自己的 Codex 起飛的一 part。

如果你比較喜歡知識管理,那你一定不要錯過 Codex+ Obsidian 這個案例,他教你用 Codex × LLM Wiki,在 Obsidian 中搭建 AI 知識庫。

說實話,這個項目 5 月 1 號就開始搞了,斷斷續續在完善。
起因很簡單,我當時連 Codex 的登錄和充值都搞不定,問了一圈 AI,翻了一圈教程,全是廢話。
最後靠自己瞎試,才摸出來一條路。
那一刻我就悟了:Codex 這東西,難的不是用,是「用上」。
很多人不是不想用,是卡在賬號、環境、網絡這些破事上,直接勸退了。
官方文檔倒是有,但你懂的,那玩意兒是寫給已經會的人看的。
所以我就想,乾脆自己整一份,從註冊到實戰,把坑全踩一遍,再鋪平了給後面的人走。
還有個私心,我最近用 Codex 屬於上癮狀態,天天跟它對線,踩的坑比寫的代碼還多。
與其讓這些經驗爛在聊天記錄裏,不如沉澱下來,也算給自己一個交代。
如果這份教程能讓你少走哪怕一個彎路,那我這兩週的黑眼圈就沒白長。
最後感謝參與本開源教程共建的各位小夥伴,也歡迎社區共建,一起打磨。
雖然他還是不完美的,但完成比完美重要。
感謝你喜歡我的文章,我們下一期見啦。