0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code v2.1.329:設定消失・MCP再接続・ループ停止の修正(速報)

0
Posted at

対象読者

Claude CodeをAPIやMCPサーバー経由でチーム・企業向けに使っている方、バックグラウンドエージェントや自動化ワークフローを組んでいる方、Managed Settingsやhooksで設定を配布している方を想定する。

2026-11-19(日本時間 2026-11-20 07:14)に Claude Code v2.1.329 がリリースされた。前日の v2.1.328 に続いて即日の大型リリースで、新機能追加5件・バグ修正50件以上という内容だった。すべての変更を追うのは難しいため、企業・チームでの利用で特に影響があると判断した変更を5点に絞って整理する。

出典:https://github.com/anthropics/claude-code/releases/tag/v2.1.329

1. ~/.claude.json が消える問題を修正(設定の突然消失)

地味だが、じわじわ困っていた系の修正だ。

何が起きていたか:ネットワークの一時停止やファイルロックが重なったタイミングで保存が走ると、~/.claude.json が読めない状態になる→空のJSONとして扱われる→デフォルト値で上書きされる、という手順で設定が消えていた。

具体的に消えやすかったもの:

  • 保存したモデル選択(/model で変えたもの)
  • 認証トークン
  • カスタム設定(autoCompactWindow など)

これが起きると、次の起動でサインインを求められたり、設定したモデルが組織デフォルトに戻ったりする。「設定したはずなのに元に戻っている」という症状がこれに当たる可能性が高い。

複数人が同じマシン(またはNFS経由の共有ホームディレクトリ)を使っている開発環境では、無関係なプロセスのファイルロックが他人の設定を壊す可能性があった。CI/CDのエージェントサーバー上でClaude Codeを動かしている場合も影響を受けやすい。

修正後:ネットワーク停止中やファイルロック中は既存の設定を保持する動作になった。

実環境での判断:この修正は v2.1.329 以前から静かに発生していた可能性がある。設定が消えた記録があれば、このバグが原因だった可能性が高い。設定ファイルのバックアップを取っておく運用は引き続き推奨する(~/.claude.json はJSON形式なので cp でコピーするだけでよい)。

2. macOSのKeychainサインアウトループを修正(企業管理端末向け)

macOSでKeychain読み取りはできるが書き込みができない状態になると、Claude Codeが繰り返しサインアウトを求めるループに入っていた。

なぜ企業端末で起きやすいか:MDM(Mobile Device Management)やエンドポイント管理ソリューションが導入された企業端末では、Keychainへの書き込み権限が制限されているケースがある。その場合、Claude Codeが認証トークンをKeychainに保存しようとして失敗し、次の起動でトークンが見つからず再サインインを求めるループになっていた。

修正後の動作:

  • Keychainに書き込めないセッションは、トークンの有効期限に達した時点でサインアウトを要求する(無限ループではなく、期限切れで1回だけ)
  • 他のセッションには影響しない(「他のウィンドウは動いているのに、このウィンドウだけループする」という状態は解消された)
  • サインアウト要求の際に、なぜ終了したかを理由と一緒に表示するようになった

MDM環境でのClaude Code利用を検討している組織には、この修正で安定性が上がるはずだ。

3. HTTP MCPサーバーが古いプロトコルバージョンで止まる問題を修正(自動再接続)

企業内で独自のHTTP MCPサーバーを運用している場合に効く修正だ。

何が起きていたか:接続が低速だったり、古いプロトコルバージョンのHTTP MCPサーバーがあるとき、バックグラウンドタスクが止まる問題があった。再接続は手動で行う必要があり、無人の自動化環境では気づかずにタスクが積まれていた。接続が取れていないのに「動いている」として扱われるケースもあった。

修正後:ほとんどのHTTP MCPサーバーでの自動再接続に対応した。古いプロトコルバージョンのサーバーを使っている場合でも、Claude Codeが自動で再接続を試みる。

実環境での影響:ローカルMCPサーバー(stdio接続)を使っているケースでは変化なし。企業内のイントラネット上にHTTP MCPサーバーを置いているケース、または外部のAPIをHTTP MCPサーバーとしてラップしているケースで効果がある。

バックグラウンドエージェントや無人実行では HTTP接続型のMCPサーバーを使うことが多い。今回の修正でタスクが止まった状態に気づけずに放置されるリスクが下がった。

4. Code Modeのランアウェイループがメモリを埋める問題を修正

Code Modeで暴走ループが発生すると、マシンのメモリが埋まり続ける問題があった。

何が起きていたか:Code Modeで実行されたループが制限なく走り続けると、プロセスがメモリを食い尽くすまで止まらない状態になっていた。OS側のOOM Killerが動くか、手動でプロセスを止めるまで収束しなかった。

CI/CD・自動化環境での影響:Windowsタスクスケジューラや cron からClaude Codeを呼び出している場合、このループが発生するとホストマシン全体のメモリを食い尽くしてシステムが不安定になる可能性があった。他のプロセスへの影響も出るため、無人環境では特に危険だった。実際にタスクスケジューラから呼び出したプロセスが深夜に暴走して翌朝気づく、というパターンが起きやすかった。

