👉 디벨로켓의 새로운 커뮤니티가 생겼어요! →

✨
노하우 & 팁
Peter Park
Peter Park
운영진
·노하우 & 팁에 게시됨

클로드 코드(Claude Code) CLI 터미널에 설치부터 첫 사용까지 — 5분 세팅 가이드

요새 클로드 코드(Claude Code)관련 소식이 여기저기서 자주 들립니다.

뭐가 좋다고 해서 결제하고 깔아는 봤는데... 그냥 좀 누런 챗지피티 같은 느낌이고 그렇죠?

질문을 한다고 뭐 특별하게 다르게 답하는 것 같지도 않고, 코딩 능력이 뛰어나다는데 뭔가 크게 다른것도 모르겠고.

근데 혹시, 데스크톱 앱으로만 쓰고 계신건 아닌가요?

바이브 코딩 한다고 하면서, 데스크톱 앱 채팅창에 코드 복붙하고 "이 에러 뭐야?", "이거 해결해줘" 이런 식으로 쓰고 계신 건 아니죠? 그건 바이브 코딩이 아니라 그냥 질문입니다.

클로드 코드를 제대로 쓰려면 CLI로 연결해서 사용해야 합니다. CLI(Command Line Interface)는 까만 화면에 글자를 입력해서 컴퓨터를 조작하는 방식인데요, Windows에서는 CMD나 PowerShell이 이 CLI에 해당합니다.

CLI로 클로드를 실행하면 클로드가 내 컴퓨터 폴더에 직접 접근해서 파일도 만들고, 내용도 수정하고, 코딩까지 해줍니다. 그냥 채팅창에서 답변만 받는 게 아니라, 진짜 AI 비서처럼 일을 시킬 수 있는 거죠.

"CLI요? 저는 개발자가 아닌데요..."라고 생각하실 수 있습니다. 솔직히 좀 무섭죠. 하지만 어렵게 생각할 거 하나도 없습니다. CMD나 PowerShell도 윈도우처럼 컴퓨터를 관리하는 프로그램일 뿐이거든요. 다만 마우스 대신 글자를 입력하는 방식이라 낯설게 느껴지는 것뿐입니다.

명령어 하나도 몰라도 괜찮습니다. 이 글에서 스텝 바이 스텝으로 알려드리겠습니다. Windows 기준으로 설명하지만, Mac/Linux도 거의 동일합니다.

