클로드 코드(Claude Code) 터미널 설치: 터미널이 처음인 분을 위한 화면 읽는 순서

클로드 코드 터미널 설치는 창 열기, 설치, 버전 확인, 연습 폴더에서 로그인 순서로 진행합니다. 각 단계의 결과를 확인한 뒤 다음 단계로 넘어갑니다. 실제로 걸리는 시간은 파일 내려받는 속도에 따라 달라집니다.

클로드 코드(Claude Code) (클로드 코드가 무엇인지 설명한 글 바로가기)가 터미널에서 돌아가는 도구라는 사실은 이미 알고 계신 분이 많습니다. 설치 명령도 검색하면 한 줄로 나오고, 붙여 넣으라는 데까지 따라가기는 어렵지 않습니다.

정작 막히는 곳은 그 앞뒤입니다. 터미널 창을 어디에서 여는지, 명령을 넣은 뒤 쏟아지는 글자 가운데 무엇을 봐야 하는지, 화면에 아무 반응이 없는 것이 성공인지 실패인지가 안내에서 빠져 있습니다. 이 셋을 모르는 채로 시작하면 이미 끝난 설치를 실패로 오해해 같은 명령을 여러 번 돌리거나, 한 줄이면 풀릴 문제를 붙잡고 지웠다 깔았다를 반복하게 됩니다. 아래 명령과 사양은 2026년 10월 4일 공식 문서 기준입니다. 이미 설치되어 있다면 새 터미널에서 claude --version부터 확인하고, 정상 출력되면 설치 명령을 반복하지 않습니다.

위 그림은 앤트로픽 공식 저장소에 올라와 있는 시연 화면입니다. 설치를 마치고 claude를 입력한 뒤 첫 요청까지 보낸 상태이며, 화면에 보이는 버전은 촬영 시점 기준입니다.

터미널 창을 여는 곳: 맥과 윈도우

터미널(Terminal)은 버튼을 누르는 대신 글로 컴퓨터에 지시를 넣는 창입니다. 따로 내려받을 것은 없고, 맥과 윈도우에 처음부터 들어 있습니다.

• 맥: Command + Space로 Spotlight 검색을 열고 Terminal을 입력한 뒤 엔터를 누릅니다.
• 윈도우: Win + X를 누르고 메뉴에서 Windows PowerShell 또는 Terminal을 고릅니다.
• 리눅스: Ctrl + Alt + T를 누르거나 프로그램 목록에서 터미널을 찾습니다.

윈도우에는 생김새가 비슷한 명령 창이 두 개 있습니다. PowerShell과 CMD인데 둘은 알아듣는 명령이 서로 다릅니다. 줄 맨 앞을 보면 구분할 수 있습니다. PS C:\Users\이름>처럼 앞에 PS가 붙어 있으면 PowerShell이고, PS 없이 C:\Users\이름>으로 시작하면 CMD입니다. 설치 명령이 다르므로 붙여 넣기 전에 어느 쪽 창인지 한 번 확인하시면 됩니다.

터미널 화면에서 먼저 읽어야 할 세 곳

창을 열면 글자 몇 줄과 깜빡이는 커서만 보입니다. 낯설어 보이지만 실제로 볼 곳은 세 군데뿐입니다.

우체국 창구 직원이 서류를 받을 준비가 되면 손을 내밀고 기다리듯, 터미널도 명령을 받을 준비가 되면 짧은 기호 하나를 줄 맨 앞에 띄워 둡니다. 이 기호가 명령 프롬프트(prompt), 즉 지금 명령을 입력해도 된다는 표시입니다. 모양은 셸(shell)마다 다릅니다. 셸은 입력한 명령을 받아 실행하는 프로그램입니다. 맥의 기본값인 zsh에서는 %, 리눅스의 bash에서는 $, 윈도우 PowerShell에서는 >가 나옵니다.

• 프롬프트 기호: 이 기호가 보이면 명령을 입력할 수 있는 상태입니다. 새 프롬프트가 없으면 실행 중이거나 추가 입력을 기다릴 수 있습니다. 마지막 안내 문장부터 확인합니다.
• 기호 앞의 글자: 지금 어느 폴더에서 작업하고 있는지 알려 줍니다. 맥은 ~ 하나가 홈 폴더를 뜻하고, 윈도우는 C:\Users\이름 같은 경로가 그대로 나옵니다.
• 깜빡이는 커서: 앞으로 입력하는 글자가 들어갈 지점입니다. 일반적인 셸 입력줄에서는 화살표 키로 입력 위치를 옮깁니다. 터미널이나 실행 중인 프로그램에 따라 마우스 기능도 지원할 수 있습니다.

