改程式前先問「會動到誰」｜Graphify 讓 Claude 讀完專案畫出知識圖實測

⏱️ 一分鐘教你一個 AI 工具技巧｜第 16 集 · 看全系列 ›

更新時間：2026.10.24（Windows 實測）

Graphify 是給 Claude Code 用的開源 Skill，裝好之後在專案裡打一個指令 /graphify .，它會把整個專案的程式碼和文件掃過一遍，畫成一張可以點、可以篩選的知識圖。之後要改東西之前，先請 Claude 查這張圖回答「改這個會動到誰」。

以下是我 2026.10.24 在 Windows 上的實際安裝與操作，包含安裝程式被 Windows 擋下來時我怎麼繞過去，你可以用同樣的指令拿自己的專案試試。

📱 這系列的 Reel 都在 IG｜@pinkjhs.life，下一集不漏接 立即追蹤 IG ›

📑 快速導覽目錄

• 🧩 ① 怎麼安裝：4 行指令，被擋了就換 2 行
• 📋 ② 指令懶人包：5 段直接複製
• ✨ ③ 效果展示：旅遊規劃網頁，168 個檔案變一張圖
• ❓ 常見問題 FAQ
• ⏱️ 一分鐘版
• 💡 結語：先畫一張圖，之後都先查圖再動手

---

🧩 ① 怎麼安裝：4 行指令，被擋了就換 2 行

Graphify 是 Skill，要在 Claude Code 裡用，所以電腦要有 Claude Code。它本體是 Python 套件，GitHub 說明頁要求 Python 3.10 以上，建議用 uv 來裝。我的電腦是 Python 3.11.9、uv 0.12.17，Claude Code 本來就有，這次沒有從零重裝。

整段安裝先看這 4 行，在終端機（我用 Windows PowerShell）一行一行貼：

python --version
uv --version
uv tool install graphifyy
graphify install

前兩行是確認環境，第三行裝本體，第四行把 Skill 登記進 Claude Code。我在第四行被 Windows 擋下來了（應用程式控管政策不讓 graphify.exe 執行），改貼這 2 行就過了：

python -m pip install --user graphifyy
python -m graphify install

下面是每一步我看到的畫面。

第 1 步：確認 Python 和 uv

貼 python --version 和 uv --version，Python 要 3.10 以上，uv 有版本號就好。我的是 Python 3.11.9、uv 0.12.17。沒有 uv 的話，GitHub 說明頁的 Windows 裝法是 winget install astral-sh.uv，裝完把終端機關掉重開（這行我沒有實測，我的 uv 本來就有）。

第 2 步：裝 Graphify 本體

uv tool install graphifyy

注意套件名是 graphifyy，最後兩個 y；GitHub 說明頁特別寫了，PyPI 上其他 graphify 開頭的套件都不是它們的。裝好之後下的指令仍然是 graphify（一個 y）。成功的話最後會出現 Installed 2 executables: graphify, graphify-mcp。

圖說：執行 uv tool install graphifyy 之後的輸出，最後一行是 Installed 2 executables。資料夾路徑已遮。

第 3 步：把 Skill 登記進 Claude Code

graphify install

這一行會偵測你用的是 Claude Code，把 /graphify 這個 Skill 登記進去。我在這一步被擋了：PowerShell 顯示 graphify.exe 無法執行（錯誤裡有 ApplicationFailedException 字樣），是 Windows 的應用程式控管政策不讓 uv 產生的那個 graphify.exe 跑。你的電腦如果沒被擋，這一行就會直接成功，可以跳到第 5 步。

圖說：graphify install 被擋的畫面。路徑已遮。

第 4 步（被擋才需要）：改走 python -m

被擋的只是那個 .exe，Python 本身沒被擋，所以改請 Python 直接執行 Graphify 的模組。但 uv 是把套件裝在自己的隔離環境，系統的 python 看不到，所以要先用 pip 再裝一份到系統的 Python 裡：

