Claude Code v2.1.307

変更項目 43 件

公式 CHANGELOG.md

このバージョンの概要

v2.1.307 では、MCP 接続の安定性向上として macOS キーチェーンロック時の認証エラー表示やスリープ中のタイムアウト誤検知を修正しました。また、パース不能なツール呼び出しの自動リトライ(最大2回)や、PDF・画像の大量読み取り時に発生するオートコンパクトのエラーを改善しました。さらに、Code Review に @claude review stop を追加し、PR 上の常時レビュー購読を終了できるようになりました。

Added追加(4件)

Added
/claude-api api-version を追加し、Claude API のコードを API バージョン 2026-10-21 に移行できるようにした
英語原文を表示
Added /claude-api api-version to move Claude API code to API version 2026-10-21
Added
パーミッションルール、オートモード、セーフティチェック、フック、またはサンドボックスがツール呼び出しを停止・確認要求・差し戻しした際に、claude_code.safety_event という OpenTelemetry イベントをツール呼び出しごとに送出するようにした
英語原文を表示
Added the claude_code.safety_event OpenTelemetry event for each tool call a permission rule, auto mode, a safety check, a hook or the sandbox stopped, prompted or sent back

変更後

パーミッションルールやオートモード、セーフティチェック、フック、サンドボックスがツール呼び出しを停止・確認要求・差し戻した際に、OpenTelemetry イベント claude_code.safety_event として記録されるようになる。これにより、どの仕組みがどのツール呼び出しをどう扱ったかをテレメトリで追跡・分析できるようになる。

Added
[VSCode] 音声入力が自動停止した場合(認識できる発話が 15 秒なかった場合、または 2 分制限に達した場合)に、マイクボタン上に停止理由とそこまでのテキストが保持される旨を知らせる通知を追加した
英語原文を表示
[VSCode] Added a notice on the microphone button when voice dictation stops by itself (15 seconds without recognized speech, or the 2-minute limit), saying why and that the text so far is kept

変更後

音声入力が勝手に停止したときも、マイクボタンの表示で停止理由と、それまでに認識されたテキストが残っていることが分かるようになり、意図せず入力が失われたと誤解せずに済む

Added
[Code Review] Code Review に @claude review stop(off と pause も可能)を追加した。プルリクエスト上の @claude review always サブスクリプションを、新しいレビューを開始せずに終了できる
英語原文を表示
[Code Review] Added @claude review stop (also off and pause) to Code Review, ending an @claude review always subscription on a pull request without starting a new review

変更後

@claude review always で登録したプルリクエストの、以降のプッシュごとの自動レビューをコメント1つで解除できる。不要になった PR でレビューが繰り返し走るのを止められ、コストの無駄遣いを防げる。

Changed変更(9件)

Changed
セルフホストランナー: --use-anthropic-git-proxy を使用したセッションが、以前のセッションがクローンに残した .claude/settings.local.json をコミットしてしまう問題を修正した
英語原文を表示
Self-hosted runner: Fixed sessions with --use-anthropic-git-proxy committing a .claude/settings.local.json left in the clone by an earlier session

変更後

Self-hosted runner の再開セッションで、以前のセッションが残した .claude/settings.local.json が誤ってコミットされることを防げるようになり、リポジトリに意図しないローカル設定ファイルが混入しなくなる

関連ドキュメント

Changed
セルフホストランナー: チェックアウトフックの実行中にセッションのアーカイブ・再キューイングやランナーの停止を行うと、フックのプロセスが動き続け、ランナーのスロットが占有され続ける問題を修正した
英語原文を表示
Self-hosted runner: Fixed archiving or requeueing a session, or stopping the runner, during its checkout hook leaving the hook's processes running and the runner's slot held

変更後

セッションのチェックアウトフック実行中にセッションのアーカイブや再キューイング、ランナーの停止が発生しても、フックのプロセスが残留せず、ランナーのスロットも適切に解放されるようになる。