이 글의 네이티브 설치는 일반 사용자 터미널에서 시작합니다. 관리자 권한이나 sudo를 먼저 붙일 필요는 없습니다.

처음 쓸 때 헷갈리기 쉬운 것이 두 가지 더 있습니다. 붙여넣기는 맥이 Command + V, 리눅스가 Ctrl + Shift + V, 윈도우 PowerShell이 Ctrl + V 또는 마우스 오른쪽 버튼입니다. sudo가 붙은 명령이나 Homebrew 설치처럼 맥 비밀번호를 묻는 명령에서는 입력해도 화면에 글자가 하나도 보이지 않습니다. 이것이 정상입니다. 본인이 실행한 명령이 비밀번호를 요구하는지 확인한 뒤 입력하고 엔터를 누릅니다.

클로드 코드 설치 명령 한 줄과 화면에 돌아오는 응답

시작 전에 사양부터 확인합니다. 공식 문서 기준으로 macOS는 13.0 이상, 윈도우는 10 버전 1809 이상이나 Windows Server 2019 이상, 리눅스는 우분투 20.04 이상과 데비안 10 이상, 알파인 리눅스 3.19 이상입니다. 하드웨어는 메모리 4GB 이상에 x64 또는 ARM64 프로세서면 됩니다. 계정은 Pro와 Max, Team, Enterprise, Console 가운데 하나가 필요하고 무료 Claude.ai 플랜에는 클로드 코드 사용 권한이 들어 있지 않습니다. Amazon Bedrock이나 구글 클라우드의 에이전트 플랫폼, 마이크로소프트 파운드리 같은 외부 API 사업자를 연결해 쓰는 방법도 있습니다.

아래 세 설치 명령은 대안이므로 자신의 환경에 맞는 하나만 실행합니다. 설치 명령은 인터넷의 공식 스크립트를 받아 실행하므로 주소를 그대로 확인합니다.

맥과 리눅스에서는 아래 한 줄을 붙여 넣고 엔터를 누릅니다.

윈도우 PowerShell에서는 명령이 다릅니다.

CMD 창에서 시작하셨다면 다음 명령을 씁니다.

엔터를 누르면 글자가 여러 줄 지나갑니다. 전부 읽을 필요는 없고 끝에 Claude Code successfully installed!가 뜨면 설치가 끝난 것입니다.

창을 잘못 고른 경우에도 화면이 알려 줍니다. Windows PowerShell 5.1에서 CMD용 명령을 넣으면 The token '&&' is not a valid statement separator가 나올 수 있고, CMD에서 PowerShell용 명령을 넣으면 'irm' is not recognized as an internal or external command가 나옵니다. 둘 다 맞는 창에서 명령을 다시 넣으면 됩니다.

설치 안내가 끝나면 터미널 창을 닫고 새로 열어 버전 번호를 확인합니다.

2.1.211 (Claude Code)는 출력 모양의 예시입니다. 다른 버전 숫자가 나와도 실행 파일이 버전 정보를 정상 출력했다면 이 확인 단계는 통과입니다.

claude를 입력한 뒤 처음 만나는 화면

처음에는 중요한 파일이 없는 연습 폴더를 만듭니다. 폴더 이름 claude-practice는 원하는 이름으로 바꿀 수 있습니다. 이미 같은 이름의 폴더에 자료가 있다면 다른 이름을 사용합니다.

맥과 리눅스에서는 아래 명령을 한 줄씩 실행합니다.

윈도우 PowerShell에서는 다음을 실행합니다.

마지막 결과의 폴더 이름이 claude-practice인지 확인합니다. 폴더 이동이 실패했다면 다음 명령을 실행하지 말고 경로부터 고칩니다. 맞으면 claude를 입력하고 엔터를 누릅니다.

