高效 AI 駕馭術
2026 一台 Oracle 主機跑多個專案,GitHub 權限怎麼分開?Claude Code Remote Control 權限隔離教學
同一台主機替好幾個專案跑 Claude Code 時,怎麼讓每個專案只碰得到自己的 GitHub repo:一個專案一個 Linux 使用者、fine-grained token/deploy key/GitHub App 怎麼選、怎麼輪換、怎麼用 rulesets 擋住直接推 main,以及主機出事時要撤銷哪些東西。
Kelvin Wang · · 11 分鐘閱讀
重點整理
- git worktree 本身不隔離權限;分開 Linux 使用者和家目錄,可以避免專案共用同一份 token 和金鑰。
- 一個專案一個 Linux 使用者、家目錄 700、不給 sudo,各自登入 Claude、各自一把只開一個 repo 的 GitHub 憑證。
- 人工把關需要 rulesets 要求 PR 與核准;用你自己的 token 開的 PR,你不能自己核准。
- 主機出事時,到 GitHub 刪 token、拿掉 deploy key、看安全紀錄;本機的 gh auth logout 不會撤銷 token。
我在東京區拿到一台 Oracle Cloud A1 主機,用 systemd 常駐 Claude Code Remote Control,GitHub 則使用 fine-grained token。若要再放第二個、第三個專案,就得先決定:每個專案的 session 能碰到哪些 GitHub repo?
以下多使用者隔離、憑證設定與撤銷步驟是依官方文件整理的做法,尚未在這台主機上測試。指令中的使用者名稱與路徑是範例,不能視為已驗證的主機設定。
同一台主機上,Claude Code session 拿得到哪些憑證?
Remote Control 的 session 跑在你的主機上,檔案存取和指令執行都在本機1。沒有額外隔離時,評估憑證能否被取得,應以執行它的 Linux 使用者權限為準:
- GitHub CLI 的登入。
gh找不到系統的憑證儲存區時,會把 token 寫成明文檔案2;在伺服器上跑一次gh auth status,就知道你的 token 存在哪裡。 - SSH 私鑰。
~/.ssh裡可能有 deploy key 或個人金鑰。GitHub 文件指出,deploy key 通常沒有密碼保護,主機被入侵時容易被拿走3。 - Claude 的登入。Linux 上預設存在
~/.claude/.credentials.json,權限 0600;若有設定CLAUDE_CONFIG_DIR,就存在該目錄下4。0600 擋的是其他使用者,擋不住同一個使用者的行程。 - 環境變數。把 token 放進
GH_TOKEN也一樣,同一個使用者的行程看得到。
personal access token 以你的身分操作,能做的事同時受你的帳號權限與 token 權限限制510。任何一個 session 出錯、被提示注入或被入侵時,這些權限就決定了可能的損害範圍。--spawn=worktree 分開工作目錄,本身不提供權限隔離。以下採用每個專案一個 Linux 使用者的方式22;容器與虛擬機也是隔離方案,不是只有這一種選擇23。
怎麼替每個專案建一個 Linux 使用者?
用有 sudo 的管理帳號(Oracle 的 Ubuntu 映像檔是 ubuntu)執行下面的步驟,proj-a 換成你的專案名稱。
-
建使用者,不設密碼。
--disabled-password不會設密碼,但不擋 SSH 金鑰這類其他登入方式6;這個使用者不需要從外面登入,你從管理帳號切過去就好:sudo adduser --disabled-password --comment "" proj-a -
家目錄設成 700。
adduser.conf的DIR_MODE決定新家目錄的權限7,但你的系統設定可能被改過,直接設一次再檢查最保險。舊的管理帳號家目錄也一起看:sudo chmod 700 /home/proj-a ls -ld /home/* -
確認它沒有 sudo。能用 sudo 取得 root 權限,就能跨過其他使用者的檔案權限。下面這行應該顯示這個使用者沒有獲准執行的 sudo 指令:
sudo -l -U proj-a -
開 linger。開了以後,這個使用者的 systemd 會在開機時啟動、登出後繼續跑,服務不需要有人登入8:
sudo loginctl enable-linger proj-a -
切過去,各自裝好、各自登入。在這個使用者底下照官方說明裝 Claude Code,跑一次
claude完成登入、信任專案資料夾,再設定這個專案自己的 GitHub 憑證(下一段選哪一種):sudo -iu proj-a
管理帳號留給維護主機,不拿來跑專案 session,避免專案取得它的管理權限。
怎麼用 systemd 替別的使用者管 Remote Control 服務?
服務檔放在那個使用者自己的 ~/.config/systemd/user/,例如 /home/proj-a/.config/systemd/user/claude-proj-a.service。沿用單一專案的服務檔時,把 WorkingDirectory 指向這個使用者擁有的 repo,ExecStart 的執行檔路徑用 %h/.local/bin/claude,後面接 remote-control --name "a1 - proj-a" --spawn=worktree。憑證也要由這個服務載入,做法見下一段。
啟用和查看服務不必每次切過去。systemctl 的 --machine 參數可以直接接到指定使用者的 user manager,使用者@ 後面省略主機名稱就代表本機9。從管理帳號執行:
sudo systemctl --user -M proj-a@ daemon-reload
sudo systemctl --user -M proj-a@ enable --now claude-proj-a.service
sudo systemctl --user -M proj-a@ status claude-proj-a.service
每個專案重複一次,就是每個專案一個使用者、一個服務、一份 Claude 登入、一組 GitHub 憑證。
每個專案該用 fine-grained token、deploy key 還是 GitHub App?
三種都能把範圍限制在一個 repo,差在能不能用 API、會不會過期、主機被入侵時丟掉的是什麼。
| 憑證 | 範圍 | 能做什麼 | 做不到什麼 | 過期 |
|---|---|---|---|---|
| Fine-grained personal access token | 一個擁有者底下選定的 repo;另外永遠能讀所有公開 repo | git push,加上勾選的 API 權限,例如開 PR | 以你的身分操作,開的 PR 作者是你,你不能自己核准 | 建立時選;組織或企業可限制最長期限 |
| Deploy key | 只有一個 repo,同一把不能用在別的 repo | git clone,勾了寫入權限就能 push | 呼叫 REST API,所以不能開 PR | 不會過期 |
| GitHub App 安裝 token | App 安裝範圍內的 repo,產生時還能再縮小 | git push 和 App 有的 API 權限;動作記在 App 名下 | 要先寫程式用 App 私鑰換 token,設定最麻煩 | 1 小時 |
表裡的細節分別來自 GitHub 的 personal access token10、REST API 驗證5、deploy key3 和 App 安裝 token1112 文件。挑選時可以這樣想:
- 只要 push,不用 API:deploy key。它用於 SSH Git 存取,不能拿來驗證 REST API,所以只有這把金鑰的 session 不能透過 API 開 PR 或合併 PR。代價是它不會過期,要自己記得換。
- 要讓 session 自己開 PR:fine-grained token,Repository access 只選這個 repo,Contents 和 Pull requests 設 Read and write,不額外開其他權限。特別是 Administration:它的寫入權限能新增、修改、刪除 rulesets,也能新增 deploy key13。
- 想要短效 token、而且由你核准 PR:GitHub App。安裝 token 1 小時就過期,PR 的作者是 App,你可以核准它。但持有 App 私鑰的人能持續簽發新 token14,不能把 token 到期當作私鑰外洩後的保護。
fine-grained token 還有適用範圍:目前不支援你只是 outside collaborator 或 repository collaborator 的 repo;組織也可能封鎖這類 token,或要求管理員核准,核准前只能讀公開資源10。替別人的專案工作時,先確認自己在該 repo 的角色,再選憑證。
GitHub App 要多看一層:換 token 時指定一個 repo,只限制那把 token。持有 App 私鑰的行程仍能替該 App 的其他 installation 換 token;省略 repo 限制時,新的 token 會取得該 installation 獲准的所有 repo12。因此,要維持專案隔離,就讓專案帳號只拿到縮限後的 token;若一定要讓它持有私鑰,App 的整個安裝範圍也必須只屬於該專案。私鑰交給外部服務保管時,簽發服務同樣要限制每個專案能要求哪些 repo。
fine-grained token 的接法採 GitHub CLI 建議的 GH_TOKEN,避免混用已儲存的登入與環境變數;GH_TOKEN 會優先於已儲存的憑證224:
- 把 token 放進專案使用者的私有檔案。例如
~/.config/claude-github.env,內容是一行GH_TOKEN=你的專案token。檔案由該使用者擁有,權限設為 0600,不放進 repo。 - 讓服務載入它。在服務檔的
[Service]加上EnvironmentFile=%h/.config/claude-github.env,修改後重新載入並重啟服務。systemd 的服務環境由 manager 與服務設定組成;只在互動 shell 執行export GH_TOKEN=…,不代表開機啟動的服務也會取得它25。 - 設定 HTTPS Git 的憑證來源。在專案使用者底下執行
gh auth setup-git --hostname github.com --force,把gh設成 credential helper26。repo 的 remote 要用不含 token 的 HTTPS URL,例如https://github.com/OWNER/REPO.git;SSH remote 不會因此改用 token27。
這樣設定後,服務啟動的 gh 和 HTTPS Git 指令會使用該服務的 token;互動 shell 若沒有載入 token,仍是另一個環境。0600 是防止其他使用者讀取,不能防止這個專案自己的 session 取得 token。App 安裝 token 也可以透過 credential helper 作為 HTTPS 密碼,但必須在到期時更新;不要把 token 寫進 remote URL11。deploy key 則使用 SSH remote3。
token 和金鑰多久換一次?
- Fine-grained token 一定設到期日。GitHub 建議每把 token 都設到期日,到期後就自動失效,只能建一把新的,不能復原15。期限也可能受組織或企業政策限制10。
- Deploy key 自己排時間換。它沒有到期日,也不會因為建立的人離開 repo 就失效3。換的方式是在主機上產生新的金鑰、加到 repo,確認能 push 後刪掉舊的。
- App 私鑰先加新的再刪舊的。一個 App 最多可以有 25 把私鑰,只有一把時必須先產生新的才能刪舊的14。
- Claude 的登入也會過期。登入有效期剩下 3 天內時,Claude Code 啟動會提醒你用
/login更新。登入到期且無法自動更新後,模型請求會失敗,直到重新登入4。常駐服務可以排固定時間,逐一切到各個使用者底下檢查登入狀態。 - 沒用的 token 直接刪。GitHub 會自動移除一年沒用過的 personal access token10,但不要等到那時候。
怎麼擋住任何人直接推 main?
token 和 deploy key 只決定「能碰哪個 repo」,不決定「能不能直接改 main」。後者交給 repo 的 rulesets。私人 repo 要 GitHub Pro、Team 或 Enterprise Cloud 才能用 rulesets,公開 repo 用免費方案就有16。
- 新增分支規則。到 repo 的 Settings → Rules → Rulesets → New ruleset → New branch ruleset17。
- 啟用規則。把 Enforcement status 改成 Active。預設是 Disabled,不改就不會生效。
- 指定保護分支。Target branches 加上預設分支。
- 要求 PR。勾 Require a pull request before merging,讓目標分支的改動必須對應到 PR18。
- 禁止強制推送與刪除。確認 Block force pushes 和 Restrict deletions 有勾,這兩條預設就是勾的18。
- 不留繞過規則的身分。Bypass list 留空,規則才會對每個人都有效。
這樣會擋住沒有對應 PR 的 main 更新。Require a pull request 只要求 PR 存在,不要求有人核准,也不等於禁止所有形式的直接推送:符合規則、對應既有 PR 的 merge commit 仍可能經由 Git 推上去18。合併 PR 的 API 使用 Contents 寫入權限13,因此同時有開 PR 與合併權限的 session,仍可能自己開 PR、自己合併。
要由人把關,還要設定需要核准的人數,並啟用 Dismiss stale pull request approvals when new commits are pushed,避免核准後新增的變更沿用舊核准18。PR 作者不能核准自己的 PR19,因此憑證的選擇會影響流程:
- 用 deploy key:session 可以推分支,但不能用這把 key 呼叫 API 開 PR 或合併 PR。你可以負責開 PR 與合併;若要強制人工核准,仍須設定核准規則,不能只靠 key 的種類。
- 用你的 fine-grained token:PR 作者是你,要求核准會連你自己都卡住。只有你一個審核者時,單開 Require a pull request 可以保留 PR 流程,但不保證每次都有人工把關。
- 用 GitHub App:PR 作者是 App,你可以核准,最適合加上核准人數。
主機被入侵時要撤銷哪些東西?
懷疑主機被入侵時,先假設主機上每個使用者的憑證都已經被複製。在主機上執行 gh auth logout 只會刪掉本機的設定,不會撤銷 token20,所以每一步都要到 GitHub 和 claude.ai 上做。
- 刪掉 fine-grained token。Settings → Developer settings → Personal access tokens → Fine-grained tokens,每個專案的 token 按 Delete10。
- 拿掉 deploy key。到每個 repo 的 Settings → Deploy keys 刪掉這台主機用的金鑰。
- 換掉 GitHub App 私鑰。私鑰放在主機上的話,在 App 設定裡產生新私鑰、刪掉舊的14;已經發出去的安裝 token 最多 1 小時就過期11。
- 看安全紀錄。頭像 → Settings → Archives 裡的 Security log,列出最近 90 天的帳號活動,fine-grained token 和 SSH 金鑰都有自己的分類,可以篩選後匯出 JSON 或 CSV21。
- 檢查 repo。看有沒有不認得的分支、PR、commit,rulesets 是不是還開著、Bypass list 有沒有被加人。
- 處理 Claude 的登入。有開 Trusted Devices 的話,到 claude.ai 的 Settings → Account → Trusted devices 移除舊裝置,裝置憑證會立刻失效1。這不能直接當作已複製的 CLI 登入憑證也已撤銷;目前引用的文件不足以確認個人帳號的完整撤銷方式。新主機上的每個使用者都要重新
/login,但重新登入本身不代表舊憑證已失效。
常見問題
一個專案一個 Linux 使用者,會不會太麻煩?
只有一個專案、或幾個專案本來就用同一組權限時,一個使用者就夠了。專案屬於不同的人、不同的 GitHub 擁有者,或其中一個 repo 特別重要時,就值得分開。多出來的工作是每個使用者各裝一次 Claude Code、各登入一次,服務管理用上面的 systemctl --user -M 就能在管理帳號一起處理。
用 git worktree 不就把專案分開了嗎?
worktree 分開的是工作目錄和分支,不是權限。同一個使用者底下,所有 worktree 的 session 讀得到同一份 ~/.config/gh 和 ~/.ssh。
fine-grained token 選了 Only select repositories,就碰不到其他 repo 了嗎?
沒有選到的私人 repo 不能靠這把 token 存取,但 fine-grained token 永遠能讀所有公開 repo10。它也只能選一個擁有者;自己的 repo 和有成員資格的組織 repo 要分開建 token,仍須符合前面提到的組織政策與角色限制。
想深入 2026 Oracle Cloud 免費 ARM 主機怎麼搶?常駐 Claude Code + Git repo 合作流程解析 從搶到 A1 主機、systemd 常駐 Remote Control,到接上 GitHub。資料來源
- 1. Remote Control
- 2. gh auth login
- 3. Managing deploy keys
- 4. Authentication
- 5. Authenticating to the REST API
- 6. adduser(8)
- 7. adduser.conf(5)
- 8. loginctl
- 9. systemctl
- 10. Managing your personal access tokens
- 11. Authenticating as a GitHub App installation
- 12. Generating an installation access token for a GitHub App
- 13. Permissions required for fine-grained personal access tokens
- 14. Managing private keys for GitHub Apps
- 15. Token expiration and revocation
- 16. About rulesets
- 17. Creating rulesets for a repository
- 18. Available rules for rulesets
- 19. Approving a pull request with required reviews
- 20. gh auth logout
- 21. Reviewing your security log
- 22. 一台主機跑多個 Claude Code Remote Control:Linux user、systemd 與 git worktree 分工
- 23. Sandboxing
- 24. gh environment
- 25. systemd.exec(5)
- 26. gh auth setup-git
- 27. gitcredentials