Changed
WebSearch の予算を使い切った際に Claude が受け取る通知を変更し、ブラウザや computer use を通じて検索エンジンに問い合わせないようにも伝えるようにした
英語原文を表示
Changed the notice Claude gets when the WebSearch budget is used up to also tell it not to query search engines in a browser or through computer use

変更後

WebSearch の予算を使い切った後も Claude がブラウザや computer use を通じて検索を実行して無駄な処理が発生する問題を防げるようになる。検索上限に達した際の挙動が一貫し、意図しない回避ルートでの検索を抑止できる。

関連ドキュメント

Changed
axScreenReader 設定と設定の env ブロック内の CLAUDE_AX_SCREEN_READER が、ユーザー設定、管理設定、または --settings による設定にのみ適用されるよう変更した (2.1.305 以降)
英語原文を表示
Changed the axScreenReader setting and CLAUDE_AX_SCREEN_READER in a settings env block to apply only from user, managed or --settings settings (since 2.1.305)

変更後

スクリーンリーダー設定がユーザー設定や管理設定など信頼できる設定ファイルからのみ適用されるようになり、プロジェクト単位の設定で意図せず出力形式が切り替わるのを防げる。

関連ドキュメント

Changed
Self-hosted runner: チェックアウトフックがデフォルトで 30 分後に停止し、セッションのセットアップが失敗するように変更した。より長い時間が必要な場合は、--checkout-hook-timeout-min を引き上げるか 0 に設定する
英語原文を表示
Self-hosted runner: Changed checkout hooks to be stopped after 30 minutes by default, failing the session's setup; if yours needs longer, raise --checkout-hook-timeout-min or set it to 0

変更後

checkout フックがハングしてもセッションのセットアップが 30 分で打ち切られ、失敗が早く検知できるようになる。30 分以上かかるフックを使う場合は --checkout-hook-timeout-min で待ち時間を延ばせる。

Changed
Self-hosted runner: Anthropic 管理の git 向けにビルドされる証明書ファイルが、CLI と同様に信頼する証明書をフィルタリングするように変更した。除外された証明書の数は [runner:warn] 行で表示される
英語原文を表示
Self-hosted runner: Changed the certificate file built for Anthropic-managed git to filter its trusted certificates as the CLI does; a [runner:warn] line gives the number left out

変更後

Anthropic 管理の git 向けにランナーが生成する証明書ファイルが、CLI と同じ基準で信頼する証明書を絞り込むようになったため、不要な証明書が原因の TLS 接続トラブルを避けられる。除外された証明書の数は [runner:warn] ログで確認できる。

Changed
[VSCode] 「他の場所でまだ開いています」の通知が、拡張機能の再起動後に残った Claude プロセスにも適用されるように変更した。このプロセスは通常、約 10 分以内に自然に終了する
英語原文を表示
[VSCode] Changed the "still open somewhere else" notice to also cover a Claude process left over from an extension restart, which usually ends on its own within about 10 minutes

変更後

拡張機能の再起動後に別のプロセスが会話を開いたままでも、誤って二重に開いてしまう前に確認メッセージで教えてくれるようになり、安心して会話を再開できる。

関連ドキュメント

Changed
[VSCode] 音声入力が CLI と同様に信頼する証明書をフィルタリングするように変更した
英語原文を表示
[VSCode] Changed voice dictation to filter its trusted certificates as the CLI does

変更後

VSCode 拡張の音声入力でも CLI と同じ証明書フィルタリングが適用され、社内プロキシなどカスタム証明書環境でも CLI と一貫した形で音声入力を利用できる。*

Changed
[VSCode] 拡張機能自身のリクエストが、CLI と同様に信頼する証明書をフィルタリングし、環境変数またはユーザー設定で指定された NODE_EXTRA_CA_CERTS のファイルを信頼するように変更した
英語原文を表示
[VSCode] Changed the extension's own requests to filter their trusted certificates as the CLI does, and to trust the NODE_EXTRA_CA_CERTS file named in the environment or in user settings

