Claude Code - wersje, kanały wydań i aktualizacje

Sekcja referencyjna Claude Code opisuje to, co zmienia się pod działającą konfiguracją: jaka wersja i jaki kanał wydań są zainstalowane, co każde wydanie usunęło lub zmieniło, jak bezpiecznie aktualizować i które funkcje są wciąż podglądami. 12 października 2026 roku kanał latest to 2.1.296, a stable to 2.1.287. Oba domyślnie używają Claude Opus 5.5, a różnią się tym, jakie zmiany niosą: wszystko od 2.1.288 wzwyż jest tylko w latest.

Ten przegląd jest dla dewelopera, który sam utrzymuje swoją instalację, i dla tech leada, który odpowiada za zespołowy .claude/settings.json i zadania CI. Kolega z zespołu mówi, że --model haiku uruchamia teraz Claude Haiku 5.5. U ciebie nadal uruchamia Haiku 4.5, a żaden z was nie zmienił ustawień. Jesteście na różnych kanałach: alias przesunął się w 2.1.293, którą ma tylko latest, i nic was o tym nie poinformowało.

Co daje ci sekcja referencyjna Claude Code

• Dwuminutowe sprawdzenie wersji, kanału i modelu domyślnego
• Mapę: od pytania, które masz, do strony, która na nie odpowiada
• Dwa prompty do skopiowania, które zamieniają informacje o wydaniach w listę zmian dotyczących twojego repozytorium
• Krótki smoke test, który dowodzi, że aktualizacja nie zepsuła logowania, dostępu do modelu ani wyjścia JSON

Jaką wersję i jaki kanał Claude Code masz zainstalowane?

Zrób te sprawdzenia, zanim zaczniesz debugować brakującą komendę albo zmienione ustawienie domyślne.

1. Wypisz zainstalowaną wersję w terminalu:

   claude --version

2. Porównaj ją z tym, co aktualnie oferuje każdy kanał:

   npm view @anthropic-ai/claude-code dist-tags

   12 października 2026 roku wynik wymienia latest i next na 2.1.296 oraz stable na 2.1.287.

3. Sprawdź instalację bez uruchamiania sesji:

   claude doctor

   claude doctor czyta też pliki ustawień w bieżącym katalogu. W sesji /doctor przeprowadza pełniejszą kontrolę, która potrafi naprawić problemy.

4. W sesji uruchom /model, żeby zobaczyć model, który faktycznie dostajesz. /release-notes otwiera wybór wersji z informacjami o wydaniach.

	Kanał latest	Kanał stable
Wersja 12.10.2026	2.1.296	2.1.287; według przewodnika instalacji Anthropic „typically about one week old”, z pominięciem wydań z poważnymi regresjami
Jesteś na nim, gdy	użyłeś natywnego instalatora albo npm z ustawieniami domyślnymi, albo casku Homebrew claude-code@latest	ustawiłeś autoUpdatesChannel: "stable", instalowałeś przez bash -s stable albo używasz casku Homebrew claude-code
Model domyślny	Claude Opus 5.5 na każdym płatnym planie i w API (wymaga 2.1.280 lub nowszej)	ten sam, bo 2.1.287 jest nowsza niż 2.1.280
Aliasy modeli w Anthropic API	sonnet to Claude Sonnet 5.5 (od 2.1.284); haiku to Claude Haiku 5.5 (od 2.1.293)	sonnet to Claude Sonnet 5.5; haiku wskazuje to, co przed 2.1.293, czyli Haiku 4.5, bo Haiku 5.5 wymaga 2.1.293
Zmiany od 2.1.288 wzwyż, np. claude purge i pole hooka onFailure	są	jeszcze nie: stable to 2.1.287
Startowy tryb uprawnień w sesjach interaktywnych	auto na każdym planie i u każdego dostawcy (wymaga 2.1.283), o ile model go obsługuje	ten sam, bo 2.1.287 jest nowsza niż 2.1.283

claude -p i Agent SDK startują w trybie Manual na obu kanałach, z wyjątkiem dostawców zewnętrznych i wyłączonej telemetrii, gdzie od 2.1.285 startują w trybie auto. Wartości domyślne dla poszczególnych planów i dostawców, ceny oraz aliasy są w przeglądzie modeli; Microsoft Foundry odbiega od obu kolumn.

Która strona referencyjna odpowie na twoje pytanie?

Twoje pytanie	Strona
Co zmieniło się w wersji X i co przestało działać?	Historia wersji Claude Code
Jak bezpiecznie zaktualizować CI jednego repozytorium albo przypiąć zespół do jednej wersji?	Historia wersji Claude Code, sekcje o aktualizacji CI i przypinaniu wersji w zespole
Jak wdrożyć aktualizację na całą flotę maszyn i jak ją wycofać?	Procedury aktualizacji Claude Code
Czy ta funkcja to research preview, beta czy eksperyment i jak ją wyłączyć?	Funkcje beta i podglądy badawcze
Która komenda lub który klucz ustawień co robi, we wszystkich narzędziach?	Ściągawka poleceń i dokumentacja konfiguracji

Prompt do skopiowania: co różnica do latest oznacza dla tego repozytorium

