codex 读取本地文件需三步：开启「本地文件系统访问」权限，skill.md 中声明 allowed-tools: read，再用绝对路径、相对路径或 argument-hint 指定文件；否则仅能访问对话上下文和 assets/ 目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Codex 中让 Skill 读取你电脑上已有的 Markdown 笔记、API 文档、数据库 Schema 或项目配置文件，必须明确告诉 Codex 这些文件的路径和访问权限，否则它默认只能看到当前对话上下文和 skill 自带的 assets/ 目录内容。
确认 Codex 是否具备本地文件读取能力
打开 Codex 客户端 → 点击左下角设置图标 → 进入「安全与权限」→ 查看「本地文件系统访问」是否已开启。若为灰色禁用状态，【必须先勾选并重启 Codex】，否则后续所有路径配置都无效。
在 SKILL.md 中声明可读文件路径
进入你的 Skill 文件夹（例如 C:\Users\HUAWEI\.codex\skills\api-debugger\），用文本编辑器打开 SKILL.md。
在 YAML frontmatter 区域（即 --- 包裹部分）添加 allowed-tools: Read，这是硬性前提——没有这一行，Codex 不会允许任何文件读取操作。
在描述或执行步骤中，用绝对路径或相对路径明确写出目标文件。推荐优先使用绝对路径，避免因工作目录切换导致读取失败。例如：
## 执行步骤<br>1. 从 <code>C:\my-projects\backend\src\config\database.json</code>读取数据库连接参数
2. 将 host 和 port 注入到调试命令中
三种安全可用的本地文件引用方式
方法一：直接写绝对路径（最常用）
在 SKILL.md 的执行步骤里直接写明完整路径，如：读取 C:\Users\HUAWEI\Documents\api-specs\v3.yaml。Codex 会自动识别该路径并尝试加载。注意路径中的反斜杠 \ 不需要转义，但空格和中文路径名完全支持。
方法二：用相对路径 + skill 根目录为基准
把待读文件放进 skill 文件夹内，例如放在 api-debugger/references/openapi.yaml，然后在步骤中写：读取 ./references/openapi.yaml。这种写法不依赖用户电脑结构，适合分发给他人使用的 Skill。
方法三：通过 argument-hint 动态传入路径
在 YAML frontmatter 中加入：argument-hint: [配置文件路径]
这样用户调用时就能手动指定，比如输入：$api-debugger C:\temp\custom-config.json。Codex 会把该字符串当作变量注入执行流程，技能脚本中可用 {{arg0}} 引用。
验证文件是否成功加载
第一步：在 Codex 对话框中输入 /skills → 确认你的 Skill 已出现在列表中。
第二步：输入 $your-skill-name（例如 $api-debugger）→ 观察 Codex 是否立即报错 “File not found” 或 “Permission denied”。如果出现前者，说明路径写错；如果出现后者，说明 allowed-tools: Read 缺失或权限未开启。
第三步：若无报错但返回空内容，检查文件编码是否为 UTF-8（非 ANSI 或 GBK），Codex 当前仅可靠解析 UTF-8 编码的文本文件。