처음 실행하면 로그인 안내가 뜨고 브라우저 창이 열립니다. 브라우저에서 사용할 계정과 플랜을 확인해 로그인한 뒤 터미널로 돌아옵니다. 인증 완료와 입력창이 표시되는지 확인합니다. API 키가 이미 설정된 환경은 계정 로그인 대신 키 사용 여부를 묻는 등 흐름이 다를 수 있습니다. API 사용료는 Claude 구독료와 별개입니다.

글 맨 위 그림이 로그인을 마치고 첫 요청을 보낸 뒤의 화면입니다. 윗줄에 클로드 코드 버전, 그 아래에 쓰고 있는 모델 이름과 계정 종류, 그다음 줄에 지금 작업 중인 폴더 경로가 차례로 적혀 있습니다. 이 세 줄을 확인하는 습관을 들이면 엉뚱한 폴더에서 작업을 시키는 실수가 줄어듭니다. 그 아래 > 표시가 있는 줄이 메시지를 입력하는 곳입니다. 이 줄은 앞에서 본 셸 프롬프트가 아니라 클로드 코드가 따로 띄우는 입력줄이고, 여기서부터는 웹 채팅과 쓰는 방식이 거의 같습니다.

작업이 길어지면 화면이 이렇게 채워집니다.

이 화면을 읽는 방법은 단순합니다. 초록 점이 붙은 Search와 Read 줄은 클로드가 실제로 실행한 작업을 보여 주고, 바로 아래 한 칸 들어간 줄에 그 결과가 나옵니다. 마지막 진행 문장과 오류 여부, 실제 결과를 읽습니다. 색상은 테마와 버전에 따라 달라지므로 회색이라는 이유로 경고를 건너뛰지 않습니다.

터미널 안에서 알아 둘 것은 네 가지입니다.

• 일반 입력과 메뉴 선택은 키보드로 진행합니다. 링크나 화면 요소의 마우스 지원은 터미널과 버전에 따라 다릅니다.
• 클로드가 작업하는 중에 멈추려면 Esc를 누릅니다.
• 클로드 코드를 끝낼 때는 /exit를 입력하거나 빈 입력줄에서 Ctrl + D를 누르고 안내에 따라 한 번 더 누릅니다.
• 쓸 수 있는 명령을 보려면 /help를 입력합니다.

첫 요청과 결과를 확인합니다

Claude Code의 입력창에서 다음 문장을 보냅니다. 아래 요청은 셸 명령이 아니므로 %나 PS ...>가 보이는 터미널 입력줄에 붙이지 않습니다.

준비물은 책 한 권과 물 한 병이어야 합니다. 장소나 시간을 추가하면 원문에 없는 내용입니다. ‘메모에 있는 준비물 두 가지만 남겨줘’라고 요청해 바로잡습니다. 이어서 메모의 물을 연필로 바꿔 요청하면 준비물도 그에 맞게 바뀌는지 확인합니다. 이 응답은 사용량을 소비할 수 있으며, 설치 확인 명령과 AI 요청은 다릅니다.

작업이 끝나면 /exit로 나가 셸의 프롬프트로 돌아옵니다. 다시 같은 폴더에서 claude를 실행할 수 있으면 첫 실행 과정을 혼자 반복할 수 있습니다.

명령이 제대로 실행됐는지 어떻게 알 수 있나요?

cd처럼 성공해도 아무 문장을 출력하지 않는 명령이 있습니다. 그러나 출력이 없다는 사실만으로 성공을 확정하지 않습니다. 폴더를 옮겼다면 pwd 또는 Get-Location으로 위치를, 설치했다면 claude --version으로 실행 결과를 확인합니다. 우체국에 서류를 낸 뒤 접수 여부를 확인하듯, 명령마다 확인할 결과가 다릅니다.

반대로 잘못된 것이 있으면 화면에 그 내용이 문장으로 뜹니다. 설치 단계에서 자주 나오는 문구는 아래와 같습니다.

위 네 문구는 앤트로픽 공식 문제 해결 문서가 운영체제별로 정리해 둔 것입니다.

권한이 모자라 설치가 멈추는 경우는 이 표에 없고 같은 문서의 권한 오류 항목에서 따로 다룹니다. 파일을 넣을 폴더에 쓸 권한이 없다는 뜻이고, 푸는 방법은 아래 권한 항목에 적어 두었습니다.

