Codex QuickStart

这篇适合谁

适合希望在 Codex 中直接调用 VSH 工作流的人，例如上传文件、创建订阅链接、检查配置或排查当前项目状态。

开始前准备

• 你已经能正常使用 Codex
• 你知道自己的 Codex skills parent 目录在哪里
• 你已经准备好可用的 VSH 登录态，或者准备好 VSH_API_URL 与 VSH_API_KEY
• 你知道应该把文件和订阅放到哪个项目中

安装或接入

pnpm exec vsh skill install --dir ~/.codex/skills

如果你的 Codex 安装目录不是默认位置，请把 ~/.codex/skills 替换成你的 skills parent 目录。

推荐你先做的第一件事

先让 Codex 帮你检查配置和项目状态，再进入真正的上传或创建订阅流程。这样可以优先发现 skill 未加载、凭证缺失或项目不对等问题。

可以直接复制的提示词

“使用 VSH 帮我上传这个文件并创建订阅链接；如果缺少配置，请先告诉我缺什么。”

如果你想先做更稳妥的接入检查，可以先用这一句：

“使用 VSH 检查我当前是否已经具备可用配置、当前项目是否可用；如果还不能创建订阅链接，请先说明原因。”

成功后你会看到什么

如果接入成功，Codex 应该能够：

• 识别已经安装好的 VSH skill
• 说明当前是否已具备可用配置
• 告诉你当前项目是否正确
• 在配置完整时继续执行上传、创建订阅或检查状态等动作

常见问题

• 安装后 Codex 仍然读不到 skill：先确认 ~/.codex/skills/vsh/SKILL.md 是否存在，并确认你安装到了正确的 skills parent 目录
• Codex 能看到 skill，但不能执行 VSH：优先检查 vsh login 是否已完成，或者 VSH_API_URL 与 VSH_API_KEY 是否已进入当前会话环境
• 执行结果落在了错误项目：先看 项目与默认项目，再决定是否切换 active/default project

下一步

• 创建订阅链接
• 登录与 API 密钥
• 项目与默认项目