必须修改codex默认技能路径以避免c盘爆满并支持共享协作:先在%userprofile%.codex下创建config.toml配置skills.directory为d:/codex-skills(正斜杠、无尾斜杠),重启客户端生效;项目级可单独建.gitignore友好的.project/.codex/skills;cli安装推荐用--local参数或改npm prefix。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想把Codex技能统一存到D盘或自定义路径,避免C盘爆满、方便多项目共享或团队协作,就必须改掉默认的C:\Users\用户名\.codex\skills硬编码路径。
修改用户级默认安装路径(推荐)
这一步直接决定新装技能往哪放,不改它,所有手动或命令行安装都会继续往C盘塞。
第一步:打开文件资源管理器,在地址栏粘贴 %USERPROFILE%\.codex → 回车进入该目录。
第二步:在该目录下新建或编辑 config.toml 文件(若不存在就新建一个),用记事本或VS Code打开。
第三步:写入以下内容并保存:
[skills]enabled = truedirectory = "D:/codex-skills"[features]skills = true
【注意】斜杠必须用正斜杠 /,不能用反斜杠 \,否则Codex会加载失败。路径末尾不要加斜杠,比如写成 D:/codex-skills/ 会导致技能无法识别。
第四步:重启Codex客户端——这是强制要求,配置文件只在启动时读取一次。
项目级技能路径(按需启用)
当你只想让某个特定项目(比如电商分析脚手架)独享一套技能,不污染全局环境,就用这个路径。
在你的项目根目录下,创建 .codex/skills/ 文件夹(注意前面有个点)。
把技能文件夹(含SKILL.md)直接丢进去就行,无需改任何配置。
下次在该项目内打开Codex对话窗口,自动优先加载这个路径下的技能,比用户级路径优先级更高。
系统级路径与CLI安装路径适配
如果你用的是npm全局安装的Codex CLI(npm install -g @openai/codex),它的默认技能路径是 ~/.codex/skills,也就是用户级路径。
方法一:改npm全局前缀(影响所有全局包)
执行:npm config set prefix "D:\npm-global" → 再重装Codex CLI → 技能自然落到D盘对应位置。
方法二:用 --local 参数强制走项目级路径
运行:codex skill-installer --local → 它会把技能装进当前目录的 .codex/skills/ 里,完全绕过用户级配置。
【关键提醒】不要直接剪切已存在的 .codex 文件夹挪位置——注册表和缓存指向旧路径,会导致技能加载为空白或报错“no skills found”。











