Claude Code v2.1.317の変更点、/scheduleの警告とメールアドレス送信の確認

Claude Code の v2.1.317 が、2026年11月3日に公開されました。クラウドの定期タスク（/schedule）への警告、アカウントのメールアドレスを送る前の確認、費用レポートの API などが追加されています。Claude Code を日常的に使っている方や、チームの設定を管理している方に向けて、設定や使い方に関わる項目を選んで整理します。

v2.1.317 の概要

v2.1.317 のリリースノートは、公式の GitHub と、公式ドキュメントの変更履歴（Changelog）の両方に載っています。公開日は2026年11月3日です。リリースノートの項目数は多く、大半は不具合の修正です。この記事では、使い方や管理に関わる「追加」と「変更」を中心に紹介します。

種類	代表的な項目
追加	/schedule の警告、メールアドレス送信前の確認、費用レポート API
変更	サブエージェントの effort（考える深さ）の扱い
削除	Read ツールの「変更なし」の表示

内容は2026年11月4日時点のものです。バージョンや仕様は変わることがあるため、最新の内容は公式の変更履歴で確認してください。

安全面に関わる追加

/schedule のコネクタ警告

リリースノートには、次の項目があります。クラウドの定期タスクを新しく作ったとき、頼んでいないコネクタ（外部サービスとの接続）が付いた場合に、警告が出るようになりました。警告には、そのコネクタの外し方も示されます。

定期タスクを作る方は、作成後に、付いているコネクタを一度見直すとよいでしょう。

メールアドレスを送る前の確認

Web ツールやシェルツールの呼び出しが、アカウントのメールアドレスをネットワークに送ろうとするとき、先に確認を求めるようになりました。意図しない送信に気づきやすくなる変更です。

Agent SDK のフックに onFailure: “block”

Agent SDK のフックのコールバック（呼び出される処理）に、onFailure: "block" が追加されました。コールバックが失敗したとき、操作をそのまま通さず、ブロックします。

コマンドフックと HTTP フックについては、以前の v2.1.295 で同じ設定が追加されています。詳しくは、Claude Codeのフックに失敗時ブロック「onFailure: block」が追加、v2.1.295の変更点で扱っています。

管理者向けの追加

チームや組織で Claude Code を管理している方に関わる項目です。

1. 費用レポート API: Claude apps gateway（組織向けの接続口）の管理 API に、GET /v1/organizations/analytics/cost が追加されました。過去の利用額を、期間を指定して、合計・開発者ごと・日ごと・IdP グループごとに読み取れます。
2. IdP グループの記録: admin: を設定した Claude apps gateway では、各開発者の IdP グループ（ログイン基盤で管理するグループ）が毎日記録されます。保持期間は admin.identity_retention_days で決まり、費用レポートのグループ分けに使われます。
3. OpenTelemetry の項目追加: OTel（利用状況を集めるための共通の仕組み）のメトリクス、イベント、スパンに、anthropic.plan、anthropic.seat_type、anthropic.provider、anthropic.custom_base_url が加わりました。

動作が変わった項目

次の変更は、これまでの使い方に影響する可能性があります。

• サブエージェントの effort: メインの会話と別のモデルで動くサブエージェントやチームメイトは、セッションの effort ではなく、そのモデルの保存済みの effort か既定値を使います。
• Read ツール: 「前回の Read から変更なし」という簡易表示がなくなりました。変更のないファイルを再び読むと、内容が返ります。
• CLAUDE_CODE_DISABLE_NESTED_SESSION_ID: 自己ホストのランナー上で、セッション内の claude -p が、そのセッションの ID と記録を使う動作を戻す環境変数です。1 に設定します。

サブエージェントの effort の指定は、以前のバージョンでも話題になっています。経緯は、Claude Code v2.1.311〜v2.1.316の変更点にまとめています。

主な不具合の修正

v2.1.317 には、多くの修正が含まれます。たとえば、次のものがあります。

• claude auth status が、時間のかかるトークンの更新の保存前に終了し、次の実行でサインアウトされることがある問題
• プロジェクトの effortLevel の設定が、アプリが先に起動したセッションで無視される問題
• claude -p が、ディスクの空きやクォータの不足で記録を失ったときも、終了コード 0 で終わる問題（修正後はエラーを表示し、テキスト出力と json 出力では 1 で終了）
• Grep や Glob の検索が時間切れになったとき、一部の結果を完全な結果として扱う問題

そのほかの修正は、全文を GitHub のリリースノートで確認できます。Windows、VSCode、クラウドセッションなど、環境別の項目もあります。

よくある質問

Q. 更新しないと、メールアドレスの確認は出ませんか。 A. 確認は v2.1.317 で追加された項目です。このバージョンより前のバージョンに入っているかは、リリースノートからは分かりません。

Q. 費用レポート API は、誰でも使えますか。 A. リリースノートには、Claude apps gateway の管理 API と書かれています。利用の条件は、公式ドキュメントで確認してください。

Q. 以前のバージョンの変更点はどこで読めますか。 A. 公式の変更履歴と、GitHub のリリースページで読めます。このサイトでは、v2.1.311〜v2.1.316の記事も用意しています。

まとめ

• v2.1.317 は2026年11月3日に公開され、/schedule のコネクタ警告と、メールアドレス送信前の確認が追加された
• 管理者向けに、費用レポート API と OTel の項目が追加された
• サブエージェントの effort の扱いと、Read ツールの表示が変わった

次の一歩として、Claude Code を最新版に更新する前に、GitHub のリリースノートで、自分の環境に関わる項目（Windows、VSCode、自己ホストのランナーなど）を確認してください。