dsh-packycode-api

日常使用

换 Key。 Key 按添加顺序使用。点「切到此 Key」可以指定当前 Key；「重命名」改备注（最多 60 字，不能为空）；充值或更换后点「重新启用」。

看余额。 设置页的合计是已列出的这些 Key 的剩余、已用与额度，不是 PackyCode 账号下全部令牌的账单。读失败的 Key 不计入合计，并会注明个数；某个 Key 这次读失败但之前读到过，会继续显示上次的余额并注明读取时间（输入框里显示为 ≈US$…），重启 DSH 后才清空。输入框右侧只在选中 PackyCode 模型时显示当前 Key 的剩余额度。「刷新」会跳过约 60 秒的缓存。默认模型接口是 https://cf.api.fan，余额接口是 https://www.packyapi.ai，可在「高级：接口地址」里改。旧默认值 https://www.packyapi.com 在国内网络下 DNS 被污染、直连会 fetch failed，即使设置里保存的是它，插件也会先试 .ai。

用 Claude。 设置页顶部的「Claude Code CLI」卡片会检测本机 CLI。没装时点「安装 Claude Code CLI」，本机执行 npm install -g @anthropic-ai/claude-code（需要 Node.js 18+）。装好后不用重启 DSH。Windows 上另外需要 Git for Windows。

什么时候会自动切换 Key

• 会切换并停用当前 Key： 额度用尽（网关报额度、余额、insufficient quota 之类），或 Key 被拒绝（HTTP 401 / 无效的令牌）。失败的那一步由 harness 重试，从而用上新 Key。
• 不会切换： 限速（429）；网关把上游渠道故障误报成 400（当前令牌未覆盖供应商 …）；以及「只允许官方客户端」的 403。后一种会直接说明原因，而不是显示成 API Key 无效。
• 全部 Key 都停用时，请求失败并说明没有可用 Key，不会回退到别的凭据。