结论先说
- 权限要授给「宿主应用」而不是
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 条评论
还没有评论,来抢沙发~