◉CLAUDE LABEN
●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です
MEMBERSHIP

メンバーシップ

実装コード付きの上級ガイドが読み放題

Claude Lab をご覧いただきありがとうございます。コピー&ペーストで使える実装コード、ベンチマーク結果、本番設計パターンを含む上級ガイドを毎日追加しています。無料記事で基礎を学んだ後の「次の一歩」として、お役に立てれば幸いです。

  • ✦すべてのプレミアム記事が読み放題
  • ✦毎日追加される実装コード付き上級ガイド
  • ✦本番環境で使える設計パターン・ベストプラクティス
PREMIUM ARTICLES

プレミアム記事

433 本の限定記事
PREMIUM◈ Cowork/2026-06-23上級

無人の記事生成タスクが『ほぼ同じ記事』を二度書く前に止める重複検出ゲート

Cowork のスケジュールタスクで毎日記事を生成していると、無人ゆえに数日前と中身がほぼ重なる記事を作ってしまいます。公開直前に slug の類似度と当日ログを照合して重複を止めるゲートを、実際に誤公開を防いだ実装とともにお届けします。

PREMIUM⬡ API & SDK/2026-06-22上級

Claude Files API のファイルが知らぬ間に溜まる — 内容ハッシュ台帳で重複を止め、孤児を回収する

自動パイプラインで Files API を使うと、同じファイルが何度もアップロードされ孤児ファイルが静かに溜まります。内容ハッシュ台帳での重複排除と、参照されなくなったファイルの GC 設計を実装例つきで解説します。

PREMIUM⬡ API & SDK/2026-06-22上級

Claude API の静的キーをやめる — Workload Identity Federation で CI と本番を鍵なしに切り替える

Claude Platform で一般提供が始まった Workload Identity Federation を使い、sk-ant- 形式の静的キーを数分で失効する OIDC トークンへ移行する設計を扱います。GitHub Actions の鍵なし認証、移行手順、トークン更新まで具体的に整理しました。

PREMIUM⬡ API & SDK/2026-06-22上級

Claude API のコスト計算が請求と合わないとき — usage の4トークンバケットを正しく会計する

プロンプトキャッシュを有効にすると、自前のコスト集計とコンソールの請求額が食い違うことがあります。input_tokensにキャッシュ分が含まれない仕様、単価の異なる4つのトークンバケットの重み付き会計、1コール1行で突合できる台帳の組み方までを運用上の注意とともにまとめました。

PREMIUM⬡ API & SDK/2026-06-22上級

Claude API のストリーミングは「全部届く」前提が崩れる — 部分失敗を回復に変える運用メモ

Claude API のストリーミングは、同時接続が増えた途端に途中で切れ・重複し・半端なツール引数を吐きます。部分失敗を異常ではなく前提として扱い、静かに回復させるための実装と監視を、運用で削れた具体例とともにまとめました。

PREMIUM⬡ API & SDK/2026-06-22上級

pause_turn の継続ループに上限を入れる — 無人で長時間サーバーツールを安全に回す

web_search や code execution など長時間サーバーツールを使うと返ってくる pause_turn を、無人運用で安全に継続する設計をまとめました。4種類の stop_reason を1ループで分岐し、継続回数と時間に上限を入れ、セグメントを跨ぐ usage を数える実装まで扱います。

PREMIUM⬡ API & SDK/2026-06-21上級

90秒で切られるコード実行セルを跨いで、長いバッチをチェックポイント分割で回す

Claude のコード実行ツールはセル単位で90秒の上限が明示されました。長いバッチがここで打ち切られないよう、コンテナのファイルシステムへ進捗を残してセルを跨いで再開する設計を、計測・冪等なチェックポイント・撤退判断まで実装コード付きで整理します。

PREMIUM◈ Cowork/2026-06-21上級

Cowork の bash が『ファイルがありません』と言うのに Finder には見える理由

クラウド同期フォルダを Cowork に接続すると、bash からは実体のないプレースホルダが見え、cat が失敗します。オンデマンド実体化の仕組みと、自動化を取りこぼさないための設計パターンを実体験から解説します。

PREMIUM⬡ API & SDK/2026-06-21上級

検索結果を二度運ばない — response_inclusion で消費済みブロックを応答から外す設計

dynamic filtering を有効にしたエージェントで出力トークンが膨らむ原因は、code execution が消費し終えた検索結果ブロックが応答に二重で乗ることにあります。response_inclusion を excluded にして安全に外せる条件と、full を保つべき条件を実装と判断表で整理しました。