설치와 설정 상태는 아래 명령 하나로 확인합니다.

이 명령은 설치 상태와 설정 파일 오류, 마지막 자동 갱신 결과를 확인해 화면에 보여 주기만 합니다. 아무것도 바꾸지 않으므로 막혔을 때 먼저 돌려 봐도 안전합니다.

설치가 막히는 곳 세 군데: PATH, 권한, Node 버전

PATH: claude 명령을 찾지 못할 때

설치는 끝났는데 claude를 입력하면 명령을 찾을 수 없다고 나오는 경우가 흔합니다. 현재 셸이 실행할 claude를 찾지 못한 상태입니다. 파일이 없는 경우와 검색 경로에서 빠진 경우를 구분해야 합니다. 셸은 PATH라는 목록에 적힌 폴더만 위에서부터 차례로 찾아보고, 목록에 없는 폴더는 들여다보지 않습니다. 설치 파일은 맥과 리눅스에서 ~/.local/bin/claude, 윈도우에서 %USERPROFILE%\.local\bin\claude.exe에 들어가는데, 이 파일이 들어 있는 폴더가 목록에 없으면 셸이 찾지 못합니다.

설치 직후라면 먼저 터미널을 새로 열어 claude --version을 다시 확인합니다. 그래도 안 되면 네이티브 설치 파일을 확인합니다.

맥과 리눅스:

윈도우 PowerShell:

파일이 없거나 False라면 설치가 끝났는지, 네이티브 방식으로 설치했는지 확인합니다. Homebrew나 WinGet은 다른 위치를 사용할 수 있습니다. 파일이 있고 전체 경로로는 버전이 출력되는데 claude --version만 실패할 때 PATH를 확인합니다.

맥의 기본 zsh에서는 다음 명령으로 해당 경로 등록 여부를 확인합니다.

경로가 출력되면 다시 추가하지 않습니다. 없을 때만 다음 두 줄을 한 번 실행합니다. >>는 기존 파일 뒤에 한 줄을 더하는 기호이며 반복하면 같은 줄이 쌓입니다.

리눅스의 bash는 ~/.bashrc를 사용합니다. macOS에서 bash를 쓰거나 다른 셸을 쓴다면 공식 PATH 안내의 해당 환경을 따릅니다.

윈도우 PowerShell에서는 먼저 목록을 확인합니다.

설치 폴더가 없을 때만 사용자 PATH에 추가하고 터미널을 새로 엽니다.

수정 후 claude --version이 출력되는지 확인합니다. 파일을 전체 경로로 실행해도 오류가 나면 PATH만의 문제가 아니므로 그 오류 문구를 기준으로 원인을 찾습니다.

권한: 쓸 수 없는 폴더를 만났을 때

permission denied는 작업하려는 경로에 필요한 권한이 없다는 뜻입니다. 오류에 나온 경로부터 확인합니다. 폴더가 없는 상황과 폴더에 쓸 수 없는 상황은 다릅니다.

이 명령은 폴더의 존재와 소유자, 권한을 보여 줍니다. 없는 폴더는 No such file or directory라고 나옵니다. 폴더가 있다는 이유만으로 쓰기 권한이 있다는 뜻은 아닙니다.

설치가 본인 계정의 어느 경로에서 막혔는지 확인한 뒤 공식 권한 문제 안내를 따릅니다. ~/.local 전체에는 다른 프로그램도 있을 수 있으므로 원인을 확인하지 않고 하위 폴더 전체의 소유권을 바꾸지 않습니다. npm 전역 설치에서 오류가 나도 sudo npm install -g로 우회하지 않습니다.

Node 버전: npm으로 깔 때만 걸리는 조건

설치 방법을 검색하면 npm install -g @anthropic-ai/claude-code가 함께 나와서 Node.js를 먼저 깔아야 한다고 생각하기 쉽습니다. 하지만 앞에서 소개한 설치 스크립트로 깔면 클로드 코드는 자체 실행 파일로 돌아가고 Node.js를 쓰지 않습니다.

