Claude Code 寫的程式怎麼打包成 exe 和 dmg？用 GitHub Actions 一次編譯兩個系統

AI 寫好的程式要同時變成 Windows 的 exe 和 macOS 的 dmg，最省事的做法是推送到 GitHub，讓 GitHub Actions 在雲端分別編譯。我用 Claude Code 做了一個工程數學計算機，全程不用第二台電腦，最後直接從 Releases 下載可以打開的 App。

重點摘要

• Mac 很難直接編譯出 Windows 的 exe，Windows 也很難編譯出 macOS 的 App，GitHub Actions 可以一次解決
• Claude Code 下指令時就先講清楚「最後要透過 GitHub 編譯成 exe 和 dmg」
• GitHub 的 Personal Access Token（Classic）只要勾 repo 和 workflow 兩個權限，期限盡量設短
• Mac 有 M 系列和 Intel 兩種晶片，兩種都要支援就要先告訴 AI，否則只會產生 M 系列版本
• 編譯完成後到 GitHub 專案的 Releases 下載各版本的安裝檔

影片章節

1. 00:00 AI 寫完程式怎麼打包成桌面軟體？
2. 00:46 Mac 與 Windows 跨平台編譯的痛點解析
3. 02:27 神招公開：透過 GitHub 解決雙系統編譯問題
4. 02:43 實作演練：用 Claude Code 製作工程計算機
5. 05:18 獲取 GitHub Personal Access Token 教學
6. 06:26 透過 GitHub Actions 自動編譯 exe 與 dmg 檔案
7. 07:20 開發小提醒：Mac M系列與Intel晶片版本差異
8. 08:08 教你從 Releases 下載與驗證打包好的軟體

為什麼 AI 寫的程式要打包成桌面軟體？

不是每個小工具都適合做成網頁，只在自己電腦上離線使用的工具，直接做成軟體反而方便。這一年教了很多用 AI 打造網頁工具的方法，常有人問我：AI 寫出來的程式，要怎麼變成 Windows 可以執行的 exe 檔，或 macOS 可以執行的 App、dmg 檔？做網頁工具上癮之後會發現，每個東西都要架到網站上其實很麻煩，有些工具本來就是離線用的，那就把它打造成軟體就好。

Mac 和 Windows 跨平台編譯卡在哪裡？

一個工具要同時給 Windows 和 macOS 使用，就必須分別產生 Windows 的 exe 檔和 macOS 的 App 檔，而這兩種檔案很難在同一台電腦上做出來。

• 在 Mac 上開發：用 Xcode 可以做出 Mac 能執行的 App，但要編譯成 Windows 的 exe 就沒辦法，得另外找工具，或拿到 Windows 電腦上編譯。
• 在 Windows 上開發：編譯成 exe 完全沒問題，但要做出 macOS 的檔案一樣比較麻煩。

所以很多開發者手邊都會有兩個系統。今天要介紹的另一個方法是：開發完把程式交給 GitHub，由 GitHub 幫我們同時編譯出 Mac 用的 App 和 Windows 用的 exe 檔。

用 Claude Code 先做出要打包的工具

Claude Code 是 Anthropic 推出、在終端機裡執行的 AI 程式開發工具，下指令時就把「最後要編譯成 exe 和 dmg」講清楚，AI 才會照這個方向寫程式。我示範的是在 macOS 上做一個工程數學計算機：

1. 先建立一個專案資料夾，在 Mac 上對資料夾按右鍵，選「新增位於檔案夾位置的終端機視窗」，就會開啟在這個資料夾裡的終端機。
2. 在終端機執行 claude。我是用略過所有權限詢問的方式執行，它會照需求一路做完再告訴我結果。
3. 輸入需求，例如：幫我做一個工程數學計算機軟體，最後要分別編譯成 Windows 可以用的 exe 檔案和 macOS 的 dmg 檔案，會透過 GitHub 來製作，先做程式就好。
4. Claude Code 會先問技術框架、功能需求、UI 風格。我選了開發最快的框架、只做核心功能，UI 風格選「都可以」。
5. 確認它列出的規劃後讓它開始製作，最後它是用 Python 把計算機做完。

如果你也是用略過權限的方式執行，建議下完指令再補一句「先規劃給我看，確認後再開始執行」，這樣比較容易確認它有沒有理解你要的功能。

怎麼建立 GitHub Personal Access Token？

要讓 AI 幫你把程式推送到 GitHub，需要先建立一組 Personal Access Token（個人存取權杖，可以想成給程式用的臨時密碼），權限只要給 repo 和 workflow 兩個。

1. 登入 GitHub，點右上角進入 Settings。
2. 拉到最下面進入 Developer Settings（開發者設定）。
3. 點 Personal Access Token，再點 Token，選擇建立 Classic 類型的新 Token。
4. 名稱輸入你記得住的用途，我打的是「工程計算機」。
5. 期限設短一點，例如一週，或選 Custom 指定到哪一天過期。
6. 權限勾選 repo 和 workflow 兩個就好，按 Generate Token 產生後複製起來。

把這種私密金鑰交給 AI 並不是安全的做法，所以期限一定要設短，用完記得回 GitHub 把它刪掉，就算忘了刪，時間到也會自動失效。

交給 GitHub Actions 自動編譯 exe 與 dmg

GitHub Actions 是 GitHub 內建的自動化功能，程式推送上去後，它可以在雲端分別建置 Windows 和 macOS 的檔案。接下來只要把 Token 給 Claude Code，告訴它推送到 GitHub、編譯成 Windows exe 和 macOS dmg，順便把 GitHub 專案頁面上的 Readme 說明也寫好。

因為我沒有先在 GitHub 建立專案，Claude Code 會提出它準備使用的專案名稱，沒有要改的話回它「繼續推送」就好。它會先把檔案推送到 GitHub，再用 GitHub Actions 建立 Windows 和 macOS 的檔案，過程中會自己修正問題，我這次它從 1.0.0 一路更新到 1.2.0 才編譯完成上線。

M 系列和 Intel Mac 要分開編譯

Mac 電腦分成舊款 Intel 晶片和新款 M 系列晶片，兩種的 App 在編譯上不一樣，要兩種都支援就必須事先告訴 AI。我這次忘了交代，最後只產生 M 系列晶片的 App。如果你希望 Intel 的 Mac 也能用，下指令時就把兩種晶片都寫進去，GitHub 最後就會產生兩種晶片各自的檔案。

從 Releases 下載測試

編譯完成後，到 GitHub 專案的 Releases 頁面就能看到所有版本，直接下載對應系統的檔案。Claude Code 寫好的 Readme 也會說明檔案怎麼下載。我下載 Mac 版本測試，App 可以正常打開。

之後做軟體時，可以直接用 GitHub 管理程式版本，再讓 GitHub Actions 幫你編譯，不管用 Mac 還是 Windows 開發，都不用煩惱另一個系統的版本要怎麼做；編譯好的檔案也能直接放在 GitHub 上給別人下載。

本文整理自阿湯的 YouTube 影片〈Claude Code 寫的工具怎麼變成軟體？GitHub Actions 一次打包 Windows exe＋Mac dmg〉，實際操作畫面請看影片；更多 AI 實用教學，歡迎訂閱 I'm 阿湯 YouTube 頻道。

常見問題