Claude Code v2.1.23 — 企業ネットワーク経由の接続と端末描画を一斉整備
Claude Code v2.1.23はmTLS/プロキシ疎通、prompt cachingのrace condition、ripgrepタイムアウトの沈黙失敗、端末描画の最適化など11項目を束ねた整地パッチ。企業ネットワークと長時間運用の穴を静かに塞ぎにきた版です。
このリリースで何ができるようになるか
Claude Code v2.1.23は、企業ネットワーク・長時間運用・ヘッドレス自動化で起きていた地味な詰まりをまとめて剥がしにきた整地パッチです。新機能はスピナー文言のカスタマイズ1件のみですが、修正側に「踏むと厄介だが普段は気付かない」種類のバグが揃っています。
- mTLS / コーポレートプロキシ経由の疎通が修正され、クライアント証明書付きの企業ネットワークから接続できるようになる
- prompt cachingのscope有効時のrace conditionが解消され、長時間Sub-agent運用での散発的な400エラーが減る
- ripgrep検索のタイムアウトが沈黙して空結果を返す挙動が修正され、検索ヒットの信頼性が上がる
- スピナー脇の動詞(
Thinking...等)をspinnerVerbs設定でカスタマイズできる
あなたの開発フローはどう変わるか
コーポレートプロキシ / mTLS環境のチーム
エンタープライズ環境では、全アウトバウンドHTTPSをプロキシ経由に強制する構成、TLSをMITM再署名するゲートウェイ、API呼び出しにクライアント証明書を要求するゼロトラスト構成のいずれか、あるいは組み合わせが入っていることが珍しくありません。これらが揃うと、Node.js系CLIはHTTPS_PROXY / NODE_EXTRA_CA_CERTSと内部fetch実装の組み合わせのどこかで疎通に詰まります。
本版はこの経路を正面から修正しているため、過去に企業ネットワーク経由でClaude Codeの初期接続に失敗していたチームは再挑戦する価値があります。社内CAを信頼させた状態でmTLSが必要な構成でも、本版以降は通常通り認証が通ります。
CIランナー・共有開発サーバー
複数ユーザーが同一ホストでClaude Codeを走らせる構成では、tempディレクトリがユーザー別に分離されていない実装だと、先行ユーザーのキャッシュ/ロックファイルを次のユーザーが読めず権限エラーで起動が落ちる事故が起きがちでした。本版でユーザー別tempディレクトリの分離が入ったため、docker exec -u <uid>運用や、システムアカウントを切り替えて動かすCI構成での権限衝突が構造的に解消されます。
prompt cachingを本格利用している運用
prompt cachingは、リクエスト間で共通するプレフィックスをキャッシュ扱いにしてコストとレイテンシを下げる仕組みです。scopeを指定すると範囲を制御できますが、そこにrace conditionが残っていたため、長時間Sub-agent実行やCIパイプラインで散発的な400エラーが出ていました。本版で競合が塞がれたため、「たまに落ちるけどリトライすれば通る」状態が解消され、長時間運用の安定性が底上げされます。
巨大リポジトリでGrep / 検索を多用するワークフロー
Claude Codeのコード検索は内部でripgrepを呼びます。タイムアウトがエラー報告されずに空結果を返していたため、モデル側は「ヒットしなかった」と解釈し、実際には存在するコードを「ない」と判断して後続の回答を組み立てる、最も厄介な失敗モードに陥っていました。本版で明示エラーとして扱うようになり、検索ヒット数が不自然に少ないときの切り分けが一段楽になります。
主な変更点
新機能
spinnerVerbs設定追加: スピナー脇の動詞(Thinking...Cooking...等)をカスタマイズ可能に。チームの語彙に寄せる用途で使える。
修正
| 項目 | 要点 |
|---|---|
| mTLS / プロキシ疎通 | クライアント証明書を要求する企業ネットワークでも接続できるように |
| ユーザー別tempディレクトリの分離 | 共有システム上での権限衝突を防止 |
| prompt cachingのrace condition | scope有効時の散発400エラーを解消 |
| ヘッドレスstreamingのasync hook残留 | セッション終了後のpending hook未キャンセル問題を修正 |
| タブ補完の入力欄反映 | 候補採用時に入力欄が更新されない不具合を修正 |
| ripgrepタイムアウトの沈黙失敗 | 空結果の代わりに明示エラーを返すように |
| [IDE] Bedrockリージョン文字列 | ヘッドレスmodeで誤ったリージョン文字列が出ていた問題を修正 |
改善・変更
- 端末レンダリング性能を改善(スクリーンデータ配置の最適化)
- Bashコマンドの実行表示が経過時間に加えてタイムアウト値も並記するように変更
- マージ済みPRのステータスインジケータをプロンプトフッタで紫色で表示するよう変更
企業ネットワーク × 長時間運用に束ねられた意図
11項目のうち、mTLS / プロキシ疎通とユーザー別tempディレクトリ分離が同じ版に同居しているのは偶然ではなく、「企業・共有環境での初期導入の失敗パターン」を一度に剥がす意図と読めます。さらにprompt caching race / async hook残留 / ripgrep沈黙失敗の3つは、いずれも「短時間の対話利用では気付きにくく、長時間セッションや自動化パイプラインで連続実行したときに確率的に顕在化する」タイプのバグです。
| 性質 | 該当項目 | 影響が出やすい利用ケース |
|---|---|---|
| 導入段階の詰まり | mTLS / プロキシ / temp衝突 | 企業ネットワーク、共有CIランナー |
| 長時間運用の詰まり | prompt caching race / async hook / ripgrep沈黙 | Sub-agent運用、巨大リポジトリ検索、並列CI |
| UX微調整 | spinnerVerbs / Bashタイムアウト表示 / 端末描画 | 日常CLI体験 |
ripgrepの沈黙失敗を明示エラーに変える修正は、モデル側の判断品質を救う意味合いが特に大きい部分です。検索が空で返ると「ヒットしなかった」と誤認したまま回答を組み立てるため、根の浅い結論に至るリスクがありました。本版以降はエラーが顕在化するため、Grep結果が極端に少ないときの再試行や条件見直しを判断しやすくなります。
前後版との位置付け
v2.1.23は単体では地味ですが、前後数版との並びで見ると同じ方向を向いた一連の整地であることが分かります。
| バージョン | 主な変更 | 方向性 |
|---|---|---|
| v2.1.22 | 非対話(-p)モードのstructured outputs修正 | ヘッドレス運用の穴埋め |
| v2.1.23 | mTLS / プロキシ / temp / prompt caching / ripgrep / 端末描画など11項目 | 企業ネットワーク × 長時間運用の底上げ |
| v2.1.25 | Bedrock / Vertex gatewayのbeta header validation修正 | 企業向けゲートウェイの互換確保 |
| v2.1.30 | PDF部分読み込み / MCP OAuth事前設定 / --resume メモリ68%削減など19項目 | 機能追加と運用詰まりの総ざらい |
並べると、v2.1.22からv2.1.30までの流れは**「ヘッドレスと企業環境の穴を先に塞いでから、機能追加に戻る」順序**で動いていることが見えます。逆に言えば、v2.1.23を飛ばして上位版だけを追うと、mTLSやプロキシ周りの修正コミットを後から発見する手間が増えます。
まとめ
- 企業ネットワーク経由(mTLS / プロキシ)で詰まった経験があるなら更新推奨: 接続経路が正面から直っている
- CIランナー / 共有サーバーでClaude Codeを走らせるなら更新推奨: tempディレクトリ衝突が構造的に解消
- prompt cachingやヘッドレス自動化を本格運用しているなら更新推奨: 長時間運用での散発エラーが減る
- 巨大リポジトリでGrep結果が不自然に少なかった経験があるなら更新推奨: ripgrepタイムアウトが顕在化する
- 日常CLI利用のみなら任意: 端末描画と表示改善のみで急ぎではない
更新はclaude updateで取得できます。
関連する記事
Claude Code をもっと見る →Claude Code v2.1.133 — ワークツリーのベース選択機能と、Hooks/Bashでのeffort連携
Claude Code v2.1.132 — ターミナル全画面表示を切り替え可能に、IDE停止時の安全な終了処理
Claude Code v2.1.120 — WindowsでGit Bash不要に、ホスト全体が落ちるfindバグを修正
Claude Code v2.1.39 — ターミナル描画と握り潰されたエラーの表示を立て直す安定化パッチ
Claude Code v2.1.139 — 複数セッションを束ねるエージェント一覧と、目標達成まで走り続ける /goalコマンドの追加
Claude Code v2.1.137 — Windows版VS Code拡張の起動失敗を再修正(v2.1.131と同種の不具合)
Claude Code v2.1.136 — /clear後のMCP/Plugin喪失修正とOAuth競合解消
Claude Code v2.1.131 — Windows版VS Code拡張の起動失敗と、Mantle認証の修正