codex 启动后找不到 skills 目录是因为首次运行未初始化导致 .codex 隐藏目录未创建,需手动执行 mkdir -p ~/.codex/skills(macos/linux)或在 %userprofile% 下创建 .codex\skills(windows),再配置 config.toml 启用 skills 并重启生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex 启动后找不到 skills 目录,导致自定义 Skill 无法加载、$skill 命令报错“未找到该 skill”,甚至 Skills 插件面板空白——这不是配置错误,而是目录压根没被创建出来。
确认 Codex 是否已初始化技能目录
打开终端或命令提示符,直接执行:
Windows: dir %USERPROFILE%\.codex\skills
macOS/Linux: ls ~/.codex/skills
如果返回“系统找不到指定的路径”或“No such file or directory”,说明 【.codex 目录尚未生成】——这通常发生在首次安装 Codex 后从未启动过 UI 或 CLI,或启动时未触发技能系统初始化。
手动创建标准技能目录结构
进入用户主目录,按操作系统创建完整路径:
Windows:
在资源管理器地址栏粘贴:%USERPROFILE%\.codex\skills → 回车 → 点击“新建文件夹”,依次创建 .codex → 进入 → 新建文件夹 skills
macOS/Linux:
终端中逐级执行:mkdir -p ~/.codex/skills
⚠️ 注意:【必须是 .codex(点开头)隐藏目录】,不能写成 codex 或 Codex;skills 必须是其子目录,不能放在桌面或文档里。
验证并激活技能系统
第一步:确保 config.toml 存在且启用技能
若 ~/.codex/config.toml 不存在,用文本编辑器新建该文件,写入以下两行:
[skills]enabled = true
第二步:重启 Codex Desktop 或重新运行 codex CLI 命令
此时 Codex 会识别到 skills 目录存在,并开始扫描其中的 Skill 文件夹。
第三步:放入一个合法 Skill 测试
新建文件夹 ~/.codex/skills/test-skill/,在其内创建 SKILL.md,内容至少包含:
---name: test-skilldescription: A minimal valid skill---
保存后重启 Codex,再点击 Skills 插件 → 刷新,应能看到 test-skill 出现在列表中。











