Claude Code の schedule で現在のセッション使用上限のリセット時間をコントールする

Posted at 2026-04-30

はじめに

Claude のトークン使用量には上限があり、一定時間ごとにリセットされます。
現時点では、5時間間隔でリセットが発生します。

毎朝9時（JST）にセッションを開始すると、リセットのタイミングが次のように並びます。

09:00 → 14:00 → 19:00 → 00:00（翌日）→ 05:00 → ...

日中の主要な作業時間帯（9時・14時・19時）に新鮮なトークン枠が確保されます。
これは Claude を使い倒す上でかなり有利なサイクルです。

問題は、「毎朝9時にセッションを開始する」という行為を自動化したい点です。

そこで Claude Code の /schedule スキルを使います。
Anthropic のクラウド上でエージェントが毎朝9時に自動起動するため、ローカルマシンは起動していなくてかまいません。

この記事では、毎朝9時のセッション起動を自動化する手段として /schedule を活用し、ClaudeのコネクタからGoogle Calendar連携して、イベント登録してもらいます。

最終成果物として、毎朝このようなイベントが Google Calendar に自動追加されます。

今回は RemoteTrigger APIなどでmcp設定を見るので Claude Code（プロンプト）から作成してもらいます。

Web UI では https://claude.ai/code/routines で確認できますが、より詳細なものは現時点ではClaudeCodeからRemoteTriggerを実行してもらうのが良いです。

/schedule スキルとは何か

Claude Code の /schedule は、RemoteTrigger API を通じて Anthropic のサンドボックス環境でエージェントを cron 定期起動できる仕組みです。

重要な特徴を整理しておきます。

ローカルの Claude Code セッションが落ちていても動く
設定した MCP コネクターをそのまま利用できる
実行ログが claude.ai/code/routines に残る

ルーティン定義の主要な構成要素は次のとおりです。

フィールド	役割
`cron_expression`	起動タイミング（UTC 基準）
`allowed_tools`	エージェントが使えるツールの許可リスト
`mcp_connections`	接続する MCP サーバーの定義
`events[].message.content`	エージェントに渡すプロンプト

サンドボックス環境はネットワーク制限があります。
任意の外部 API を curl や WebFetch で叩ける保証はありません。
この制限が後ほど天気取得で大きな障壁になります。

全体設計: 毎朝9時 JST に何をさせるか

処理の流れは次のとおりです。

JST 基準で明日の日付を取得する
東京の明日の天気データを取得する
天気情報を日本語に整形する
Google Calendar に終日イベントを登録する

Step 1: Google Calendar MCP コネクターを接続する

まずブラウザで次の URL にアクセスして、Google Calendar コネクターを追加します。

「Google Calendar」を選択して OAuth 認証を完了させてください。

Step 2: コネクター UUID を取得する

mcp_connections フィールドには connector_uuid を指定する必要があります。
ところが、公式ドキュメントにはこの UUID をどこから取るかが明記されていません。

コネクターを設定ページで表示すると、URL が次の形式になっています。

https://claude.ai/settings/connectors/{uuid}

この {uuid} 部分がそのまま connector_uuid として使える値です。

ブラウザのアドレスバーをコピーして UUID を取り出してください。

UUID は小文字のハイフン区切り（v4 形式）です。
例: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Step 3: MCP サーバー URL を特定する

mcp_connections には connector_uuid だけでなく url フィールドも必要です。
これを省略すると HTTP 400 エラーが返ります。

では URL はどこから取るのか。
これも公式ドキュメントには明記されていません。

Google Calendar MCP ツール（mcp__claude_ai_Google_Calendar__authenticate など）のスキーマを ToolSearch で読み込むと、description の中に MCP サーバー URL が書かれていることがわかります。

Google Calendar の MCP サーバー URL は次のとおりです。

https://calendarmcp.googleapis.com/mcp/v1

最終的な mcp_connections の記述例はこちらです。

"mcp_connections": [{
  "connector_uuid": "<コネクターUUID>",
  "name": "Google-Calendar",
  "url": "https://calendarmcp.googleapis.com/mcp/v1"
}]

url フィールドを省略すると HTTP 400 が返ります。
必ず指定してください。

Step 4: 天気データ取得でひたすらハマった話