変更後

企業内の TLS 検査プロキシやプライベート CA を利用した環境でも、VSCode 拡張機能からのリクエストが CLI と同じ CA 証明書の設定に従うようになり、NODE_EXTRA_CA_CERTS を設定するだけで拡張機能も正常に接続できるようになる。

関連ドキュメント

Improved改善(6件)

Improved
パースできないツール呼び出しからの回復を改善した。エラーでターンを終了する前に、Claude Code はその呼び出しを最大 2 回再試行するようになった
英語原文を表示
Improved recovery from unparseable tool calls: Claude Code now retries the call up to twice before ending the turn with an error
Improved
同時に起動される fork サブエージェントを改善した。各サブエージェントがどの起動が自分のものかを認識するようになり、fork 同士が互いの作業を開始しようとする可能性が大きく減った
英語原文を表示
Improved fork subagents launched together: each is now told which launch is its own, so forks are much less likely to try to start each other's work

変更後

fork subagent を同時に立ち上げたときに、それぞれの fork が自分自身の起動を見分けられるようになり、他の fork の作業を重複して始めてしまうことが大幅に減る。

関連ドキュメント

Improved
ブラウザサインインを改善した。サインイン完了後にアカウントプロファイルの読み込みを待たず、すぐに成功ページが表示されるようになった
英語原文を表示
Improved browser sign-in: the success page now appears as soon as sign-in completes, without waiting for your account profile to load

変更後

ブラウザでのサインイン完了後、アカウントプロファイルの読み込みを待たずにすぐに成功ページが表示されるようになる。

関連ドキュメント

Improved
クラウドおよびセルフホストランナーセッションでの Web 検索エラーを改善した。403 で理由付きの拒否を受けた場合、汎用的な「Authentication error」の代わりにその理由が表示されるようになった
英語原文を表示
Improved web search errors in cloud and self-hosted runner sessions: a search refused with a 403 that gives a reason now shows that reason instead of a generic "Authentication error"

変更後

クラウドおよびセルフホストランナーのセッションで Web 検索が 403 で拒否された場合、拒否理由がそのまま表示されるようになり、ゲートウェイ管理者への問い合わせや原因の切り分けがしやすくなる。

Improved
デスクトップアプリの MCP サーバーが接続できない場合の、クラウドセッションでの最初の返信までの時間を改善した
英語原文を表示
Improved the time to the first reply in cloud sessions when one of the desktop app's MCP servers can't connect

変更後

デスクトップアプリの MCP サーバーのいずれかが接続できない場合でも、クラウドセッションでの最初の応答がすぐに返ってくるようになる。

関連ドキュメント

Improved
トランスクリプトに大きな貼り付け画像や PDF の読み取り結果が含まれるセッションの Remote Control 接続時間を改善した
英語原文を表示
Improved Remote Control connect time for sessions whose transcript contains large pasted images or PDF reads

変更後

トランスクリプトに大きな貼り付け画像や PDF の読み込みが含まれるセッションでも、Remote Control で素早く接続できるようになる。

Fixed修正(24件)

Fixed
CLAUDE_CODE_DISABLE_1M_CONTEXT が設定されていて、モデルが opus[1m] のような [1m] 接尾辞付きのエイリアスの場合に、モデルが見つからないエラーでリクエストが失敗する問題を修正した
英語原文を表示
Fixed requests failing with a model-not-found error when CLAUDE_CODE_DISABLE_1M_CONTEXT is set and the model is an alias with the [1m] suffix, such as opus[1m]
Fixed
カスタムの ANTHROPIC_BASE_URL ゲートウェイ経由時や Foundry 上で、効果のない prompt-caching-scope ベータヘッダーが送信される問題を修正した
英語原文を表示
Fixed the prompt-caching-scope beta header being sent behind custom ANTHROPIC_BASE_URL gateways and on Foundry, where it has no effect
Fixed
macOS でログインキーチェーンがロックされている間に claude -p の MCP サーバーが「認証が必要」と表示される問題を修正した。理由が表示されるようになり、ロック解除後の次回実行では再サインインなしで接続できる
英語原文を表示
Fixed MCP servers showing "needs authentication" in claude -p on macOS while the login keychain was locked; they now say why, and the next run after an unlock connects without a new sign-in

