先说结论：Codex 插件安装失败，根本原因往往是其默认的数据目录位于 C 盘用户文件夹下。特别是当您的 Windows 用户名包含中文字符，或者系统启用了“受控文件夹访问”防护时，极易因权限冲突或路径识别问题导致安装过程被拦截。 首先，请打开 PowerShell（无需管理员权限），执行以下命令来检查当前配置：codex config get marketplace_dir。如果该命令返回空值或直接报错，则表明 Codex 正在使用其默认的存储路径：C:Users你的用户名.codexmarketplace。您可以手动访问此文件夹，右键查看其“属性”→“安全”选项卡，确认其中名为“Authenticated Users”的用户组是否拥有“写入”权限。若没有，请参照下文提供的修复方案进行操作。 具体而言，Windows 安全中心内置的“受控文件夹访问”功能会严格监控并阻止非常规进程对受保护文件夹的写入操作。当路径中包含非 ASCII 字符（如中文）时，拦截和报错的发生率会显著增高。我们按照推荐顺序提供三种解决方案。 ### 方法一：更改插件目录路径（推荐首选） 此方案旨在彻底规避系统盘权限问题。**请注意，必须在管理员权限的 PowerShell 中执行以下命令，方能生效。** codex config set marketplace_dir "D:codex-marketplace" mkdir D:codex-marketplace icacls D:codex-marketplace /grant Users:(OI)(CI)F **重要提示**：不建议将新目录设置在 C 盘（例如 `C:temp`）。即使是非用户目录，Windows Defender 的受控文件夹访问仍有可能拦截对 C 盘非标准位置的写入。将目录设置在 D 盘（或其他非系统盘）根目录下，是目前最稳定可靠的方案。 ### 方法二：临时关闭受控文件夹访问（适用于确认系统环境安全时） 如果您能确保当前计算机环境安全，可尝试临时关闭此防护功能。按下 `Win + R` 组合键，运行命令 windowsdefender://advancedsettings，进入“病毒和威胁防护”的高级设置页面，找到“勒索软件防护”并关闭“受控文件夹访问”的开关。之后，请重启终端并再次尝试运行 codex plugin add 命令。若问题依旧，则表明根源并非 Defender，而是用户目录本身存在权限不足问题，此时应转而采用方法一。 ### 方法三：修复原目录权限（适用于英文用户名环境） 如果您的 Windows 用户名由纯英文字符组成，可以尝试直接修复默认目录的访问控制列表来解决问题。 操作步骤如下： 第一步：使用管理员身份运行 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，因为更早的旧版本存在 marketplace 目录路径被硬编码而无法通过配置修改的已知缺陷，必须升级至最新版本。 至此，问题应已得到解决。希望这份详尽的 Codex 插件安装问题排查与修复指南能够帮助您。如果您恰巧通过本文解决了困扰，欢迎点赞支持——因为下一次您可能遇到的安装难题，或许答案就在这里。