Claude Codeの定期タスクはコネクタと鍵とpush先を絞って動かす

この記事の目次
Claude Codeの定期タスクで毎朝の集計や報告を自動にするときは、作る前にその仕事で使わないコネクタを外して鍵とpush先を絞るのが先です。書き込みのあるコネクタを使う仕事なら使わないコネクタを外しAPIの鍵を環境変数ではなくnetwork secretsに置いて、mainへのpushをGitHubの側で止めてから動かすのが弊社の結論です。反対にリポジトリを読んで結果を自分あてに報告するだけの仕事なら、初期の設定のままで動かして問題ありません。
初期の設定のままだと任せる範囲は広くなります。Claude Code公式の定期タスクの説明によると定期タスクを作るとつないでいるコネクタはすべて初期で入り、実行中のClaudeは書き込みも含めて使えます。
この記事では定期タスクがどこでどう動くのかと、任せる範囲を絞る3つの場所を順に説明します。そのうえで2026年11月時点の公式の説明に沿って作り方と1回目の確かめ方を書きます。
Claude Codeの定期タスクはクラウドで無人で動く
Claude Codeの定期タスク(以前の名前はルーティン)は、指示とリポジトリとコネクタを1つにまとめて保存し決まった時刻に動かす機能です。公式の説明では、動く場所はAnthropicのクラウドなのでパソコンを閉じていても止まりません。
動かすきっかけは3つあります。1つ目は毎時や毎日のような決まった時刻で、2つ目は専用のURLにHTTPのPOSTを送る呼び出しです。3つ目はプルリクエストやリリースのようなGitHubの出来事です。2026年11月時点ではresearch preview(試験的な提供)で、Pro・Max・Team・Enterpriseのプランで使えます。
作り方は claude.ai/code/routines の画面かデスクトップのアプリか、端末で /schedule を打つ方法の3つです。どれで作っても同じアカウントに保存されます。
回数には上限があります。時刻で動く回はアカウントで1時間に100回までで、1時間より短い間隔のcronの式は受け付けられません。
定期タスクはチームで共有されず作った人のアカウントに属するので、コネクタでの操作やコミットとプルリクエストは作った人の名前で行われます。
定期タスクは作った人の名前で無人で動くので、何に触れるかを作る前に決めておく必要があります。
新しい回はauto modeで始まりコネクタは全部入る
定期タスクを作る画面で権限のモードは選びません。公式の説明ではAnthropicのクラウドで始まる回はauto modeで始まり、分類のモデルが操作を通すか止めるかを決めます。
auto modeは操作ごとに止めるかどうかを判断するもので、確かな線引きではありません。Claude Code公式の権限のモードの説明では分類のモデルが3回続けてか合計20回止めると確認を求める形に戻り、誰かが答えるまで待つとされています。確実に止めたい操作は分類のモデルに任せずにdenyのルールを書くよう案内されています。
前の節のとおり定期タスクは無人で動くので、確認を求める形に戻った回は誰かが画面を開くまで止まったままになります。
コネクタは初期ですべて入ります。公式の説明では作る画面の「Advanced settings」の「Connectors」のタブに今つないでいるコネクタがすべて並び、使わないものは自分で外すよう書かれています。
auto modeは操作を止めることはあっても範囲を決めることはしないので、任せる範囲は作る人が先に絞ります。
鍵とpush先は環境とGitHubの側で止める
任せる範囲を絞る場所はコネクタとクラウドの環境とGitHubの3つです。どれも定期タスクの外にある設定なので、指示の文で「書き込まないで」と頼むよりも確かに効きます。
APIの鍵は環境変数ではなくnetwork secretsに置く
Claude Code公式のクラウドの環境の説明では、環境変数はその環境を使う人なら誰でも読めると書かれています。実行中に呼ぶAPIの鍵はnetwork secretsに置くよう案内されています。
network secretsはAnthropicの中継のサーバーが指定したホストへの通信にだけ鍵を足す設定で、鍵は実行中の環境の変数にもファイルにも現れません。ただしGitHubとAnthropicのAPIと主なパッケージの配布元への通信には足されず、環境を作るときのスクリプトの通信にも足されません。
push先はGitHubのブランチの保護で止める
公式の説明では、Claudeは指示で別のブランチを指定されない限り claude/ で始まるブランチに作業をpushします。指示の書き方しだいでmainにもpushできるので、どのブランチにpushできるかはGitHubのブランチの保護かルールセットで決めます。
見落としやすいのは保護を飛ばせる権限です。公式の説明ではGitHubはつないだアカウントの権限で保護を確かめるので、そのアカウントが保護を飛ばせるなら定期タスクのpushも止まりません。
鍵はnetwork secretsに置きpush先はGitHubで止めれば、指示の文が多少ずれても書き込める範囲は広がりません。
定期タスクに任せてよい仕事と任せる前に絞る仕事
絞るかどうかは、書き込むか・外のAPIの鍵を使うか・誰に結果が届くかで決まります。社内で説明するときは次の表をそのまま使えます。
確かめること | 初期の設定で動かしてよい | 任せる前に絞る |
|---|---|---|
リポジトリへの書き込み | 読むだけでpushしない | コミットやプルリクエストを作る |
コネクタの使い方 | 使わないか読むだけ | Slackへの投稿やチケットの作成のように書き込む |
外のAPIの鍵 | 使わない | 使う |
結果が届く先 | 自分だけ | 社内のほかの人やお客さま |
右の列が1つでもあるなら、使わないコネクタを外し鍵をnetwork secretsに移しpush先を保護してから動かしてください。どれも1回の設定で済み、毎回の指示を書き直す必要はありません。
4つとも左の列なら、初期の設定のままで問題ありません。指示に書き込む作業が無く、pushしたとしても claude/ で始まるブランチに入るからです。
弊社もこの表の右の列に当たる仕事を、外すものを決めないまま全部自動にすることはすすめません。
定期タスクを作って1回目を確かめる手順
2026年11月時点・Claude Codeの定期タスク(research preview)・Anthropicのクラウドの環境で動かす場合の手順です。画面の名前は公式の説明で確かめたもので、research previewのため変わることがあります。
- GitHubで対象のリポジトリの設定を開き、mainなど守りたいブランチにブランチの保護かルールセットを入れます。つないでいるアカウントが保護を飛ばせる設定になっていないかも見ます。
- claude.ai/code で使うクラウドの環境を編集し「Network secrets」の行から鍵を足します。「Allowed websites」にはAPIのホストだけを書き、同じ鍵が「Environment variables」に残っていれば消します。
- claude.ai/code/routines で「New task」を押して名前と指示を書きます。指示には何をすれば終わりかと、pushしてよいブランチを書きます。
- 「Advanced settings」の「General」のタブでリポジトリと手順2の環境を選び、「Connectors」のタブで使わないコネクタを外します。
- 時刻を決めます。cronの式で書くときは5つの欄だけなら時刻はUTCで、頭に
CRON_TZ=を付けるとその地域の時刻で書けます。公式の説明では毎時0分ちょうどは数分遅れることがあるので、少しずらすのがすすめられています。CRON_TZ=Asia/Tokyo 7 9 * * 1-5 - 「Create」で作り、詳しい画面の「Run now」で1回だけ動かします。
- 「History」の一覧から今の回を開き、使ったコネクタとpushしたブランチと止められた操作を読みます。
うまくいったかは手順7で判断します。外したコネクタの呼び出しが無くpushが claude/ で始まるブランチだけなら、コネクタとpush先の設定は効いています。鍵の値が記録のどこにも出ていないことも確かめます。
やりがちな失敗は「History」の一覧に「Error」が出ていないことだけで成功と判断することです。公式の説明では通信が止められた回やコネクタの道具が見つからなかった回も一覧では成功と表示されるので、記録を開いて中身を読む必要があります。auto modeで止まった操作を数える方法は止めた操作を記録で数える記事で説明しています。
弊社がやっていること
弊社ではコラムの公開と分析の数字の取り込みと記事のサムネイルづくりを自動にしています。どれも人が最後に確認してから先へ進む形にしていて、全部を自動にはしていません。
つないだサービスの仕様が変わったりアクセストークンの期限が切れたりすると、自動化は止まります。そのため弊社では止まったことに気づく監視と直す手順も自動化と一緒に用意しています。
読んで自分あてに報告するだけの定期タスクなら、上の手順で御社の中で進められるので弊社に頼む必要はありません。Claude Codeに鍵を読ませない設定は.envとサンドボックスの記事にまとめています。
書き込みのある業務の自動化で人が確認する所をどこに置くか迷うときは、業務の自動化のページをご覧ください。相談の窓口からもご連絡いただけます。初回の30分は無料です。
よくある質問
定期タスクは自分のパソコンを閉じていても動きますか
動きます。クラウドの定期タスクはAnthropicのクラウドで動くので、パソコンを閉じていても決まった時刻に始まります。
指示の文で書き込まないでと頼めば十分ですか
十分ではありません。指示の文は分類のモデルの判断に頼るので、確実に止めたい書き込みはコネクタを外すかGitHubのブランチの保護で止めます。
APIの鍵を環境変数に入れたままでもよいですか
Anthropicのクラウドの環境ならnetwork secretsに移してください。環境変数はその環境を使う人なら誰でも読めると公式の説明に書かれています。
Historyに成功と出ていれば作業は終わっていますか
終わっているとは限りません。通信が止められた回やコネクタの道具が見つからなかった回も成功と表示されるので、回を開いて記録を読みます。