요약
- 네이티브 설치(curl 또는 PowerShell 설치 스크립트)는 백그라운드에서 자동 업데이트됩니다. 재시작해서 적용만 하면 됩니다.
- 지금 바로 필요하면 claude update를 실행하세요. 패키지 매니저 설치라면 brew upgrade claude-code 또는 winget upgrade Anthropic.ClaudeCode를 쓰세요.
- claude --version으로 버전을 확인하고, claude doctor는 최근 업데이트 시도 결과를 알려줍니다.
- 새 기능은 터미널이 가장 먼저 받고, IDE 확장·데스크톱 앱·웹은 각자 다른 속도로 업데이트됩니다.
Installing Claude Code (official walkthrough)
채널: Claude — official YouTube channel3:02
Claude Code Plugins Explained In 7 Minutes
채널: Software Engineer Meets AI7:21
Set up Claude Code — official docs (updates & channels)
문서: code.claude.com/docs
프레임은 공식 워크스루와 깨끗한 화면 녹화에서 가져왔고, 단계별 설명은 공식 셋업 문서를 따랐습니다.
스크린샷의 저작권은 원작자에게 있으며, 각 단계에 원본 영상의 타임스탬프로 돌아가는 링크를 붙였습니다.
Claude Code 업데이트, 단계별 정리
CLI 업데이트
- 1
네이티브 설치인지 확인하세요
curl과 PowerShell 설치 스크립트가 설치하는 네이티브 빌드는 백그라운드에서 스스로 업데이트합니다. 시작 시와 실행 중 주기적으로 확인하죠. Homebrew, WinGet, apt, npm으로 설치했다면 자동 업데이트가 꺼져 있으니 7단계로 가세요.
네이티브 설치가 끝나면 버전과 설치 위치가 터미널에 바로 표시됩니다.0:23부터 보기 - 2
지금 바로: claude update 실행
아무 터미널에서 claude update를 실행하면 그 자리에서 최신 빌드를 가져옵니다. 성공하면 어떤 버전에서 어떤 버전으로 바뀌었는지 알려주고, 이미 최신이면 그냥 최신 상태라고 답합니다.
- 3
실행 중인 버전 확인하기
claude --version을 실행하면 정확한 빌드 번호(예: 2.1.211)가 출력됩니다. 세션을 시작할 때마다 뜨는 배너에도 같은 버전이 모델 옆에 표시되니 평소에는 한눈으로 충분합니다.
세션 배너에는 실행 중인 버전이 표시됩니다. 여기서는 Sonnet 4.6의 v2.1.87.5:31부터 보기 - 4
조용히 실패했다면 claude doctor로 진단
자동 업데이트가 멈춘 것 같으면 claude doctor를 실행하세요. 최근 업데이트 시도 결과를 포함한 진단 정보를 출력합니다. npm 전역 디렉터리에 쓰기 권한이 없어 업데이트가 실패하는 대표적인 사례도 이것부터 확인하는 게 빠릅니다.
업데이트 채널 고르기
- 5
어느 환경이 먼저 새 기능을 받는지 알아두기
새 기능은 터미널에 먼저 배포되고, IDE 통합이 바로 뒤를 따르며, 데스크톱과 웹은 그다음입니다. 이번 주에 발표된 기능이 필요하면 CLI를 업데이트하고 터미널에서 작업하세요.
공식 워크스루는 터미널·IDE·데스크톱·웹을 나란히 비교합니다.2:25부터 보기 - 6
안정성 우선이면 stable 채널로
최신 빌드가 모두에게 맞는 건 아닙니다. /config 또는 settings.json에서 autoUpdatesChannel을 stable로 바꾸면 약 일주일 늦은 빌드를 쓰게 되고, 심각한 문제가 있는 릴리스는 자동으로 건너뜁니다.
- 7
패키지 매니저는 내 속도대로 업데이트
Homebrew, WinGet, apt, dnf, npm 설치는 절대 자동 업데이트되지 않습니다. brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode, apt upgrade 명령, 또는 npm install -g @anthropic-ai/claude-code@latest로 수동 업그레이드하세요. 문서가 명시적으로 경고하는 npm update -g는 쓰지 마세요.
모든 환경을 최신으로
- 8
VS Code 확장 업데이트
확장은 다른 확장과 마찬가지로 VS Code 확장 패널에서 업데이트합니다. Claude Code를 검색해 업데이트를 설치하고 창을 다시 불러오세요. 확장이 구동하는 것은 같은 CLI 바이너리이므로 둘 다 최신을 유지해야 합니다.
Claude Code for VS Code는 설치된 확장 목록에서 Claude Code 패널 옆에 자리합니다.1:07부터 보기 - 9
JetBrains 플러그인 업데이트
JetBrains IDE에서 Settings, Plugins, Marketplace로 이동해 Claude Code를 검색하고 설치 또는 업데이트하세요. 안내가 뜨면 IDE를 재시작해 새 플러그인 버전을 불러옵니다.
JetBrains Marketplace의 Claude Code에는 설치됨 표시가 붙어 있습니다.1:37부터 보기 - 10
데스크톱 앱도 최신으로
데스크톱 앱은 자체 인앱 업데이터로 업데이트되고, 안의 Code 토글로 폴더를 지정해 세션을 열 수 있습니다. 권한 제어와 클라우드 실행도 지원하죠. 업데이트 알림을 무시하면 내장 CLI가 터미널보다 뒤처지니 그때그때 적용하세요.
공식 워크스루는 데스크톱 환경에 별도 섹션을 할애했습니다.1:50부터 보기 - 11
재시작 안내 문구 이해하기
백그라운드 업데이트는 실행 중인 세션의 바이너리를 절대 바꾸지 않습니다. 다운로드된 업데이트는 다음에 Claude Code를 시작할 때 적용되므로, 재시작 안내는 오류가 아니라 정상 동작입니다. 작업을 마치고 종료한 뒤 다시 시작하세요.
업데이트가 적용되지 않을 때
- 12
업데이트가 적용되지 않을 때
먼저 claude doctor를 실행하세요. 권한 문제, 실패한 업데이트 시도, 수정 제안을 표시해 줍니다. 그래도 안 되면 네이티브 설치 스크립트를 다시 실행해 바이너리를 교체하거나, Claude Code 멈춤·응답 없음 해결 가이드의 문제 해결 목록을 확인하세요.
Claude Code 버전 명령어 한눈에 보기
버전 확인, 업데이트, 문제 해결에 필요한 명령어를 한 목록에 정리했습니다. 모두 일반 터미널에서 실행합니다.
- 1claude --version — 정확한 빌드 번호를 출력합니다(예: 2.1.211).
- 2claude update — 네이티브 설치를 즉시 업데이트하고 이전·새 버전을 알려줍니다.
- 3claude doctor — 설치 진단 정보. 최근 업데이트 시도 결과도 포함됩니다.
- 4brew upgrade claude-code — Homebrew 설치의 수동 업그레이드. 오래된 버전은 가끔 brew cleanup으로 정리하세요.
- 5winget upgrade Anthropic.ClaudeCode — WinGet의 수동 업그레이드. 실행 중에는 Windows가 실행 파일을 잠가 실패할 수 있습니다.
- 6settings.json의 env 블록에 DISABLE_AUTOUPDATER=1을 넣으면 백그라운드 업데이트 확인이 완전히 꺼집니다.
두 개의 다른 다이얼도 알아두세요. autoUpdatesChannel을 stable로 하면 최신 릴리스보다 약 일주일 늦게 따라가고, 조직의 managed settings로는 모든 머신에 최소·최대 버전을 강제할 수 있습니다.