核心症结在于 Codex 插件默认存放在 C 盘用户目录下。当中文用户名与 Windows “受控文件夹访问”功能同时存在时,路径与权限冲突将导致插件安装失败。
定位问题路径:在 PowerShell 中执行
codex config get marketplace_dir。
若输出为空或报错,则表明 Codex 正在使用默认路径:C:Users你的用户名.codexmarketplace。请通过资源管理器手动访问此文件夹,右键查看属性 → 安全 → 检查“Authenticated Users”组是否拥有“写入”权限。
“受控文件夹访问”功能会拦截跨进程写入操作,若用户目录包含非 ASCII 字符,触发拦截的概率极高。请按以下顺序尝试修复。
### 方法一:重新配置插件目录
这是首选且一劳永逸的方案。请在以管理员身份运行的 PowerShell 中执行以下命令:
codex config set marketplace_dir "D:codex-marketplace"
mkdir D:codex-marketplace
icacls D:codex-marketplace /grant Users:(OI)(CI)F
**关键提示**:避免将新目录设置在 C 盘任何位置,包括临时文件夹。Windows Defender 对 C 盘非系统目录的写入监控依旧严格,D 盘根目录的权限配置通常最直接有效。
### 方法二:临时禁用受控文件夹访问
如果确定系统环境安全,可临时关闭此防护功能进行排查。按下 Win+R 键,运行 windowsdefender://advancedsettings,在“勒索软件防护”设置中关闭“受控文件夹访问”。关闭所有终端窗口后重新打开,再次尝试 codex plugin add 命令。若问题依旧,则证明根源在于目录本身权限,而非实时防护,应切回方法一。
### 方法三:修复原有目录的访问控制列表(ACL)
此方法适用于系统用户名仅为英文字母与数字组合的情况。请使用管理员权限的 PowerShell 执行:
第一步:替换下面命令中的 YOUR_USERNAME 为你的实际用户名。
icacls "C:UsersYOUR_USERNAME.codexmarketplace" /reset /T /C /Q
第二步:授予当前用户完全控制权限:
icacls "C:UsersYOUR_USERNAME.codexmarketplace" /grant "%USERNAME%":(F) /T
第三步:测试目录写入能力:
echo test > "C:UsersYOUR_USERNAME.codexmarketplacetest.txt" && del "C:UsersYOUR_USERNAME.codexmarketplacetest.txt"
若无任何错误提示,说明目录权限已修复。
### 验证最终修复成果
执行插件安装命令以确认问题已解决:
codex plugin add vercel@openai-curated
观察输出中是否出现 Plugin installed successfully 字样。如果此时仍报错,请检查 Codex CLI 版本:codex --version。版本号低于 26.519.81530 的旧版本存在路径硬编码问题,必须更新至最新版本才能完全解决。