ここが今回の最大のクライマックスです。
試行錯誤の全記録を書きます。

(a) wttr.in を curl → 403

最初に試みたのは、天気 API として定番の wttr.in を Bash の curl で叩く方法です。

curl "https://wttr.in/Tokyo?format=j1"

結果: 403 Forbidden。
サンドボックスのアウトバウンド制限に引っかかりました。

(b) open-meteo.com に切り替え → 同じく 403

次に、オープンソースで無料の気象 API である open-meteo.com を試しました。

curl "https://api.open-meteo.com/v1/forecast?latitude=35.69&longitude=139.69&daily=temperature_2m_max&timezone=Asia/Tokyo"

結果: 同じく 403。

(c) Bash の curl 自体がホスト許可リスト制限でブロック

2 つ試して同じ結果になったので、curl そのものの問題を疑いました。
サンドボックスには許可された外部ホストのリストがあり、任意のホストには接続できないようになっています。

(d) WebFetch も制限に当たる

WebFetch ツールを使って同じ URL にアクセスしてみました。
これも同様にブロックされました。

(e) WebSearch で「東京明日の天気」を検索 → 安定して取得できる

試行錯誤の末、WebSearch ツールで検索する方法が安定して動くことがわかりました。

WebSearch: "東京 明日の天気"

tenki.jp や Weather.com などの検索結果から天気情報を抽出できます。
最高気温・最低気温・天気概況・降水確率が揃ったデータを取得できます。

得られた知見

リモートサンドボックスでは任意の外部 API を curl や WebFetch で叩けません。
外部データを取得する場合は、MCP コネクター経由か WebSearch を使う設計にする必要があるみたいです。

Step 5: allowed_tools に WebSearch を追加する

デフォルトの allowed_tools には WebSearch が含まれていません。
明示的に追加しなければ、エージェントは WebSearch を使えません。

最終的に採用した allowed_tools セットはこちらです。

"allowed_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]

WebSearch だけでなく WebFetch も入れているのは、エージェントが URL から詳細情報を取得しようとする場合に備えるためです。
サンドボックスの制限で実際には動かないケースもありますが、ツールとして使える状態にしておくことで、エージェントが代替手段を選択しやすくなります。

Step 6: 日付ズレ問題 — UTC と JST の境界で事故る

エージェントが Bash の date コマンドを実行すると、UTC 時刻が返ります。

date -d "tomorrow" +%Y-%m-%d
# UTC 00:05 に実行すると UTC 翌日 = JST 同日 になる

JST 09:00 に起動するルーティンの場合、UTC では 00:00 です。
date -d "tomorrow" を UTC で実行すると、JST の「明日」より1日ずれた日付が返ることがあります。

対策として、TZ 環境変数を指定して JST 基準で日付を取得します。

TZ=Asia/Tokyo date -d "tomorrow" +%Y-%m-%d

プロンプトにこのコマンドを明示的に書いておくことで、エージェントが正しい日付を取得できます。

date コマンドを素のまま使うと UTC 基準になります。
JST で「明日」を取得するには必ず TZ=Asia/Tokyo を付けてください。

完成したルーティン定義

エージェントに渡すプロンプト全文

You are a weather assistant. Follow these steps carefully:

## Step 1: Get tomorrow's date in JST
Run this bash command:
TZ=Asia/Tokyo date -d "tomorrow" +%Y-%m-%d
Save the result as TOMORROW_DATE (format: YYYY-MM-DD).

## Step 2: Fetch tomorrow's Tokyo weather via WebSearch
Use the WebSearch tool with this query:
"東京 明日の天気"

From the search results, extract:
- max temperature (C)
- min temperature (C)
- weather condition (text in Japanese)
- precipitation probability (%)

Use whichever result contains the most complete data for TOMORROW_DATE.

## Step 3: Convert weather condition to Japanese if needed
If the condition is already in Japanese, keep it as-is.
If it is in English, map it:
- Clear / Sunny -> "快晴"
- Mostly Sunny / Partly Cloudy -> "おおむね晴れ"
- Mostly Cloudy -> "一部曇り"
- Cloudy / Overcast -> "曇り"
- Rain / Showers -> "雨"
- Snow -> "雪"
- Thunderstorm -> "雷雨"
- Other -> "不明"

