高效 AI 駕馭術
2026 手機怎麼用 Claude Code 改程式、開 PR?Remote Control + GitHub App 從改到合併的完整流程
在 Claude App 接上常駐主機上的 Claude Code,請它開分支、改程式、跑測試、push、用 gh 開 PR,再用 GitHub App 看 diff、留言、合併。CLAUDE.md 規則、權限模式、ruleset 和清理 worktree 都整理在這裡。
Kelvin Wang · · 11 分鐘閱讀
重點整理
- 用 --spawn=worktree 啟動 Remote Control,每個從手機開的新 session 都有自己的 git worktree,不會互相蓋掉檔案。
- 分支、測試、PR 格式寫進 CLAUDE.md,但它只是給 Claude 的指示;阻擋未經 PR 的 main 更新,要靠 GitHub 的 ruleset。
- 自己的 token 開出的 PR 不能自己核准;必要核准數設 0 時,同一把 token 也能合併,人工看完再合併仍是操作約定。
- 伺服器模式斷網約 10 分鐘會自己結束,用 systemd 的 Restart=always 叫回來。
我有一台 Oracle Cloud 東京區的 A1 主機,上面用 systemd 跑 Claude Code Remote Control,GitHub 則用 fine-grained token。主機架好之後,接著要處理的是:人不在電腦前,怎麼用手機交代改動,再到 GitHub 看 diff、合併。
以下流程依官方文件整理,還沒有在這台主機上逐步實測。啟動參數、權限模式和 PR 規則都是設定範例;手機操作、斷線恢復與清理結果,也還需要在主機上驗證。
從手機改程式到合併,整個流程長什麼樣?
- 手機接上主機。在 Claude App 或 claude.ai/code 找到主機上那個 Remote Control,開一個新的 session1。
- 交代工作。說清楚要改什麼,並要求它開新分支、跑測試、push、開 PR。
- 在手機上回答權限詢問。Claude 要跑需要核准的指令時,手機會收到詢問,按允許或拒絕。
- Claude 開 PR。它在主機上用
gh pr create開 PR,把網址回給你5。 - 用 GitHub App 審。看 Files changed、留言;要改的地方回到 Claude 的 session 請它照留言改。
- 等 CI 過、合併。檢查都通過後,在 GitHub App 裡直接合併10。
- 清理。刪掉遠端分支,主機上移除用完的 worktree。
主機上的 Remote Control 要怎麼設定?
claude remote-control 是伺服器模式:一個程序可以同時服務好幾個 session。加上 --spawn=worktree,每個從手機或網頁新開的 session 都會拿到自己的 git worktree,啟動時預先建好的 session 則留在專案資料夾本身;--capacity 限制同時幾個 session,預設 321。以下範例把上限設為 4,起始權限模式設為 acceptEdits:
claude remote-control --name "Phone PR" --spawn=worktree --capacity 4 --permission-mode acceptEdits
Claude Code 預設用 worktree.baseRef=fresh,從遠端預設分支(通常是 main)開出新 worktree,隔開各 session 的檔案。不過,它可能使用本機快取的遠端 ref;fetch 失敗時也不保證拿到最新提交。要帶入剛合併的規則或程式,先在主 checkout 執行 git fetch origin,再確認新 worktree 的起點。若改成 worktree.baseRef=head,或沒有可用的遠端 ref,起點也可能是本機 HEAD3。
新 worktree 還要準備依賴套件和執行設定;主 checkout 的 node_modules、.env 不會自動出現在裡面。先依專案方式安裝依賴,必要的 gitignored 設定檔可用 .worktreeinclude 帶入3。
另外兩件事要在主機上先做好:
- GitHub 登入。session 用的是主機上
gh的登入,gh auth status要能看到帳號;token 只開需要的 repo 和權限(Contents、Pull requests 讀寫)。 - 手機推播。在主機上開
claude,輸入/config,打開 Push when actions required,權限詢問和提問就會推到手機;手機的 Claude App 要登入同一個帳號、允許通知1。
從手機開的 session 用哪種權限模式?
--permission-mode 設定新 session 的起始權限模式。官方文件列出以下六種;實際可用值可在主機上用 claude remote-control --help 確認12:
| 模式 | 會做什麼 | 用在手機流程 |
|---|---|---|
| default(也可寫 manual) | 讀檔通常不問;大部分改檔、執行指令、連網前會問 | 需要較多手動核准,適合不熟的 repo |
| acceptEdits | 自動允許工作範圍內的一般改檔與常用檔案指令;受保護路徑等情況仍會問 | 測試、git push 通常會問;已有 allow 規則時可能直接執行 |
| auto | 依權限規則與內建判斷處理動作,需要時交給另一個分類模型審查 | 減少詢問,但不保證安全,也不代表每個動作都經過分類模型 |
| plan | 只研究、寫計畫,計畫核准前不能改程式 | 先看它打算怎麼做,再放手 |
| dontAsk | 原本需要權限詢問的動作預設拒絕,執行已允許的讀取與工具 | 適合預先設定權限的腳本;未獲允許的 git push 會被拒絕 |
| bypassPermissions | 略過一般權限詢問;明確的 deny、ask 規則和部分保護仍適用 | 不建議用在這種存有 token 的常駐主機,見下方 |
可以先從 acceptEdits 開始,減少一般改檔的詢問。權限模式只是基準,allow、ask、deny 規則等設定也會影響結果,不能只靠模式名稱保證每次 push 都由你核准2。需要你回答的權限詢問和 AskUserQuestion 會一直等著,晚一點看手機也不會自動略過;其他轉送對話框可能有逾時期限1。
CLAUDE.md 要寫哪些規則,每個 session 才會照做?
專案根目錄的 CLAUDE.md(或 .claude/CLAUDE.md)每個 session 開始時都會載入,跟著 repo 進版本控制4。把流程規則寫在這裡,就不用每次在手機上打一長串。
下面用這個網站的 npx vitest run 當測試指令。換成其他 repo 時,要改成該專案實際使用的指令。採用這套 PR 流程前,也要先取代既有「直接在 main 工作」等衝突規則,不要把兩套相反指示一起留著。
## Git 與 PR 規則
- 每件事開一個新分支(feat/…、fix/…),不在 main 上 commit。
- 永遠不要 push 到 main,也不要 force push。
- push 前先跑 `npx vitest run`;沒過就不要 push,把錯誤貼給我。
- 用 `gh pr create --base main --title "…" --body "…"` 開 PR,不要用 --fill。
- PR 描述固定四段:## 為什麼、## 改了什麼、## 怎麼驗證、## 風險。
- 開完 PR 回報網址,再跑 `gh pr checks --watch` 等 CI,把結果告訴我。
- 不自行合併 PR;回報檢查結果後停下,等我在 GitHub 處理。
gh pr checks --watch 會等到 CI 跑完6,你在手機上就能直接看到「CI 過了」或「哪一項失敗」。
幾個限制要知道:
- CLAUDE.md 是指示,不是鎖。官方寫明 Claude 把它當成上下文,不是強制設定;要不管 Claude 怎麼判斷都擋下某個動作,得靠 hook 或外部規則4。阻擋未經 PR 的 main 更新,交給後面的 GitHub ruleset。
- 規則先合進預設分支,再更新本機 ref。使用預設
fresh模式時,先合併 CLAUDE.md,再 fetch,才能讓新 worktree 從包含規則的提交開始3。 - 寫短一點。官方建議每個 CLAUDE.md 在 200 行以內,越長越佔上下文、越不容易被照做4。
在手機上要怎麼下指令,它才會開分支、開 PR?
打開 Claude App,點 Code 進 session 列表,Remote Control 的 session 會顯示電腦圖示,綠點代表在線1。開新 session 後,一則訊息把範圍、驗收和交付方式講完:
把 about 頁的錯字「部屬」改成「部署」。
在新分支 fix/about-typo 上改,跑 npx vitest run,
通過後 push 這個分支,用 gh pr create 開 PR 到 main,描述照 CLAUDE.md 的四段。
不要動 main,也不要合併 PR。開完把 PR 網址給我。
- 分支名稱自己給。你給了名字,PR 和之後的清理都好找。
- 一個 session 一件事。worktree 是照 session 分的,兩件不相干的改動放在兩個 session,就是兩個分支、兩個 PR。
- 驗收條件寫具體。「跑 npx vitest run 通過」比「確認沒壞」好判斷,也方便核對回報。
怎麼用 GitHub App 審 PR、要它照留言改?
GitHub Mobile 可以看 PR 的 Files changed,合併區塊會顯示審查、檢查和能不能合併的狀態,條件都滿足時能直接在 App 裡合併10;留言、核准、合併也都能在 App 裡做9。
- 從通知或 PR 列表點進 Claude 開的 PR,先讀描述的「為什麼」和「怎麼驗證」。
- 看 Files changed,一個檔一個檔看 diff。
- 有意見就留言,寫清楚哪一行、想改成什麼。
- 回到 Claude 的 session 請它處理,例如「讀 PR #12 的留言,照著改,跑測試,push 到同一個分支,改完逐條回覆我改了什麼」。
- 等檢查變綠再合併。
處理留言時,可以請 Claude 用 gh pr view 12 --comments 讀 PR 的留言和審查7;貼在 diff 某一行上的審查留言,則用 gh api repos/{owner}/{repo}/pulls/12/comments 讀取8。push 到同一個分支,PR 會自動更新,不用重開。
你不能核准自己的 PR。GitHub 規定 PR 的作者不能核准自己的 PR13。Claude 用的是你的 token,PR 的作者就是你,所以在 App 裡審自己的 PR 只能留言,不能按 Approve。有其他協作者時,他們可以在 App 裡核准;一個人用的 repo,看完 diff、檢查通過就合併。
怎麼設定 ruleset,擋住直接推 main、沒過 CI 不能合併?
ruleset 是 GitHub 端的規則,不管 Claude 有沒有照 CLAUDE.md 做都會生效。這裡設定的是「main 的更新必須關聯 PR」,不是禁止所有形式的 git push main;符合條件的 PR merge commit 仍可能直接推入12。公開 repo 用免費方案就能設;私人 repo 要 GitHub Pro、Team 或 Enterprise Cloud11。
- 進 repo 的 Settings → Rules → Rulesets,點 New ruleset → New branch ruleset19。
- 把 Enforcement status 改成 Active。預設是 Disabled,不改就不會生效。
- Target branches 選預設分支(main)。
- 勾 Require a pull request before merging。所有進 main 的改動都要經過 PR12。一個人用的 repo,必要核准數留 0,因為你核准不了自己的 PR。
- 勾 Require status checks to pass,加入必須通過的 CI 檢查;這些必要檢查未滿足時就不能合併12。
- 保留 Block force pushes 和 Restrict deletions,這兩項預設就勾著12。
- Bypass list 不要加自己。主機上的 token 是用你的帳號身分操作,你能繞過,Claude 也就能繞過。
這些規則擋的是未經 PR 的更新和不符合條件的合併,沒有把「最後按合併的人」限定成你。GitHub 的 merge API 接受具有 Contents: write 的 fine-grained token16;依這組設定,必要核准數是 0、CI 條件滿足時,主機上的 token 也有合併能力。人工看完再合併是操作約定,CLAUDE.md 裡的「不自行合併」也只是指示。若要強制另一個人核准,需要獨立的審查者身分與必要審查規則,不能靠同帳號 token 區分人和 Claude。
如果還沒有 CI
Require status checks 需要 repo 裡有會在 PR 上跑的檢查,例如 GitHub Actions 的測試流程。還沒有的話,先只開第 4 步的 Require a pull request,阻擋未經 PR 的 main 更新;測試靠 CLAUDE.md 要求 push 前先跑。
PR 合併後,怎麼清掉分支和 worktree?
遠端分支交給 GitHub:在 repo 的 Settings → General → Pull Requests 勾 Automatically delete head branches,PR 合併後 head 分支會自動刪掉14。
手動清理前,先結束使用該 worktree 的 session,再從主 checkout 的另一個 session 或 SSH shell 操作。不要讓仍在 worktree 裡工作的 session 刪掉自己的目錄。以下路徑、分支名和 PR 編號都要換成實際值。
-
確認 PR 已合併,再找出 worktree。
state必須是MERGED,並核對headRefName;只有關閉 PR 不算合併7:gh pr view 12 --json state,headRefName,mergedAt git fetch origin --prune git worktree list -
檢查剩餘內容,再移除 worktree。先看有沒有未 commit 或未追蹤的檔案;git 會拒絕移除不乾淨的 worktree。需要保留的內容先另存,確定不要的內容才可用
--force移除315:git -C /path/to/worktree status --short git worktree remove /path/to/worktree -
刪掉本機分支:
git branch -d fix/about-typo
git branch -d 檢查的是 Git 提交是否合入 upstream 或 HEAD,不會查 GitHub PR 狀態17。squash 或 rebase merge 會改變提交關係,因此 PR 已合併,-d 仍可能拒絕18。只有確認 PR 為 MERGED、沒有後來新增或尚未保留的工作,才改用 git branch -D fix/about-typo;不要把 -D 當成遇錯就重跑的選項。
若 worktree 被鎖住,先確認沒有 session 或其他程序仍在使用它;確定是殘留鎖後,再執行 git worktree unlock /path/to/worktree 並移除3。
網路斷了或伺服器停了,session 會怎樣?
主機醒著但連不上網路時,伺服器模式大約 10 分鐘後放棄,claude remote-control 程序會結束;官方的做法是重新執行一次1。systemd 服務可以設定 Restart=always,讓程序退出後自動重啟;這是服務設定的用途,還不能當作這台主機已通過斷線恢復測試。
用 Ctrl+C 停掉伺服器後,在同一個資料夾重新執行 claude remote-control,大約四小時內可以接回原本服務的 session;前提是沒有另一個 Remote Control server 在同目錄執行,而且啟動時沒用 --no-create-session-in-dir1。若無法恢復,先檢查原本的 worktree、分支和 commit 是否仍在,再從那個 worktree 繼續,避免另開同名分支。
手機適合做什麼、不適合做什麼?
- 小改動很適合。錯字、文案、設定值、一兩個檔案的 bug,diff 在手機上一眼看得完。
- 審查留言來回很適合。留言、請 Claude 改、看新的 diff,每一輪都很短。
- 大重構不適合。幾十個檔案的 diff 在手機上看不完,也看不出結構問題;這種 PR 留到電腦前再審,手機上最多請 Claude 先開 draft PR。
- 要看畫面的改動要另外驗證。手機上看的是程式碼,不是結果;前端改動等預覽環境或回到電腦再確認。
常見問題
一定要用 Oracle 的主機嗎?
不用。符合 Claude Code 系統需求、持續開機連網的電腦都可以;Remote Control 需要主機上的程序繼續執行1。Oracle 是這次使用的主機,並非必要條件。
需要什麼 Claude 方案?
Remote Control 支援 Pro、Max、Ultra、Team 和 Enterprise 方案,不能用 API 金鑰;Team 和 Enterprise 要先由 Owner 在管理設定裡打開1。
能不能同時開好幾個 session 改同一個 repo?
可以。--spawn=worktree 下每個新 session 有自己的 worktree 和分支,檔案修改彼此隔開13。上限由 --capacity 決定;兩個 PR 改到同一段程式時,後合併的可能遇到衝突。上面的規則禁止 force push,因此已推送的分支可合併最新的 main、解決衝突,再重跑測試。
資料來源
- 1. Remote Control
- 2. Permission modes
- 3. Run parallel sessions with worktrees
- 4. How Claude remembers your project
- 5. gh pr create
- 6. gh pr checks
- 7. gh pr view
- 8. REST API endpoints for pull request review comments
- 9. GitHub Mobile
- 10. Working with pull requests on GitHub Mobile is now much easier
- 11. About rulesets
- 12. Available rules for rulesets
- 13. Approving a pull request with required reviews
- 14. Managing the automatic deletion of branches
- 15. git-worktree
- 16. Merge a pull request
- 17. git-branch
- 18. Pull request merges
- 19. Creating rulesets for a repository