Threads · Instagram · YouTube 全平台實戰內容系統

會員專區 梗圖庫 療癒一下

AI 工具

xtool 教學：用 Claude 做 iPhone App，Mac／Windows 安裝與設定

想用 Claude 做自己的 iPhone App？整理 xtool 的 Mac、Windows／WSL 前置設定、Apple ID 登入、建置安裝指令與常見問題，附可複製的 Claude Code 需求範例。

作者：章琪 Scarlett｜2026/11/01

用 Claude 做 iPhone App：xtool 安裝與設定教學，章琪 Scarlett 漫畫情境封面

想做一個自己用的 iPhone App，例如待辦清單、閱讀紀錄或簡單的記帳工具，可以先讓 Claude Code 協助寫程式，再用 xtool 處理建置、簽署和安裝。

我把官方設定方式整理在下面。這是一份設定教學，還沒有逐一實測所有作業系統；第一次使用，請先從功能很少的小 App 開始。

xtool 是什麼？Claude 和它怎麼分工？

xtool 是開源的 iOS 開發工具，採用 Swift Package Manager 建立專案。Claude Code 負責協助寫 Swift／SwiftUI 程式、讀錯誤和修改檔案；xtool 負責把專案建置、簽署並裝到連接的 iPhone。

這裡說的是能在電腦專案資料夾中工作的 Claude Code。單純在聊天視窗拿到一段程式碼，還需要另外建立專案與設定開發環境。xtool 本身可以免費取得，Claude 的使用費、Apple 開發者方案則要分開看。

先確認你的電腦：Mac 與 Windows 的準備不同

Mac：先安裝並開啟一次 Xcode，完成它要求的初始設定。xtool 取代部分建置工作，仍然需要 Xcode 提供 iOS SDK 與工具鏈。只有 Command Line Tools 並不足以取代完整的 iOS SDK。

Windows：官方走的是 WSL 裡的 Linux 環境，需要另外設定 USB 裝置轉接，讓 WSL 看得到 iPhone。Linux 路線還需要 Swift 工具鏈、usbmuxd，以及從 Apple 下載的 Xcode .xip 來擷取 SDK；不是下載一個 Windows 程式就能直接開始。

Windows／Linux 請先照官方安裝文件完成 WSL、Swift、USB 與 SDK 設定，再接下面的帳號與專案步驟。

Mac 安裝 xtool：先檢查環境，再做初始化

打開 Mac 的「終端機」，先確認 Xcode SDK 與 Swift 都找得到。如果第一行找不到 iphoneos SDK，先回到 Xcode 完成下載與初始設定。

檢查 Mac 開發環境
xcrun -sdk iphoneos -show-sdk-path
swift --version

電腦已經裝好 Homebrew 的話，可以用下列指令安裝。還沒有 Homebrew，可改走官方文件的 xtool.app 下載方式，並依文件設定 PATH。以下 brew 指令只適用於 Mac 這個安裝路線。

安裝與初始化
brew install xtool-org/tap/xtool
xtool --help
xtool setup

Windows／WSL：依序完成這些設定

  1. 先照 Microsoft 文件安裝 WSL，再設定 USBIPD。iPhone 接上後，要把裝置連接轉交給 WSL。
  2. 在 WSL 的 Linux 終端機，依 Swift 官方步驟安裝工具鏈。目前 xtool 文件指定 Swift 6.4；安裝後用 swift --version 確認。
  3. 確認 usbmuxd --help 能執行。Ubuntu／Debian 若沒有安裝，可用 sudo apt-get install usbmuxd；其他 Linux 請用對應的套件管理工具。
  4. 用瀏覽器登入 Apple 的開發者下載頁，取得官方文件指定的 Xcode .xip，目前是 Xcode 27.1。依 Apple 畫面完成下載所需的登入與授權，記下檔案位置。
  5. 下載與 Linux 架構對應的 xtool AppImage，加入 PATH，再執行 xtool setup。登入方式看下一節；之後輸入 Xcode .xip 的位置，讓 xtool 擷取 SDK。

Microsoft：安裝 WSL · USB 轉接設定 · Swift Linux 安裝 · Apple：Xcode 下載

在 WSL／Linux 終端機執行
curl -fL \
  "https://github.com/xtool-org/xtool/releases/latest/download/xtool-$(uname -m).AppImage" \
  -o xtool
chmod +x xtool
sudo mv xtool /usr/local/bin/
xtool --help
xtool setup

