클로드 코드 업데이트, 설치 방식부터 확인하면 명령어가 달라진다

업데이트 명령은 실행했는데 버전이 그대로인 경우가 있다. 다른 경로에 설치한 프로그램을 계속 실행하고 있을 수 있다.

클로드 코드 업데이트는 설치 방식 확인부터 시작한다. 네이티브 설치라면 claude update, Homebrew라면 해당 cask의 brew upgrade를 쓴다. 완료 후에는 프로그램을 다시 시작하고 claude --version으로 실제 버전을 확인한다.

2026년 9월 8일 공식 문서와 이 Mac의 CLI 도움말을 대조했고, 9월 13일에는 아래 Homebrew 설치 목록과 네이티브 실행 경로를 추가로 확인했다. 아래 순서는 터미널에서 사용하는 Claude Code 기준이다. Claude 데스크톱 앱이나 요금제를 바꾸는 절차는 별개다.

클로드 코드 버전과 설치 방식을 먼저 확인하기

터미널에서 현재 버전을 확인한다.

claude --version

이 명령은 지금 실행되는 프로그램의 버전을 보여준다. 출력 숫자가 인터넷에서 본 번호와 다르다고 곧바로 설치 오류는 아니다. 업데이트 채널이나 배포 시점이 다를 수 있다.

설치 방식이 기억나지 않으면 다음 진단 명령을 확인해보면 좋다.

claude doctor

공식 문서는 이 명령을 설치와 설정 상태를 확인하는 읽기 전용 진단으로 설명한다. 결과에 나온 설치 방식과 경고를 먼저 읽고, 다음 표에서 해당하는 한 경로를 고르면 된다. 명령을 찾지 못한다면 클로드 코드 설치 오류 해결에서 실행 경로부터 확인한다.

설치 방식에 맞는 업데이트 명령 하나 고르기

설치한 방식	직접 갱신할 때	먼저 확인할 점
네이티브 설치 스크립트	claude update	기본 자동 갱신과 별도로 수동 확인 가능
Homebrew의 claude-code	brew upgrade claude-code	설치된 cask 이름 확인
Homebrew의 claude-code@latest	brew upgrade claude-code@latest	다른 cask를 새로 추가하지 않기
Windows WinGet	winget upgrade Anthropic.ClaudeCode	실행 파일 잠금으로 실패하면 종료 후 재시도
기존 npm 설치	npm install -g @anthropic-ai/claude-code@latest	npm 설치를 사용 중인지 먼저 확인

위 명령을 위에서부터 전부 실행하는 것이 아니다. 현재 설치한 방식의 한 줄만 선택한다. apt·dnf·apk로 설치했다면 공식 설치 문서의 해당 패키지 관리자 안내를 따른다.

npm 사용자는 npm update -g와 구별할 필요가 있다. 공식 안내는 기존 설치의 버전 범위 때문에 최신 릴리스로 이동하지 않을 수 있다며 npm install -g @anthropic-ai/claude-code@latest를 안내한다.

업데이트 때문에 새 설치 방식을 추가하는 건 뒤로 미루는 편이 낫다. 지금 쓰는 경로를 유지하면 이후 문제가 생겼을 때 무엇이 바뀌었는지 확인하기 쉽다.

Homebrew에서 설치한 cask 이름이 기억나지 않을 때

Mac의 터미널 앱에서 아래 두 줄을 각각 실행한다. cask는 Homebrew가 관리하는 설치 항목의 이름이다. 다음 명령은 설치 목록을 조회하며 Claude Code를 갱신하지 않는다.

brew list --cask --versions claude-code
brew list --cask --versions claude-code@latest

이름과 버전이 표시되면 위 명령표에서 같은 이름의 갱신 명령을 고른다. 공식 설치 안내에 따르면 claude-code는 stable, claude-code@latest는 latest 채널이다. 이름 끝의 @latest를 보고 새 cask를 추가하는 절차로 바꾸지 않는다.

