Claude Waker — Development skill for Claude Code

Claude Waker ⏰

自动唤醒 Claude 账号，优化 5 小时限额使用窗口 | Claude Scheduler | Claude Wakeup Tool | Claude Auto Timer

**Automatic Claude account scheduler for optimizing 5-hour usage quota windows**

[English Documentation](README.en.md) | 中文文档

**关键词**: Claude定时唤醒 | Claude调度器 | Claude自动化 | Claude Pro优化 | Claude Max工具 | claude scheduler | claude wakeup | claude timer | claude automation | claude quota optimizer

📖 项目背景

问题

Claude Pro/Max 账号有每 5 小时的使用限额，但这个限额**不是固定时间重置**，而是从**第一次使用开始计时**。

这可能导致无法最大化利用额度。例如：

• 工作时间：9:30-12:00, 13:30-18:30
• 如果 10:00 第一次使用，很快耗尽额度
• 下午 3:00 之前都无法继续使用（浪费了下午的工作时间）

解决方案

通过在**固定时间点**自动发送消息来"唤醒" Claude，主动触发计时窗口，从而优化使用时间：

• 早上 7:05 自动唤醒 → 12:00 重置
• 中午 12:05 自动唤醒 → 17:00 重置
• 下午 17:05 自动唤醒 → 22:00 重置

**为什么是 05 分？** Claude 的 5 小时限额是按**整点计时**的（如 7:00-12:00），在 7:05 发送消息不会影响这 5 分钟，因为计时已经从 7:00 开始了。使用 05 分可以确保 cron 任务稳定触发。

这样就能在工作时间内最大化利用额度！

✨ 特性

**🎯 核心优势**：

• 🚀 同时管理多个 Claude 账号 - 网上大多数工具只支持单账号，本工具可以一次性唤醒所有账号
• ⚡ 极致轻量 - 单个 Python 文件 + 最小依赖，无复杂配置，资源占用极低
• 🎨 简单易用 - 一键安装，自动配置，无需编程知识

**完整功能**：

• ✅ 支持多个 Claude 账号同时唤醒
• ✅ 自定义唤醒时间（最多 5 个时间点）
• ✅ 自动配置 crontab 定时任务（claude scheduler）
• ✅ 最小化 API 请求（短 prompt + 快速超时）
• ✅ 详细日志记录
• ✅ 错误处理（单个账号失败不影响其他账号）
• ✅ 支持 Linux 和 macOS

🚀 快速开始

部署建议

**推荐部署环境**：

• 🖥️ 常开机器：家用 NAS、云服务器、个人电脑等 24 小时运行的设备
• 💻 操作系统：macOS 或 Linux（推荐 Ubuntu/Debian）
• ⚠️ 注意：如果部署在个人电脑上，需要保持电脑开机以确保定时任务正常运行

**为什么需要常开机器？** 因为程序通过 crontab 定时任务运行，机器关机时任务无法执行。建议部署在服务器、NAS 或树莓派等常开设备上。

前置要求

1. Python 3.8+
2. uv (快速的 Python 包管理器)

   curl -LsSf https://astral.sh/uv/install.sh | sh

3. Claude CLI (用于获取 OAuth Token)

   npm install -g @anthropic-ai/claude-code

安装步骤

1. 获取 OAuth Token

为每个 Claude 账号获取 OAuth Token：

# 获取第一个账号的 token
claude setup-token

这会打开浏览器进行认证，完成后会在终端输出 token，类似：

Your OAuth token: sk-ant-oat03-...（很长的字符串）

**复制并保存这个 token**。

如果有多个账号，退出当前账号后重复此步骤：

# 在浏览器中登出 Claude
# 再次运行获取另一个账号的 token
claude set