错误：Permission denied 排查指南

当使用 MCP filesystem 工具访问文件时，如果遇到 "Permission denied" 错误，说明操作系统层面的权限不足。

错误原因

1. 文件权限不足（不可读/不可写）
2. 目录权限不足（无法进入目录）
3. 文件被其他进程锁定
4. 操作系统安全策略限制

排查步骤

第一步：检查文件权限

ls -la /path/to/file

权限位说明：

• 第 1 位：文件类型
• 第 2-4 位：所有者权限（rwx）
• 第 5-7 位：组权限
• 第 8-10 位：其他用户权限

第二步：检查目录权限

ls -ld /path/to/directory

目录需要执行权限（x）才能进入。

第三步：修复文件权限

# 添加读权限
chmod u+r /path/to/file

# 添加写权限
chmod u+w /path/to/file

# 设置标准权限（644）
chmod 644 /path/to/file

第四步：修复目录权限

# 设置目录权限（755）
chmod 755 /path/to/directory

# 递归修复整个项目
chmod -R 755 /path/to/project

第五步：检查文件锁定

# 检查文件是否被占用
lsof | grep /path/to/file

# 关闭占用进程
kill -9 <PID>

第六步：检查 macOS 特殊权限

完全磁盘访问权限

• 系统设置 → 隐私与安全 → 完全磁盘访问权限
• 确保 Claude Code 有权限

权限参考表

权限数字	文件权限	目录权限
644	rw-r--r--	-
755	rwxr-xr-x	rwxr-xr-x
600	rw-------	-
777	rwxrwxrwx	rwxrwxrwx

常见问题

Q: 为什么 chmod 后还是 Permission denied？
A: 可能原因：1) 目录权限不足；2) 文件被锁定；3) 需要递归修改。

Q: 如何批量修复权限？
A: 使用 find 命令：

find /path/to/project -type f -exec chmod 644 {} \;
find /path/to/project -type d -exec chmod 755 {} \;

Q: macOS 提示 "Operation not permitted"？
A: 给 Claude Code 完全磁盘访问权限。

验证修复

1. 检查文件权限：ls -la /path/to/file
2. 检查目录权限：ls -ld $(dirname /path/to/file)
3. 测试读取文件：cat /path/to/file
4. 重启 Claude Code

下一步

• 文件系统工具配置指南
• Path not allowed 错误排查