1. 当 Codex 的 Skills 开始处理 Word 和 PDF模型通道得先配通Codex 的 Skills 是这套工具里最容易被低估的一块。它把指令、资源和脚本打包成一个可复用的能力单元官方示例里已经覆盖了创建和编辑 PDF、电子表格、Word 文档、演示文稿这类非代码文件。换句话说你不需要会写 Python 去操作 docx只要 Skill 里定义好了流程Codex 就能按步骤把一份会议记录整理成一页纪要或者把一堆表格数据汇总成经营结论。但这里有个前置条件经常被忽略Skills 本身只是“怎么做”的说明书真正执行时还是要调用模型。模型通道没配好Skill 写得再漂亮也跑不起来。我见过不少人卡在这一步Skill 装好了一执行就报 401或者路径里莫名其妙多出/v1折腾半天以为是 Skill 的问题其实是config.toml里的 Base URL 没填对。这篇就按“Skill/MCP 视角”来写目标很明确让你在 Codex 里配好 TaoToken 的模型通道然后让 Skills 真正跑起来处理 PDF、表格和 Word 类办公任务。TaoToken 在这里只做一件事——提供 Key 和 Base URLWord/PDF 的编辑仍然由 Codex 的 Skills 自己执行。分工清楚排障才不会乱。适合谁看已经在用 Codex、想用 Skills 处理办公文档但模型调用没配通的人或者刚接触 Codex、想从“能跑起来”开始的人。下面从注册拿 Key 到改config.toml再到验证请求和排错一步步来。2. 前置准备TaoToken 的 Key 和 Base URL 怎么拿TaoToken 在这个流程里的角色是模型通道。你从它这里拿到两样东西一个 API Key一个 Base URL。Codex 的 Skills 在执行时会通过这个 Base URL 去请求模型Key 用来鉴权。先打开官网注册https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 。注册流程不复杂邮箱加密码就能进控制台。进去之后找 API Keys 页面创建一个新的 Key。创建时建议给 Key 起个能认出来的名字比如codex-skills-office后面如果有多个项目方便区分。创建完 Key 之后把它复制出来。注意Key 只在创建时完整显示一次关掉页面就看不到了所以先存到安全的地方。如果你习惯用密码管理器直接存进去如果只是临时测试至少别丢在聊天记录里。Base URL 这块要记牢https://taotoken.net/api。不带/v1不加任何 UTM 参数。这一点后面排错会反复提到因为 Codex 的配置对路径比较敏感多一段少一段都会导致请求失败。注意TaoToken 只提供 Key 和 Base URL不参与 Word/PDF 的实际编辑。文档处理是 Codex Skills 的职责模型通道只负责让 Skill 能调用到模型。拿到这两样东西之后就可以进 Codex 的配置文件了。如果你还没装 Codex先去装好确保codex命令能在终端里跑起来。装好之后配置文件一般在用户目录下的.codex/config.tomlWindows 上类似C:\Users\你的用户名\.codex\config.toml。找不到的话在终端里跑一次 Codex它通常会自动生成默认配置。3. 可复制配置config.toml 里改哪几行Codex 的config.toml是 TOML 格式结构不复杂。你要改的核心是模型通道的 Base URL 和 API Key。下面给一份可以直接参考的配置片段你按自己的实际情况替换 Key 就行。# ~/.codex/config.toml # 模型通道配置 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY # 默认模型按你实际可用的填 model gpt-4o # Skills 相关确保 Skills 目录被加载 [skills] enabled true这里有几个点要解释清楚。base_url填的是https://taotoken.net/api注意结尾没有斜杠也没有/v1。env_key指定的是环境变量名也就是说 Key 不直接写在配置文件里而是通过环境变量传入。这样做的好处是配置文件可以分享、可以进版本管理Key 不会泄露。设置环境变量的方式Linux/macOS 下在~/.bashrc或~/.zshrc里加一行export TAOTOKEN_API_KEY你的TaoToken KeyWindows PowerShell 下$env:TAOTOKEN_API_KEY你的TaoToken Key如果想永久生效Windows 可以用setxsetx TAOTOKEN_API_KEY 你的TaoToken Key设置完记得重开终端或者source一下配置文件让环境变量生效。验证环境变量有没有生效可以跑echo $TAOTOKEN_API_KEYWindows PowerShell 下echo $env:TAOTOKEN_API_KEY能打印出你的 Key 就说明设置成功了。如果打印为空检查一下是不是写错了变量名或者终端没重开。配置里的model字段按你实际能用的模型填。TaoToken 支持的模型列表可以在控制台或者文档里查填一个你确认可用的。[skills]段是确保 Skills 功能被加载如果你的 Codex 版本里 Skills 默认开启这段可以不加但加上更稳妥。改完配置之后建议先跑一个最简单的请求确认模型通道通了再去折腾 Skills。下一节就讲怎么验证。4. 验证请求让 Codex 读一份 PDF 生成会议纪要配置改完先别急着上复杂的 Skill。用一个最小可验证的任务来确认模型通道通了让 Codex 读取一份 PDF然后生成一页会议纪要。这个任务同时验证了两件事——模型调用是否成功以及 Skills 处理非代码文件的能力是否正常。准备一份测试用的 PDF随便什么内容都行比如一份产品需求文档或者会议记录。放到一个工作目录里然后在终端里进到这个目录启动 Codex。如果你是用命令行方式可以这样cd ~/test-codex-skills codex进入 Codex 交互界面后输入类似这样的指令读取当前目录下的 meeting-notes.pdf整理成一页会议纪要包含参会人、讨论要点、决议事项和待办。如果模型通道配通了Codex 会开始处理这个 PDF然后输出一份结构化的会议纪要。你会看到它调用了模型并且按你要求的格式返回了内容。这个过程里Skills 负责解析 PDF、提取文本、组织输出模型通道负责理解内容和生成文字。如果一切正常你会看到类似这样的输出结构会议纪要 参会人张三、李四、王五 讨论要点 1. 项目进度回顾 2. 下阶段排期 决议事项 - 本周五前完成接口联调 待办 - 张三更新需求文档 - 李四准备测试用例看到这个结果说明模型通道和 Skills 都跑通了。接下来你可以换成 Word 文档或者表格试试比如让 Codex 读取一份 xlsx 并生成三条经营结论或者把一份 docx 改成客户版说明。逻辑是一样的Skill 负责文件操作模型通道负责内容生成。提示第一次跑的时候如果 Codex 提示需要确认权限或者安装依赖按提示操作就行。Skills 处理 PDF 和 Word 可能需要一些本地库Codex 会引导你装好。验证通过之后你就可以把常用的办公任务沉淀成 Skill 了。比如市场部建一个活动复盘 Skill财务部建一个明细核对 Skill项目组建一个周报 Skill。每个 Skill 里定义好流程和输出格式模型通道配一次就行后面复用。5. 本篇常见错排查401 和路径多出 /v1配通过程中最常见的两个报错一个是 401一个是路径里多出/v1。这两个问题的根源都在config.toml的 Base URL 和 Key 上排查起来不复杂。401 Unauthorized看到 401先检查三件事。第一环境变量TAOTOKEN_API_KEY有没有设置成功用前面说的echo命令确认一下。第二Key 有没有复制完整有没有多出空格或者换行。第三config.toml里的env_key字段是不是写成了TAOTOKEN_API_KEY大小写要一致。如果这三项都没问题还是 401那就去 TaoToken 控制台确认一下 Key 的状态是不是被禁用或者过期了。正常情况下新建的 Key 是立即可用的。路径多出 /v1这个问题的表现是请求发出去之后报 404 或者路径错误。原因通常是 Base URL 填成了https://taotoken.net/api/v1或者https://taotoken.net/v1。正确的填法是https://taotoken.net/api不带/v1。Codex 在请求时可能会自己拼接路径如果你在 Base URL 里已经带了/v1拼出来就会变成/api/v1/v1/...这种奇怪的东西。所以记住Base URL 只填到/api为止。Skills 不执行如果模型通道通了但 Skills 没反应检查config.toml里[skills]段的enabled是不是true。另外确认一下 Skills 目录的位置对不对Codex 默认会从特定目录加载 Skills具体路径可以查 Codex 文档。模型名不对如果报模型不存在的错误检查model字段填的是不是 TaoToken 支持的模型名。填错了会直接报错换一个确认可用的就行。排障的基本思路就是先确认 Key 和环境变量再确认 Base URL 路径最后确认模型名和 Skills 配置。按这个顺序查大部分问题都能定位到。6. 配通之后让 Skills 接管你的办公文档流程模型通道配通之后Codex 的 Skills 就能真正跑起来了。你可以从简单的任务开始比如把会议记录整理成一页纪要或者根据表格生成几条结论。跑顺了之后再逐步增加约束目标读者是谁、语气什么风格、输出什么格式、保存到哪里。对于团队使用建议把常见工作流沉淀成固定的 Skill。市场部可以建活动复盘 Skill财务部可以建明细核对 Skill项目组可以建周报和风险跟踪 Skill。每个 Skill 里把流程和输出格式定义清楚模型通道配一次后面直接复用。这样 Codex 就不只是临时助手而是团队流程的执行入口。如果你在配通过程中遇到问题优先检查config.toml里的 Base URL 和 Key。需要创建新的 Key 或者查看文档可以从这几个入口进创建和管理 API Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite长期编码和 Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite配通之后你可以让 Codex 读取一份 PDF 并生成一页会议纪要或者处理一份表格生成经营结论。Skills 负责文件操作TaoToken 提供模型通道分工明确跑起来就顺了。