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

【上級】Claude APIが途中で切れても続きから受け取る部品

    Claude API の長い出力が途中で切れると、受け取り済みの部分まで捨てて、最初から呼び直すことになります。私の作業場では毎晩 02:00 に AI の係が note の作り置きを回し、07:00 に1本を公開しています。

    10/28 からの自動公開は 13 本です。過去 28 日の note は表示 725・閲覧 76・スキ 23 です。同じ PC で YouTube の台本も書かせていて、未解決事件のチャンネルだけで動画は 111 本になりました。

    この作り置きが落ちる一番の原因は、長い出力を受信している途中の通信切れでした。画面には何も出ないので、翌朝ログを見るまで気づけません。1本あたり Claude の呼び出しは 15 回前後で、費用は約 620 円です。中でも一番長い出力を受け取る特典生成が 225 円で、最も高くつきます。ここで切れて最初から呼び直すと、費用も 18〜20 分の所要時間も、まとめて無駄になります。

    Claude API が途中で切れたときの再開のやり方

    よくある対処は3つあります。例外を捕まえて丸ごと再試行する、max_tokens(1回の出力の長さの上限)を上げる、ストリーミング(出力を少しずつ受け取る方式)にする、の3つです。どれも正しい対処ですが、夜間バッチで長い出力を受け取る場合は、次の問題が残ります。

    1. 途中まで受け取った文章が、例外が出た時点で消える

    2. 長さ上限で止まったのか、通信切れなのかを区別せずに扱ってしまう

    3. 続きを書かせると重複したり、コードの囲み(```)やファイル区切りが崩れたりする

    以前、どの工程まで終わったかを記録する「工程チェックポイント」を作りました。これで工程の単位では再開できるようになりました。ただ、1回の呼び出しの途中で切れると、その工程は最初からやり直しです。一番損の大きい呼び出しを丸ごと失う形が残っていました。

    もう1つ失敗があります。公開はできたのに記録の書き換えに失敗して、二重投稿しかけたことが1回ありました。今回の部品は、この2つの失敗をもとに設計しました。


    画像

    手で直す場合は、朝にログを読み、どこまで出ていたかを探し、続きを頼む文を書いて、つなぎ目を目で確かめます。本業の前に毎朝続けられる作業ではありませんでした。

    このツールでできること

    模擬応答に「ここで切れる」という印を入れ、切断を再現して確かめた範囲では、次のことができます。

    • 通信が切れても、受け取り済みの部分はファイルに残ります。同じ呼び出しを再実行すれば続きから受け取れるので、一番高い呼び出しを丸ごと捨てずに済みます

    • 止まった理由(正常終了・長さ上限・通信切れ)に応じて、どこまで残して続きを頼むかを部品が決めます。扱いに迷うことがなくなります

    • コードの囲みやファイル区切りが閉じていない出力は「完成」にしません。閉じ忘れを後の工程へ流しにくくなります

    部品は、次の役割でできています。

    • 受信と保存

    • 止まった理由の判定

    • 続きの依頼(受信済みの文章を渡す方式と、末尾を見せる方式を設定で切り替え)

    • つなぎ目の整えと完成の点検(つなぎ目の整えとは、続きの頭で繰り返された部分を削ること)

    • 費用と失敗の記録

    本番の API で実際に回線が切れたときの再開は、まだ確かめていません。


    画像

    完成イメージ

    resume_stream を開始します(模擬モード / 続きの方式: prefill / 続きの上限: 3回)
    [tokuten_code] attempt 1(初回): 通信切れ  断片 10 個 / 捨てた 26 文字 / 重複削除 0 文字
    [tokuten_code] attempt 2(続き): 正常終了  断片 12 個 / 捨てた 0 文字 / 重複削除 35 文字
    [tokuten_code] 完成しました → out\tokuten_code.txt
    [long_script] attempt 1(初回): 長さ上限  断片 6 個 / 捨てた 0 文字 / 重複削除 0 文字
    [long_script] attempt 2(続き): 長さ上限  断片 4 個 / 捨てた 0 文字 / 重複削除 0 文字
    [long_script] attempt 3(続き): 正常終了  断片 7 個 / 捨てた 0 文字 / 重複削除 0 文字
    [long_script] 完成しました → out\long_script.txt
    [never_closes] attempt 1(初回): 通信切れ  断片 4 個 / 捨てた 8 文字 / 重複削除 0 文字
    [never_closes] attempt 2(続き): 通信切れ  断片 3 個 / 捨てた 8 文字 / 重複削除 0 文字
    …(続きは有料部分の手順どおりに動かすと表示されます)
    

    (公開前に実際に動かしたときの画面表示です)

    ここまでにやる作業は、特典プロンプトを Claude Code に貼るか、完成品のコードを保存して1行実行するかのどちらかです。コードを書く作業はありません。API キーがなくても、最後まで動きます。

    こんな場面で便利

    • 深夜2時: 特典コード一式を受信している途中で回線が切れても、受け取り済みの部分は残ります。次の起動で続きから受け取れます

    • 朝の公開前: 開くのは失敗一覧だけです。上限まで続きを頼んでも完成しなかったものが、理由付きで載ります

    • 週末の振り返り: 続きの呼び出しにいくら使ったかを、初回と分けて原価として確認できます

    有料部分で手に入るもの

    • 実行ステップ(構成とデータの流れ・模擬と本番の切り替え)と設計の判断

    • Claude Code に貼るだけで作れるプロンプトの全文

    • 動作確認済みの完成品のコード

    • 場面別の記入例テンプレ(3パターン)

    • つまずき対処と、Claude Code に伝える言葉

    • カスタマイズ集

    • 実例と数字

    • 次の一歩

    買う前の不安に答えます

    Q. Claude API の費用はいくらかかる?

    模擬モードは API を呼ばないので 0 円です。本番の費用はモデルと出力の長さで変わり、私の環境では特典生成1回が約 225 円でした。続きの呼び出しは受信済みの文章も入力に含むので、そのぶん高くなります。部品が初回と続きの費用を分けて記録するので、自分の実測をもとに見積もれます。

    作り方は2通りあります。

    • A: Claude Code で作る(Claude の有料プランが必要)

    • B: 完成品のコードを保存して使う(無料の Python だけで動く。本番で API を呼ぶときだけ anthropic を追加)

    Claude Code を持っていなくても、B の方法で使えます。

    Q. 本番で使える品質?

    公開前に、プロンプトからコードを生成し、インストール・起動・pytest まで通しました。プロンプトは1回目で合格し、テストは18本あります。認証エラーのように続きを頼んでも意味のない失敗は、別に分けて止めます。再実行しても結果は変わらず、呼び出し回数も増えません。経過は1回の呼び出しごとにログへ残ります。

    止まった理由の分け方やつなぎ目の扱いは、一言頼むだけだと何度も直すことになりやすい所です。特典プロンプトには、その判断をあらかじめ書き込んであります。ただし、実際の回線切れでの再開、切れる頻度、浮いた金額は未検証です。有料部分では、確かめた所と未検証の所を分けて書いています。

    Q. 自分の仕組みに組み込める? 仕様が変わったら?

    標準ライブラリだけで書いた小さな部品で、呼び出しごとの ID で動きます。今あるバッチのうち、長い出力を受け取る呼び出しだけを差し替える使い方を想定しています。書き出し(assistant の冒頭を先に渡すこと)を受け付けないモデルに変えた場合も、設定を1行変えれば、末尾を見せて続きを頼む方式に切り替えられます。

    まとめ: Claude API が途中で切れても続きから受け取る


    画像

    Claude API が途中で切れても、受け取り済みの部分を残して続きから受け取り、つなぎ目を点検してから完成にする部品です。朝のログ探しと、一番高い呼び出しのやり直しを減らせます。有料部分の最初の手順は、API キーなしで結果の表を1枚出すところから始まります。

    ▼ あわせて読みたい

     
     
    プログラミング未経験でも作れる、AI製の小さな道具を紹介しています。副業の事務、記事づくり、家事の見える化など。記事には動作確認済みのプロンプト全文と完成品コード、つまずき対処法を付けています。Threads: @xmarlx6

    あなたへのおすすめ