## Step 4: Create Google Calendar event
Use the Google Calendar MCP tools to create an all-day event:
- calendarId: "primary"
- Date: TOMORROW_DATE
- Title: "東京の天気: [condition] [max_temp]C"
- Description: "最高: [max_temp]C / 最低: [min_temp]C / 降水確率: [precip]% / Source: [source name]"
- Reminders: useDefault=false, overrides=[{"method": "popup", "minutes": 120}]
  (120 minutes before midnight UTC = 07:00 JST on the event day)

First check if an event with '東京の天気' already exists for TOMORROW_DATE.
If yes, update it. If no, create a new one.

## Step 5: Confirm
Report the final event title, date, description, and reminder setting to confirm success.

RemoteTrigger API create body

{
  "name": "東京明日の天気 to Google Calendar",
  "cron_expression": "0 0 * * *",
  "enabled": true,
  "job_config": {
    "ccr": {
      "environment_id": "<environment_id>",
      "session_context": {
        "model": "claude-sonnet-4-6",
        "sources": [],
        "allowed_tools": [
          "Bash",
          "Read",
          "Write",
          "Edit",
          "Glob",
          "Grep",
          "WebFetch",
          "WebSearch"
        ]
      },
      "events": [{
        "data": {
          "uuid": "<lowercase-v4-uuid>",
          "session_id": "",
          "type": "user",
          "parent_tool_use_id": null,
          "message": {
            "role": "user",
            "content": "<上記プロンプト全文>"
          }
        }
      }]
    }
  },
  "mcp_connections": [{
    "connector_uuid": "<コネクターUUID>",
    "name": "Google-Calendar",
    "url": "https://calendarmcp.googleapis.com/mcp/v1"
  }]
}

<environment_id> は Claude Code の設定画面から確認できます。
<lowercase-v4-uuid> は任意の v4 UUID を小文字で生成してください。

python3 -c "import uuid; print(uuid.uuid4())"

運用してみてわかったこと・落とし穴まとめ

実際に数日間運用して気づいたことを整理します。

コネクターを追加後は Claude Code を再起動しないと /schedule に反映されない
MCP サーバー URL は省略不可。url フィールドを必ず指定する
サンドボックスでは任意の外部 API を curl できない。WebSearch か MCP を使う
日付は TZ=Asia/Tokyo date -d "tomorrow" で JST 基準を明示する
終日イベントのリマインダー分数は UTC midnight からの逆算になる
実行ログは https://claude.ai/code/routines で確認できる
同日に重複して実行された場合のために、プロンプトに「既存イベントがあれば更新する」ロジックを入れておく
WebSearch の結果は検索エンジンの仕様変更に依存するため、稀にデータ取得が失敗することがある

実行ログページでは、各ルーティンの実行結果（成功・失敗・エラーメッセージ）を確認できます。
初期設定後は必ずログを確認して、期待どおりに動いているかチェックしてください。

発展: 他のルーティンにも応用するには

「WebSearch で情報取得 → 整形 → MCP で書き込み」というパターンは、他のルーティンにもそのまま応用できます。

朝のニュースダイジェスト

WebSearch でその日のニュース検索 → 要約 → Google Calendar や Slack に投稿

GitHub 通知サマリ

GitHub MCP コネクターで通知を取得 → 重要度でフィルタ → Slack MCP で送信

週次レビューの自動作成

毎週月曜に先週の Google Calendar イベントを一覧取得 → GPT で要約 → Google Docs に保存

共通のパターンとして意識しておくべき点があります。

外部データ取得は WebSearch か MCP コネクター経由にする
日付・時刻操作は必ずタイムゾーンを明示する
重複実行に備えて「既存があれば更新」ロジックを入れる
allowed_tools は必要なものを明示的に列挙する

おわりに

/schedule は Claude Code を「クラウド常駐エージェント」として機能させられる強力な仕組みです。
設定さえ済めば、ローカルマシンを起動しなくても毎日決まった時刻にエージェントが動き続けます。

一方で、次の3点を押さえていないとほぼ確実に詰まります。

サンドボックスのネットワーク制限
UTC と JST のズレ
MCP 接続設定の細かい仕様

これらのハマりどころを先に知っておけば、設定自体は難しくありません。
ぜひ天気以外のルーティンにも応用してみてください。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up