준비물

  • 인터넷 연결(이건 당연하겠죠..?)

  • Claude 구독 (Pro 또는 Max) 또는 API 키 (Anthropic Console)

  • Git for Windows — Windows 사용자는 반드시 설치해야 합니다 ([다운로드](https://git-scm.com/downloads/win))

Git이 이미 설치되어 있다면 넘어가세요. 터미널에서 git --version을 입력하면 확인할 수 있습니다.

Step 1. 터미널 열기

먼저 터미널을 열어야 합니다. 파일 탐색기에서 아무 폴더나 열고:

  • Windows 11: 빈 공간 우클릭 → "터미널에서 열기"

  • Windows 10: 빈 공간 Shift+우클릭 → "여기에 PowerShell 창 열기"

까만 화면이 뜨면 준비 완료입니다.

Step 2. 클로드 코드 설치

열린 터미널에 아래 명령어를 복사해서 붙여넣고 Enter를 누르세요.

Windows (PowerShell일 경우):

irm https://claude.ai/install.ps1 | iex

Windows (CMD일 경우):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Mac / Linux:

curl -fsSL https://claude.ai/install.sh | bash

설치가 끝나면 확인합니다:

claude --version

버전 번호가 뜨면 설치 성공입니다.

claude --version을 입력했는데 "인식되지 않습니다" 에러가 뜬다면, 다음 Step 3에서 PATH를 등록해주세요.

Step 3. PATH 등록하기

설치 후 claude 명령어가 바로 인식되지 않는 경우가 많습니다. Windows에 "클로드가 설치된 경로"를 알려줘야 하기 때문인데요, 한 번만 등록하면 됩니다.

1. Windows 검색에서 "환경 변수" 검색 → "시스템 환경 변수 편집" 클릭

2. "환경 변수" 버튼 클릭

3. 사용자 변수에서 Path 선택 → 편집 → 새로 만들기

4. C:\Users\내아이디\.local\bin 입력 → 확인 (내아이디 자리에 본인 Windows 사용자 이름)

5. 터미널을 닫고 다시 열면 claude가 바로 동작합니다

등록 후 터미널을 새로 열고 claude --version을 입력해보세요. 버전이 뜨면 완료입니다.

> 이미 claude --version이 정상 동작했다면 이 단계는 건너뛰어도 됩니다.

Step 4. 첫 실행 & 인증

설치와 패스등록까지 끝났으면, 이제 클로드를 실행할 프로젝트 폴더에서 터미널을 다시 열어주세요. (Step 1과 같은 방법으로, 이번엔 작업할 폴더에서 열면 됩니다.)

터미널에 claude를 입력합니다.

claude

처음 실행하면 화면 테마를 고르는 화면이 뜹니다. 터미널 배경에 맞는 걸 고르면 되는데, 보통 1. Dark mode를 선택하면 됩니다. 나중에 /theme 명령어로 언제든 바꿀 수 있으니 부담 없이 고르세요.

다음으로 로그인 방식을 선택하는 화면이 뜹니다.

Claude 구독자 (Pro/Max)라면 → "Claude App" 또는 "Claude.ai account"를 선택하세요. 브라우저가 열리면서 로그인하면 끝입니다.

API 키로 접속하려면 → "API Key"를 선택한 뒤, Anthropic Console에서 발급받은 키를 입력하면 됩니다.

구독제를 선택하면 브라우저가 열리면서 승인 화면이 뜹니다. "승인" 버튼을 누르면 인증 완료입니다.

터미널로 돌아오면 환영 메시지와 함께 입력창이 뜹니다. 이제 클로드를 사용할 수 있습니다.

잘못된 방식을 선택했다면? 구독자인데 실수로 API Key를 선택하면 에러가 나면서 입력창 자체가 안 열릴 수 있습니다. 이 상태에선 /logout 같은 명령어를 칠 수도 없어서 한참 헤매기 쉽습니다.

해결 방법은 간단합니다. 터미널을 닫고, 새 터미널을 열어서 아래 명령어를 실행하세요.

PowerShell:

Remove-Item "$env:USERPROFILE\.claude.json" -ErrorAction SilentlyContinue

CMD:

del "%USERPROFILE%\.claude.json"

%USERPROFILE%(CMD)과 $env:USERPROFILE(PowerShell)은 내 Windows 사용자 폴더 경로를 가리킵니다. 예를 들어 Windows 사용자 이름이 peter라면 C:\Users\peter이고, 삭제할 파일의 전체 경로는 C:\Users\peter\.claude.json이 됩니다. 위 명령어를 그대로 복붙하면 자동으로 내 경로를 찾아주니까 직접 입력할 필요는 없습니다. 단, CMD 명령어는 CMD에서, PowerShell 명령어는 PowerShell에서 실행해야 합니다.

Mac / Linux:

rm ~/.claude.json

이렇게 인증 정보를 초기화한 뒤 다시 claude를 실행하면 처음 선택 화면으로 돌아갑니다. 이번엔 올바른 방식을 선택하세요.

구독자 로그인을 선택했는데 브라우저가 자동으로 안 열리는 경우가 있습니다. 그럴 때는 터미널에 /login을 입력하면 로그인 URL이 표시됩니다. 그 URL을 복사해서 브라우저에 직접 붙여넣으면 로그인 페이지로 이동할 수 있습니다.

Step 5. 대화해보기

인증이 끝나면 바로 대화할 수 있습니다. 프롬프트에 질문이나 요청을 입력하면 됩니다.

이 프로젝트의 폴더 구조를 설명해줘

클로드 코드는 현재 폴더의 코드를 읽고, 파일을 수정하고, 터미널 명령어를 실행할 수 있습니다. 변경사항이 생기면 승인 여부를 물어보기 때문에 실수로 코드가 바뀔 걱정은 없습니다.

Step 6. VS Code에서 사용하기 (선택)

터미널이 아니라 VS Code 안에서 쓰고 싶다면, 확장 프로그램을 설치하면 됩니다.

1. VS Code에서 Ctrl+Shift+X → "Claude Code" 검색 → Install

2. 설치 후 우측 상단의 ✨ 아이콘 클릭, 또는 Ctrl+` 로 터미널 열기 -> 스텝 1로 되돌아가기.

VS Code에서 사용하는 것이 터미널만 쓸 때보다 훨씬 편합니다. 왼쪽에서 폴더 구조를 바로 확인할 수 있고, 클로드가 수정한 파일을 클릭하면 어디가 바뀌었는지 diff로 비교할 수 있습니다. 텍스트 편집도 에디터에서 바로 되니까, 클로드한테 시키고 → 결과 확인하고 → 직접 수정하는 흐름이 한 화면에서 다 됩니다.

알아두면 좋은 것들

유용한 명령어:

  • claude — 대화형 세션 시작

  • claude "질문" — 터미널에서 실행하는 일회성 질문 (답변 후 종료)

  • claude -c — 마지막 대화 이어서

  • claude -r — 마지막 대화 내용 출력 (이어가지 않고 확인만)

  • /help — 세션 내 도움말

  • /compact — 대화 내용 압축 (긴 세션일 때)

비용 참고:

  • Claude Pro ($20/월): 일반 사용에 충분

  • Claude Max ($100/월~): 헤비 사용자용

  • API 키: 사용량 기반 과금 (소량이면 저렴)

문제가 생기면:

claude doctor

이 명령어로 설치 상태, 인증, 네트워크 등을 자동 진단할 수 있습니다.

마무리

설치부터 첫 사용까지 실제로 5분이면 충분합니다. 복잡한 설정 없이 설치 → 로그인 → 바로 사용이 되는 게 클로드 코드의 장점입니다.

한번 써보면 "이걸 왜 이제 알았지?" 싶을 겁니다. 코드 질문, 리팩토링, 버그 찾기, 문서 작성까지 — 터미널 하나로 다 됩니다.

지금 하고 계신 프로젝트 폴더에서 claude를 실행해보세요. 그리고 명령어에 "지금 이 프로젝트 파일들을 확인하고 너의 의견을 들려줘" 한마디만 작성해 보세요.

클로드가 열심히 나의 프로젝트를 분석하고, 함께 고민하고, 작업 방향까지 정리해줄 겁니다.

그럼 모두 즐거운 코딩 되시길!

2026.04.09.