python -m pip install --user graphifyy

--user 是裝在你個人帳號的資料夾裡。畫面會跑一長串 Collecting、Downloading（它要下載很多種程式語言的解析套件），等它跑完回到提示字元。接著登記 Skill：

python -m graphify install

成功的畫面會出現這幾行：skill installed 後面接 .claude 資料夾裡的 graphify\SKILL.md、skill registered in 後面接 .claude 資料夾裡的 CLAUDE.md，最後一行是 Done。想先確認 python -m graphify 能跑，可以貼 python -m graphify --help，會印出一長串指令清單。之後終端機裡所有 graphify 指令，都改成 python -m graphify 開頭；在 Claude Code 裡打的 /graphify . 不受影響。

圖說：改用 python -m 之後的成功畫面：skill installed、skill registered、Done。路徑已遮。

第 5 步：在哪裡用、怎麼確認裝好

在哪裡用：我只試過 Windows 上的 Claude Code。Mac、Claude 桌面版、Claude 網頁版我沒試過，所以不寫步驟（見 FAQ 第 2 題）。

怎麼確認裝好：安裝成功的輸出本身就是證明（skill installed、Done）。再保險一點：在終端機 cd 進你的專案資料夾，輸入 claude 啟動 Claude Code，打 /graphify，斜線指令清單出現它就是登記好了（這個畫面我沒有另外截圖，安裝成功的畫面見上面第 4 步）。最後一關是照下一章的指令跑一次 /graphify .，專案裡多出 graphify-out 資料夾、裡面有三個檔案，整條路就通了。

另外有一件事要知道：這個安裝步驟會在你家目錄的 .claude\CLAUDE.md 登記 graphify（上面第 4 步輸出的 skill registered 那一行），影響到每個專案，細節見 FAQ 第 7 題。

圖說：在 Claude Code 打 /graphify 之後的掃描畫面。畫面上的點數與線數是掃描中途的數字，最終結果見下一章。輸出路徑已遮。

---

📋 ② 指令懶人包：5 段直接複製

把「你的……」換成自己的東西。前三段是在終端機貼，後兩段是在 Claude Code 的對話框貼。

① 確認環境（終端機）

python --version
uv --version

Python 要 3.10 以上。沒有 uv 的 Windows 先跑 winget install astral-sh.uv，裝完把終端機關掉重開。

② 安裝（終端機，只做一次）

uv tool install graphifyy
graphify install

套件名是兩個 y。第二行如果成功，就直接跳到第 ④ 段。

③ 被 Windows 擋住時的替代做法（終端機）

python -m pip install --user graphifyy
python -m graphify install

第二行的輸出出現 Done 就裝好了。之後終端機裡的 graphify 指令都用 python -m graphify 開頭。

④ 畫圖（在專案資料夾啟動 Claude Code 後，貼進對話框）

/graphify .

句尾的 . 代表「目前這個資料夾」。（我自己實際打的是 /graphify，GitHub 說明頁的範例寫的是 /graphify .，建議照說明頁的寫法。）它會掃完專案，在專案根目錄產出 graphify-out 資料夾，裡面有 graph.html（圖）、GRAPH_REPORT.md（報告）、graph.json（資料）。我的專案是 168 個檔案；專案越大，掃的時間越久。我沒有精準計時，所以不寫幾分鐘。

⑤ 改程式之前，先問它會動到誰（貼進 Claude Code）

這是我實際貼的那一句，原文照放：

我想改 useTrip()。請用 graphify 的圖告訴我，改了會動到哪些功能？用繁體中文、簡短回答，不要修改任何檔案。

換成你自己的專案，把 useTrip() 換成你要改的函式或檔案名稱就好：

我想改 你的函式或檔案名稱。請用 graphify 的圖告訴我，改了會動到哪些功能？用繁體中文、簡短回答，不要修改任何檔案。

