Claude Code v2.1.4 — バックグラウンドタスク機能を環境変数1つで丸ごと無効化できるように

このリリースで何ができるようになるか

Claude Code v2.1.4は変更点2件の小粒パッチですが、運用側の選択肢が一つ増えるリリースです。

• バックグラウンドタスク機能を丸ごと停止できる環境変数 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS が追加: 自動バックグラウンド化と Ctrl+B ショートカットの両方が無効化されます
• 「Help improve Claude」設定の取得がOAuthトークン期限切れで失敗したとき、トークンを再取得してリトライするよう修正されました

直前のv2.1.0で Ctrl+B の一括バックグラウンド化が入り、v2.1.3でカウンタ表示のズレが直り、本版で「機能ごと止める出口」が用意される、という流れです。

あなたの開発フローはどう変わるか

Ctrl+B をtmuxなどのプレフィックスキーとして使いたい人

tmux / GNU screenのプレフィックスキーが Ctrl+B のままだと、Claude Code側がショートカットを奪うため衝突します。本版以降は環境変数1つで Ctrl+B キャプチャごと無効化できます。

# .zshrc / .bashrc に書いておけば恒久的に無効化
export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1
claude

direnv を使えばプロジェクト単位で切り替えられます。チームで挙動を揃えたい場合は .envrc やチーム共通のシェルプロファイルに寄せておくと、ペア作業時に挙動の食い違いが出ません。

CI / 教育環境

CIランナーでは、長時間タスクが意図せずバックグラウンドに回ると後段のステップ判定が複雑になります。教育環境では「TUIで何本走っているか」の認知負荷を学習者に持ち込みたくないケースもあります。本版以降は環境変数で意図しないバックグラウンド化を禁止できるため、こうした場面の選択肢として有用です。

「Help improve Claude」設定で不可解なエラーを見ていた人

設定画面を開いたときに、「Help improve Claude」項目が読み込めずエラーになることがありました。これはOAuthトークンが古くなっている(stale)状態で、サーバへのfetchが401 / 403で落ちていたためです。本版では失敗時にトークンを再取得してから1度リトライするため、設定画面を開いたときに値が正しく見えるようになります。

v2.1.0で入った「サーバ側expired / ローカルvalid判定で再取得が発火しない」修正と同じ系譜で、認証回りのstale耐性を細かく詰める流れの一部です。

バックグラウンド化を活用しているユーザー

挙動は変わりません。デフォルトのままで従来通りの自動バックグラウンド化と Ctrl+B が使えます。

主な変更点

環境変数の追加

• CLAUDE_CODE_DISABLE_BACKGROUND_TASKS: 自動バックグラウンド化と Ctrl+B ショートカットを含むバックグラウンドタスク機能全体を無効化

バグ修正

• 「Help improve Claude」設定のfetch: OAuthトークン期限切れで失敗したとき、トークンを再取得してリトライするよう修正

バックグラウンドタスク機能の出し方が示す設計姿勢

v2.1系のchangelogを横並びにすると、本版の意味が見えやすくなります。

v2.1.0で機能を強化し、v2.1.3で可視化を直し、v2.1.4で「そもそも止める」出口を用意する、という3段の流れになっています。実装的には派手な改善ではありませんが、「機能を入れたら無効化パスも整える」設計姿勢が端的に出たパッチと読めます。

OAuthリトライの修正も、v2.1.0で入った同様の修正系列に並ぶもので、トークン期限切れの自動回復を細かいケースまで含めて詰めていく流れの一部です。

まとめ

• Ctrl+B をtmuxで使いたい人: 即更新推奨。環境変数を .zshrc などに書いておくと恒久的に止められます
• CI / 教育環境: 環境変数をCI側に渡すか、チーム共通のシェルプロファイルに寄せておく運用が扱いやすい形です
• OAuth staleエラーが出ていた人: 本版でfetchのリトライが効きます
• バックグラウンド機能を活用している人: 挙動は変わらないため任意更新で問題ありません

派手な変更こそありませんが、CIや教育環境、ターミナル構成の都合で「バックグラウンド化を止めたい」チームには、この1行の意味が大きいリリースです。