首页 / 全部技能 / 基础工具与工作流 / claude-code-ping-start-5h-quota
English (EN)简体中文 (ZH)日本語 (JA)
基础工具与工作流 · daymade/claude-code-skills

claude-code-ping-start-5h-quota

睡前/离开前额度耗尽时，设置一次性本机定时器，在 Claude 订阅额度重置后自动发一条极简 claude -p 消息，立刻开启新的 5 小时用量窗口——用户睡醒时新窗口已跑掉大半，等于白赚一个 冷却期。Use when 用户说「还有 X 小时重置额度，帮我定时戳一下 Claude」「我去睡觉了，到点 ping 一下开启新窗口」「额度用完了，重置后帮我踩个点」「设个定时器开启新的 5 小时 冷却期」，或提到 定时戳、戳 Claude、quota ping、开窗、额度重置后自动发消息。仅限一次性定时任务与 macOS 本机（caffeinate/BSD date）；周期性任务用 /loop 或 cron，查询 ChatGPT/Codex 何时重置用 tibo-reset-codex，分析额度为什么烧完用 claude-usage-analyst。

L4 高权限 · 分级授权与审计V1 已固定执行命令联网Dual-pass Audit
Author daymadeGitHub daymade/claude-code-skills ↗Stars 1385License MIT（仓库根 LICENSE 文件；GitHub API spdx MIT；Copyright (c) 2025 daymade）Commit d5c4678cb5
管控等级描述 skill 的能力与建议配套的管控措施，不代表质量或安全认证，也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同，请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者，使用风险由使用者自行承担。

1实现原理 · 为什么它能做到

利用 5 小时窗口的起算语义：窗口从『窗口内第一条请求』起算而非固定时刻轮转，所以额度耗尽后没人发消息窗口就不开始计时；重置后立刻由定时任务代发一条极简消息，把窗口计时的起点藏进睡眠时间。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
Claude 订阅的 5 小时用量窗口从**窗口内第一条请求**开始计时，而不是按固定时刻轮转。
这里在做什么：把『睡觉期间额度重置』这个空档转化为收益——用户睡醒时新窗口已经消耗掉大半时长而几乎没消耗额度；'一次戳的成本极小：一条 `claude -p` 单轮消息。2026-08-29 实测全流程成功。'

定时器本体是一条 detached 后台进程链：caffeinate -is 防睡眠撑住等待期 → sleep N 秒 → cd $HOME → claude -p 发『Reply with exactly: ok』单轮消息，由 Bash run_in_background 启动。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
caffeinate -is /bin/sh -c 'sleep <SLEEP_SECONDS> && cd "$HOME" && claude -p "Reply with exactly: ok"'
命令解剖表解释每个组件为什么在：caffeinate 防 idle/插电睡眠（进程结束自动释放，防不了物理合盖）；sleep 是最简一次性载体（macOS 别依赖 at，ScheduleWakeup 上限 3600s 不够）；cd $HOME 避免加载项目 CLAUDE.md/hooks 白烧 token；claude -p 回一个词就退出的真实 API 请求。

run_in_background 是关键语义：前台 sleep 会被 harness 拦截；后台 detached 进程不依赖会话存活，且退出时会唤醒原会话形成『双保险』。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
**必须 run_in_background**：前台 sleep 会被 harness 拦截；后台任务是 detached 进程，且退出时会重新唤醒当前会话（见 Step 5）。
『被唤醒这件事本身也是一次 API 请求，与 `claude -p` 互为双保险——任何一个发生都能开窗。』这是设计亮点：唤醒通知=宿主发起的请求，与定时戳互为冗余。

幂等与读回验证：启动前 ps 检查是否已有同款定时器（有则报告并问是否替换）；启动后用 ps 验证进程链三行（sh/caffeinate/sleep）都在。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
ps -ef | grep -E 'claude -p "Reply with exactly: ok"' | grep -v grep
『启动回执不算数，用 ps 确认进程链真的存在』是独立读回验证；预期至少三行，少了 sleep 行说明进程没起来。

时间换算公式化：等待分钟数 = 距重置分钟数 + 5 分钟缓冲；绝对时刻早于/等于当前时间按次日同刻理解（深夜跨零点是常态输入）；SLEEP_SECONDS = 等待分钟数 × 60。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
换算公式（占位符全文统一）：`等待分钟数 = 距重置分钟数 + 5`；`SLEEP_SECONDS = 等待分钟数 × 60`。
+5 分钟缓冲的理由：『重置时刻按用户口述估算有误差；早于重置时刻戳到的是旧窗口，纯浪费』。目标钟面时刻要报告给用户（'用户睡前想知道的是墙钟时刻'），并解释跨零点『6 点 15 重置』指明早的语义。

收尾核实与取消纪律：到点被唤醒后读任务 output 文件，预期 'ok' + '[exited with code 0]'；实际触发时刻以 output 文件 mtime 为准（stat -f '%Sm'）；取消用特征串 pkill 且明令禁止按秒数杀。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
**禁止按秒数 `pkill -f 'sleep <SLEEP_SECONDS>'`**：本机长驻脚本的心跳 sleep 可能恰好同秒数，实测发生过误杀
取消命令为 pkill -f 'Reply with exactly: ok'（2026-08-29 实测可杀 caffeinate 与 sh；残留孤儿 sleep 无害，sh 已死 && 后不会执行）；output 文件路径在 Step 4 交代时写入对话历史，作为『通知丢失/上下文压缩』后的兜底（'路径也丢了就 ps 查进程链…读不到任何本地证据时如实说「无法本地确认」'——禁谎报）。