幾個寫法可以照抄：先講清楚「我想改什麼」、要它用 graphify 的圖回答、要「簡短」（表格才看得清楚）、最後一句「不要修改任何檔案」（它才不會順手動手）。

---

✨ ③ 效果展示：旅遊規劃網頁，168 個檔案變一張圖

我拿八月歐遊時做的旅遊規劃網頁來試。它是一個手機網頁加一支後端，分成前端、後端兩個資料夾，行程、景點、記帳都存在 Notion。我把它複製一份到另一個資料夾，拿掉金鑰檔（.env）之後才跑。

在專案根目錄打 /graphify .，它掃完 168 個檔案，畫出 1,059 個點、2,575 條線，自動分成 51 組。這些數字都寫在它產出的 GRAPH_REPORT.md 第一段。

圖說：打開 graph.html 看到的全圖。右側清單是它自動分出來的 51 組。

這張圖怎麼看

第一次打開會覺得密密麻麻，記住兩件事就好：

• 一個點＝專案裡的一個東西：一個函式、一個檔案、一個套件、一段文件裡的概念，都是一個點。
• 一條線＝它們之間有關係：誰呼叫誰、誰引用誰、誰包含誰。它的報告裡會標每條線是「直接從程式碼讀到的」還是「推論出來的」，我這個專案 99% 是直接讀到的。

圖上的顏色只是用來區分相鄰的群，顏色總共只有 10 種、輪流配給 51 組，所以同一種顏色不代表同一個功能區，要看功能請看右側清單上的組名。

勾哪一組，就只看那一組

右側清單先取消全選，再一組一組勾回來，圖上就只剩那一組的點和線。51 組的名字是它自己取的（英文），像 Expense Entry UI、Daily Info Cards、Offline IndexedDB Sync Queue 這種，一看就知道是專案的哪一塊；前幾組的名單放在 FAQ 第 8 題。下面截圖裡的中文組名（例如「費用錄入介面」）是我的瀏覽器把頁面翻成中文的結果，原文是 Expense Entry UI。

圖說：左：清單只勾「費用錄入介面」（原文 Expense Entry UI）一組；右：圖上只剩那一組（藍色）。

最實用的一招：改程式之前，先問「改這個會動到誰」

這才是我覺得值得裝的理由。我自己的經驗是，請 Claude 改一個東西，它得先翻檔案才知道牽連多廣，翻漏了就可能改壞別的地方。現在圖畫好了，我貼上一章第 ⑤ 段的那句指令，說我想改 useTrip()（專案裡連線最多的函式，報告列它有 72 條線），它直接查圖，回我一張表：useTrip() 共有 36 個直接呼叫者（它標註全部是從程式碼直接讀到的線），照功能分成地圖、抽屜與行程、首頁與導覽、每日資訊、記帳、任務、連結、其他等幾類，最後還補一句：整個前端幾乎都會受影響，只有新增旅程精靈沒用到它。

圖說：問完之後 Claude 查圖列出的表格，useTrip() 共有 36 個直接呼叫者。終端機其他區域已裁掉。

這一題我沒有逐條核對它列的 36 個呼叫者是不是全對。另外要注意它自己也說了：圖只記錄「誰呼叫了 useTrip()」，沒記錄「誰讀了哪個欄位」，所以只改某個欄位時，圖沒辦法幫你縮小範圍，要再請它搜欄位名稱。拿到清單之後還是要自己看一遍再動手（見 FAQ 第 9 題）。

---

❓ 常見問題 FAQ

Graphify 要付費嗎？

GitHub 專案頁標示 Apache-2.0 授權（另附 MIT 授權檔），可以自由使用（2026.10.25 查 Graphify-Labs/graphify）。GitHub 說明頁另外提到同一家公司有雲端版，寫有 14 天免費試用，之後的費用我沒查，本文也沒有用到。Claude Code 本身的使用條件，請看 Anthropic 的說明。

