登录与 API 密钥
什么时候只需要网页登录
Section titled “什么时候只需要网页登录”如果你只是通过网页上传文件和管理订阅链接，只需要在 vsh.cc 使用邮箱一次性验证码登录。
什么时候必须使用 API 密钥
Section titled “什么时候必须使用 API 密钥”如果你要让 CLI、自动化脚本或 AI 助手调用 VSH，就需要 API 密钥或等价的可用 API 配置。
典型场景包括：
- 让 Claude、Codex、OpenClaw 等助手直接帮你上传或创建订阅
- 在脚本、自动化任务或 CI 中调用 VSH
- 希望不依赖浏览器手动点击，而是通过工具链完成操作
推荐的准备顺序
Section titled “推荐的准备顺序”一个稳妥的准备顺序通常是：
- 先确认你可以正常网页登录
- 再准备 API 密钥或等价配置
- 最后让 AI 助手或 CLI 检查当前配置是否真的可用
这样做的好处是，一旦后面助手提示“没有配置”或“身份不可用”，你能更容易判断问题出在登录、密钥还是环境传递。
使用 API 密钥时要注意什么
Section titled “使用 API 密钥时要注意什么”- 把 API 密钥保存在安全位置
- 请求头使用
x-api-key - 不要把原始 API 密钥当成普通登录密码到处粘贴
- 把 API 密钥当成网页登录密码使用
- 已经有密钥，但没有把它传进 AI 助手或脚本所在环境
- 以为“我在浏览器里登录过”就等于“助手也已经能调用 API”
- 同时存在多套配置，却不确定当前会话到底读取了哪一套
-
为什么我在网页里已经能用，助手却还说没有配置？
因为网页登录态和 API 调用配置不是同一件事。网页可用，不代表当前工具环境已经拿到了 API 密钥。 -
助手已经能调用 VSH，为什么结果还是不对？
下一步通常不是继续怀疑凭证，而是检查 项目与默认项目。