2核心能力

01一次性延迟触发额度窗口（caffeinate 防睡 + sleep 定时 + claude -p 单轮戳）
02幂等：启动前检测已有定时器并询问是否替换（不默默叠加第二个）
03进程链独立读回验证（ps 三行预期）
04任务 output 路径持久化交代 + 唤醒收尾核实（ok/exit 0/实际时刻 stat）
05特征串安全取消（pkill 'Reply with exactly: ok'；禁止按秒数杀）
06相对/绝对时间换算 + 跨零点次日语义 + 5 分钟缓冲

3外部依赖

KindDependency / Endpoint
cliclaude（官方 Claude Code CLI；claude -p 单轮 print 模式）
clicaffeinate（macOS 防睡眠）
clisleep / date / ps / pkill / stat（macOS/BSD 系统工具）
cli宿主 Bash 的 run_in_background 后台任务 + task-notification 唤醒（harness 能力）

4管控建议与判定依据

建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
  • scripts/: 执行本地脚本或命令: agent 在宿主后台执行：caffeinate -is /bin/sh -c 'sleep <S> && cd $HOME && claude -p
  • 网络端点: 声明外部网络访问: 经官方 claude CLI 对 Anthropic 发起一次真实订阅 API 请求（claude -p 单轮；这是 skill 的目的本身）
审计说明： 。按统一分档：无脚本资产、无凭证接触（claude CLI 用自己的登录态，skill 不读 key/cookie/env）、无直接网络代码——本地系统 CLI/进程管理为主（偏蓝）。抬到黄色的理由：① 经官方 claude CLI 产生真实网络 API 外发（对象 Anthropic，可预期但会消耗订阅与开启计时窗口）；② 指令含『沙箱拦截时用 dangerouslyDisableSandbox: true 重试』——在特定故障路径下建议关闭宿主沙箱执行 caffeinate/claude，属安全降级提示需用户知情；③ 后台长驻进程 + pkill 特征串取消存在误杀其他进程的残余面（skill 已有防误杀纪律但非零概率）。

5第二遍独立确认

  • [ok] 无自带脚本/资产（纯指令 skill） — glob 确认目录仅 SKILL.md；external_deps/internal_assets 不夸大（asset 列表为空）。
  • [ok] caffeinate/sleep/claude -p 命令链存在且为固定模板 — Step 2 代码块逐字存在；命令解剖表逐组件解释；无 shell 拼接注入（数字换算后入占位符）。
  • [ok] run_in_background 语义与双保险 — SKILL.md 原文『后台任务是 detached 进程，且退出时会重新唤醒当前会话』与 Step 5『被唤醒本身也是一次 API 请求』一致。
  • [ok] 幂等检查与 ps 读回验证 — Step 0 的 ps grep 命令与 Step 3 的三行预期存在；Step 4 交代 output 路径进对话历史。
  • [ok] 凭证接触面为零 — token 扫描（API_KEY/token/cookie/secret/Authorization）零命中；无 env/keychain/文件读取。
  • [ok] pkill 取消纪律（防误杀） — 禁止按秒数 pkill 的原文与实测误杀背景存在；特征串 pkill 为唯一取消路径。
  • [ok] 功能声明 vs 夸大检查 — 『5 小时窗口从窗口内第一条请求起算』是描述性机制声明（对 Claude 订阅语义的表述，标注 2026-08-29 实测）；skill 边界（macOS/一次性/不查询重置时刻）自我声明清晰，无越界承诺。
  • [ok] 元数据（license/stars/commit） — 仓库级 MIT、stars=1385、pushed_at=2026-09-09T12:33:29Z；本地 HEAD==pin d5c4678cb5d4fd6acc9c922690df035dbd33d247。

6结论

  • 用『窗口第一条请求起算』的订阅语义做时间套利，价值主张清晰且成本极小（一条 claude -p 单轮消息）。
  • 双保险与可恢复现场设计：claude -p 与唤醒互为备份，output 路径写进对话历史防压缩丢失，读不到证据就如实说无法确认。
  • 防误杀/幂等纪律来自实测教训：禁止按秒数 pkill（误杀过心跳 sleep）、启动前查重、替换走全流程。
  • 把系统知识教给后续 agent：命令解剖表逐组件『为什么在、改掉会怎样』，防止未来 agent 优化掉关键组件。
  • 边界诚实：macOS-only、一次性、不查不预测重置、关机合盖无法履约就不承诺——不假装通用。
    • 适合： 适合：Claude 订阅额度耗尽且即将在数小时内重置、想睡觉/离开前把 5 小时窗口起点藏进空档的 macOS 本机用户；接受一次性定时器语义、愿意在启动后 ps 核验并把 output 路径记下来的场景。触发场景即 description 里的中文口令（「还有 X 小时重置」「我去睡觉了到点 ping」等）。
    不适合： 不适合：非 macOS（Linux caffeinate/date -v 不可用且未验证）；需要周期性保活/每日定时（应用 /loop 或 cron）；需要查询/预测 ChatGPT/Codex 重置时刻（转 tibo-reset-codex）；关机/合盖常态化的设备（无法履约）；对『关闭沙箱重试』或后台进程面不适的用户。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload claude-code-ping-start-5h-quota.tar.gz
    sha256: c6f9d07b09144f82…
    Option B · Copy Guide for Agent
    install.json
    agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit d5c4678cb5.