修正後:制限値に達した時点でループを停止する動作になった。ループの暴走がメモリ問題に発展する前に制御が戻る。

実環境での判断:自動化環境でClaude Codeを使っている場合は、念のためメモリ使用量のモニタリングを設定しておくことを推奨する。今回の修正でCode Mode側では防げるようになったが、スクリプト側でのリソース制限(Windowsタスクスケジューラの制限設定、ulimitなど)も引き続き有効だ。

5. hooksに信頼ダイアログの警告を追加(マネージドsettings向けセキュリティ)

フォルダのhooksがどのsettingsファイルで宣言されているかを示す信頼ダイアログの警告が追加された。

何が追加されたか:

  • フォルダを開いたとき、hooksがどのsettingsファイル(プロジェクト設定・ユーザー設定・マネージドsettings)から来ているかを警告で示す
  • Claude Desktopなどのノンインタラクティブなホストがあるとき、マネージドsettingsのhooksが読み込みに失敗した場合に会話内で警告を表示

企業のマネージドsettingsを使う場合:会社でClaude Codeの設定(hooksを含む)をManaged Settingsで配布している場合、設定に問題があるとすぐに気づける。設定ミスのまま無音で動いていた問題の可視化として重要な変更だ。

セキュリティの観点:どのsettingsファイルからhooksが来ているかを明示することで、意図しない設定の適用に気づきやすくなる。サプライチェーン的なhooks混入のリスクを早期発見する観点でも有効だ。

その他の主な変更(一覧)

その他の変更のうち、企業・チームで利用していて影響しそうなものを抜粋する。

修正(バグ修正):

  • /terminal-setup がVS Codeの設定ファイルを破壊する問題:keybindings.jsonのブロックコメント周辺で設定が壊れ、成功と報告しながらShift+Enterバインドが消える問題を修正。すでにShift+Enterが効かなくなっている場合は /terminal-setup を再実行してみる
  • /code-review がPRではなくブランチをレビューする問題:gh pr diff でPRを正しく読むか、読めない場合は明示的に「PRのdiffが取れなかった」と伝える動作になった。これまで「レビューした」と報告しながら実はブランチ全体を見ていたケースがあった
  • IDEのdiff経由で保存したファイルの末尾改行とBOMが失われる問題:VS CodeでIDEのdiffを承認したとき、末尾の改行とBOM(Byte Order Mark)が消える問題を修正。BOMが必要なファイル(一部のCSVや連携ファイル)で起きていた
  • バックグラウンドシェルコマンドが旧会話のメモリを保持し続ける問題:バックグラウンドで動いているシェルコマンドが終了するまで以前の会話のメモリを解放しない問題を修正
  • /usage の表示が誤っていた問題:ProとMaxユーザーに対して、利用制限切れを正しく表示するよう修正。これまで「オフになっている」という誤表示だった
  • /teleport のクラウドセッション選択が現在の会話を置き換える問題:選択が /clear と同様に新しいセッションを開始するよう修正。元の会話は /resume で戻れる

新機能:

  • /tasks の内容拡張:セッションのスケジュールタスク・/loop のウェイクアップ・ゴール・フォークを /tasks で確認できるようになった。バックグラウンドタスクの状況をまとめて確認するときに便利
  • /mcp の「Server message」行:HTTP MCPサーバーが接続を拒否したときのJSON-RPCエラーメッセージを /mcp のサーバーページで確認できるようになった。接続トラブルのデバッグに有効
  • /status の「Marketplace auto-update」行:マネージドマーケットプレイスで自動更新が行われないものを /status で確認できるようになった
  • OpenTelemetryとCode Modeの組み合わせが有効に:OpenTelemetryのイベント・メトリクスが有効な状態でCode Modeをオンにできるようになった。各ツール呼び出しのイベントが送信される

バージョン固定の考え方(無人環境向け)

v2.1.328(前日のリリース)に続いてv2.1.329が出た。設定消失やメモリ暴走は「いつの間にかおかしくなっていた」系のバグで、原因の特定が難しかったと推測する。

自動化でClaude Codeを呼び出している環境では、次のような運用を検討するとよい。

  1. バージョン固定:npm install -g @anthropic-ai/claude-code@2.1.329 のように特定バージョンを固定して使う。いつの間にかバグが入ってシステムが止まる事態を防ぐ
  2. 週次でリリースノートを確認:毎日のリリースをすべて追うのは難しいが、週に1回 GitHub Releases を確認し、自分の環境に影響するバグ修正があればアップデートを判断する
  3. 設定ファイルのバックアップ:~/.claude.json を定期的にバックアップしておく。今回修正されたが、過去バージョンで設定が消えていた可能性は否定できない

企業のマネージドsettingsとhooks周りの修正が続いている。チームで使うほど設定の一貫性が重要になるので、今回のhooks信頼ダイアログの追加は方向性として正しいと感じた。ただし大型修正が続いているということは、まだ新規発見のバグが多い状態でもある。

出典:https://github.com/anthropics/claude-code/releases/tag/v2.1.329(2026-11-19公開)

関連記事:
https://qiita.com/Sidejob/items/[Claude Code v2.1.328 速報]


無人実行が止まる原因の点検を、ココナラで承っています(「Claude Code 点検」で検索)。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?