~/教學/DIAGRAM.md

文章 / AI 工具

Archify:一句話讓 Claude Code 把整個專案畫成互動架構圖

Archify 是免費開源的 Claude Code 技能,讀你的程式碼,畫出每個方塊都連到原始碼的架構圖。附安裝、一句話指令、追路徑、改圖和分享。

在 Instagram 看這支 Reels留言關鍵字 #DIAGRAM 就會收到這篇

接手一個新專案,最慢的不是寫程式,是搞懂它:資料從哪裡進來、哪個檔案管什麼、改這裡會影響哪裡。Archify 是一個免費開源(Apache 2.0)的 Claude Code 技能,讓 Claude 讀你的程式碼,畫成一張可以點的架構圖,每個方塊都連到原始碼的第幾行。這篇是 Reels 裡 DIAGRAM 那支影片的完整版:我們拿開源專案 nanoGPT 真的畫了一張、安裝方法、一句話指令、怎麼看原始碼和追路徑、怎麼改圖和分享,以及要注意的地方。

01先看結果:一句話,nanoGPT 整個專案變成一張可以點的架構圖

Reels 畫面:3D 筆電上是 Archify 畫的 nanoGPT 架構圖,訓練那一排被綠框圈起來,旁邊綠色印章寫真的畫好了
真實輸出:Archify 讀了開源專案 nanoGPT,畫出整個專案從資料到產生文字的流程。

照著做完,你會得到這些:

  1. 一個 HTML 檔:你的專案架構圖,元件、流向、資料存在哪裡,一張看完。
  2. 每個方塊都連到原始碼,點下去就看到是哪個檔案的第幾行。
  3. 可以追一條路徑,看資料從哪裡流到哪裡。
  4. 要改不用拖拉,跟 Claude 說一句就好;做好的檔案傳給同事,打開就能點。
Archify 畫的 nanoGPT 架構圖:資料、prepare.py、train.bin、train.py、ckpt.pt 一排,下面是 meta.pkl、GPT-2 權重、model.py、sample.py
我們在 2026 年 11 月 3 日用 Archify 3.2.0 畫的 nanoGPT(karpathy/nanoGPT,commit 3adf61e),四道檢查全部通過。

02第 1 步:安裝 Archify

Reels 畫面:GitHub 上 tt-a1i/archify 的頁面,Star 92.9k 被圈起來,旁邊紙條寫 Apache 2.0・免費
GitHub 上的 Archify:Apache 2.0 授權,2026 年 11 月 3 日約 9.3 萬顆星。

Archify 是 tt-a1i 做的開源「技能」(skill),Claude Code、Codex、Cursor、OpenCode 都能用,電腦要先有 Node.js 18 以上。最簡單的裝法是直接叫 Claude Code 幫你裝,把這句貼進去:

在 Claude Code 貼上(官方安裝句)
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt

Claude 會先告訴你要跑哪些指令,問你要裝在全部專案還是只裝在這個專案,你確認後才會裝。想自己在終端機裝,用官方這一行(裝給 Claude Code、全部專案都能用):

自己裝(終端機)
npx -y skills@latest add https://archify.si --skill archify --agent claude-code --global --copy --yes

03第 2 步:一句話叫 Claude 畫

Reels 畫面:README 的 Start from a description,Analyze this repository 那段指令被圈起來,下方黑色卡片寫 > 用 Archify 畫出這個專案
README 給的指令,和我們用的中文版。

在你的專案資料夾開 Claude Code,直接說:

畫整個專案(換成你想看的部分)
用 Archify 分析這個專案,畫出[整個專案/登入流程/付款流程]的架構圖,每個元件都連到原始碼。

想要更精準,可以用 README 裡的這段(英文直接貼也可以):

README 的版本
Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.

Archify 會先檢查圖的格式、版面和連線,全部通過才輸出 HTML 檔,有錯會自己修再重跑。除了架構圖,它還有流程圖、時序圖、資料流、狀態圖、資料表關係圖等十種,你說要哪一種就好。

04第 3 步:點方塊看原始碼,追一條路徑

Archify 的 HTML:點了 train.py 之後左邊跳出卡片,寫已驗證來源 karpathy/nanoGPT @ 3adf61e,get_batch L116–131、評估、反向傳播、更新 L255–314
點 train.py:卡片列出這個方塊對應的檔案和行數,對到某一個版本(commit)。

用瀏覽器打開 HTML 檔,點任何一個方塊,旁邊就會列出它的原始碼位置,再點一下就跳到 GitHub 上那幾行。

Reels 畫面:筆電上是 GitHub 的 nanoGPT train.py,第 116 到 131 行 get_batch 被綠框圈起來,下方紙條寫 train.py L116–131
點下去:直接打開 train.py 的第 116 到 131 行。

幾個好用的按鍵:

  1. /:找任何一個方塊。
  2. R(或右下角的「路徑」):選起點和終點,追一條路徑。
  3. M:打開整張圖的小地圖。
  4. F:簡報模式,整張圖占滿畫面。
  5. S / T / E:換風格、換深淺色、匯出圖片。
Archify 的 HTML:路徑 Tiny Shakespeare 到 ckpt.pt,5 個節點 4 步,prepare.py、train.bin / val.bin、train.py 這一排發亮
追一條路徑:資料從 Tiny Shakespeare 一路流到 ckpt.pt,只亮這一條。

05第 4 步:要改就用說的,做好傳給同事

Reels 畫面:README 的 3. Refine in chat 被圈起來,旁邊紙條寫拖拉編輯?叉叉,綠色印章寫用說的改
Archify 不是拖拉式的畫圖軟體,要改就繼續跟 Claude 說。

圖畫好之後,繼續在同一個對話裡說你要改什麼:

改圖(換成你要的)
把[sample.py]那條路徑標出來,[資料庫]移到右邊,再加上[快取]。
Reels 畫面:Claw'd 站在桌上,綠色的 HTML 檔滑到旁邊寫著同事的電腦的小筆電,螢幕亮起來顯示架構圖
一個 HTML 檔,傳給同事,對方不用裝 Archify,打開就能點。

輸出的是一個獨立的 HTML 檔,傳給別人,互動功能也跟著過去。右上角「匯出」還能存成 PNG、JPEG、WebP、SVG 或 6 秒的 WebM 動畫,貼到簡報或文件裡。

06要注意

  1. HTML 檔要用瀏覽器打開才會動;放在 GitHub 上點開,只會看到一大堆原始碼。
  2. 原始碼連結只在「讀程式碼畫的圖」才有,而且對到畫圖當下的版本(commit);程式改了,重新叫它畫一次。
  3. 它不是拖拉式的畫圖軟體,沒有滑鼠編輯;要改就用說的,Claude 會改圖的資料再重畫。
  4. 圖、驗證都在你的電腦上跑。它會偶爾連網查有沒有新版本(只提醒,不會自動更新);不想要就設環境變數 ARCHIFY_UPDATE_CHECK_DISABLED=1。
  5. 官方只有 github.com/tt-a1i/archify 和 archify.si。GitHub 上有別人 fork 的同名專案,README 裡的贊助商(像是 API 轉售服務)是第三方,和 Archify 無關。
  6. 這篇是在主頁連結輸入關鍵字 DIAGRAM 找到的,不會私訊。

資料來源

延伸閱讀