Run `claude --version` and `npm view @anthropic-ai/claude-code dist-tags`
and tell me which channel I am on and how many releases I am behind latest.
Fetch https://code.claude.com/docs/en/changelog.md and read every entry after
my version. Then read .claude/settings.json, .claude/agents/, .claude/skills/,
CLAUDE.md, AGENTS.md and .github/workflows in this repository.
List only the changes that affect what this repository uses: removed commands
or settings, changed defaults (model, permission mode, instruction files),
and hook or MCP behaviour. For each, quote the changelog line with its
version and show the file:line in this repository it touches.
Do not edit files. Do not invent versions or settings keys.

Prompt do skopiowania: gdzie wersja Claude Code w zespole „pływa”

Find every place this repository installs or runs Claude Code: CI workflows,
Dockerfiles, devcontainer config, Makefiles, shell scripts and setup docs.
For each one, report: file:line, how it installs (native, npm, Homebrew,
image), whether the version is pinned to an exact number, whether
DISABLE_AUTOUPDATER or DISABLE_UPDATES is set, and whether the claude
invocation passes --model. Flag every place where the version or the model
can change without a commit. End with a table and a one-line fix per row.
Do not edit files.

Oba prompty wymagają pliku i linii albo cytatu z changelogu za każdym ustaleniem, więc sprawdzasz każde twierdzenie u źródła, zamiast ufać podsumowaniu.

Jak udowodnić, że aktualizacja nie zepsuła konfiguracji?

Nie musisz czytać transkryptu agenta. Po każdej zmianie wersji uruchom ograniczony smoke test, którego sygnałem sukcesu jest jedno słowo:

claude doctor
claude -p --output-format json --max-budget-usd 0.50 "Reply with the single word OK." | jq -r '.result'

Drugie polecenie (wymaga jq; bez niego sprawdź, czy pole result w JSON-ie ma wartość OK) jednym wywołaniem dowodzi, że działają logowanie, dostęp do modelu i wyjście JSON, i nie może wydać więcej niż 0,50 USD. Następnie wywołaj jeden hook na pliku testowym i sprawdź jego efekt, a jedną automatyzację używającą --output-format json uruchom ponownie na znanym wejściu: te same klucze, ten sam werdykt. W CI inżynier odpowiedzialny za konfigurację potoku zatwierdza podbicie wersji dopiero, gdy te kroki przejdą. Pełna, siedmiokrokowa procedura jest w sekcji o aktualizacji w historii wersji.

Co psuje się przy wersjach Claude Code i jak to naprawić?

• Udostępniona komenda jest „nieznana”. Twoja wersja jest starsza od niej albo jesteś na stable. Uruchom claude update albo claude install latest, żeby zainstalować najnowszą wersję, i ustaw autoUpdatesChannel: "latest", żeby automatyczne aktualizacje szły za nim. claude install 2.1.296 instaluje konkretną wersję.
• Homebrew nigdy się nie aktualizuje. Żaden z casków domyślnie nie aktualizuje się sam. Uruchom brew upgrade --cask claude-code (albo claude-code@latest, zależnie od tego, który zainstalowałeś).
• Sesje w tle zachowują się dziwnie po aktualizacji. Nadal działają na starym pliku wykonywalnym. Uruchom claude respawn --all, żeby przeszły na bieżącą wersję.
• Wyniki CI zmieniły się bez żadnego commita. Model domyślny zmienił się na Opus 5.5 w wersji 2.1.280 (w obu kanałach, odkąd stable doszedł do 2.1.287), alias sonnet na Sonnet 5.5 w 2.1.284, a alias haiku na Haiku 5.5 w 2.1.293 (tylko latest). Przypnij dokładną wersję Claude Code i przekazuj --model w każdym wywołaniu w CI, a przed przesunięciem któregokolwiek z tych pinów uruchom ponownie swoje ewaluacje.
• Przypięta maszyna i tak się zaktualizowała. DISABLE_AUTOUPDATER=1 wyłącza tylko sprawdzanie w tle, więc ktoś wciąż może uruchomić claude update. DISABLE_UPDATES blokuje też claude update i claude install; używaj go tylko wtedy, gdy Claude Code rozprowadzasz własnym kanałem.

Sprawdzono na Claude Code 2.1.283 (claude --help, claude doctor --help, claude install --help, claude respawn --help) 26 września 2026 roku. Powyższe stwierdzenia o wersji, kanale i modelu domyślnym sprawdzono ponownie 12 października 2026 roku w npm, we wskaźnikach kanałów instalatora natywnego, w caskach Homebrew i na stronie konfiguracji modeli Claude Code, przy zainstalowanym CLI w wersji 2.1.296.

Dokąd dalej z wersjami Claude Code

Historia wersji Claude Code Wydania, zmiany łamiące zgodność, procedura aktualizacji CI i przypinanie wersji w zespole.

Procedury aktualizacji Claude Code Wdrożenia na całą flotę, etapowe fale i wycofywanie zmian.

Funkcje beta i podglądy badawcze Co jest wciąż podglądem i jak bezpiecznie to wypróbować.

Instalacja Claude Code Punkt wyjścia: instalacja natywna, npm, Homebrew i menedżery pakietów.

Błędy niezwiązane z wersją opisuje rozwiązywanie problemów z sesją Claude Code. Odpowiedniki tej sekcji dla pozostałych narzędzi to materiały referencyjne Codex i materiały referencyjne Cursora.