PREMIUM⟐ Claude Code/2026-06-21上級

Context7 を入れても Claude Code が古いコードを書くとき — 注入が効いているかを運用で確かめる

Context7 MCP を入れたのに古い API のコードが返る——その多くはドキュメント注入が静かに不発になっています。注入が効いたかを毎回確かめる検証フック、ライブラリ単位のバージョン固定、未対応ライブラリへのフォールバックを運用の実装メモとしてまとめます。

PREMIUM⬡ API & SDK/2026-06-21上級

service_tier で優先枠をユーザー応答だけに振り向ける

Priority Tier を契約しているのにピーク時だけユーザー向け応答が遅くなる——その原因を service_tier の auto と standard_only の挙動から切り分け、背景ジョブを優先枠から隔離する構成を、自動運用の実例とともにまとめました。

PREMIUM⬡ API & SDK/2026-06-20上級

effort パラメータを工程ごとに振り分けて Claude の出力コストと待ち時間を整える

Claude API の effort パラメータは思考・本文・ツール呼び出しを含む出力トークン全体を制御します。一律 high をやめ、工程ごとに段階配分する実装と動的ルーターを、個人開発の自動運用での実測とともに解説します。

PREMIUM⬡ API & SDK/2026-06-20上級

サブエージェントの並列実行で、1つの失敗が全体を巻き込まない設計

複数のサブエージェントを並列に走らせる fan-out / fan-in 構成を、トークン予算・結果コントラクト・部分失敗の扱いまで含めて設計します。1つのブランチが落ちても全体を止めない実装と実測値を共有します。

PREMIUM⬡ API & SDK/2026-06-20上級

Cloudflare AI Gateway を Claude の手前に置くと、見えるはずの数字が見えなくなる — 運用で効いた計装メモ

Cloudflare AI Gateway を Claude API の前段に置いたあと、コスト按分・セマンティックキャッシュの誤ヒット・フォールバックの静かな品質低下・予算の実効化で実際につまずいた箇所と、その手当てをコード付きでまとめます。

PREMIUM⟐ Claude Code/2026-06-20中級

Claude Design の画面案を Claude Code にそのまま実装させる — ローカルコードベース連携で往復を畳む

6/17 の Claude Design 更新でローカルコードベース起点の動作が入りました。トークンを単一の正本にして、画面案を Claude Code へ受け渡し、実装まで一本の流れに畳む手順を、コピーして使えるコードと共にまとめます。

PREMIUM◉ Claude AI/2026-06-19上級

Claude Design に既存コードベースを読ませて画面案を作る — デザインと実装の往復を一人で畳む

6月17日の更新で Claude Design はローカルのコードベースを起点に動けるようになりました。既存コンポーネントを反映した画面案を作り、そのまま Claude Code へ渡すまでを、4サイトのUIを一人で手入れする個人開発の現場目線で設計します。

PREMIUM⬡ API & SDK/2026-06-19上級

search_result ブロックで自前ナレッジに根拠を引かせる — Claude Citations 実装メモ

自前のRAGでClaudeが「どの記事を根拠にしたか」を見失う問題を、search_result コンテンツブロックと citations で解決する実装手順を、4サイト運用の実測値とともにまとめます。

PREMIUM⬡ API & SDK/2026-06-19上級

Claude × Playwright のブラウザエージェントが「成功したつもり」で失敗するとき — 操作を検証し UI の変化に先回りする実装メモ

Claude API と Playwright のブラウザエージェントは、視覚で判断する分だけ「やったつもりで失敗する」誤成功が起きます。自己申告を信じず操作を事後検証する設計と、UI 変化に先回りで気づくドリフト検知の実装をまとめます。

PREMIUM⟐ Claude Code/2026-06-19上級

スケジュール生成が無音で不発に終わったことを、外側から気づく仕組み

exit 0 で終わったのに成果物がゼロだった——そんな無音の不発を、ジョブ自身のログではなく外部のハートビート台帳と地の事実から検知する設計を、個人開発で複数サイトを自動運用している立場からまとめました。

PREMIUM⟐ Claude Code/2026-06-19上級

弾いたはずの記事が公開された — 品質ゲートと git push を同じ呼び出しにまとめた代償

無人運用の投稿パイプラインで、品質ゲートで弾いたはずの記事がそのまま公開されました。原因はゲートと git push を一つのシェル呼び出しに連結したことでした。終了コードが握りつぶされる仕組みと、公開マーカー方式で「通過を確認してからしか push しない」二段構えの実装を記録します。

