昨日の記事では Code with Claude SF の発表と v2.1.132 を取り上げた。今日は v2.1.133(5/7 リリース)を起点に、直近でひっそりリリースされた「地味だが実務に刺さる」アップデート群をまとめる。
1. v2.1.133 — worktree.baseRef 設定が登場
ワークツリーの起点を選べるように
// .claude/settings.json
{
"worktree": {
"baseRef": "head" // "fresh"(デフォルト)または "head"
}
}
| 値 | 動作 |
|---|---|
fresh(デフォルト) | origin/<default> から分岐。常にリモートの最新をベースにする |
head | ローカル HEAD から分岐。未プッシュのコミットも新しいワークツリーに引き継ぐ |
--worktree フラグや EnterWorktree、エージェント隔離ワークツリーすべてに適用される。v2.1.128 以降、EnterWorktree のデフォルトがローカル HEAD に変わっていたが、今回 fresh でリモートベースに戻った。未プッシュのコミットをワークツリーに持ち込みたい場合は "head" を明示的に指定する。
sandbox パスの managed settings(Linux/WSL)
// managed settings(企業展開向け)
{
"sandbox": {
"bwrapPath": "/usr/local/bin/bwrap",
"socatPath": "/usr/local/bin/socat"
}
}
Linux/WSL 環境でカスタムの bubblewrap・socat バイナリを使っている場合にパスを明示できる。コンテナやセキュリティ強化環境で Claude Code をデプロイしているチーム向け。
参考: Release v2.1.133 · anthropics/claude-code — GitHub
2. --plugin-url — URL からプラグインをその場でロード
# セッション限りで URL から .zip を取得してプラグインとして使う
claude --plugin-url https://example.com/my-plugin.zip
プラグインを npm や公式ディレクトリに登録せずに、URL 指定で一時的に読み込める。社内限定プラグインやテスト中のプラグインを手軽に試せる。
セッション終了後は消えるので、恒常的に使いたい場合は通常のインストールが必要。
あわせて修正: npm ソースのプラグインで /plugin update が新バージョンを検出できなかったバグも修正済み。
参考: Claude Code Updates by Anthropic - May 2026 — Releasebot
3. Homebrew / WinGet の自動更新が公式サポートに
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE
# ~/.zshrc に追記
export CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1
Homebrew・WinGet 経由でインストールした場合、これまで自動更新は効かず brew upgrade claude-code を手動で叩く必要があった。この環境変数を設定すると、バックグラウンドでアップグレードコマンドを実行し、再起動を促すプロンプトを表示するようになる。
未設定の場合の挙動(手動更新が必要)は変わらない。opt-in なので既存環境には影響なし。
参考: Claude Code v2.1.129 Release Notes — ClaudeWorld
4. CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 — 同期出力を強制有効化
export CLAUDE_CODE_FORCE_SYNC_OUTPUT=1
claude
ターミナルの自動検出がうまく機能せず出力が崩れる環境向けの救済オプション。特殊なターミナルエミュレータや CI 環境で Claude Code の出力が乱れる場合に試す価値がある。
5. ゲートウェイモデル探索がオプトインに変更
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
v2.1.126〜2.1.128 で自動的に有効だった「ANTHROPIC_BASE_URL がカスタムゲートウェイを指しているとき、/v1/models エンドポイントを叩いてモデル一覧を取得し /model ピッカーに表示する」機能が、オプトインになった。
背景:ゲートウェイの /v1/models レスポンスが Anthropic ネイティブ形式でないと(OpenAI 互換形式など)うまく動かないという問題があった。自動実行でエラーが出るケースが報告されたため、環境変数で明示的に有効化する方式に戻った。
LiteLLM などを使っているチームは Issue #27180 も参照。
6. PostToolUse フック — 全ツールの出力を書き換えられるように
hookSpecificOutput.updatedToolOutput
以前は MCP ツールにしか使えなかった「フックがツール出力を差し替える」機能が、Bash・Edit・Read・Write を含む全組み込みツールに拡張された。
// PostToolUse フックが返す JSON(stdout)
{
"hookSpecificOutput": {
"updatedToolOutput": {
"stdout": "フィルタ済みの出力",
"stderr": "",
"interrupted": false,
"isImage": false
}
}
}
使いどころ:
- Bash の出力からシークレットをマスクして Claude に渡す
- diff の noisy な部分を削って Claude のコンテキストを節約
- 読み込んだファイルの内容を正規化(BOM 除去など)してから渡す
ツールはすでに実行済みなので副作用は取り消せないが、Claude が「見る内容」だけを変えられるのが強み。コンテキスト節約やセキュリティの観点で効いてくる機能。
参考: Hooks reference — Claude Code Docs
7. MCP サーバーの起動失敗を自動リトライ(最大3回)
起動エラー → 1秒待機 → 再試行 → 2秒待機 → 再試行 → 4秒待機 → 再試行 → 失敗マーク
MCP サーバーが起動時に一時的なエラー(5xx レスポンス・接続拒否・タイムアウト)を返した場合、自動的に指数バックオフで最大3回再試行するようになった(v2.1.121〜)。
認証エラーや 404 など設定変更が必要なエラーはリトライしない。
CI 上で MCP サーバーが先に立ち上がっていない状況など、タイミング依存の「最初だけ失敗する」問題に効果的。
8. /skills に検索ボックスが追加
/skills
> [検索ボックス] prisma で絞り込み...
✅ prisma-migrate
✅ prisma-schema-lint
スキルが多いと /skills の一覧をスクロールするのが大変だった。type-to-filter な検索ボックスが追加されたので、名前の一部を入力するだけで目的のスキルを素早く見つけられる。プラグインを大量に入れているユーザーには地味に便利。
本日のまとめ
| トピック | 要点 |
|---|---|
| v2.1.133 | worktree.baseRef でワークツリーの分岐元を選択可能に |
--plugin-url | URL 指定でプラグインをその場でロード(セッション限り) |
| Homebrew 自動更新 | CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 で opt-in |
FORCE_SYNC_OUTPUT | 特殊ターミナルで出力が崩れる場合の救済オプション |
| ゲートウェイ探索 | ENABLE_GATEWAY_MODEL_DISCOVERY=1 のオプトインに変更 |
| PostToolUse フック | updatedToolOutput が全ツール対応(旧: MCP のみ) |
| MCP 自動リトライ | 起動失敗時に指数バックオフで最大3回再試行 |
/skills 検索 | type-to-filter ボックスで素早く絞り込み |
Code with Claude SF の大型発表の影に隠れがちだが、直近リリースは「細部の詰め」が多い。特に PostToolUse フックの全ツール対応と Homebrew 自動更新は、日常的な開発フローに直接効いてくる変更。フックで出力をフィルタするパターンは今後ますます活用されそうだ。
参考ソース:
- What’s new — Claude Code Docs
- Changelog — Claude Code Docs
- Release v2.1.133 · anthropics/claude-code — GitHub
- Claude Code Updates by Anthropic - May 2026 — Releasebot
- Hooks reference — Claude Code Docs
- Advanced setup — Claude Code Docs
- Claude Code Best Practices 2026 — mcp.directory
- Claude Code Changelog: All Release Notes 2026 — claudefa.st