◉CLAUDE LABEN
●WATERMARK — 11/16 から Opus 4.6・Sonnet 4.5 などの生成テキストに透かしが入ります。temperature などを既定以外にすると付かない場合があります●CC 2.1.325 — Claude Code の最新は 2.1.325(11/13)のまま、新しいリリースは出ていません●SONNET 4.5 — Claude API での提供終了は 11/30、残り13日。コードと保存済みのモデル設定を一度に洗い出してください●AUTOMATION — AI に組ませた定期実行が、回数や費用の見積もりなしで週の利用枠を使い切った、という報告が出ています●CONNECTOR — 新しい会話でだけコネクタが見えないときは、まず /mcp の一覧を以前の会話と見比べると切り分けが早くなります●NEW — Cowork の出来が落ちたと感じたら、同じ依頼を3回試す●WATERMARK — 11/16 から Opus 4.6・Sonnet 4.5 などの生成テキストに透かしが入ります。temperature などを既定以外にすると付かない場合があります●CC 2.1.325 — Claude Code の最新は 2.1.325(11/13)のまま、新しいリリースは出ていません●SONNET 4.5 — Claude API での提供終了は 11/30、残り13日。コードと保存済みのモデル設定を一度に洗い出してください●AUTOMATION — AI に組ませた定期実行が、回数や費用の見積もりなしで週の利用枠を使い切った、という報告が出ています●CONNECTOR — 新しい会話でだけコネクタが見えないときは、まず /mcp の一覧を以前の会話と見比べると切り分けが早くなります●NEW — Cowork の出来が落ちたと感じたら、同じ依頼を3回試す
記事一覧/API & SDK
⬡ API & SDK/2026-06-29上級

中間ファイルを毎回作り直さない — Code Execution のコンテナを跨いで多段パイプラインの状態を保つ

Code Execution ツールのコンテナを container ID で再利用し、生成済みファイルや前処理結果を次のリクエストへ持ち越す設計を解説します。実行時間課金の落とし穴と container_expired の安全な扱い方まで、実装コード付きで整理しました。

Claude API147Code Executionコンテナパイプライン3コスト最適化25

✦ プレミアム記事

最初に Code Execution ツールでデータ集計を任せたとき、私は同じ CSV を毎リクエストでアップロードし直していました。抽出して、整形して、集計して、グラフにする。工程を分けてリクエストを重ねるたびに、前のリクエストで作ったはずの中間ファイルが消えていて、また一からやり直しになる。個人開発で複数サイトの数値を自動でまとめている身としては、この「毎回ゼロから」が地味に実行時間を食っていることに、請求の内訳を見て気づきました。

原因は単純で、リクエストごとに別のコンテナが立ち上がっていたからです。Code Execution のコンテナは container パラメータで明示的に再利用しない限り、リクエストをまたいで状態を共有しません。逆に言えば、前のレスポンスが返してきた container ID を次のリクエストへ渡すだけで、作ったファイルも展開済みのデータも、そのまま引き継げます。今日はこの「コンテナを跨いで状態を保つ」設計と、その裏にある課金の実像、そして避けて通れない失効の扱いを、実装コードと一緒に整理します。

コンテナIDを渡すだけで、作ったファイルが次のリクエストに残る

仕組み自体はとても素直です。レスポンスには container オブジェクトが含まれていて、その id を次のリクエストの container パラメータに指定すると、同じワークスペースが再利用されます。

import anthropic
 
client = anthropic.Anthropic()  # APIキーは環境変数 ANTHROPIC_API_KEY から読み込まれます
 
# 1回目: ファイルを作って /tmp に保存する
response1 = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "乱数を1つ生成して '/tmp/seed.txt' に書き込んでください",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)
 
# レスポンスから container ID を取り出す
container_id = response1.container.id
 
# 2回目: 同じコンテナを再利用して、さっき書いたファイルを読む
response2 = client.messages.create(
    container=container_id,  # ← これだけで状態が引き継がれます
    model="claude-opus-4-8",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "'/tmp/seed.txt' の値を読み、その2乗を計算してください",
        }
    ],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)
 
print(response2)

ポイントは response1.container.id を保持して、2回目の container= に渡しているところだけです。これを忘れると、2回目は新しいコンテナで立ち上がり、/tmp/seed.txt は「そんなファイルはありません」になります。私が最初にハマったのは、まさにここでした。

何が「持ち越せて」何が「消える」のか

再利用と聞くと「全部そのまま続きから」と思いがちですが、引き継がれるものとそうでないものは分けて理解しておく必要があります。

ワークスペース上のファイルは残ります。/tmp や作業ディレクトリに書き出したものは、同じ container ID を指定する限りそのまま見えます。これが再利用の主役です。一方、会話のコンテキスト(messages 配列)は別物です。コンテナを再利用しても、前のやり取りの内容を Claude が覚えているわけではありません。状態は「ファイルとして残っている」だけなので、2回目のリクエストでは「どのファイルに何が入っているか」を改めて伝える必要があります。

もう一つ注意したいのが、Python の REPL 上の変数(メモリ上の状態)です。これは基本のツールバージョンでは引き継がれません。インメモリの変数まで保持したい場合は、REPL 状態の永続化に対応した新しいツールバージョン(code_execution_20260120 以降、Opus 4.5+ / Sonnet 4.5+ で利用可)が必要になります。ただ実務では、変数を抱え込むより節目ごとに中間結果をファイルへ書き出す方が、失効や再実行に強い設計になります。私はこの工程を、出力を必ずファイルへ落とす形に統一することを推奨します。実体験として、その方が失効や再実行にずっと強いからです。

対象同じコンテナ再利用で引き継がれるか
ワークスペースに書き出したファイル(/tmp 等)引き継がれる
Files API でマウントした入力ファイルコンテナ上に残る(再マウント不要)
Python の REPL 変数(メモリ状態)基本版では引き継がれない(20260120 以降で対応)
会話の文脈(messages の中身)引き継がれない(毎回伝え直す)
✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦container.id を渡してコンテナを再利用し、生成済みファイルと前処理結果を次のリクエストへ持ち越す具体的な実装
✦「ファイル同梱は呼ばれなくても実行時間課金」という見落としやすい課金トラップと、再利用で実行時間を削る考え方
✦container_expired を握りつぶさず、ソースから安全に作り直す防御パターン(30日失効・90秒セル上限を踏まえた段階設計)
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

⬡ API & SDK2026-08-01
会話の途中でツールを差し替える — プロンプトキャッシュを守るツールレジストリの設計
ターン間でツールを追加・削除できるようになった一方、ツール定義はキャッシュプレフィックスの最前列にあります。12種類の変更を指紋で実測し、安定コアと揮発テールに分けるレジストリ設計とガード実装をまとめました。
⬡ API & SDK2026-05-14
Claude API でアプリ内 AI チャットを実装して踏んだ6つの罠 — 本番投入までの設計記録
Claude APIをアプリ内チャットに組み込んで本番で直面した6つの設計ミスを、個人開発での実運用経験から解説。コンテキスト設計、ストリーミング、セッション管理、コスト監視の実装パターンを動くコード付きで紹介します。
⬡ API & SDK2026-05-12
Haiku 4.5・ストリーミング・プロンプトキャッシングを組み合わせて個人開発アプリのAPIコストを抑えた記録
個人開発アプリのAI機能で膨らむAPIコストを、Haiku 4.5への移行・ストリーミング・プロンプトキャッシングの3つの組み合わせで抑えた記録です。各ステップの実装と落とし穴、統合パターン、実装前後のコスト比較、キャッシュの損益分岐を先に計算する考え方までまとめました。