1. Codex 里 Skill 到底是什么为什么值得先装再写代码如果你刚接触 Codex可以把 Skill 理解成给 Codex 预装的“专项能力包”。默认状态下 Codex 什么都能聊一点但遇到具体任务时容易自由发挥让它总结 PDF它可能只读前两页让它检查网页它可能凭想象描述布局让它改登录逻辑它可能忽略权限校验。装上对应 Skill 之后Codex 会按这套能力包内置的流程、脚本和检查清单来做事输出稳定性会明显不一样。这篇面向 Windows PowerShell 环境把 Codex 与 GPT-5.5 常用 Skill 的筛选、一键安装命令、settings 配置片段以及把 settings 改到 TaoToken 统一 Key/API 通道后的连通性验证动作串成一条可跟做的路径。核心检索词就是 Codex Skill 安装命令、GPT-5.5 Skill 推荐、PowerShell 配置。适合谁刚装好 Codex 想快速补齐能力的新手、大学生、非专业开发者以及想把 Codex 接入统一 API 通道做长期编码的人。我实测下来Skill 装与不装的区别在“多步骤任务”上最明显。比如“打开本地网页、截图、检查手机端错位、指出问题位置”这种任务没有 screenshot 或 playwright Skill 时Codex 往往只给你一段建议装了之后它会真的去启动项目、截图、对比桌面端和手机端。再比如“把这个音频转成文字并总结重点”transcribe Skill 会按保留段落、去口头禅、标注听不清位置的流程走而不是随便转一段。安装前先确认两件事。第一Codex 已经能正常启动$env:USERPROFILE\.codex目录存在。第二PowerShell 里能调用python。你可以先跑一句确认python --version Get-ChildItem $env:USERPROFILE\.codex -Directory如果python报“不是内部或外部命令”先去装 Python 并勾选 Add to PATH再回来继续。Skill 安装脚本本身是 Python 写的这一步绕不过去。另外提醒一个容易踩的坑Skill 安装完成后通常需要重启 Codex 才能识别新 Skill。很多人装完直接在原来的会话里喊“请使用 xxx skill”结果 Codex 说找不到其实是没重启。养成“装完就重启”的习惯能省掉一半排障时间。下面从“先看已装了什么”开始一步步把常用 Skill 装齐再把 settings 改到 TaoToken 通道做验证。2. 先盘点已装 Skill再决定装哪些Codex Skill 列表查看与筛选动手装之前先看自己已经有什么避免重复安装。Codex 的 Skill 目录默认在$env:USERPROFILE\.codex\skills用一条命令列出所有已安装 Skill 的目录名Get-ChildItem $env:USERPROFILE\.codex\skills -Directory | Select-Object -ExpandProperty Name这条命令会输出类似pdf、doc、playwright、sora、academic-research、Data Analysis、sql-assistant、prompt-engineering-expert、imagegen这样的名字。这些是你本地已经有的常用 Skill不需要重复安装。再看官方 curated 列表也就是官方维护的推荐 Skill 清单python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\list-skills.py想看 JSON 版本方便脚本处理python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\list-skills.py --format json这里有个关键点.system目录是系统内置 Skill不要随便删。skill-installer本身就在.system下面删了之后安装脚本就没了。你只需要往skills目录里加新 Skill不要动.system。筛选逻辑我建议按“你最近一周真实做过什么任务”来定而不是按“听起来很厉害”来装。下面给一张对照表帮你快速判断你的高频任务推荐 Skill装完能做什么查 OpenAI / Codex / API 文档openai-docs优先官方文档、给链接、中文总结做网页、作品集、课程项目screenshot / playwright打开页面、截图、检查桌面端和手机端整理课堂、会议、访谈录音transcribe音频转文字、去口头禅、总结重点数据分析、课程实验jupyter-notebook把分析过程整理成可运行 notebook改登录、权限、接口security-best-practices检查密码处理、权限判断、输入校验经常提 PR、修 CIgh-address-comments / gh-fix-ci处理 review comments、定位 CI 失败前端作品要上线vercel-deploy / netlify-deploy / cloudflare-deploy检查构建、本地 build 通过再部署UI 还原设计稿figma / figma-implement-design按设计稿实现页面、截图对比用 Notion 管笔记notion-knowledge-capture 等把讨论整理成结构化笔记做 ChatGPT App 或 CLI 工具chatgpt-apps / cli-creator设计最小可用版本、做命令行工具如果你只想省事先装一组“通用打底”的python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/openai-docs skills/.curated/screenshot skills/.curated/transcribe skills/.curated/jupyter-notebook skills/.curated/security-best-practices这一组覆盖查文档、看网页、转录音、做数据、查安全基本能应付大部分学习和开发场景。装完重启 Codex再按需补装其他 Skill。筛选时还有一个判断标准看这个 Skill 是否“有明确流程”。像 openai-docs 会强制优先官方文档、给链接security-best-practices 会按密码、权限、输入校验逐项检查。这类有流程的 Skill 收益最大。反过来如果某个 Skill 只是换个提示词那不如自己写提示词。3. 可复制配置settings 改到 TaoToken 统一 Key/API 通道Skill 装好只是能力就位真正调用模型时还要走 API 通道。这一步把 Codex 的 settings 改到 TaoToken 统一 Key/API 通道好处是 Key 和 Base URL 集中管理换模型、换项目不用到处改。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。先拿到 Key。打开控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建后复制 Key形如sk-xxxx。然后配置 Codex 的 settings。Codex 的配置文件通常在$env:USERPROFILE\.codex\config.toml用 PowerShell 打开notepad $env:USERPROFILE\.codex\config.toml如果文件不存在先创建目录和文件New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.codex | Out-Null New-Item -ItemType File -Force -Path $env:USERPROFILE\.codex\config.toml | Out-Null把下面这段 TOML 片段写进去注意把sk-你的Key换成你自己的# Codex settings - 统一走 TaoToken 通道 model gpt-5.5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat这里三件套要写全Base URL 是https://taotoken.net/apiKey 通过环境变量TAOTOKEN_API_KEY注入Model ID 是gpt-5.5。wire_api chat表示走 chat completions 兼容协议Codex 和 GPT-5.5 都支持。接着在 PowerShell 里设置环境变量。当前会话临时生效$env:TAOTOKEN_API_KEY sk-你的Key想永久生效写入用户环境变量[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, sk-你的Key, User)设置完关掉 PowerShell 重开验证一下echo $env:TAOTOKEN_API_KEY能打印出 Key 就说明环境变量生效了。注意不要把 Key 直接写进config.toml的明文里用env_key引用环境变量更安全也方便多项目共用。如果你用的是 Claude Code 或 Cline 这类工具配置思路一样都是 Base URL Key Model ID 三件套。Claude Code 的 settings 里把 Base URL 指向https://taotoken.net/apiKey 填同一个Model ID 按需选。Cline 的 MCP 配置里同理。Codex 的auth.json如果存在也要确认里面没有残留旧通道的凭证避免两套配置打架。配置完成后Codex 的模型调用就会统一走 TaoToken 通道。这一步做完再回去用 Skill 才有意义否则 Skill 装了一堆模型请求发不出去也是白搭。4. 验证请求确认 Skill 能正常调用 GPT-5.5配置写完必须验证不然你不知道是 Skill 没装好还是通道没通。验证分两层先验证 API 通道再验证 Skill 调用。第一层用 PowerShell 直接打一次 API确认 Key 和 Base URL 可用$headers { Authorization Bearer $env:TAOTOKEN_API_KEY Content-Type application/json } $body { model gpt-5.5 messages ( { role user; content 用一句话说明 Codex Skill 的作用 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body如果返回里有choices字段和一段中文回复说明通道通了。如果报 401说明 Key 不对或环境变量没生效如果报连接失败检查 Base URL 是不是写成了https://taotoken.net/api不要多加/v1之外的路径。第二层重启 Codex在会话里直接调用 Skill。先确认 Skill 被识别请列出当前可用的 skill。然后测试 openai-docs请使用 openai-docs skill查一下 GPT-5.5 在 Codex 中适合做哪些任务。 要求 1. 优先使用官方文档 2. 给出链接 3. 用中文总结 4. 不要引用过期资料测试 screenshot请使用 screenshot skill帮我打开本地网页并截图。 检查 1. 桌面端是否正常 2. 手机端是否正常 3. 有没有文字溢出、按钮重叠、页面空白 4. 如果有问题请指出位置测试 transcribe请使用 transcribe skill把这个音频转成文字。 要求 1. 保留主要段落 2. 去掉明显口头禅 3. 最后总结重点 4. 如果有听不清的地方请标注如果 Codex 回复“找不到该 skill”先回去跑第 2 节的列表命令确认 Skill 目录名再确认是否重启过 Codex。如果 Skill 被识别但调用时报模型错误回到第一层检查 API 通道。验证通过后你可以把常用提示词固定下来。通用模板是请使用 [skill 名称] skill帮我完成[任务] 要求 1. 先检查相关文件或资料 2. 不确定的地方不要编造 3. 给出可以复现的步骤 4. 最后总结结果和风险这个模板的好处是强制 Codex 先检查再动手减少它凭想象编造的情况。实测下来加上“不确定的地方不要编造”这一条输出质量会稳定不少。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来对照遇到问题直接查表。401 Unauthorized。最常见。原因通常是 Key 没设置、环境变量没生效、或者 Key 复制时带了空格。排查步骤echo $env:TAOTOKEN_API_KEY如果为空重新设置环境变量并重开 PowerShell。如果打印出来但仍有 401检查 Key 是否在控制台被禁用或额度用尽。控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewritelocal proxy failed / connection refused。这类报错说明 Codex 尝试连本地代理但连不上。检查config.toml里base_url是不是被写成了http://127.0.0.1:xxxx之类的本地地址。正确写法是https://taotoken.net/api。如果你之前配过其他工具留下的本地代理配置一并清掉。reading choices 报错 / choices 字段为空。通常是返回体结构不符合预期或者模型名写错。确认model gpt-5.5wire_api chat。如果用的是 responses 协议但通道只支持 chat也会出现解析失败。把wire_api改成chat再试。OAuth 相关报错。Codex 某些版本会走 OAuth 登录流程如果你已经用 API Key 通道就不需要再走 OAuth。检查auth.json里是否有残留的 OAuth token和 API Key 冲突。auth.json路径Get-ChildItem $env:USERPROFILE\.codex\auth.json如果存在且里面是旧凭证备份后清空或删除让 Codex 走config.toml里的 API Key 通道。Skill 安装失败。常见原因有四类网络访问 GitHub 不稳定Skill 已存在脚本拒绝覆盖没重启 Codex私有仓库没权限。先重新列一遍python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\list-skills.py如果显示已安装就不用再装。要重装先确认目录位置Get-ChildItem $env:USERPROFILE\.codex\skills -Directory不要随便删.system目录。如果是从指定 GitHub 地址安装命令是python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --url https://github.com/openai/skills/tree/main/skills/.curated/openai-docs其他仓库用--repo owner/repo --path path/to/skill格式。Skill 被识别但结果不对。先确认提示词里明确写了 Skill 名称比如“请使用 openai-docs skill”。如果只写“帮我查文档”Codex 可能不调用 Skill。其次确认任务和 Skill 匹配用 transcribe 去查文档肯定不对。排障时建议按“通道 → Skill 识别 → Skill 调用”三层顺序查不要一上来就重装。大部分问题出在通道层也就是 Key 和 Base URL。6. 按人群组合安装把 Skill 用成日常习惯Skill 不是装越多越好装太多反而让 Codex 选择困难。按人群组合安装更实用。编程新手和大学生装这一组python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/openai-docs skills/.curated/screenshot skills/.curated/jupyter-notebook skills/.curated/transcribe用途是查文档、检查网页、做数据作业、整理录音。这四个覆盖了大部分课程和自学场景。前端和作品集方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/screenshot skills/.curated/vercel-deploy skills/.curated/figma skills/.curated/figma-implement-design用途是页面截图、设计稿还原、部署作品。做完直接部署形成闭环。GitHub 协作方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/gh-address-comments skills/.curated/gh-fix-ci skills/.curated/yeet用途是处理 PR 评论、修 CI、提交并开 PR。安全和后端方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/security-best-practices skills/.curated/security-threat-model skills/.curated/security-ownership-map用途是检查权限、登录、接口、威胁建模。内容整理和研究方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/transcribe skills/.curated/notion-knowledge-capture skills/.curated/notion-research-documentation用途是录音转文字、整理资料、沉淀笔记。长期做编码和 Agent 任务的话建议把 Coding Plan 用起来配合 Skill 做持续开发https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite需要查模型能力和对比时用模型对话页面快速验证https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite接入文档和 API Key 管理分别在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite最后给一个实用技巧把常用 Skill 调用写成 PowerShell 别名或脚本比如把“打开项目、截图、检查手机端”封装成一条命令每次改完前端跑一次。Skill 的价值在于把重复的多步骤任务固化下来而不是每次重新描述。装好、配好、验证好之后剩下的就是把它用进日常流程里。
1. Codex 里 Skill 到底是什么为什么值得先装再写代码如果你刚接触 Codex可以把 Skill 理解成给 Codex 预装的“专项能力包”。默认状态下 Codex 什么都能聊一点但遇到具体任务时容易自由发挥让它总结 PDF它可能只读前两页让它检查网页它可能凭想象描述布局让它改登录逻辑它可能忽略权限校验。装上对应 Skill 之后Codex 会按这套能力包内置的流程、脚本和检查清单来做事输出稳定性会明显不一样。这篇面向 Windows PowerShell 环境把 Codex 与 GPT-5.5 常用 Skill 的筛选、一键安装命令、settings 配置片段以及把 settings 改到 TaoToken 统一 Key/API 通道后的连通性验证动作串成一条可跟做的路径。核心检索词就是 Codex Skill 安装命令、GPT-5.5 Skill 推荐、PowerShell 配置。适合谁刚装好 Codex 想快速补齐能力的新手、大学生、非专业开发者以及想把 Codex 接入统一 API 通道做长期编码的人。我实测下来Skill 装与不装的区别在“多步骤任务”上最明显。比如“打开本地网页、截图、检查手机端错位、指出问题位置”这种任务没有 screenshot 或 playwright Skill 时Codex 往往只给你一段建议装了之后它会真的去启动项目、截图、对比桌面端和手机端。再比如“把这个音频转成文字并总结重点”transcribe Skill 会按保留段落、去口头禅、标注听不清位置的流程走而不是随便转一段。安装前先确认两件事。第一Codex 已经能正常启动$env:USERPROFILE\.codex目录存在。第二PowerShell 里能调用python。你可以先跑一句确认python --version Get-ChildItem $env:USERPROFILE\.codex -Directory如果python报“不是内部或外部命令”先去装 Python 并勾选 Add to PATH再回来继续。Skill 安装脚本本身是 Python 写的这一步绕不过去。另外提醒一个容易踩的坑Skill 安装完成后通常需要重启 Codex 才能识别新 Skill。很多人装完直接在原来的会话里喊“请使用 xxx skill”结果 Codex 说找不到其实是没重启。养成“装完就重启”的习惯能省掉一半排障时间。下面从“先看已装了什么”开始一步步把常用 Skill 装齐再把 settings 改到 TaoToken 通道做验证。2. 先盘点已装 Skill再决定装哪些Codex Skill 列表查看与筛选动手装之前先看自己已经有什么避免重复安装。Codex 的 Skill 目录默认在$env:USERPROFILE\.codex\skills用一条命令列出所有已安装 Skill 的目录名Get-ChildItem $env:USERPROFILE\.codex\skills -Directory | Select-Object -ExpandProperty Name这条命令会输出类似pdf、doc、playwright、sora、academic-research、Data Analysis、sql-assistant、prompt-engineering-expert、imagegen这样的名字。这些是你本地已经有的常用 Skill不需要重复安装。再看官方 curated 列表也就是官方维护的推荐 Skill 清单python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\list-skills.py想看 JSON 版本方便脚本处理python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\list-skills.py --format json这里有个关键点.system目录是系统内置 Skill不要随便删。skill-installer本身就在.system下面删了之后安装脚本就没了。你只需要往skills目录里加新 Skill不要动.system。筛选逻辑我建议按“你最近一周真实做过什么任务”来定而不是按“听起来很厉害”来装。下面给一张对照表帮你快速判断你的高频任务推荐 Skill装完能做什么查 OpenAI / Codex / API 文档openai-docs优先官方文档、给链接、中文总结做网页、作品集、课程项目screenshot / playwright打开页面、截图、检查桌面端和手机端整理课堂、会议、访谈录音transcribe音频转文字、去口头禅、总结重点数据分析、课程实验jupyter-notebook把分析过程整理成可运行 notebook改登录、权限、接口security-best-practices检查密码处理、权限判断、输入校验经常提 PR、修 CIgh-address-comments / gh-fix-ci处理 review comments、定位 CI 失败前端作品要上线vercel-deploy / netlify-deploy / cloudflare-deploy检查构建、本地 build 通过再部署UI 还原设计稿figma / figma-implement-design按设计稿实现页面、截图对比用 Notion 管笔记notion-knowledge-capture 等把讨论整理成结构化笔记做 ChatGPT App 或 CLI 工具chatgpt-apps / cli-creator设计最小可用版本、做命令行工具如果你只想省事先装一组“通用打底”的python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/openai-docs skills/.curated/screenshot skills/.curated/transcribe skills/.curated/jupyter-notebook skills/.curated/security-best-practices这一组覆盖查文档、看网页、转录音、做数据、查安全基本能应付大部分学习和开发场景。装完重启 Codex再按需补装其他 Skill。筛选时还有一个判断标准看这个 Skill 是否“有明确流程”。像 openai-docs 会强制优先官方文档、给链接security-best-practices 会按密码、权限、输入校验逐项检查。这类有流程的 Skill 收益最大。反过来如果某个 Skill 只是换个提示词那不如自己写提示词。3. 可复制配置settings 改到 TaoToken 统一 Key/API 通道Skill 装好只是能力就位真正调用模型时还要走 API 通道。这一步把 Codex 的 settings 改到 TaoToken 统一 Key/API 通道好处是 Key 和 Base URL 集中管理换模型、换项目不用到处改。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。先拿到 Key。打开控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建后复制 Key形如sk-xxxx。然后配置 Codex 的 settings。Codex 的配置文件通常在$env:USERPROFILE\.codex\config.toml用 PowerShell 打开notepad $env:USERPROFILE\.codex\config.toml如果文件不存在先创建目录和文件New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.codex | Out-Null New-Item -ItemType File -Force -Path $env:USERPROFILE\.codex\config.toml | Out-Null把下面这段 TOML 片段写进去注意把sk-你的Key换成你自己的# Codex settings - 统一走 TaoToken 通道 model gpt-5.5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat这里三件套要写全Base URL 是https://taotoken.net/apiKey 通过环境变量TAOTOKEN_API_KEY注入Model ID 是gpt-5.5。wire_api chat表示走 chat completions 兼容协议Codex 和 GPT-5.5 都支持。接着在 PowerShell 里设置环境变量。当前会话临时生效$env:TAOTOKEN_API_KEY sk-你的Key想永久生效写入用户环境变量[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, sk-你的Key, User)设置完关掉 PowerShell 重开验证一下echo $env:TAOTOKEN_API_KEY能打印出 Key 就说明环境变量生效了。注意不要把 Key 直接写进config.toml的明文里用env_key引用环境变量更安全也方便多项目共用。如果你用的是 Claude Code 或 Cline 这类工具配置思路一样都是 Base URL Key Model ID 三件套。Claude Code 的 settings 里把 Base URL 指向https://taotoken.net/apiKey 填同一个Model ID 按需选。Cline 的 MCP 配置里同理。Codex 的auth.json如果存在也要确认里面没有残留旧通道的凭证避免两套配置打架。配置完成后Codex 的模型调用就会统一走 TaoToken 通道。这一步做完再回去用 Skill 才有意义否则 Skill 装了一堆模型请求发不出去也是白搭。4. 验证请求确认 Skill 能正常调用 GPT-5.5配置写完必须验证不然你不知道是 Skill 没装好还是通道没通。验证分两层先验证 API 通道再验证 Skill 调用。第一层用 PowerShell 直接打一次 API确认 Key 和 Base URL 可用$headers { Authorization Bearer $env:TAOTOKEN_API_KEY Content-Type application/json } $body { model gpt-5.5 messages ( { role user; content 用一句话说明 Codex Skill 的作用 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body如果返回里有choices字段和一段中文回复说明通道通了。如果报 401说明 Key 不对或环境变量没生效如果报连接失败检查 Base URL 是不是写成了https://taotoken.net/api不要多加/v1之外的路径。第二层重启 Codex在会话里直接调用 Skill。先确认 Skill 被识别请列出当前可用的 skill。然后测试 openai-docs请使用 openai-docs skill查一下 GPT-5.5 在 Codex 中适合做哪些任务。 要求 1. 优先使用官方文档 2. 给出链接 3. 用中文总结 4. 不要引用过期资料测试 screenshot请使用 screenshot skill帮我打开本地网页并截图。 检查 1. 桌面端是否正常 2. 手机端是否正常 3. 有没有文字溢出、按钮重叠、页面空白 4. 如果有问题请指出位置测试 transcribe请使用 transcribe skill把这个音频转成文字。 要求 1. 保留主要段落 2. 去掉明显口头禅 3. 最后总结重点 4. 如果有听不清的地方请标注如果 Codex 回复“找不到该 skill”先回去跑第 2 节的列表命令确认 Skill 目录名再确认是否重启过 Codex。如果 Skill 被识别但调用时报模型错误回到第一层检查 API 通道。验证通过后你可以把常用提示词固定下来。通用模板是请使用 [skill 名称] skill帮我完成[任务] 要求 1. 先检查相关文件或资料 2. 不确定的地方不要编造 3. 给出可以复现的步骤 4. 最后总结结果和风险这个模板的好处是强制 Codex 先检查再动手减少它凭想象编造的情况。实测下来加上“不确定的地方不要编造”这一条输出质量会稳定不少。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来对照遇到问题直接查表。401 Unauthorized。最常见。原因通常是 Key 没设置、环境变量没生效、或者 Key 复制时带了空格。排查步骤echo $env:TAOTOKEN_API_KEY如果为空重新设置环境变量并重开 PowerShell。如果打印出来但仍有 401检查 Key 是否在控制台被禁用或额度用尽。控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewritelocal proxy failed / connection refused。这类报错说明 Codex 尝试连本地代理但连不上。检查config.toml里base_url是不是被写成了http://127.0.0.1:xxxx之类的本地地址。正确写法是https://taotoken.net/api。如果你之前配过其他工具留下的本地代理配置一并清掉。reading choices 报错 / choices 字段为空。通常是返回体结构不符合预期或者模型名写错。确认model gpt-5.5wire_api chat。如果用的是 responses 协议但通道只支持 chat也会出现解析失败。把wire_api改成chat再试。OAuth 相关报错。Codex 某些版本会走 OAuth 登录流程如果你已经用 API Key 通道就不需要再走 OAuth。检查auth.json里是否有残留的 OAuth token和 API Key 冲突。auth.json路径Get-ChildItem $env:USERPROFILE\.codex\auth.json如果存在且里面是旧凭证备份后清空或删除让 Codex 走config.toml里的 API Key 通道。Skill 安装失败。常见原因有四类网络访问 GitHub 不稳定Skill 已存在脚本拒绝覆盖没重启 Codex私有仓库没权限。先重新列一遍python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\list-skills.py如果显示已安装就不用再装。要重装先确认目录位置Get-ChildItem $env:USERPROFILE\.codex\skills -Directory不要随便删.system目录。如果是从指定 GitHub 地址安装命令是python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --url https://github.com/openai/skills/tree/main/skills/.curated/openai-docs其他仓库用--repo owner/repo --path path/to/skill格式。Skill 被识别但结果不对。先确认提示词里明确写了 Skill 名称比如“请使用 openai-docs skill”。如果只写“帮我查文档”Codex 可能不调用 Skill。其次确认任务和 Skill 匹配用 transcribe 去查文档肯定不对。排障时建议按“通道 → Skill 识别 → Skill 调用”三层顺序查不要一上来就重装。大部分问题出在通道层也就是 Key 和 Base URL。6. 按人群组合安装把 Skill 用成日常习惯Skill 不是装越多越好装太多反而让 Codex 选择困难。按人群组合安装更实用。编程新手和大学生装这一组python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/openai-docs skills/.curated/screenshot skills/.curated/jupyter-notebook skills/.curated/transcribe用途是查文档、检查网页、做数据作业、整理录音。这四个覆盖了大部分课程和自学场景。前端和作品集方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/screenshot skills/.curated/vercel-deploy skills/.curated/figma skills/.curated/figma-implement-design用途是页面截图、设计稿还原、部署作品。做完直接部署形成闭环。GitHub 协作方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/gh-address-comments skills/.curated/gh-fix-ci skills/.curated/yeet用途是处理 PR 评论、修 CI、提交并开 PR。安全和后端方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/security-best-practices skills/.curated/security-threat-model skills/.curated/security-ownership-map用途是检查权限、登录、接口、威胁建模。内容整理和研究方向python $env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py --repo openai/skills --path skills/.curated/transcribe skills/.curated/notion-knowledge-capture skills/.curated/notion-research-documentation用途是录音转文字、整理资料、沉淀笔记。长期做编码和 Agent 任务的话建议把 Coding Plan 用起来配合 Skill 做持续开发https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite需要查模型能力和对比时用模型对话页面快速验证https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite接入文档和 API Key 管理分别在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite最后给一个实用技巧把常用 Skill 调用写成 PowerShell 别名或脚本比如把“打开项目、截图、检查手机端”封装成一条命令每次改完前端跑一次。Skill 的价值在于把重复的多步骤任务固化下来而不是每次重新描述。装好、配好、验证好之后剩下的就是把它用进日常流程里。
