Как читать журнал изменений

Инструмент выпускает версии почти ежедневно. Из-за этого половина утверждений о нём верна не вообще, а начиная с конкретного номера — и статья годичной давности может описывать поведение, которого больше нет. Навык сверять свою привычку с версией нигде не преподаётся, а стоит дорого.

Два места, где живёт правда

Страница журнала в документации. Записи идут в обратном хронологическом порядке: номер версии, дата, список пунктов по категориям — добавлено, исправлено, улучшено, изменено, удалено. Страница генерируется из файла в репозитории проекта.

Исходный CHANGELOG.md. Тот же список, но без дат: заголовок с номером версии и маркированный список под ним. Удобен тем, что его можно скачать и продиффить целиком.

Отдельной команды /release-notes не существует, и специальной страницы «что нового у вас» тоже — сверка остаётся ручной операцией.

Правильный порядок сверки

Начинайте не с журнала, а со своей машины:

claude --version     # печатает номер и (Claude Code)
claude doctor        # здоровье установки и результат последней попытки обновления

Дальше сравнивайте диапазон, который вы пропустили, а не «последние новости». Смысл именно в диапазоне: если вы обновились с 2.1.180 на 2.1.246, вас касаются шестьдесят с лишним записей, и большинство из них к вам не относится.

Читайте с фильтром «что изменилось в поведении по умолчанию». Именно эти пункты ломают привычку молча — новые возможности вы просто не заметите, пока не понадобятся, а изменившийся дефолт вы заметите как «инструмент стал странно себя вести».

Примеры такого класса изменений, которые стоит уметь узнавать:

• встроенный стартовый режим разрешений на планах Pro, Max и Team стал авторежимом (на macOS, Linux и WSL — с 2.1.228, на нативном Windows — с 2.1.233);
• рантайм MCP переключился на вторую версию протокола с 2.1.232, вместе с ревизией спецификации (Врата, выдерживающие команду);
• встроенное ревью агент начал запускать сам, не только по вашей команде, с 2.1.246 (Вторые глаза);
• счётчики расхода стали обнуляться на /clear, а не копиться за весь процесс.

Более надёжный источник, чем журнал

Неочевидный, но самый практичный приём: страницы документации сами помечают пороги версий. Ищите на странице два шаблона — Requires Claude Code v2.1. и Before v2.1.: первый называет минимальную версию, при которой механизм работает, второй описывает, как он вёл себя раньше. Оба стоят прямо рядом с описанием механизма. Это точнее журнала, потому что отвечает на ваш конкретный вопрос — работает ли это у вас, — а не на вопрос, что вообще поменялось.

Отсюда рабочая привычка: столкнулись с тем, что описанное в статье не воспроизводится, — сначала сверьте версию по странице доки, потом ищите ошибку у себя.

Каналы и пороги

У Homebrew канал зашит в имя каски, а не в настройку: claude-code — stable, claude-code@latest — latest. Установки через Homebrew, WinGet, apt, dnf и apk сами не обновляются вовсе (Посадка).

Для команды выбор канала — это не вкусовщина, а решение о том, кто ловит регрессии. Разумная схема: часть команды на latest замечает проблемы первой, остальные на stable с зафиксированным полом версии (Развёртывание на гильдию).

Что делать с находкой

Изменение, которое вас касается, полезно не просто прочитать, а закрепить. Новая настройка по умолчанию — либо принять её осознанно, либо зафиксировать прежнее поведение в файле настроек. Исчезнувший или переименованный флаг — поправить в скриптах и воркфлоу. Изменившийся дефолт прав — сверить с тем, что вы считаете безопасным (Круг дозволенного).