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

Claude Code×GitHub Actionsで、保守の自動チェックを月額メニューにする|定期実行と報告の下書き、人が見る線

    この記事は、Claude Code×GitHub Actionsで、保守の定期チェックを自動化し、月額の保守メニューとして売る方法を扱います。

    「毎月の点検」を、人が手で回していないか

    「毎月1日に、全サイトの表示とリンクと更新の有無を見ています」


    丁寧な保守です。けれど、サイトが20を超えると、この点検だけで数日が消えます。
    しかも、その時間は保守料の中に埋もれ、見積もりにも報告にも出てきません。


    点検は、決まった手順の繰り返しです。繰り返しは、仕組みに渡せます。
    人の時間は、仕組みが拾った「おかしい」の判断に使うべきです。

    GitHub Actionsの保守チェックとは、決まった日時やプルリクエストを合図に点検を自動で走らせ、結果の下書きまでを仕組みに任せる保守の工程である

    黒字化の外科医です。GitHub ActionsとClaude Codeで、保守の点検を「売れる工程」に変える手順を解剖します。


    仕組みに渡すべき理由は、三つあります。


    第一に、GitHub Actionsは、決まった時刻に処理を走らせられるから。
    scheduleという合図を使うと、POSIXのcron形式で日時を決めて実行できます。初期設定はUTC(協定世界時)で、最短の間隔は5分です(GitHub公式ドキュメント、2026年11月2日確認)。


    第二に、Claude Codeを、その仕組みの中で動かせるから。
    Claude Code GitHub Actions(anthropics/claude-code-action)は、リポジトリのワークフローの中でClaude Codeを動かす仕組みです。promptを渡すと、メンションを待たずに自動で動く「オートメーションモード」になり、結果は初期設定ではワークフローの実行ログに出ます(Claude Code公式ドキュメント、2026年11月2日確認)。


    第三に、点検の結果を「報告の下書き」まで進められるから。
    数字や差分は決まった処理で取り、Claude Codeには、その結果を読んで要点を書かせます。人は、下書きを読んで判断するだけになります。

    GitHub Actionsで、Claude Codeに渡せる範囲と渡さない範囲

    公式ドキュメントで確かめた、設計の前提を並べます(Claude Code公式ドキュメント・GitHub公式ドキュメント、2026年11月2日確認)。

    • 導入は、Claude Codeで /install-github-app を実行する方法と、手で設定する方法がある。どちらもリポジトリの管理者権限が必要
    • 認証の情報は、リポジトリのシークレット(ANTHROPIC_API_KEY など)に置く。ワークフローのファイルに直接書かない
    • 文章だけのpromptでは、Claude Codeはシェルを使えない。使ってよい道具を、claude_args の --allowedTools などで個別に渡す
    • --max-turns で1回の実行の往復を、ワークフローのタイムアウトで実行時間を、上限として決められる
    • 費用は、GitHub Actionsの実行時間と、Claudeの利用分の二つがかかる
    • scheduleの実行は、既定のブランチからだけ動く。混雑時は遅れることがある。公開リポジトリでは、60日間動きがないと定期実行が止まる

    渡すのは「読む・まとめる・下書きする」まで。本番への反映、プルリクエストのマージ、顧客への送信は、人に残します。

    今すぐ試せる:自社の保守点検を、自動化できる工程に分けるプロンプト

    私はWeb制作会社の経営者です。保守契約で毎月行っている点検を、GitHub Actionsで自動化できる工程と、人が残す工程に分けてください。
    
    【前提】
    ・保守しているサイトの数と種類:〔例:WordPress 12、静的サイト 8〕
    ・毎月の点検の項目:〔例:表示確認、リンク切れ、更新の有無、フォームの送信、表示速度〕
    ・1サイトあたりの点検時間:〔例:90分〕
    ・コードの置き場所:〔例:GitHubのプライベートリポジトリ〕
    ・自社の時間単価:〔例:8,000円〕
    
    1. 点検の項目ごとに「決まった処理で取れる」「AIに要約させる」「人が判断する」に分ける。
    2. 決まった処理で取れる項目に、実行の合図(毎月の定期実行/プルリクエスト)を割り当てる。
    3. 人が判断する項目について、判断の基準を1行で書く。
    4. 自動化した後の、1サイトあたりの人の作業時間の見込みを出す。
    5. 顧客のアカウントや鍵を扱う項目には、「要同意」と印をつける。
    
    断定できないことは「要確認」と書くこと。

    保守チェック工場:ワークフローの設計と月額の計算

    点検の分け方

    応答・リンク切れ・画面の差分・更新の有無は、決まった処理で取ります。その要点と月次報告の文面は、Claude Codeに下書きさせます。差分が意図した変更か不具合か、顧客に連絡するかは、人が判断します。


    画面の差分を取る方法は、こちらで扱っています。

    ▶ Playwrightのビジュアル回帰テストを保守メニューに組み込む──更新のたびに画面を目で全部見る作業を、スクリーンショット比較とClaude Codeの下調べに置き換える手順

    ワークフローの骨子

    合図:
     毎月1日の定期実行(UTCで指定。日本時間との差に注意)
     手動実行(workflow_dispatch)も付けておく
    
    権限:
     ワークフローの permissions は読み取りを基本にする
     Claude Codeに渡す道具は --allowedTools で必要な分だけ
    
    上限:
     --max-turns を決める
     ワークフローのタイムアウトを決める
    
    出力:
     結果は実行ログに残す
     報告の下書きは、人が読んでから顧客に送る

    月額の計算例

    (例)1サイトあたり、時間単価8,000円で計算
    
    手作業の点検:毎月3時間 × 8,000円 = 24,000円の原価
    
    自動化した後:
     人が結果を読み判断する時間:1.5時間 × 8,000円 = 12,000円
     実行の実費(GitHub Actions・Claudeの利用分。自社の請求で実測):例 1,000円
     原価の合計:13,000円
     粗利率40%を乗せた月額:13,000円 ÷(1 − 0.4)≒ 21,700円
    
    初期構築:8時間 × 8,000円 = 64,000円(別途お見積り)


    (数字はすべて例です。実費は、1か月動かしてから自社の請求で確かめてください)


    手作業のままなら、原価は24,000円です。自動化しても月額を大きく下げる必要はありません。浮いた時間を、速い連絡と丁寧な報告に回せば、同じ月額で中身が厚くなります。

    ▶ 保守にClaude Codeを入れたら、月額はどう見直すか──値下げだけで返さず「範囲・速さ・一部還元」の3つから選ぶ、1サイトの原価の計算例

    構造的なリスク

    逆説を指摘しておきます。


    自動化すると、「見ているつもり」が生まれます。
    仕組みが毎月動いていても、誰も結果を読んでいなければ、それは点検ではありません。


    もう一つは、鍵の扱いです。
    顧客のサイトやアカウントに触れる鍵をシークレットに置くなら、権限は最小にし、何をどこに置いたかを台帳に残し、契約と顧客の同意を先に取ってください。
    なお私は弁護士ではありません。実務の指針として読み、個別の判断は専門家や公的な窓口に確認してください。

    ▶ Claude Codeの失敗例と対策、制作会社で起きる「削除・暴走・コスト超過」──チェックポイント、権限、利用額の上限など公式の安全機能で先に止める

    よくあるQ&A

    Q. 顧客のコードが、GitHubにない。


    まずは自社のサイトや、GitHubで管理している案件から始めてください。顧客のコードを預かる場合は、置き場所と権限を契約で決めます。


    Q. AIの報告を、そのまま顧客に送ってよいか。


    送らないでください。下書きを人が読み、判断と責任を持てる文面にしてから送ります。

    最後に

    保守の点検は、繰り返しだから、仕組みに渡せます。


    点検を仕組みに渡し、浮いた時間を判断と報告に回した会社だけが、同じ月額のまま、保守の中身を厚くできるのです。

    これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。


    #Web制作会社 #ClaudeCode #GitHubActions #保守契約 #自動化 #CI #制作会社経営 #中小企業 #業務効率化 #AI活用

     
     
    Web制作・開発会社の「労働集約という病」をAIで冷徹に切除し、利益率を極限化する組織ハッキング術を公開。 人間の感情と作業を排除し、社長一人で莫大な富を搾取する「完全無人ファクトリー」を構築する覚悟を持つ経営者のみ、有料記事で圧倒的な暴利と勝利を手に入れてください。

    あなたへのおすすめ