Day25:如何用 Codex/Claude Code 發文:把開發對話變成一篇 MakeClass 文章
延續「創作者的門檻在問不在寫」,這篇給你真正能跑的步驟
前幾篇講的是觀念——創作者的門檻不在寫,在問。這篇給你真正能跑的步驟:怎麼讓 Codex 或 Claude Code 幫你把日常的開發對話,直接變成一篇 MakeClass 文章,或做成一份可以上台播的簡報。 📢 最新更新:2026/09/27(mcpost 1.5.3) 看過的文章,加上你的想法就能變成一篇 Post:在站上看到一篇有感覺的,把網址和你的想法交給 mcpost,站上的 AI 會以你的想法為主軸、把那篇當引用,寫成一篇 Post 草稿。每次 3 點,失敗自動退點(下面 Step 4)。網頁上文章封面上方的「發成 Post」按鈕也是同一個功能 AI 寫的文章會自動排得比較好讀:幾個並列重點會變成小卡片、「以前 vs 現在」會變成左右對照、步驟會變成編號卡。你不用學任何寫法,跟平常一樣說「存進 MakeClass」就好 已經裝過的人請升級:在終端機(任何資料夾都可以)打 npm install -g mcpost,再打 mcpost doctor,看到 1.5.3 就完成了 (更早的更新,2026-09-26:電腦裡的圖片會自動放上去了——用 mcpost 整理文章、用 mcslide 做簡報時,放在電腦裡的圖片會自動上傳;圖片下方的說明文字也修好了;mcslide 也會提醒有新版。需要 1.5.1 以上。) (更早的更新,2026-09-24:文章可以帶圖了。正文裡直接寫 ,mcpost 會自動把本地圖片上傳再換成網址,不必自己先把圖搬到別的地方(下面 Step 5)。同時加了 mcpost --version,而且任何指令跑完都會提醒你版本有沒有落後。需要 1.4.2 以上。) (更早的更新:Codex 現在也是裝一次、全域生效,不必再每個專案貼一次 AGENTS.md;同一個套件還有 mcslide 可以把內容做成站上可播的簡報。完整說明書在 makeclass.me/cli。) (更早的一次更新:這篇原本要求先 clone MakeClass 的私有主程式才能用——後來拆成獨立公開的 npm 套件,任何人都能裝,不需要任何 repo 權限。) Step 1|建一支 Token
到 makeclass.me 註冊好帳號,再到 makeclass.me/settings/tokens(這頁選單找不到,記網址或存書籤),建立一支 Personal Access Token。
勾選範圍照用途來,漏勾的話會等到最後送出那一刻才報錯:
你要做什麼 勾哪個 :--- :--- 發一般文章 發表內容 發到 Vibe Coding 專區(devlog) 送開發日誌(文章有圖的話,再加勾「發表內容」) 做簡報(mcslide) 發表內容 讓 AI 讀你自己的內容 讀取內容
Token 只會顯示一次(mck 開頭),先複製存好。 只勾「讀取內容」的那種,就算外洩也灌不了東西。建議照用途分開建,不要一支全開。 Step 2|安裝
已經裝過的人,同一行 npm install -g mcpost 就是升級。
跑 mcpost token 會直接問你要不要貼上剛才拿到的 token,貼了就自動存檔。不需要 git clone 任何東西。
一次安裝會拿到兩個指令:
指令 做什麼 :--- :--- mcpost 把開發對話存成 DevLog、發一篇文章 mcslide 把一篇內容做成站上可播的簡報,含講者備註
兩個共用同一支 token,設定一次就好。 Step 3|讓你的 AI 認得這些指令
這一行 Claude Code 與 Codex 一起裝好,兩邊都會出現 /mcpost 與 /mcslide,而且是全域生效——任何專案都能用,不必每個專案各弄一次。 ⚠️ 這裡跟這篇文章的舊版本不一樣。以前 Codex 沒有全域機制,得把提示貼進每個專案的 AGENTS.md。現在 Codex 支援 /.codex/skills/,install-skill 會自動偵測並裝進去。如果你照舊版做過,那些專案裡的 AGENTS.md 可以留著,不影響。
Cursor 或其他平台還是走貼提示那條:把套件裡的 AGENTS.md 內容貼進專案根目錄的 AGENTS.md,或 .cursor/rules/。格式與產出完全相同,差別只在各家怎麼載入提示。
裝完之後想確認環境對不對:
它會印出你裝的版本、registry 上最新是哪一版、token 有沒有設、四個 skill 各指到哪裡。只想知道版本的話:
⚠️ 這裡更正這篇文章先前的說法。 舊版本寫「升級套件之後一定要重跑 install-skill」,講得太絕對了。skill 的捷徑指向的是安裝目錄本身,而 npm install -g 是就地更新那個目錄,路徑不變——所以一般升級之後捷徑仍然有效。 真的會失效的是另外兩種:用 npx 跑(根本沒有全域安裝目錄)、或換了 Node 版本(捷徑路徑裡含版本號)。doctor 會把這兩種抓出來,所以升級後跑一次 doctor 確認就夠了。 Step 4|平常開發到一半,隨口說一句就好
不用特別空出時間寫文章。卡關解決了、想留下來,直接跟你的 AI 說: 「這段記下來」/「存進 MakeClass」/打 /mcpost
它會自動把「你問了什麼、AI 怎麼答、最後怎麼決定」整理成一篇文章,先跑一次預覽給你看——機密掃描會硬擋 API key、私鑰、連線字串,沒有繞過的選項,你確認沒問題才正式送出。
也可以自己在終端機直接跑,不透過 AI:
送出後是草稿+連結限定,進「Vibe Coding 專區」。要不要公開,自己上網頁按發布,AI 不會替你決定。
一般觀點文(不進 Vibe Coding 專區)則用:
在站上看到一篇有感覺的、想寫自己的觀點?不用自己寫正文,把網址和你的想法交出去就好:
站上的 AI 會以你的觀點為主軸、那篇當引用素材,寫成一篇 Post 草稿,回給你一個審閱網址(每次 3 點,失敗自動退點;需要 1.5.3 以上)。你沒寫過的經歷它不會替你編,一樣是草稿,看過、改過才發布。也可以直接跟 AI 說「拿這篇寫成我的 Post」。 Step 5|讓文章帶圖
寫技術文章最麻煩的一步通常不是寫,是圖:截圖存在本機,可是文章要放的是網址,於是得先把圖傳到某個地方、複製網址、再貼回文章。
現在不用了。正文裡直接寫相對路徑就好:
送出時 mcpost 會自己把這些圖傳上去、換成網址:
路徑是相對於正文那個檔案,不是相對於你現在站在哪個目錄。不想自動上傳就加 --no-images。
mcpost post、mcpost devlog、mcslide 三個指令都一樣(devlog 與 mcslide 需要 1.5.0 以上)。送出前加 --dry-run,預覽會告訴你抓到幾張圖。 ⚠️ 站上正文只顯示 https 的圖片——http 與 data: 一律不渲染。那是刻意的:前者會讓整頁變成混合內容,後者可以夾帶 HTML。所以不先上傳的話,圖一張都不會出現。 SVG 也不收(它可以夾帶 script),請先轉成 PNG。單張上限 9 MB。 Step 6|把一篇內容做成簡報
這是新的。同一支 token、同一個套件,mcslide 把內容變成一份站上可播的簡報——有翻頁、有縮圖列、有講者備註,可以直接投影,也可以列印成 PDF。
兩條路,看你手上有什麼:
讓站上的 AI 讀一篇來做
pushId 就是 makeclass.me/learn/ 後面那一段。它會讀那篇的逐字稿來寫,所以數字附得出時間碼。約一分鐘,會扣點,失敗自動退。
自己寫好再送上去
教材裡的本機圖片一樣直接寫 ,送出時會自動上傳(1.5.0 以上)。
或者根本不用記指令,在 Claude Code 或 Codex 裡直接說「/mcslide 把剛剛這段整理成 15 頁的簡報」就行。
送出後一律是草稿、不公開,回傳可播的網址。 有一件事是一般簡報工具沒有的:講者備註只有作者與訂閱者看得到。同一份簡報,讀者看到內容,訂閱者看到你怎麼講。
寫法約定(一個 ## 一頁、# 是章名頁、> 意思是: 是提煉框之類)在 makeclass.me/cli 有完整一份,連常見錯誤對照表都在。 這篇文章本身,也是這樣寫出來的。你在讀的這句話,三分鐘前還是我跟 Claude Code 之間的一段對話。