関連ドキュメント

Fixed
macOS や Linux のマシンが接続中にスリープした際、MCP サーバーがタイムアウトと報告され、ヘッドレス実行では失敗状態のまま残る問題を修正した
英語原文を表示
Fixed MCP servers being reported as timed out, and staying failed in headless runs, when a macOS or Linux computer went to sleep while they were connecting

関連ドキュメント

Fixed
呼び出し中に接続が切断された際に HTTP MCP ツール呼び出しが二重に送信される問題を修正した。再試行は読み取り専用または冪等なツールに限定されるようになった
英語原文を表示
Fixed HTTP MCP tool calls being sent twice when the connection closed mid-call; only read-only or idempotent tools are now retried

関連ドキュメント

Fixed
バックグラウンドタスクが実行中のとき、SDK MCP サーバーの最新のツールが揃わないままターンが開始されることがある問題を修正した
英語原文を表示
Fixed a turn sometimes starting without an SDK MCP server's latest tools when a background task was running

関連ドキュメント

Fixed
多数の PDF ページ、画像、その他の大きなツール結果を読み込むターンで発生する一部の「Autocompact is thrashing」エラーを修正した
英語原文を表示
Fixed some "Autocompact is thrashing" errors in turns that read many PDF pages, images or other large tool results
Fixed
クラウドセッションで /autocompact の設定がセッション再起動後にデフォルトのウィンドウに戻ってしまう問題を修正した
英語原文を表示
Fixed /autocompact in cloud sessions going back to the default window after the session restarted
Fixed
クラウドまたはセルフホストランナーのセッション再起動時に、/clear で消去した会話が復活することがある問題を修正した
英語原文を表示
Fixed a conversation cleared with /clear sometimes coming back when a cloud or self-hosted runner session restarted
Fixed
Claude アプリのゲートウェイセッションで CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS が無視される問題を修正した
英語原文を表示
Fixed CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS being ignored in Claude apps gateway sessions
Fixed
OTEL_EXPORTER_OTLP_HEADERS が設定されているとき、Claude アプリのゲートウェイ経由の Claude Desktop セッションからのテレメトリが拒否される問題を修正した
英語原文を表示
Fixed telemetry from Claude Desktop sessions behind a Claude apps gateway being rejected when OTEL_EXPORTER_OTLP_HEADERS is set
Fixed
/permissions の「Recently denied」に拒否されたシェルコマンドが表示されない問題、およびオートモードのローカル分類器が再試行されたコマンドのチェック時にそこでの承認を無視する問題を修正した。行を承認すると、説明ではなくコマンド名が表示されるようになった
英語原文を表示
Fixed /permissions > Recently denied not showing the denied shell command, and auto mode's local classifier ignoring an approval from there when it checks a retried command; approving a row now names the command, not its description
Fixed
/help と / コマンドメニューで、/claude-api などのバンドルスキルの短い説明ではなく、モデル向けの長い説明が表示される問題を修正した
英語原文を表示
Fixed /help and the / command menu showing long model-facing descriptions for bundled skills such as /claude-api instead of their short descriptions

関連ドキュメント

