メインコンテンツへスキップ
見出し画像

claude.ai のルーティンが指定時刻に動かない

    claude.ai のルーティンを朝8時に設定したのに、夕方5時に動いていました。

    原因は、cron の式が UTC で読まれていたことです。日本時間より9時間遅れて動きます。

    ルーティン(クラウドで動く定期実行)を cron で設定していて、時刻がずれる人向けです。僕が9月にはまったときの記録と、10月末に公式ドキュメントを読み直して分かったことを書きます。


    何が起きたか

    Claude の利用制限を見張るルーティンを作って、1日3回動かすつもりでした。

    cron に書いたのは、これです。

    0 8,13,18 * * *

    claude.ai の画面にも、こう出ていました。

    08:00 AM, 01:00 PM と 06:00 PM

    朝8時・昼1時・夕方6時。思ったとおりです。

    ところが、実行の履歴はこうでした(日本時間)。

    17:01
    22:04
    翌 03:02

    ……全部、9時間ずれてる?


    最初に疑って外れたこと

    タイムゾーンの設定がどこかにあるはずだ

    9時間なら、日本と UTC の時差そのものです。

    だったら、タイムゾーンを日本に合わせる項目がどこかにあるはずだ。そう思って探しました。

    設定画面には、タイムゾーンを選ぶ場所がありませんでした。

    ルーティンを作る API(/v1/code/triggers)の返事も見ました。timezone を表す項目そのものが無い。

    えっ、指定できないの……?

    しかも、画面の「08:00 AM」は日本時間に直した値ではありませんでした。cron に書いた値を、そのまま出していただけです。だから画面を見ても、ずれに気づけません。


    画像

    本当の原因:cron の式だけなら UTC

    2026-10-30 に公式ドキュメントを読み直すと、はっきり書いてありました。

    (ルーティンは、今のドキュメントでは「scheduled tasks(以前の routines)」という名前になっています。)

    ドキュメントによると、cron の式を5つの欄だけで書いたときは、時を UTC で書くことになっています。たとえば 0 9 * * 1-5 は、平日の UTC 9:00 に動きます(Claude Code のドキュメント「routines」・2026-10-30 取得)。

    同じ箇所には、ほかに2つのことも書かれていました。

    • 画面のプリセット(毎時・毎日・毎週など)を選んだときは、自分の地域の時刻で入力する

    • 式の頭に CRON_TZ= が付いていれば、その地域の時刻で書く

    僕がはまった9月の時点では、API の返事に timezone の項目が無く、指定する手段を見つけられませんでした。

    CRON_TZ= が使えるなら、今は9時間を引かなくても済むのかもしれません。ただ、僕はまだ CRON_TZ= を試していません。 なので下の直し方は、9月に実際に動いた方法のほうで書きます。


    解決:日本時間から9時間引いて書く

    動かしたい日本時間から、9時間引いた値を cron に書きます。

    日本時間の 3:00・8:00・13:00・18:00 に動かしたいなら、こうなります。

    0 4,9,18,23 * * *

    対応はこうです。

    日本時間  3:00  → cron は 18(前の日)
    日本時間  8:00  → cron は 23(前の日)
    日本時間 13:00  → cron は  4
    日本時間 18:00  → cron は  9

    日付をまたぐので、並び順が直感と合いません。書いた直後は、合っているのか不安になります。

    答え合わせは next_run_at で

    設定したあとは、画面の表示ではなく next_run_at を見ます。

    次に動く時刻が、ISO 形式(UTC)で返ってきます。そこに9時間足して、狙った日本時間になっていれば大丈夫です。


    同じ罠がありそうな場所:同じ cron でも、ローカルは逆

    ここも混乱したので書いておきます。

    Claude Code には、定期実行の仕組みが2つあります。時刻の読み方が逆です。

    • クラウドのルーティン:claude.ai の上で動く。cron の式だけなら UTC

    • ローカルの定期タスク:デスクトップアプリが起動している間だけ動く。自分のパソコンの時刻

    ローカルのほうは、公式ドキュメントにも、Custom の cron の式は自分のパソコンの時刻で読まれる(0 9 * * * なら毎日朝9時)とあります(Claude Code のドキュメント「desktop scheduled tasks」・2026-10-30 取得)。

    同じ「cron を書く」なのに、片方は UTC、片方は手元の時刻。

    時刻がずれたら、まず「どちらの仕組みの話か」を確かめる。ここを取り違えると、正しい値を書いているのに動かない、ということになります。


    締め

    claude.ai のルーティンが指定時刻に動かないのは、cron の式が UTC で読まれているからでした。画面の表示も式の値のままなので、見ても気づけません。

    9月の僕は、日本時間から9時間引いて書いて直しました。答え合わせは next_run_at です。

    今のドキュメントには CRON_TZ= の書き方も載っているので、試したらまた書きます。


    この「詰まりと解決」は毎日1本ずつ書いています。昨日は、ターミナルの claude -p だけがログイン切れで止まった話でした。明日は、Windows の Python で日本語の出力が化ける話です。フォローしてもらえると、次の回が届きます。

     
     
    Claude Code を使い続けて、入門記事では足りなくなった人へ。工学部の大学生の僕が、実際に詰まったことと直し方、作ったアプリの作り方、Claude の使い方の工夫を毎日書いています。詰まった数だけ記事が増えます。下書きは AI、仕上げは僕です。

    あなたへのおすすめ