一定要用 Claude Code 嗎？Mac 可以嗎？

我這次是在 Windows 的 Claude Code 裝與用的，其他環境我沒試過，不能保證一樣。GitHub 說明頁寫它也支援 Cursor、Codex、Gemini CLI 等二十多種 AI 助理，macOS、Linux、Windows 都有（2026.10.25 查）；Mac、Claude 桌面版、Claude 網頁版我都沒試，所以不寫步驟。

貼了安裝指令，說找不到 uv 或 graphify 怎麼辦？

找不到 uv：先裝 uv（Windows 貼 winget install astral-sh.uv），裝完把終端機關掉重開。裝完 graphifyy 卻找不到 graphify 指令：GitHub 說明頁寫這時可以跑 uv tool update-shell 讓指令路徑生效，再開新的終端機；或是直接用 python -m graphify，作法見 FAQ 第 4 題。我沒有碰到找不到 uv 或找不到 graphify 的狀況，這兩個解法我沒有實測。

graphify.exe 被 Windows 擋住，為什麼 python -m graphify 可以？

被擋的是 uv 幫你產生的 graphify.exe 這個執行檔，Windows 的應用程式控管政策不讓它跑；python -m graphify 是請 Python 直接執行套件裡的模組，不經過那個 .exe。但 uv 把套件裝在自己的隔離環境，系統的 python 看不到，所以我另外跑了 python -m pip install --user graphifyy，在系統的 Python 3.11.9 裡再裝一份，之後 python -m graphify install 才登記成功。這表示我的電腦同時有 uv 和 pip 各一份 Graphify，不影響使用。GitHub 說明頁的 Windows 寫法是 graphify install --platform windows，我沒有試過；如果你的 python 找不到 graphify 模組，先用 python --version 確認是不是你預期的那一個 Python，再重跑 pip 那一行。

怎麼確認 Graphify 真的裝好了？

在專案資料夾啟動 Claude Code，打 /graphify 時斜線指令清單出現它就是登記好了（這個畫面我沒有另外截圖）。最直接的方式是跑一次 /graphify .，專案裡出現 graphify-out 資料夾、裡面有 graph.html、GRAPH_REPORT.md、graph.json 三個檔案，就是整條路都通了。

它會不會讀到 .env 或金鑰？程式碼會不會被傳出去？

GitHub 說明頁寫：程式碼是在本機用語法解析器拆解，不經過語言模型、不離開你的電腦；文件、PDF、圖片這類才會交給你的 AI 助理做語意分析（2026.10.25 查）。我這次是把專案複製一份、先移除 .env 再跑，沒有去驗證它實際讀了哪些檔，所以專案裡有金鑰、帳單這類檔案時，建議照樣先移走或在 .graphifyignore 排除，再自己確認一次。

安裝之後，我的 CLAUDE.md 多了一段 graphify 的東西？

會。我的安裝畫面在成功時印了一行 skill registered in 後面接 .claude 資料夾裡的 CLAUDE.md，意思是安裝這一步就在你家目錄的 CLAUDE.md 登記了 graphify；那個檔案是 Claude Code 每個專案都會讀的全域設定。登記了哪些內容，我沒有逐行看，建議裝完自己打開看一次。GitHub 說明頁另外寫，graphify claude install 會在專案裡再加一段設定和一個鉤子，讓 Claude 搜尋檔案前被提醒先查圖（2026.10.25 查）；這個我沒有跑。不想要的話，說明頁給的移除指令是 graphify uninstall（被擋就改 python -m graphify uninstall），要連 graphify-out 資料夾一起刪才加 --purge；移除我沒有實測。

51 組是怎麼分的？組名是誰取的？

