【2026 最新】Buddy 2.1 新手教學：Android 跑 Claude Code，假筆記首跑與更新撤權五步

想做 Buddy 2.1 新手教學的第一個練習，你可能已經想到：「請 Claude Code 幫我回訊息。」先把任務縮小一點：讓它讀一份假筆記、整理三行草稿，再由你決定下一步。你學到的會是怎麼交代、核對和收回手機操作權，而不只是下載一個 APK。

本文專為完全沒有技術背景的讀者寫，依官方文件、版本紀錄與公開程式碼，帶你走過安裝、登入、首跑、批准驗收與更新撤權五步。查核截至 2026 年 10 月 14 日，2.1 系列最新 GitHub release 是 2.1.4；下文採用這個版本的操作路線。本篇未在 Android 裝置執行，練習中的結果是你要檢查的通過條件。

先說結論：讓助手先交草稿，再學會關門

Buddy ＝ 手機裡的代理程式＋操作 App 的工具＋你握著的批准與撤權。它把 Claude Code 等代理放進 Android App 的 Linux 環境，透過無障礙服務讀畫面、點按與輸入；模型服務仍需要網路。把它想成坐在你手機旁的助手：手在手機裡，思考所需的資料仍可能送到遠端服務。

• 先確認是 ghorbelhamdi/buddy-android，並使用只有假資料的練習環境。
• 首跑保持 Developer mode 關閉，明確選擇練習 App 的 Hard 模式，檢查按鈕規則。
• 把「寫對草稿」「拒絕後不動作」「修改後重新問」「停止後不續跑」分別驗收，更新後重做。

Buddy 是什麼？手機執行與模型推理分開看

Buddy 的聊天泡泡是操作入口；代理程式在 App 的私人儲存空間內執行，手機工具由本機 MCP 提供。MCP 是讓代理呼叫工具的一種通訊規格，可理解成助手與「讀畫面、按按鈕」工具之間的插座。若想先懂模型與執行層如何分工，可以讀 AI Agent Harness 白話解釋。

依 Buddy 隱私政策，使用者輸入、附件與代理讀取的畫面內容會送到所選 AI 服務；用 Claude Code 時是 Anthropic。Anthropic 的資料使用文件也明確說明，本機 Claude Code 會透過網路與模型互動。本機執行代理，不等於模型離線思考，也不等於畫面資料留在手機。所以練習 App 不同步雲端，只是減少筆記 App 的外送，代理讀到的文字仍可能送往模型服務。

另一個容易混淆的是手機遙控。Anthropic 的 Remote Control讓手機或瀏覽器連到原本執行中的 Claude Code session。Buddy 這篇教的是代理執行環境就在 Android App 裡，再接到手機工具。若你想接手的是電腦上的工作，先看 Claude Code Remote Control 教學；兩種需求有不同的工作位置。

Buddy 2.1 新手教學：五步完成第一次假資料任務

①「先認人」：核對來源、裝置與安裝包

同名 App 很多，怎麼知道下載對了？從專案 owner 和 repository 名稱開始。手機打開 官方 GitHub Releases，確認 ghorbelhamdi / buddy-android，本次版本為 v2.1.4，資產名稱是 buddy.apk。不要只憑搜尋結果裡的 Buddy 字樣。專案定位是獨立工具，並非 Anthropic 出品。

官方設定路線要求 64 位元 Android 11 以上；目前 APK 的原生程式庫是 arm64-v8a，先確認手機是 ARM64 裝置。作者主要測試的是 OnePlus 12、Android 16，這個範圍不能推成所有品牌都驗證過。先預留網路與儲存空間，下載 APK 後，設定精靈還會另下載 Linux 與代理。

若 Android 要求允許瀏覽器安裝 App，只對這次使用的來源開啟安裝權限，完成後再關閉。遇到 Play Protect 阻擋，先停下確認來源與警示，不要為了完成教學而全面關掉防護。驗收是安裝資訊的 App、來源和版本都對得上；若版本號對不上，先回 Releases 查清楚。

②「開必要的門」：完成設定與 Claude 登入

安裝好了，泡泡為什麼還不能操作？沿設定精靈完成服務與代理安裝。第一次啟動會開啟引導，之後可走 Settings → Setup → Open the step-by-step guide。選 Claude Code，閱讀無障礙用途說明後，再到 Android 的無障礙設定開啟 Buddy assistant。這項權限能讀取畫面並代你操作其他 App，不只是顯示一顆泡泡。