아무것도 표시되지 않으면 다음 명령으로 설치 목록 조회가 정상인지 확인한다. Homebrew 명령 설명은 list를 설치된 항목의 조회로 안내한다.

brew list --cask --versions

확인 결과	다음 행동
목록은 나오지만 두 이름이 없음	이 Homebrew 목록에서 확인되지 않은 상태다. 아래 실행 경로 확인으로 넘어간다.
두 이름이 모두 나옴	type -a claude와 claude doctor를 대조해 실제 실행 경로부터 확인한다.
brew를 찾지 못하거나 목록 조회도 오류	Homebrew 조회를 완료하지 못한 상태다. 오류를 남기고, 앞 절의 Claude 설치 방식 진단으로 돌아간다.

2026년 9월 13일 macOS arm64·Homebrew 6.0.18에서는 개별 조회 두 개가 빈 출력과 종료 코드 1을 반환했다. 전체 설치 목록 조회는 종료 코드 0이었고 두 cask는 없었다. 이 결과만으로 Claude Code 자체가 없다고 판단할 수는 없다. 같은 날 앞선 네이티브 경로 검사에서는 Claude Code 2.1.268 실행을 확인했다.

이번에는 설치·업그레이드를 실행하지 않았다. Homebrew 자동 갱신과 분석 전송을 끄고 조회했지만 첫 명령에서 패키지 메타데이터 다운로드는 발생했다. cask로 설치된 환경의 갱신 성공을 확인한 결과는 아니다.

자동 업데이트인데 왜 바로 달라지지 않을까?

네이티브 설치는 기본적으로 시작 시와 실행 중에 갱신을 확인한다. 백그라운드에서 설치된 변경은 다음 실행부터 적용된다. 열어둔 세션에서 새 기능이 보이지 않는다면, 작업 내용을 확인한 뒤 종료하고 다시 실행해본다.

Homebrew·WinGet 설치는 기본적으로 수동 갱신이다. 네이티브 설치 안내를 보고 같은 동작을 기대하면 헷갈릴 수 있다.

또한 native의 latest와 stable 채널은 배포를 받는 시점이 다르다. Homebrew는 설치한 cask 이름으로 채널을 구분한다. 회사가 버전을 관리하는 환경이라면 조직의 배포 정책부터 확인하는 것이 순서다.

채널을 바꾸는 일과 현재 채널에서 갱신하는 일도 나눠보자. 단지 다른 사람과 숫자를 맞추려고 설정을 바꾸기보다, 필요한 기능이 현재 채널에 제공됐는지를 먼저 보는 편이 낫다.

업데이트 후 버전이 그대로일 때 확인할 것

새 터미널에서 claude --version을 다시 실행한다. 여전히 예상과 다르면 실행 경로를 확인한다.

macOS·Linux에서는 다음 명령으로 같은 이름의 프로그램이 여러 경로에 있는지 볼 수 있다.

type -a claude

Windows PowerShell에서는 다음처럼 확인한다.

Get-Command claude -All

이 명령들은 경로를 찾는 용도다. 여러 결과가 나왔다고 파일을 바로 지우지는 않는다. 어떤 경로를 업데이트했고 지금 어떤 경로를 실행하는지 대조한다. 공식 설치 문제 해결 문서도 설치 방식과 경로에 따른 문제를 나눠 설명한다.

재설치 전에 남길 정보는 간단하다.

• 업데이트 전후 버전 두 번의 claude --version 결과
• 선택한 설치 방식 native·Homebrew·WinGet·npm 중 해당 경로
• 실행 결과 명령의 성공 또는 오류 문구
• 실행 경로 다른 설치가 먼저 잡히는지 확인할 자료

인증 키나 비공개 프로젝트 내용은 오류 질문에 붙이지 않는다.

실행 링크와 진단 버전까지 대조한 예

macOS에서 위 경로 확인 결과가 ~/.local/bin/claude이고 네이티브 설치를 쓴다면, 터미널 앱에서 다음 명령으로 연결 대상만 읽을 수 있다. 설치나 삭제를 하는 명령은 아니다.