SDK 擷取完成後，執行 swift sdk list，應該會看到 darwin。接著可以繼續建立 Hello 專案。上述 sudo 指令可能要求輸入 Linux 管理員密碼；這是電腦自己的密碼提示，不是要把密碼貼進聊天。

Apple ID 怎麼選？免費帳號與 API Key 的差別

執行 xtool setup 時會看到兩種登入方式：API Key 使用公開的 App Store Connect API，需要付費的 Apple Developer Program 會員；Password 可以搭配免費 Apple ID，但會用到 Apple 私有 API。官方建議 Password 路線使用備用 Apple ID。

已經有付費開發者帳號的人，可以依官方說明建立具有 App Manager 角色的 App Store Connect Team Key。無論選哪條路，密碼、驗證碼與 API 私鑰都只在你自己的設定介面輸入，不要貼給 AI 或放進公開專案。

建立第一個專案，讓 Claude Code 改成你要的 App

環境與帳號設定好後，在你想放專案的位置建立 Hello。先保留這個專案名稱完成第一次安裝，確認整條流程通了，再擴充功能。

建立專案
xtool new Hello
cd Hello

讓 Claude Code 在 Hello 資料夾中工作，把需求描述清楚。下面用離線待辦清單當範例，先不加入登入、雲端同步或付款，讓第一版容易檢查。

可以直接複製的 Claude Code 需求
請在目前的 Hello 專案中，用 SwiftUI 做一個繁體中文的離線待辦清單 App。

功能只要：新增待辦、勾選完成、刪除待辦，重新開啟 App 後仍保留資料。不要登入、不要雲端服務、不要付款。

請先閱讀現有 Package.swift、xtool.yml 和 Sources/Hello，保留 xtool／Swift Package Manager 的專案結構，不要另外建立 Xcode 專案。先說明要改哪些檔案，再實作，最後列出建置指令與手機驗收步驟。

如果缺少 SDK、裝置、簽署或帳號設定，請指出缺少什麼，不要猜測成功。不要讀取、顯示或提交我的密碼、驗證碼與 API 私鑰。

把 App 裝進 iPhone：連接、信任、建置

用可傳資料的 USB 線接上 iPhone，解鎖手機。如果手機跳出「信任這部電腦」，依畫面操作。Windows 使用者也要先確認 USB 已轉接給 WSL，不能只看 Windows 有沒有認到手機。

在 Hello 資料夾執行
xtool dev

xtool dev 會建置專案、處理開發用簽署並嘗試安裝到手機。第一次編譯可能需要幾分鐘；若出現裝置配對提示，依提示完成後再執行一次。

如果要求開啟「開發者模式」，依 iPhone 的提示到設定開啟並完成重新啟動與確認。若看到「未受信任的開發者」，到「設定 → 一般 → VPN 與裝置管理」找到對應帳號並信任，再回來開 App。設定項目的名稱可能隨 iOS 版本不同。

安裝完成後，自己試一次新增、勾選、刪除，以及關閉重開後資料是否保留。看到「建置成功」還不等於每個功能都正常；之後改完程式，再執行 xtool dev 更新到手機。

常見問題：卡住時先看哪裡？

終端機顯示找不到 xtool？先確認安裝完成，使用 xtool.app 路線的人也要確認 PATH。重新開啟終端機後，再試 xtool --help。

找不到 SDK？Mac 先回 Xcode 檢查初始設定，Linux／WSL 則確認 xtool setup 已完成 Xcode .xip 的 SDK 擷取，並用 swift sdk list 檢查。不要把 Mac 的檢查指令直接套到 WSL。

找不到手機？確認線材能傳資料、手機已解鎖與信任電腦；WSL 另外檢查 USB 轉接。如果是簽署錯誤，保留完整錯誤訊息，檢查帳號與 Team 設定，交給 Claude 協助判讀時先移除個人資料。

可以直接上架 App Store 嗎？這份流程的目標是開發與裝到自己的裝置。上架仍有 Apple 的開發者會員、提交與審核流程，不能把手機上能開啟，當作已經可以公開販售。

官方文件與更新日期

資料核對：2026 年 11 月 1 日。安裝版本與 Apple 登入限制可能變動，遇到畫面不同時，請以官方文件和當下的錯誤訊息為準。封面為 AI 輔助設計的情境示意，並非實際 App 完成畫面。

延伸閱讀