本文处理的是客户端本地权限问题，例如文件读写被拒绝、命令执行被拒绝、Claude Code permission 规则误拦截。若你遇到的是 API 返回 401、403、503，请优先查看「认证与 API Key 类问题」和「请求错误类问题」。

​
先区分两类权限

类型常见表现优先查看
本地权限permission denied、无法读写文件、命令被拒绝本文
API/分组权限401、403、503、模型不可用、当前分组没有该模型认证与请求错误文档
503 在卡特 Token 站通常表示当前分组没有该模型，不是本地文件权限问题。

​
Permission denied：文件读写被拒绝

常见现象： 
permission denied
EACCES: permission denied
operation not permitted
先查看目标文件或目录权限： 
ls -la /path/to/file
ls -la /path/to/directory
常见修复： 
chmod 644 /path/to/file
chmod 755 /path/to/directory
如果文件属于其他用户，先确认你是否真的应该修改它。不要对系统目录或不理解的目录直接递归 chmod。

​
项目目录不可写

如果 Claude Code 或 Codex 可以启动，但无法创建、修改或删除项目文件，通常是项目目录权限问题。 检查当前目录： 
pwd
ls -la
确认你是在自己的项目目录中启动客户端，而不是在系统目录、只读目录、下载的压缩包临时目录或挂载的只读磁盘里。 macOS 上如果项目在桌面、文稿或下载目录，系统隐私权限也可能拦截终端访问。可以到： 
系统设置 -> 隐私与安全性 -> 文件和文件夹 / 完全磁盘访问权限
给你的终端应用授权后重试。

​
Claude Code 权限规则误拒绝

Claude Code 对文件操作、shell 命令等动作有权限确认机制。首次触发时可能让你选择：
  • 允许一次。
  • 总是允许。
  • 总是拒绝。
如果误选了“总是拒绝”，后续同类操作会直接被阻断。 处理方式：
  • macOS 按 Cmd+Shift+P。
  • Windows / Linux 按 Ctrl+Shift+P。
  • 搜索 Claude: Manage Permissions。
  • 找到被拒绝的规则，改成“询问”或“允许”。
改完后重新执行刚才失败的操作。

​
.claudeignore 误匹配

如果只有某些文件 Claude Code 看不到或不能操作，检查项目根目录是否有 .claudeignore： 
cat .claudeignore
常见问题：
  • 通配符太宽，例如 *、**/*。
  • 忽略了整个源码目录。
  • 复制了其他项目的 ignore 规则。
  • 把需要修改的配置文件也忽略了。
建议使用精确路径，不要用过宽通配符。修改后重启 Claude Code。

​
skipAutoPermissionPrompt 导致行为异常

如果你在 ~/.claude/settings.json 中加入过： 
{
  "skipAutoPermissionPrompt": true
}
并且随后出现 Plan 模式、工具调用或权限确认异常，建议先移除这一项，保存后重启终端和 Claude Code。 权限相关配置不要随意照抄。每次修改后，建议用一个小任务测试文件读取、文件写入和命令执行是否正常。

​
Windows 执行策略不是文件权限

Windows PowerShell 报错： 
running scripts is disabled on this system
这不是 API 权限，也不是文件 chmod 问题，而是 PowerShell 执行策略。以管理员身份打开 PowerShell，执行： 
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
然后关闭并重新打开 PowerShell。

​
Codex 沙箱或审批限制

Codex 可能在沙箱或审批模式下运行。表现为：
  • 不能写某些目录。
  • 执行命令前需要确认。
  • 网络访问或危险命令被限制。
处理方式：
  • 确认你在项目目录中启动 Codex。
  • 避免让 Codex 修改项目外的系统目录。
  • 对需要人工确认的命令，先理解命令含义再批准。
  • 如果是在受管环境中运行，按团队安全策略配置沙箱权限。

​
不要用管理员权限掩盖问题

遇到权限问题时，不建议第一时间用管理员、root 或 sudo 运行整个客户端。这样可能导致：
  • 生成的文件归 root 或管理员所有。
  • 后续普通用户无法修改项目文件。
  • 客户端获得过高权限，风险更大。
更好的做法是修复项目目录权限，或把项目移动到当前用户拥有的工作目录。

​
排障时提供什么

联系客服时请提供：
  • 操作系统。
  • 客户端：Claude Code、Codex 或其他。
  • 具体报错文本。
  • 失败的是文件读取、文件写入、命令执行，还是 API 请求。
  • 项目目录路径。
  • ls -la 或 Windows 文件属性截图。
不要发送完整 API Key。