若看到 Restricted setting 而開關呈灰色，Google 的 restricted settings 說明列出 Settings → Apps → Buddy → ⋮ → Allow restricted settings 路線。只在你已核對這個 App、理解所授權內容後使用，再返回無障礙頁面開啟；不要把解除限制當成來源安全的證明。

接著按精靈的安裝與 Sign in，由瀏覽器完成 Claude 帳號授權。本文使用已有 Claude Pro／Max 的個人帳號路線，Anthropic 官方登入文件確認這兩種方案可登入 Claude Code。Buddy App 免費不會把模型用量變成無限；這輪工作仍使用你的方案額度。登入時自己操作，不把密碼或授權碼貼進聊天。

最後依精靈檢查電池限制；若系統經常中止 Buddy，再針對它調整為不受限制。首跑用文字即可，麥克風、語音與 Developer mode 先不開。驗收是設定項目完成、Claude Code 可建立聊天，並記下手機型號、Android 版本及 Buddy 版本。

③「先交草稿」：只讀一份假筆記

什麼任務既看得見結果，又不需要真實帳號？準備一份空白假筆記。優先用備用手機，或沒有真實帳號與既有資料的練習環境。手動打開可編輯、已關閉同步的筆記 App，新增 Buddy 練習，寫入 練習小隊：明天整理三盒彩筆，下午三點確認清單。，不要混入姓名、地址或工作內容。

先在 Settings → Experience → App permissions 找到練習 App，明確選 Hard。這是批准模式，不是只允許讀取這一個 App 的隔離區；因此環境裡是否有敏感畫面，仍需在執行前處理。回到筆記，再從泡泡或 Chats → New chat 建立 Claude Code 對話，貼上：

只讀目前這份「Buddy 練習」假筆記，回覆原文，並在聊天中整理成三行草稿。這輪不點按筆記內容、不填入、不刪除、不分享、不打開其他 App；完成後停止。

你要看到兩份可核對文字：讀回的原句，以及包含「三盒彩筆」「下午三點」的草稿。若讀錯畫面、混入別的內容或要求額外登入，停止並重新打開練習筆記。第一輪只驗讀取與理解，不急著讓它寫進 App。

④「看懂門禁」：填入、拒絕、修改與停止

讀得對，下一步能直接放手嗎？先把動作切小，逐項驗收。第二輪要求：「只把三行草稿填入這份假筆記的空白區，不按分享、送出或刪除；寫入前用 confirm 展示完整文字，等我決定。」先練 Deny，檢查筆記是否未寫入；再開一輪練 Change，把「三盒」改成「兩盒」，檢查它是否提出更新文字並重新詢問。只有內容完全符合時才按 Approve。

這一段測的是代理有沒有遵守明確要求、以及批准卡是否正常。代理主動叫出 confirm，不等於 Hard 規則已攔到所有按鈕。若要另外驗規則，練習 App 必須有不連網、可復原的本機按鈕；把它實際呈現的標籤加到 Button rules → Always ask，只讓代理嘗試那個假資料動作，先拒絕，觀察內容是否維持原樣。自動儲存的 App 若沒有可測的按鈕，這項先標為未驗收，別改用真實付款或訊息補考。

這裡有一個繁中關鍵細節：2.1.4 的 內建危險詞規則列的是英文、法文、德文、西文、義文和阿拉伯文。中文「送出」「付款」「刪除」要依畫面的實際標籤補到 Always ask，並檢查是否有同一動作落在 Never ask。程式的 點按批准路徑會先檢查 Never ask；新手先讓它保持空白。圖示按鈕、缺失的無障礙標籤和座標點按，也要以具體畫面驗收。

Hard 像拿按鈕名單的門衛：命中規則才攔。Smart 先用規則，再讓另一個 Claude Code／Codex session 檢查其他點按；這增加另一輪模型判斷與用量。Trust 則把詢問交給代理指令。首跑採 Hard 加明確規則，熟悉後再在同一份假資料上比較 Smart，別把名稱當成安全等級認證。

最後讓代理做另一個假資料小任務，在運作時長按泡泡選 Stop task。2.1.4 的 停止路徑停止 Buddy 聊天，並暫時拒絕手機工具動作一分鐘；驗收是畫面停止變動、Sessions 裡的工作狀態停止。停止不會替你還原已寫入的文字，檢查後自行復原。不要把 Hide 泡泡當成撤權。

⑤「更新後重考」：保留設定，最後收回權限

新 APK 能蓋上去就算完成嗎？更新後重做小任務。在 更新程式中，GitHub 路線核對同 repository release 的 buddy.apk。你可在 Settings 找 Check for updates，或回官方 Releases 手動下載，透過 Android 安裝器覆蓋更新。先保留重要內容的個人備份，不先解除安裝。