分組是它用演算法照「誰跟誰牽連最多」自動切的，組名也是它自己取的，原文是英文（截圖裡的中文是瀏覽器翻譯）。我的專案它分出 51 組，報告顯示 46 組、另外 5 組太小省略；前幾組的名字是 Expense Entry UI（記帳輸入畫面）、Daily Info Cards（每日資訊卡）、Offline IndexedDB Sync Queue（離線同步佇列）、Links & Emergency Calls（連結與緊急電話）、Backend Dependencies（後端套件）、Task Checklist（待辦清單），後面還有 New Trip Wizard、Map Markers & Routes、Weather Service 這類一看就懂的名字。它另外會列出「連線最多的點」，我的專案第一名是一個叫 useTrip() 的函式，72 條線，等於整個專案的中樞。

它說「36 個地方用到」，這個數字一定對嗎？

我沒有逐條核對。這個 36 是 useTrip() 這個函式的直接呼叫者數量，Claude 回答時註明這些線全部是從程式碼直接讀到的；圖本身是從程式碼解析出來的，但「會不會改壞」是 Claude 根據圖做的判斷。它也說明圖只記錄誰呼叫了這個函式，沒記錄誰讀了哪個欄位，所以只改某個欄位時，範圍沒辦法從圖縮小。整張圖的報告把每條線標成「直接讀到」或「推論」，我這個專案推論的線只有 23 條。拿到清單之後，自己看一遍、確認真的要動哪些，再請它動手。

專案改了之後，圖要重畫嗎？

要。圖是跑 /graphify . 那一刻的快照，之後改了程式它不會自己更新。GitHub 說明頁寫可以用 /graphify . --update 只重掃改過的檔案，也有裝 git 鉤子讓它在 commit 後自動重建的做法（2026.10.25 查）；這兩個我都沒有實測，我是改完直接再跑一次 /graphify .。

---

⏱️ 一分鐘版

一分鐘看 Claude 讀完整個專案畫出一張知識圖，改程式前先問它會動到誰。

⏱️ 本系列「一分鐘教你一個 AI 工具技巧」

• 前導集：Claude Chat 跟 Cowork 合併了
• 第 1 集：IG 貼文圖字體一致性
• 第 2 集：Reels 加動畫實測：Claude 六輪改稿，全用講的
• 第 3 集：Claude Code 必裝 3 個 MCP
• 第 4 集：複製自己的聲音
• 第 5 集：一支 Reel 背後用了 5 個 AI 工具（整理在 AI 工作流入口頁）
• 第 6 集：Claude 必裝 3 個 Skill
• 第 7 集：Claude 模型怎麼選最省
• 第 8 集：讓網頁變好看的 2 個 Skill
• 第 9 集：生日月優惠信一次整理
• 第 10 集：Claude 儀表板
• 第 11 集：Claude 寫 Python 畫 Reels 動畫
• 第 12 集：信用卡帳單整理成一張表
• 第 14 集：Archify 自動畫系統架構圖
• 第 15 集：DESIGN.md 把網頁換成 Airbnb、Spotify、Nike 風
• 第 16 集：Graphify 讓 Claude 讀完專案畫出一張知識圖（本篇）
• 第 17 集：Claude 聊很長，先存這 3 招內建指令

👉 看全系列

---

💡 結語：先畫一張圖，之後都先查圖再動手

整件事只有三步：裝一次 Graphify、在專案裡打一次 /graphify .、之後要改東西之前先問一句「改這個會動到誰」。圖畫好之後，勾組、看中樞、查影響範圍，都在那個 graph.html 和 Claude 的回答裡。

你也可以拿自己的專案試試同樣的指令，畫出來哪裡看不懂，直接把 GRAPH_REPORT.md 丟給 Claude 請它解釋。

遇到這類問題，問 AI 就對了。

這個系列每一集的完整整理，都收在 AI 工作流入口頁。

💡 延伸閱讀：
👉 系統架構圖 我一筆都沒畫｜Archify 安裝與指令實測
👉 Claude Code 必裝 3 個 MCP：Playwright、Context7、Firecrawl 實測