한 줄 정의

claude --version은 Claude Code를 CLI(명령줄 인터페이스)에서 실행하기 전에 버전을 확인하는 출입 명령이야. 공식 문서에서 설치 확인 명령으로 제시되는 표기는 claude --version이고, claude version은 실행 가능한 별칭으로 가정하지 않아. 이 출력은 이 항목의 출발점이야.

왜 중요한가

버전 확인을 먼저 하면 실행 실패 원인을 두 갈래로 빨리 나눌 수 있어. 2.1.50처럼 기준보다 낮으면 업데이트가 먼저고, 2.1.112처럼 이미 충분하면 환경 문제 확인으로 넘어가면 돼. 이 순서를 먼저 잡아 두면 Claude Code Remote Control(클로드 코드 리모트 컨트롤) 같은 기능을 붙인 뒤에야 버전 부족을 뒤늦게 발견하는 시간을 줄일 수 있어.

어떻게 작동하나

버전 확인 순서

버전을 먼저 점검하지 않으면, 실제 기능을 쓰다가 중간에서 멈추는 경우가 생겨. 정확한 숫자를 비교하면 문제를 빨리 좁힐 수 있어.

  1. claude --version 실행
  2. 출력 문자열에서 버전 숫자 확인
  3. Claude Code Remote Control(클로드 코드 리모트 컨트롤) 기준 2.1.51 또는 Claude Code v2.1.110(클로드 코드 2.1.110)처럼 더 높은 기능 기준과 비교
  4. 숫자가 기준보다 낮으면 claude update 또는 재설치로 먼저 보정
  5. 숫자가 이미 충분하면 claude doctor와 로그인, 정책, 신뢰, 프로세스, 네트워크를 점검

버전 비교 예시

샘플 출력은 아래처럼 보여. 기준은 바로 이 값으로 비교해.

  • 실행 명령: claude --version
  • claude-code 2.1.112

버전 출력이 2.1.50이면 Claude Code Remote Control(클로드 코드 리모트 컨트롤)의 최소 기준인 2.1.51을 통과하지 못해. 이때는 claude update로 먼저 업데이트를 실행해. 예를 들어 Claude Code v2.1.110(클로드 코드 2.1.110)에서 소개된 모바일 푸시 흐름을 보려면, 같은 출력값이 2.1.110 이상인지도 바로 비교하면 돼. 반대로 2.1.112는 Remote Control 기준과 모바일 푸시 기준을 둘 다 넘긴 값이야.

환경 점검 예시

2.1.112처럼 숫자가 이미 충분한데 기능이 안 되면, 버전이 아니라 환경 문제일 가능성이 더 커. 이때는 claude doctor를 먼저 돌리고 로그인, 정책, 신뢰, 프로세스, 네트워크를 점검해. claude.ai(클로드 웹 앱)에서는 계정이 정상인데 터미널에서만 막힌다면, 버전보다 로컬 인증이나 네트워크 쪽을 먼저 의심하는 흐름이 맞아.

어디까지 알 수 있나

claude --version은 설치된 Claude Code가 최소 버전보다 낮은지 먼저 가리는 도구야. 이 명령만으로 기능 성공, 성능, 정책 통과까지 보장하지는 않아. 버전이 충분하다는 판단이 나오면, 그다음부터는 claude doctor와 기능별 문서를 같이 봐야 해.

함께 보면 좋은 명령과 도구