claude -v: 내 Claude Code 버전 5초 만에 확인하기

블로그 글이나 문서를 쓸 때 "이게 어느 버전 기준이지?" 하고 막막했던 적 있으신가요? 혹은 뭔가 안 될 때 "내 버전이 너무 오래된 건가?" 싶을 때도요. 그럴 때 가장 먼저 확인하는 명령이 바로 이거예요.

정의 (뭐냐면)

claude -v는 지금 설치된 Claude Code의 버전을 확인하는 명령이에요(-v = version). 버전(version)은 소프트웨어가 몇 번째로 갱신된 것인지를 나타내는 번호예요. 실행하면 2.1.154 같은 번호가 화면에 한 줄 나오고 끝납니다.

어떻게 쓰나 (난이도별)

시작 전에: 이 명령은 어느 폴더에서 쳐도 똑같이 동작해요. 작업 폴더로 이동할 필요 없이, 터미널을 열고 바로 입력하면 됩니다. 별다른 설정이나 로그인도 필요 없어요.

기초 — 버전 보기

claude -v

실행하면 현재 설치된 버전 번호가 한 줄 출력돼요(예: 2.1.154). 채팅창이 열리거나 하지 않고, 번호만 보여주고 바로 끝납니다. 만약 "claude를 찾을 수 없다"는 메시지가 뜬다면, 그건 아직 Claude Code가 설치되지 않았거나 설치 경로가 인식되지 않은 거예요.

실전 사례

블로그 글에 "이 글은 어느 버전 기준이다"라고 적기 전에 claude -v로 정확한 번호를 확인하는 경우가 많아요. 명령어의 동작은 버전에 따라 조금씩 달라질 수 있어서, 기준 버전을 적어두면 읽는 사람이 헷갈리지 않아요.

이렇게 더 씁니다

• 버전을 알면 블로그·문서에 "기준 버전"을 정확히 표기할 수 있어, 글의 신뢰도가 올라가요.
• 뭔가 작동이 이상할 때, 가장 먼저 버전을 확인해 "너무 오래된 버전인지"부터 점검하면 문제 원인을 빨리 좁힐 수 있어요.
• 도움을 요청할 때 버전 번호를 함께 알려주면 상대가 상황을 정확히 파악하기 좋아요.

정리

claude -v는 가장 단순하지만 자주 쓰는 점검 명령이에요. 어느 폴더에서든 한 줄 치면 현재 버전 번호가 바로 나와요. 문서에 기준을 적을 때, 그리고 문제 해결의 첫 단계로 기억해 두세요.

기준: Claude Code v2.1.154 (2026.05)