Fixed
ストリーミングレスポンスにおいて、サブエージェントのトランスクリプトにプレースホルダーのトークン使用量と空の停止理由が記録される問題を修正した
英語原文を表示
Fixed subagent transcripts recording placeholder token usage and an empty stop reason for streamed responses
Fixed
Agent SDK の setModel() によるモデル切替やそれを基盤としたアプリで、API がモデルの確認に 5 秒以上かかると拒否される問題を修正した。Claude Code は最大 15 秒まで待機するようになった
英語原文を表示
Fixed model switches through the Agent SDK's setModel(), and apps built on it, being refused when the API took more than 5 seconds to confirm the model; Claude Code now waits up to 15 seconds
Fixed
接続中のアプリを通じてバックグラウンドコマンドが停止された場合(アイドル状態のセッションがデスクトップアプリでアーカイブされた場合など)に、ユーザーによって停止されたと Claude に報告される問題を修正した。通知には出力ファイル名が記されるようになった
英語原文を表示
Fixed a background command stopped through a connected app (such as the desktop app archiving an idle session) being reported to Claude as stopped by the user; the notice now names its output file
Fixed
Cowork クラウドセッションで、サイトが 4xx ステータスや robots.txt による拒否を返した際に WebFetch がツールエラーを報告する問題を修正した。ローカルセッションと同様に通常の結果として扱われるようになった
英語原文を表示
Fixed WebFetch in Cowork cloud sessions reporting a tool error when a site answered with a 4xx status or a robots.txt refusal; it is now a normal result, as in local sessions

関連ドキュメント

Fixed
直接設定された GitHub MCP サーバーの書き込みツールをデスクトップアプリの Code タブで使用した際、何も作成せずに閉じるフォームが表示される問題を修正した
英語原文を表示
Fixed write tools on a directly configured GitHub MCP server showing a form that closed without creating anything in the desktop app's Code tab

関連ドキュメント

Fixed
サーバーが再利用された接続を閉じていた場合に、Artifact ツールの読み取りが接続リセットで失敗する問題を修正した
英語原文を表示
Fixed Artifact tool reads failing with a connection reset when the server had closed a reused connection

関連ドキュメント

Fixed
[VSCode] 「Show more」で展開された長いプロンプトがチャットパネル全体を覆う問題を修正した。ピン留めされたプロンプトはパネルの 40% までに制限され、スクロールできるようになった
英語原文を表示
[VSCode] Fixed a long prompt expanded with Show more covering the whole chat panel: a pinned prompt is now capped at 40% of the panel and scrolls
Fixed
[VSCode] LaTeX 数式を含むリスト項目やテーブルセルの一部が、リッチテキストエディタに貼り付けた際に新しいリストやテーブルとして貼り付けられる問題を修正した
英語原文を表示
[VSCode] Fixed part of a list item or table cell with LaTeX math pasting as a new list or table in rich text editors

関連ドキュメント

Fixed
[VSCode] NODE_EXTRA_CA_CERTS が ~/.claude/settings.json でのみ設定されている場合に、TLS 検査プロキシ環境下で音声入力が失敗する問題を修正した。CLAUDE_CODE_CERT_STORE も参照するようになった
英語原文を表示
[VSCode] Fixed dictation failing behind a TLS-inspecting proxy when NODE_EXTRA_CA_CERTS is set only in ~/.claude/settings.json; it now also follows CLAUDE_CODE_CERT_STORE

関連ドキュメント

Fixed
[Cloud sessions] 検索の実行中にリポジトリピッカーが「No repositories match」と表示される問題を修正した。結果が到着するまでは「Searching…」と表示するようになった
英語原文を表示
[Cloud sessions] Fixed the repository picker saying "No repositories match" while a search was still running; it now shows "Searching…" until the results arrive

関連ドキュメント

Fixed
[Cloud sessions] Self-hosted 環境で「Waiting for a runner」ステータスが途中で切れる問題を修正した。オンデマンドランナーの場合は、最後のメッセージからの経過時間をカウントアップ表示し、失敗した試行も表示するようになった
英語原文を表示
[Cloud sessions] Fixed the "Waiting for a runner" status on self-hosted environments being cut off; with on-demand runners it now counts up from your last message and shows failed attempts
シェア: X はてブ