PREMIUM⟐ Claude Code/2026-06-18上級

Claude Code に /cd が来た — キャッシュを温存したまま複数リポジトリを横断する運用設計

Claude Code に追加された /cd で作業ディレクトリを移すと、プロンプトキャッシュを作り直さずにセッションを別リポジトリへ運べます。複数リポジトリを順に処理する運用での設計判断と落とし穴をまとめました。

PREMIUM⟐ Claude Code/2026-06-18上級

SessionEnd フックに後片付けとログ記録を寄せる

自動投稿の後片付けだけが月に数回抜け落ちる——原因は片付けを処理の続きとして書いていたことでした。Claude CodeのSessionEndフックへ一時ファイル削除とログ記録を寄せる方法を、4サイト運用で実際に移した内容、つまずいた点と回避策、発火確認の手順とともにまとめました。

PREMIUM⬡ API & SDK/2026-06-18上級

Claude API のレスポンスキャッシュが「古い答え」と「似て非なる誤答」を返すとき — 鮮度管理と誤ヒット抑制の実装メモ

Claude API のレスポンスキャッシュは速度とコストを劇的に改善しますが、運用で問題になるのは平均ヒット率ではなく、古い答えと意味的な誤ヒットの二つです。キー設計・鮮度管理・誤ヒット抑制・観測の実装をまとめます。

PREMIUM⟐ Claude Code/2026-06-18上級

無人で動くエージェントに渡すMCPツールを絞り込む — ポリシー強制で権限を deny-by-default にする

無人実行のClaude Codeエージェントは、許可ダイアログに頼れないぶんツールの届く範囲がそのまま事故の範囲になります。MCPサーバーとツールを deny-by-default で締め、必要なものだけを許可リストで渡す構成を実例つきでまとめました。

PREMIUM⟐ Claude Code/2026-06-18中級

壊れた settings.json で Claude Code が起動しなくなったとき — セーフモードの挙動と設定の分け方

settings.json の構文ミスで Claude Code が起動しなくなったときに、どの階層が壊れているかを切り分けて数分で復旧する手順と、自動運用で壊れにくい設定の分割・検証パターンをまとめました。

PREMIUM⟐ Claude Code/2026-06-17上級

課金変更が直前で撤回された日 — 慌てて組み替えないための可逆なパイプライン設計

6月15日に発効するはずだった課金変更が、直前に撤回されました。前日まで「本日発効」とログに書いていた立場から、headless 工程を慌てて組み替えずに済んだ理由と、撤回・延期に耐える可逆なパイプライン設計を、動くコードとともに記録します。

PREMIUM⬡ API & SDK/2026-06-17上級

Claude API のドキュメント抽出が「確信を持って間違える」とき — 検証層の設計メモ

Claude API で請求書や契約書を構造化抽出するとき、最も怖いのは例外ではなく「もっともらしく間違った JSON」です。スキーマ検証・算術整合・二重抽出の一致率で誤抽出を本番前に捕まえる検証層を、TypeScript の実装とともにまとめました。

PREMIUM⟐ Claude Code/2026-06-17上級

予告された課金変更が直前で保留された——切り替えを急がない自動運用の設計

6/15に発効するはずだった課金変更が当日に保留されました。告知日を信じてパイプラインを切り替えると、撤回時に二重で壊れます。実行時シグナルでカットオーバーを判断する設計を、実装コードとともに残します。

PREMIUM⬡ API & SDK/2026-06-17上級

多言語アプリの訳ブレを止める — Batch API と用語集キャッシュで Localizable.strings を一貫翻訳する設計

UI文字列を1本ずつ翻訳すると用語がブレます。Claude の Message Batches API と用語集のプロンプトキャッシュを組み合わせ、Localizable.strings を10言語以上へ一貫翻訳するパイプラインを、実測コストと落とし穴つきで設計します。

PREMIUM⟐ Claude Code/2026-06-17上級

予告された課金変更が直前で撤回されたとき、設定を一行も書き換えずに済ませる

発効するはずだった課金変更が当日に撤回される——そんな事態でも設定を一行も書き換えずに済ませるための設計です。プラットフォームの挙動を一箇所のフラグに集約する方法、適用時の月額差分を実測から先に出す手順、撤回を「保留のまま」にする考え方、先回り改修が招く事故を記録します。