結論先說
- 權限要授給「宿主應用」而不是
claude命令本身:macOS 的私隱保護(TCC)按父進程識別身份——你在 iTerm2 裏跑就去勾選 iTerm2,在 VS Code 內置終端跑就去勾選 Visual Studio Code,用桌面版就勾選 Claude。 - 代碼別放桌面和文稿目錄最省心:把倉庫建在
~/Projects或~/Code下無需觸發受保護目錄彈窗;只有放在「桌面」「文稿」「下載」裏才需要開「文件和文件夾」權限,一般不必盲目全開「完全磁盤訪問權限」。 - 局域網與容器連不通查「本地網絡」:macOS 15 及以上對訪問內網 IP 與本地端口新增了獨立攔截,需在「私隱與安全性 > 本地網絡」放行所用終端或 IDE。
- 輔助功能與麥克風按需最小化開啟:純終端改代碼不需要輔助功能,只有跑桌面自動化腳本(
osascript/ Computer Use)或用/voice語音輸入時才會分別請求輔助功能與麥克風。 - 開通與額度補充入口:Mac 端桌面版與終端 CLI 共用付費訂閱配額;國內無外幣卡用戶可在 Claude Code 訂閱專頁、免密兌換的 Claude Pro iOS 卡密 或 Claude Pro 自助充值 開通。

圖:本站根據 Apple 官方手冊:控制對文件和文件夾的訪問 與 Claude Code 文檔整理的示意圖
本文根據 Claude Code 官方文檔《Troubleshooting》《Claude Code on desktop》及 Apple 官方 macOS 使用手冊整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 在 Mac 上跑 Claude Code 讀項目或執行
git status時報Operation not permitted(EPERM)的人; - 升級 macOS Sequoia 後連不上局域網測試庫或本地 MCP 服務、反覆彈出「本地網絡」攔截框的人;
- 看到彈出「輔助功能」或「完全磁盤訪問權限」申請心裏沒底,不知道該給哪個軟件開開關的開發者。
一、四類 macOS 私隱權限彈窗與報錯對照
很多開發者一看到 EPERM: operation not permitted 就直接去開最高級別的「完全磁盤訪問權限」,其實既沒必要又擴大了風險面。按報錯特徵對號入座即可:
| 報錯或彈窗表現 | 對應系統設定路徑(私隱與安全性) | 觸發原因與建議做法 |
|---|---|---|
讀桌面/文稿項目報 Operation not permitted | 文件和文件夾(Files and Folders) | 代碼放在受保護文件夾;給宿主終端勾選對應子目錄,或把倉庫挪到 ~/Code |
| 需跨目錄掃描系統日誌或電郵容器 | 完全磁盤訪問權限(Full Disk Access) | 僅在確需排查系統受保護路徑時臨時給終端開啟,用完建議關回 |
| 連內網測試庫或本地調試服務超時被拒 | 本地網絡(Local Network) | macOS Sequoia 攔截了局域網探測;打開你所用終端或 IDE 的開關 |
| 控制桌面軟件點擊、截屏或語音聽寫無聲 | 輔助功能 / 螢幕錄製 / 麥克風 | 僅桌面自動化或 /voice 聽寫需要,純寫代碼被彈窗先檢查執行了什麼命令 |
如果你同時安裝了桌面客戶端,客戶端的安裝與基礎設定見 Claude 桌面版下載與配置指南;桌面操控類權限的通用說明也可對比 Computer Use 常見 macOS 權限排查。
二、標準放行四步法(避開改完不生效的坑)
在 macOS 上點了開關卻依然報權限被拒,通常是因為勾錯了宿主或沒徹底重啟應用。請嚴格按下面四步操作:

