核對日:2026-11-09。 Apple 喺 Xcode 開發者文件公開咗用 Model Context Protocol(MCP)俾外部 agent 接入 Xcode,同時 Anthropic 官方 plugin marketplace 亦列出「Xcode」plugin。香港已經有 Mac、Xcode 同 Claude Code 嘅開發者,而家有兩條官方路徑可以將 Claude Code 接到 Xcode。根據 Apple Developer Documentation〈Giving external agents access to Xcode〉、Anthropic 官方 marketplace GitHub README,以及 Claude Code plugin 安裝說明,兩條路徑都可以用,但機制並不相同。文件同 marketplace 清單喺 2026-11-09 核實,介面同步驟請以官網當日為準。
兩條官方路徑:MCP 同 Marketplace Plugin
路徑 A:Apple 文件記載嘅 MCP。 直接使用 Apple 文件寫明嘅接法,指令係 claude mcp add --transport stdio xcode -- xcrun mcpbridge。
路徑 B:Anthropic 官方 marketplace plugin「xcode」。 對話入面可以用 /plugin install xcode@claude-plugins-official;Terminal 亦有官方寫法 claude plugin install xcode@claude-plugins-official。呢個 plugin 嘅來源指令係 xcrun agent plugin path --plugin-format claude。你也可以用 /plugin 再揀 Discover 瀏覽。
兩條都係官方路徑,但唔係同一套機制。簡單嚟講,路徑 A 係跟 Apple 文件,用 Xcode 提供嘅 MCP 伺服器(經 xcrun mcpbridge)加入 Claude Code;路徑 B 係喺 Anthropic 官方 marketplace 安裝名為 xcode 嘅 plugin,來源指令係 xcrun agent plugin path --plugin-format claude。兩者都係為咗喺 Claude Code 操作 Xcode 專案,但加入方式、你要檢查嘅畫面,同需要覆核嘅內容都唔一樣,唔好當成撳同一個掣就完成。
安裝 plugin 前,應該先喺插件頁睇清楚詳情(包括 hooks/MCP),再揀安裝範圍(user、project 或 local)。官方 README 亦提醒,安裝前要先審查。官方 marketplace 會喺第一次互動式終端機會話加入。另外,Apple 同一份文件亦有 Codex 例子 codex mcp add xcode -- xcrun mcpbridge,呢度只作對照,唔另外展開。
點樣喺 Xcode 開權限
要讓外部 agent 用到 Xcode 工具,可以跟 Apple 文件呢幾個步驟:
- 打開 Xcode,去 Settings > Intelligence 側邊欄。
- 喺 Model Context Protocol 底下,從「Allow External Agents to Use Xcode Tools」揀 Always 或 While Xcode is Open;要關閉就揀 Never。
- 喺 Terminal 用
xcrun mcpbridge接上 Xcode 提供嘅 MCP 伺服器(路徑 A 嘅claude mcp add例子就係咁呼叫)。 - 提示外部 agent 之前,先喺 Xcode 打開你嘅專案。Xcode 會喺外部 agent 連上、以及運作緊嗰陣發出提示。
- 可選:喺
AGENTS.md或CLAUDE.md加入提示,幫 agent 理解專案。
如果想收窄授權時間,可以先揀「While Xcode is Open」,只喺 Xcode 開住嗰陣允許外部 agent。Apple 文件寫明,你喺 Xcode 以外啟動嘅外部 agent,只要獲得許可,就可以修改專案並執行例如 build app 等動作;所以授權範圍要按自己工作習慣揀,唔用嗰陣可以改返 Never。
點用一覽
| 設定/指令 | 做咩 | 注意 |
|---|---|---|
| Xcode > Settings > Intelligence > Model Context Protocol > Allow External Agents to Use Xcode Tools | 允許外部 agent 使用 Xcode 工具 | 揀 Always 或 While Xcode is Open;關閉選 Never |
claude mcp add --transport stdio xcode -- xcrun mcpbridge | 路徑 A:用 Apple 文件記載嘅 MCP 接上 Xcode | 提示 agent 前先喺 Xcode 打開專案 |
claude mcp list | 核對 Claude Code 已加入邊啲 MCP | 確認列表出現 xcode;Codex 則用 codex mcp list |
/plugin install xcode@claude-plugins-official | 路徑 B:安裝官方 marketplace 嘅 Xcode plugin | 安裝前先睇插件頁(hooks/MCP),再揀 user/project/local |
claude plugin install xcode@claude-plugins-official | 路徑 B 嘅 Terminal 安裝寫法 | 同樣要先複核插件詳情;官方 marketplace 會喺首次互動式終端機會話加入 |
實際操作時,可以先完成 Xcode Intelligence 設定,再決定行邊條路徑。如果你想完全跟 Apple 文件,就用路徑 A 嘅 claude mcp add,再用 claude mcp list 確認列表出現 xcode。如果你日常已經用 Claude Code 嘅 plugin 系統,就行路徑 B;/plugin install 會先打開詳情頁,等你複核再揀 user、project 或 local。無論邊條,都要先喺 Xcode 打開專案,先好向外部 agent 出提示;Xcode 喺 agent 連上同運作緊嗰陣會發出提示,呢個係 Apple 文件寫明嘅狀況,唔好略過。
能力一覽
| 能力 | 說明 |
|---|---|
| 編譯、執行同測試 scheme | Marketplace 指可以 build、run、test schemes |
| 渲染 SwiftUI preview | Marketplace 指可以 render SwiftUI previews |
| 驅動模擬器同裝置 | Marketplace 指可以 drive simulators and devices |
| 讀取 build log 同診斷 | Marketplace 指可以 read build logs and diagnostics |
| 搜尋 Apple 開發者文件 | Marketplace 指可以 search Apple developer documentation |
| 修改專案同 build | Apple 文件指外部 agent 可以修改 Xcode 專案,並執行例如 build app 等動作 |
呢啲能力仍然需要你自己覆核編譯、測試同提交結果,唔能夠當成可以完全自動上架 App Store。Marketplace 列出嘅功能集中喺開發過程:起 scheme、睇 preview、開模擬器或裝置、讀 log,以及查 Apple 開發者文件;最終要不要提交、點樣填 App Store 資料,仍然要由開發者自己決定。
結論
對已有 Mac、Xcode 同 Claude Code 嘅香港開發者嚟講,而家可以按 Apple 文件用 MCP 接 Xcode,或者按 Anthropic 官方 marketplace 安裝 xcode plugin;兩條路徑機制不同,揀邊條都要先睇清楚授權同插件詳情。開始提示外部 agent 之前,記得喺 Xcode 打開專案,並用人手檢查 build 同測試輸出。呢篇只寫已經同時具備呢三樣工具嘅情況;官方頁無寫可以喺 Windows,或者淨用 iPad、冇 Mac 同 Xcode 嘅環境照做。所需 Xcode 或 Claude Code 版本號上述文件亦未寫死,裝之前請直接核對當日文件。功能同設定介面會更新,以官網當日為準。
若你想一併了解 Claude Code 其他用法,可以參考 Claude Code subagent 成本同用法、AI agents harness 編程點睇,以及 Claude 遠端控制編程。
更新於 2026-11-09(Asia/Hong_Kong)。