2.1.4 release 說明覆蓋安裝會保留聊天、設定和登入；這是專案承諾，本文沒有跨裝置更新結果。更新完成仍要自己檢查版本、App 模式、Always ask／Never ask、登入狀態，再用同一份假筆記重做讀取、拒絕、修改、停止四項。若安裝器因套件簽章不相容而拒絕，回查來源，別先刪掉舊 App 強行續接。Android 的簽章文件說明更新時的簽章關係。

截至本次查核，2.1.4 release 已寫明 Google Play 正在封閉測試，Play 版省略自我更新與 Developer mode；本文專注 GitHub APK，不把 README 的舊敘述延伸成「Buddy 永遠不會在 Play 上架」。也不要混裝不同發行路線來驗證資料保留。

完成練習後，先停止工作，再到 Buddy 的 Settings → Agents 開啟 Claude Code 登入頁，按 Sign out 並確認登出狀態。接著到 Android 無障礙設定關閉 Buddy assistant，用假筆記確認它已無法繼續讀畫面或點按；再關掉為安裝 APK 開過的來源安裝權限，以及不再需要的麥克風、通知權限。

若決定移除，再從 Android 的 Buddy App 資訊解除安裝。Buddy 隱私政策說明這會刪除它在手機裡的聊天、設定、登入和代理檔案；它不代表模型供應商端的既有資料也一併刪除。已送出的資料要按供應商自己的資料控制處理。想先練不接真手機的方式，可以讀 nanoMuse 模擬手機假筆記教學。

常見坑：三種成功要分開記

你可以留下三欄簡短紀錄：內容正確、批准行為、恢復與撤權。一份草稿寫對，只證明那次文字結果；拒絕後沒有寫入，才回答那個動作的批准問題；關閉服務後工具失效，才回答撤權。每次保留版本、練習指令、所選模式、預期與觀察，別只截一張成功畫面。

畫面上的訊息、網頁或筆記可能夾帶叫代理改做別件事的文字，這叫提示注入。新手先用自己手寫的假資料，把任務限定在一份筆記；看到要求轉帳、傳密碼或移到其他 App 的內容就停止。本篇不開 Developer mode，是因為它增加命令與檔案操作的範圍，這些能力用不到首跑。

若工作一直重試，先按停止，回查最後一個工具呼叫與 App 狀態，避免重做。2.1.4 的版本紀錄加入「重試前查是否已送出」等代理指引，它們不是不會重複執行的證明。讀畫面和 Smart 審查都可能消耗用量，想整理任務脈絡可接著看 Claude token 管理教學。

FAQ：Buddy 2.1 新手教學八問

1. Buddy 是 Anthropic 官方 App 嗎？

不是。專案明確定位為獨立工具；本文辨識的是 Hamdi Ghorbel 的 buddy-android。

2. 本機執行，就能離線用 Claude 嗎？

這條路線需要網路。代理在手機執行，Claude Code 與 Anthropic 模型服務的互動仍經網路。

3. 已訂閱 Claude 還要付 Buddy 費用嗎？

Buddy GitHub 版免費；使用 Claude Code 仍消耗 Claude 方案額度，本文不把它算成新增免費額度。

4. Hard 會問每一次點按嗎？

依規則判斷。命中危險按鈕或 Always ask 才進批准路徑；其他點按及 Never ask 放行規則須另看。

5. 中文按鈕可以放心靠內建詞嗎？

先補規則並驗收。2.1.4 列出的六種內建語言不含中文；請加入你實際看到的動作標籤。

6. 按 Deny 或 Stop 就還原整個任務嗎？

要自行檢查與復原。Deny 拒絕待批准動作，Stop 停止後續工作；已寫入的假筆記應由你核對再還原。

7. 更新前要先刪掉舊 Buddy 嗎？

保留舊 App 做覆蓋更新。解除安裝會刪除 App 的本機資料，更新後仍要重新核對批准設定。

8. 第一個練習通過，就能交給它付款嗎？

先繼續做可逆任務。假筆記驗收只涵蓋當時的版本、App、畫面和指令，不涵蓋付款、登入或其他 App 的行為。

給新手的三個重點

• 位置：把代理在哪裡執行、資料送到哪裡分開記。
• 批准：模式名稱只是起點，按鈕詞彙、例外與拒絕結果要逐項核對。
• 退出：停止、登出、關閉無障礙服務與解除安裝，各自有不同作用。