圖:本站根據 Claude Code 官方文檔:Troubleshooting 整理的示意圖
- 確認當前宿主程序是誰:看螢幕左上角選單欄緊挨蘋果圖標的應用名稱(例如
Terminal、iTerm2、Warp、Code或Cursor); - 打開系統設定精準勾選:進入「系統設定(System Settings)> 私隱與安全性(Privacy & Security)」,點進對應分類(如「文件和文件夾」或「本地網絡」),找到剛才確認的宿主應用打開開關;
- 徹底退出並重開宿主應用:在 Dock 欄右鍵該終端或 IDE 選擇「退出(Quit)」(快捷鍵
Cmd + Q),只關掉單個標籤頁不會刷新 macOS 權限令牌; - 重新進入項目運行自檢:重開終端進入倉庫目錄,執行
claude doctor核對本地讀寫與網絡連通狀態。
Mac 開發者訂閱與帳號準備提示:在 Mac 上同時用 VS Code 終端跑 Claude Code 與桌面端跑多工作樹並行任務時,兩處會共享扣減同一帳號的 5 小時及周度額度。日常全職開發若覺得 Pro 檔配額吃緊,可通過 Claude Max 訂閱升級 或選購 Claude Max 會員服務 提升至 5 倍額度。
三、區分「macOS 系統攔截」與「Claude 內置權限攔截」
排查時還要分清報錯到底來自蘋果系統還是 Claude 自己的安全規則:
- 蘋果系統 TCC 攔截:終端底層直接拋出
EPERM: operation not permitted或 macOS 彈出系統級對話框,按上面兩節去「系統設定」放行; - Claude Code 內置權限攔截:介面提示某個工具被
deny規則拒絕或反覆詢問是否允許運行,這是.claude/settings.json管的事,配置方法見 Claude Code 權限模式詳解; - 語音輸入沒聲音:開啟
/voice按住空格說話沒反應時,去「私隱與安全性 > 麥克風」給所用終端放行即可,詳見 Claude Code 語音輸入開啟條件。
常見問題
問:系統設定列表裏找不到我正在用的終端軟件怎麼辦?
答:點列表左下角的 + 號(輸入 Mac 鎖屏密碼解鎖後),在「應用程式(Applications)」目錄裏手動選中你用的終端或編輯器添加進去。
問:升級 macOS 系統後原來好用的本地網絡權限突然失效了怎麼辦?
答:大版本更新後系統權限緩存偶發失步。可在列表裏先把對應終端的開關關掉,等三秒再重新打開,然後按 Cmd + Q 重啟終端。
問:為什麼不建議把代碼倉庫放在 iCloud 雲盤同步的「文稿」裏?
答:除了每次換編輯器都要觸發 macOS 文件夾權限審批外,iCloud 自動驅逐本地文件(僅保留雲端佔位符)還會導致 node_modules 或 .git 讀取卡死。建議統一建本地 ~/Code 目錄。
問:國內 Mac 開發者沒有外幣卡,怎麼開通訂閱並開具報銷發票?
答:可通過本站 Claude Code 訂閱專頁 或 AI 會員充值總覽 選購,支持支付寶、微信支付與 AlipayHK,提供免交密碼的卡密自助兌換,企業採購支持開具國內增值稅發票。實時價格與售後細則以頁面為準:訂閱期內非違規掉訂閱按剩餘天數折退,風控封號不在質保範圍。
相關教學
- Claude 桌面版下載安裝(Windows / Mac)
- Claude Code 權限模式詳解:auto、plan 與規則配置
- Claude Code 支持語音輸入嗎:/voice 開啟與麥克風要求
- Computer Use 常見地區與 macOS 權限說明
參考資料
- Claude Code 官方文檔:Troubleshooting — https://code.claude.com/docs/en/troubleshooting
- Claude Code 官方文檔:Claude Code on desktop — https://code.claude.com/docs/en/desktop
- Apple 官方支持:控制對 Mac 上文件和文件夾的訪問 — https://support.apple.com/guide/mac-help/control-access-to-files-and-folders-on-mac-mchld5a35146/mac
0 條評論
還沒有評論,來搶沙發~