readlink ~/.local/bin/claude

2026년 9월 13일 macOS arm64 검사에서 아래 세 값이 일치했다. 홈 폴더의 사용자 이름은 ~로 바꿔 표시했다.

확인 항목	실제 확인값	알 수 있는 범위
readlink의 대상	~/.local/share/claude/versions/2.1.268	현재 링크가 가리키는 파일
claude –version	2.1.268 (Claude Code)	실제 실행한 버전
claude doctor	Running: native (2.1.268), 같은 버전 파일의 Path	진단에서 확인한 방식과 경로도 일치

이것은 현재 경로의 대조이며 업데이트 성공이나 오류 해결을 검증한 결과가 아니다. 이번 검사는 계정 환경 변수를 넘기지 않고 별도 설정 폴더와 자동 업데이트 비활성화 옵션으로 실행했다.

그 조건에서 Config install method: not set과 자동 업데이트 비활성화 안내도 나왔다. 원래 사용자 설정을 검사한 결과가 아니므로, 이 경고만으로 실제 설치 오류를 단정하거나 재설치를 진행하지 않았다.

type -a에 같은 경로가 반복돼도 줄 수만으로 여러 버전 설치를 단정하지 않는다. readlink에 출력이 없을 때도 일반 파일이나 별도 실행 스크립트일 수 있다. 공식 설치 문서는 사용자 실행기가 어느 버전을 실행할지 정할 수 있다고 설명한다. 진단과 실행 경로를 먼저 대조하고 파일 삭제는 서두르지 않는다.

이 글에서 직접 확인한 범위

2026년 9월 8일 이 Mac에서는 claude --version이 2.1.263 (Claude Code)를 반환했고, claude update --help에서 업데이트 확인·설치 명령임을 확인했다.

전체 업데이트를 실행한 후기는 아니다. 다른 운영체제의 갱신 성공도 직접 검증하지 않았다. 설치 방식별 명령은 확인일의 공식 문서 기준이다. 이 숫자를 모든 사용자가 설치해야 할 최신 버전으로 제시하지 않는다.

판단의 기준은 명령을 쳤는지가 아니라 다시 실행한 프로그램이 원하는 상태인지다. 버전과 경로를 함께 남겨두면 실패했을 때도 다음에 확인할 지점이 좁혀진다.

갱신을 마치고 실습을 이어가려면 바이브코딩 시작 가이드에서 현재 진행 중인 단계로 돌아가면 된다.

자주 묻는 질문

업데이트하면 Pro가 Max로 바뀌나요?

CLI 프로그램 갱신과 구독 변경은 다른 절차다. 계정의 이용 조건이 궁금하다면 클로드 코드 요금제를 따로 확인한다.

데스크톱 앱도 이 명령으로 업데이트하나요?

이 글은 터미널 CLI 기준이다. 앱과 터미널의 차이는 CLI와 데스크톱 비교에서 먼저 구분할 수 있다.

최신이라는 메시지가 나오면 확인을 끝내도 되나요?

현재 설치 방식과 채널에서 갱신할 것이 없다는 안내일 수 있다. 프로그램을 다시 시작한 후 버전과 필요한 기능을 확인한다. 다른 설치 경로가 실행된다면 메시지만으로 판단하기 어렵다.

검증 기준

• 마지막 업데이트일: 2026-09-08
• 추가 확인일: 2026-09-13, 설치 목록·실행 경로 대조
• 확인 환경: 9월 8일 macOS·Claude Code 2.1.263의 버전·도움말, 9월 13일 macOS arm64·Claude Code 2.1.268의 격리 진단과 Homebrew 6.0.18의 설치 목록 조회. 두 날짜 사이의 업그레이드 과정·Windows 실행은 미검증.
• 주요 근거: 공식 설치·업데이트 안내, CLI 참조, 설치 문제 해결