错误代码13源于配置目录权限不足：Windows需重置QoderWake文件夹NTFS所有权与完全控制权限；Linux/macOS需修正用户归属、基础权限及umask设置；若仍失败，可启用内置沙盒模式临时绕过系统安全策略拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake启动或运行中突然弹出“错误代码13：配置文件读写权限被拦截”，说明程序在尝试访问用户配置目录（如AppData\Roaming\QoderWake）时被系统或安全策略明确拒绝，不是路径不存在，而是权限链被切断——此时界面可能卡在初始化阶段、记忆模块加载失败，或反复提示“请重新登录”。
检查并重置QoderWake配置目录所有权（Windows）
该方法直击核心：错误代码13在Windows下本质是NTFS ACL中缺少当前用户的“完全控制”权限，尤其常见于从管理员账户安装后切换为标准用户运行，或企业域策略强制重置了AppData继承权限。
第一步：按下Win + R，输入shell:appdata并回车，直接打开当前用户的Roaming目录。
第二步：在地址栏中将Roaming改为Roaming\QoderWake，按回车进入。若提示“你没有权限打开该文件夹”，说明权限已丢失——不要点“继续”，先执行下一步。
第三步：右键QoderWake文件夹 → “属性” → “安全”选项卡 → 点击“高级”按钮 → 顶部点击“更改”链接 → 在“选择用户或组”窗口中输入当前登录用户名（例如JohnDoe），点击“检查名称”确认后确定。
第四步：返回高级安全设置窗口，在权限条目列表中找到刚添加的用户名，双击它 → 勾选“完全控制”，确保“应用到”下拉框选的是“此文件夹、子文件夹和文件” → 点击“确定” → 弹出警告时勾选“用在此容器中的对象继承权限项”，再点“确定”。
【关键操作】若“完全控制”复选框呈灰色不可勾选，说明父级目录（如Roaming）已禁用权限继承——必须先点击左上角“禁用继承”，在弹出窗口中选择“将继承的权限转换为此对象的显式权限”，再重复第四步。
修复Linux/macOS下配置目录的用户归属与umask限制
在Linux或macOS中，错误代码13通常表现为Permission denied伴随stat ~/.config/qoderwake/config.json失败，根源常是配置目录由root创建，或系统umask设为0077导致新文件默认无组/其他用户读写权。
方法一：快速修正所有权与基础权限
在终端中执行：sudo chown -R $USER:$USER ~/.config/qoderwake → 再执行：chmod -R u+rw,go+r ~/.config/qoderwake。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法二：根治umask问题（仅限bash/zsh用户）
编辑~/.bashrc或~/.zshrc，在末尾添加一行：umask 0022 → 执行source ~/.bashrc（或source ~/.zshrc）立即生效。这能确保QoderWake后续新建的缓存文件对当前用户可读写，且组用户可读——避免下次启动又因新建skills_state.json失败而报13。
注意：不要用umask 0000，那会让所有新文件全局可写，存在安全风险。
绕过权限拦截：临时启用QoderWake配置沙盒模式
当所有权修复后仍报错13，极可能是SELinux（RHEL/CentOS）、AppArmor（Ubuntu）或macOS SIP对~/.config/qoderwake路径施加了额外策略限制，此时不建议强行关闭系统级安全模块，应改用QoderWake内置沙盒机制隔离配置读写。
第一步：关闭所有QoderWake进程，包括后台服务与CLI守护进程。
第二步：在终端中执行：qoderwake --sandbox-config --config-dir /tmp/qw-sandbox-$$（$$会自动替换为当前进程PID，确保路径唯一）。
第三步：QoderWake将完全忽略原~/.config/qoderwake，所有配置读写均发生在/tmp/下的临时目录中。若此时不再报错13，即可确认是系统安全策略拦截所致。
第四步：保留该沙盒模式作为长期方案——将上述命令保存为桌面快捷方式或别名，例如在~/.bashrc中添加：alias qwsb='qoderwake --sandbox-config --config-dir /tmp/qw-sandbox-$$'，之后只需运行qwsb即可。
