Claude Cowork で Teams の「後で返そう」を TODO ボードにした話

Message Batches APIを使うことで、バッチ処理が通常料金の50%引きで実行できます。チケット分類など「今すぐ結果が不要」な処理をTypeScriptで実装する方法と、リクエスト投入・ポーリング・結果回収時に踏みやすい3つの落とし穴を解説。

Message Batches API の custom_id は英数字・`_`・`-` のみ、1〜64文字、バッチ内一意という制約。不正 ID が1件でも混ざるとバッチ自体が作成されず、エラーも最初の1件のみ報告。YouTube コメント ID の「.」で定時ジョブが停止した実例と、連番キー＋ローカル対応表で突き合わせる回避実装を紹介。外部 ID をキーに使う API 利用者向け。

同じ意味の文で英語と日本語のトークン数を tiktoken で実測。cl100k_base では日本語が英語の約 2.7 倍となり、UTF-8 で 3 バイトの漢字がバイト単位に割れる仕組みを解説。o200k_base では 32 → 17 トークンに改善した点、Claude Opus 4.7 のトークナイザー変更、Claude の Token counting API による計測方法も掲載。日本語で API 料金を見積もる開発者向け。

Claude Code相当の機能を持つ @anthropic-ai/claude-agent-sdk ではなく、通常の @anthropic-ai/sdk のベータ機能 `client.beta.messages.toolRunner` で、自前定義のツールだけを持つ小型Agentを構築する実装記事。`betaZodTool` によるツール定義、ループ実行のSDK代行、再起動可否をツール側でガードする安全設計をサービス監視の例で解説。自社API連携の軽量Agentを作りたいTypeScript開発者向け。