Node.js가 필요한 경우는 npm 방식으로 깔 때이고, 2.1.198 버전부터는 Node.js 22 이상을 요구합니다. Node.js 22보다 낮은 버전에서는 설치가 멈추지 않고 EBADENGINE 경고만 뜬 채 끝납니다. 경고가 떠도 설치는 완료되고 claude 명령도 그대로 실행됩니다. npm이 받아 오는 것 역시 Node로 돌아가는 프로그램이 아니라 운영체제에 맞는 실행 파일이어서 그렇습니다.

처음이라면 설치 스크립트 쪽을 권합니다. 이 방식으로 깐 클로드 코드는 새 버전이 나오면 따로 명령을 넣지 않아도 갱신됩니다.

운영체제별 상세 절차와 터미널을 열지 않는 방법

터미널 화면을 읽는 순서는 여기까지입니다. Homebrew와 Git은 이 글의 네이티브 설치를 위한 필수 사전 준비가 아닙니다. 다른 설치 방식과 운영체제별 절차는 아래 글에 정리했습니다.

• 맥 설치 안내 (Homebrew와 Git 준비부터 한국어 설정까지 바로가기)
• 윈도우 설치 순서 (winget 설치와 작업 폴더 만들기 바로가기)
• 설치 오류 메시지 모음 (운영체제별 오류 문구와 해결법 바로가기)
• CLI 뜻 정리 (명령줄 인터페이스가 무엇인지 바로가기)

검은 창을 계속 쓰고 싶지 않은 분에게는 다른 방법이 두 가지 있습니다. 하나는 VS Code 확장이고 다른 하나는 데스크톱 앱입니다. 앤트로픽은 클로드 코드 데스크톱 앱을 맥과 윈도우용으로 내놓고 있고, 리눅스는 우분투 22.04 이상과 데비안 12 이상에서 apt로 까는 베타 단계입니다. 이 앱에서는 터미널 없이 같은 작업을 맡길 수 있습니다. VS Code 쪽은 맥 확장 설치와 윈도우 확장 설치에 화면과 함께 정리해 두었습니다.

자주 묻는 질문

터미널에서 명령을 잘못 치면 컴퓨터가 망가지나요?

명령의 종류에 따라 다릅니다. 버전 확인은 상태를 읽지만 설치와 PATH 수정은 컴퓨터의 파일이나 설정을 바꿉니다. 오타가 항상 아무 동작도 하지 않는 것은 아니므로 실행 전 주소와 경로를 확인합니다. 이 글의 확인 명령부터 사용해 원인을 좁히고 필요한 설정만 바꿉니다.

맥 비밀번호를 입력하는데 화면에 아무것도 보이지 않습니다. 고장인가요?

정상입니다. 맥 터미널은 보안을 위해 비밀번호를 칠 때 별표나 점도 표시하지 않습니다. 화면이 멈춘 것처럼 보여도 입력은 들어가고 있으니 본인이 실행한 명령이 비밀번호를 요구하는지 확인한 뒤 입력하고 엔터를 누릅니다.

설치한 클로드 코드는 어떻게 최신 버전으로 올리나요?

설치 스크립트로 깔았다면 따로 할 일이 없습니다. 클로드 코드가 시작할 때와 실행 중에 새 버전을 확인하고 받아 두었다가 다음 실행에 적용합니다. 지금 바로 올리고 싶으면 claude update를 입력합니다. Homebrew나 winget으로 깔았다면 기본값이 수동 갱신이라 brew upgrade claude-code나 winget upgrade Anthropic.ClaudeCode를 직접 실행합니다. Homebrew에서 claude-code@latest 캐스크를 깔았다면 그 이름으로 올립니다. CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE를 1로 두면 클로드 코드가 갱신 명령을 대신 돌려 줍니다.

Sources

• Claude Code 터미널 입문 안내
• Claude Code 설치와 시스템 요구 사항
• Claude Code 설치와 로그인 문제 해결
• Claude Code 빠른 시작
• Claude Code 공식 저장소

3줄 요약

1. 터미널은 글로 명령을 실행하는 창이며 셸 명령을 입력하는 곳과 Claude Code에 요청하는 곳을 구분해야 합니다.

2. 자신의 운영체제에 맞는 명령으로 설치한 뒤 새 터미널에서 버전을 확인하고 연습 폴더에서 로그인합니다.

3. 오류가 나면 재설치를 반복하기 전에 설치 파일의 존재와 직접 실행 결과, PATH 및 권한을 확인합니다.