본문으로 건너뛰기
블로그로 돌아가기
[GUIDE]

클로드코드 시작하기 2026: 뭐부터 할지 모를 때 따라 하는 첫날 3가지 순서와 준비물 체크

퀀텀점프클럽 정상록퀀텀점프클럽 정상록11분 읽기5 views

클로드코드 시작하기 2026: 뭐부터 할지 모를 때 따라 하는 첫날 3가지 순서와 준비물 체크

클로드코드: 말로 요청하면 내 폴더 안의 파일을 읽고, 만들고, 고쳐 주는 AI 도구예요. 영어 이름은 Claude Code(클로드 코드, AI가 코드와 파일 작업을 대신 해 주는 도구)입니다. 터미널(명령어를 글자로 입력하는 창)이나 데스크톱 앱에서 쓰고, Claude(클로드, Anthropic이 만든 AI) 유료 구독 계정으로 로그인해서 씁니다.

클로드코드 시작하기, 어디서 시작하면 되나요?

공식 개요 문서에 따르면 클로드코드는 4가지 방식으로 쓸 수 있어요. 터미널, IDE(코드를 편집하는 프로그램. VS Code, JetBrains가 대표적입니다), 데스크톱 앱, 웹입니다. 처음에는 이 중 하나만 고르면 충분해요.

이런 분이라면처음 고를 곳
터미널 창이 낯설지만 한 번 해 보고 싶다터미널
터미널이 싫다, 앱처럼 쓰고 싶다데스크톱 앱의 Code 탭
이미 VS Code나 JetBrains를 쓴다IDE (익숙해진 뒤에 추천)

공식 퀵스타트 문서는 터미널을 기준으로 7단계로 짜여 있어요. 그래서 이 글도 터미널 기준으로 따라가고, 터미널이 부담스러운 분은 데스크톱 앱을 고르시면 됩니다. 공식 터미널 가이드에도 터미널 대신 데스크톱 앱으로 시작할 수 있다고 적혀 있어요.

데스크톱 앱 쪽을 고르면 좋은 점이 하나 있어요. 공식 데스크톱 퀵스타트에 따르면 CLI(명령어로 쓰는 도구)나 Node.js를 따로 설치하지 않아도 됩니다. 단, 앱의 Code 탭도 유료 구독이 있어야 열려요. 이 조건은 아래 준비물에서 다시 설명할게요.

시작 전에 준비할 것은 무엇인가요?

공식 퀵스타트가 꼽는 준비물은 3가지입니다. 터미널, 작업할 코드 폴더(프로젝트), 그리고 Claude 계정이에요. 이 글에서는 하나씩 이렇게 바꿔 읽으시면 됩니다.

  1. 작업할 폴더: 비어 있는 새 폴더 하나를 만들어 두세요. 이름은 my-first-project처럼 아무거나 괜찮아요. 클로드코드는 지금 열어 둔 폴더 안에서 일하기 때문에, 처음에는 망가져도 부담 없는 빈 폴더가 안전해요.
  2. 유료 구독 계정: 로그인할 수 있는 Claude 구독은 Pro, Max, Ultra, Team, Enterprise 5가지입니다. 공식 문서의 목록에 무료 플랜은 없어요. 요금은 바뀔 수 있어서 금액은 적지 않을게요. 공식 요금제 페이지에서 직접 확인하세요.
  3. 내 컴퓨터 사양: 공식 설치 문서 기준으로 macOS 13.0 이상, Windows 10 1809 이상이어야 하고 메모리(RAM)는 4GB 이상이 필요해요. 인터넷 연결도 있어야 합니다.

터미널은 이렇게 열어요. 공식 터미널 가이드에 나온 방법입니다.

  • 맥: Cmd+Space를 눌러 검색창을 열고 Terminal을 입력한 뒤 Enter를 누릅니다.
  • 윈도우: Win+X를 누르고 Windows PowerShell(윈도우에 들어 있는 명령어 창)을 고릅니다. 메뉴에 Terminal이 있으면 그것도 괜찮아요.

설치 명령은 1줄이면 되나요?

네, 한 줄이에요. 아래 명령은 클로드코드를 내려받아 설치하는 명령입니다. 맥과 리눅스는 이쪽을 터미널에 붙여넣고 Enter를 누르세요.

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

윈도우는 PowerShell에서 아래 명령을 쓰세요. 윈도우 사용자는 이 줄만 실행하면 되고, 위의 맥용 명령은 쓰지 않습니다.

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

설치하는 동안 화면에 진행 표시가 나오지 않아요. 멈춘 것처럼 보여도 기다리면 끝나고, 공식 터미널 가이드대로 "Claude Code successfully installed!"라는 문구가 뜨면 성공입니다.

설치가 끝나면 터미널 창을 닫고 새 창을 열어서 아래 명령을 실행해 보세요. 버전 번호가 보이면 설치가 잘 된 거예요.

claude --version

여기까지가 설치의 전부입니다. 윈도우의 Git for Windows 같은 선택 사항은 클로드코드 설치 글에서 자세히 다뤄요.

첫날에는 무엇을 해 보면 되나요?

첫날 할 일은 딱 3가지입니다. 각각 "왜 이걸 먼저 하는지"를 한 줄씩 붙였어요. 순서대로 하시면 돼요.

1. 빈 폴더에서 hello world 웹페이지 만들기

왜 먼저 하나요? 클로드코드가 파일을 직접 만드는 모습을 눈으로 보면 이 도구가 무엇인지 가장 빨리 알 수 있어요. 파일을 고치기 전에 허락을 묻는 화면도 여기서 처음 경험합니다.

먼저 아까 만든 폴더로 이동하세요. 아래 명령에서 cd는 "이 폴더로 들어가라"는 뜻이고, 뒤의 폴더 경로(폴더가 있는 위치)는 내 컴퓨터의 실제 위치로 바꿔 써야 해요.

cd ~/my-first-project
claude

claude를 입력하면 처음에는 브라우저가 열리며 로그인을 요구해요. 공식 퀵스타트에 따르면 한 번 로그인하면 다시 할 필요가 없고, 계정을 바꾸고 싶을 때만 /login을 쓰면 됩니다.

로그인이 끝나면 입력창이 나와요. 여기에 프롬프트(AI에게 하는 요청 문장)를 한글이나 영어로 적으면 됩니다. 공식 터미널 가이드의 예시 요청은 이래요.

"make me a simple webpage that says hello world"

그러면 클로드코드가 HTML 파일(웹페이지를 담은 파일)을 만들어요. 폴더에서 그 파일을 더블클릭하면 브라우저에 hello world 화면이 뜹니다.

2. 내 폴더가 뭔지 물어보기

왜 먼저 하나요? 클로드코드는 파일을 내가 하나하나 넣어 주지 않아도 필요할 때 알아서 읽거든요. 이 사실을 한 번 확인해 두면 앞으로 질문하는 방식이 편해져요.

같은 화면에서 이렇게 물어보세요. 공식 퀵스타트에 나오는 첫 질문 예시입니다.

"what does this project do?"

방금 만든 hello world 파일을 읽고 이 폴더가 무슨 일을 하는지 설명해 줄 거예요. 한글로 "이 폴더가 뭐 하는 곳인지 알려줘"라고 물어도 됩니다.

3. /init으로 CLAUDE.md 만들기

왜 먼저 하나요? CLAUDE.md는 클로드코드에게 알려 주는 작업 규칙 메모예요. 공식 메모리 문서에 따르면 매 대화를 시작할 때 이 파일을 불러오기 때문에, 한 번 만들어 두면 같은 설명을 매번 반복하지 않아도 됩니다.

입력창에 아래를 치면 돼요. /init은 폴더를 읽고 CLAUDE.md 초안을 대신 만들어 주는 명령입니다. 이미 CLAUDE.md가 있는 폴더라면 덮어쓰지 않고 개선안을 제시해 줘요.

/init

완성된 초안을 한 번 열어서 읽어 보세요. 내 폴더를 클로드코드가 어떻게 이해했는지 볼 수 있어요. 틀린 부분이 있으면 말로 고쳐 달라고 하면 됩니다.

처음부터 들이면 좋은 습관 3가지는 무엇인가요?

습관은 처음에 잡아야 오래 가요. 아래 셋만 기억하세요.

1. 허락을 묻는 화면에서는 읽고 Yes를 고르기. 클로드코드는 파일을 고치기 전에 허락을 물어봅니다. 공식 퀵스타트에 따르면 이때 Yes를 선택하면 수정이 진행돼요. 무엇을 고치려는지 한 번 읽고 누르는 습관이 가장 중요합니다. 허락 방식을 바꾸는 권한 모드는 Shift+Tab으로 전환하지만, 처음에는 건드리지 않아도 돼요.

2. 이상하면 Esc로 멈추기. 공식 터미널 가이드에 따르면 Esc를 누르면 작업이 중단됩니다. 엉뚱한 방향으로 가는 것 같으면 기다리지 말고 바로 누르세요.

3. 주제가 바뀌면 /clear, 어제 하던 일은 이어서 하기. /clear는 새 대화를 시작하는 명령이에요. 반대로 이전 대화를 이어가고 싶으면 /resume이나, 터미널에서 claude -c로 시작하세요. 명령이 기억나지 않으면 /help로 목록을 볼 수 있어요. 끝낼 때는 빈 입력창에서 Ctrl+D를 2번 누르거나 /exit를 입력합니다.

다음 단계는 어디로 가면 되나요?

이 글은 공식 퀵스타트 7단계 중 앞쪽, 즉 설치와 첫 세션, 첫 질문, 첫 수정까지를 다뤘어요. 뒤쪽 단계(Git 연결, 버그 고치기와 기능 추가, 다른 작업)는 아직 남아 있습니다.

그다음 걸음으로는 이렇게 이어가 보세요.

처음 하면 여기서 막힙니다

막히는 지점은 4가지예요. 공식 문서에 적힌 증상만 골랐어요.

1. command not found: claude 또는 'claude' is not recognized가 떠요. 맥은 앞의 문구, 윈도우는 뒤의 문구가 나옵니다. 공식 문서에 따르면 설치된 폴더가 아직 PATH(컴퓨터가 프로그램을 찾는 위치 목록)에 없다는 뜻이에요. 터미널 창을 닫고 새 창을 열어 다시 시도해 보세요. 그래도 안 되면 공식 문서의 PATH 안내를 따라가세요.

2. 윈도우에서 PowerShell과 CMD(구형 명령어 창)를 헷갈렸어요. 공식 퀵스타트에 따르면 PowerShell은 줄 앞에 PS C:\가 보이고, CMD는 PS가 없어요. PowerShell에서 CMD용 명령을 치면 The token '&&' is not a valid statement separator가 나옵니다. 반대로 CMD에서 PowerShell 명령을 치면 'irm' is not recognized가 떠요. 이 오류가 보이면 지금 열어 둔 창의 종류부터 확인하세요.

3. 설치 중에 아무것도 안 나와서 멈춘 줄 알았어요. 설치 명령은 내려받는 동안 진행 표시가 없는 게 정상이에요. "Claude Code successfully installed!" 문구가 뜰 때까지 기다리세요.

4. 데스크톱 앱 Code 탭에서 업그레이드 안내가 떠요. 공식 데스크톱 퀵스타트에 따르면 이 안내는 유료 구독이 먼저 필요하다는 뜻이에요. 구독 계정으로 로그인했는지 확인하세요.

마무리

오늘은 새 폴더 하나만 만들어 보세요. 거기서 hello world 웹페이지를 만드는 것까지만 해도 충분히 시작한 거예요. 나머지 두 가지는 내일 해도 늦지 않아요.

막히면 위의 막힘 목록을 먼저 보시고, 설치 쪽이 문제라면 클로드코드 설치 글로 이어가세요.

자주 묻는 질문

터미널이 싫은데 꼭 써야 하나요?

아니요. 공식 터미널 가이드에 따르면 터미널 대신 데스크톱 앱으로 시작할 수 있어요. 앱의 Code 탭에서 쓰면 되고, 공식 데스크톱 퀵스타트상 CLI를 따로 설치할 필요도 없습니다. 다만 앱의 Code 탭도 유료 구독이 필요해요.

무료로 쓸 수 있나요?

공식 퀵스타트의 로그인 가능 목록은 Pro, Max, Ultra, Team, Enterprise 5가지 구독이고 무료 플랜은 들어 있지 않아요. 요금은 수시로 바뀔 수 있으니 공식 요금제 페이지에서 확인하세요.

설치했는데 claude를 못 찾는다고 나와요.

설치 폴더가 PATH에 아직 반영되지 않은 경우예요. 터미널 창을 닫고 새 창을 열어서 claude --version을 다시 실행해 보세요. 맥은 command not found: claude, 윈도우는 'claude' is not recognized로 나옵니다. 새 창에서도 같으면 공식 문서의 PATH 안내를 보세요.

윈도우에서 PowerShell과 CMD 중 뭘 써야 하나요?

이 글의 설치 명령은 PowerShell용이에요. 줄 앞에 PS C:\가 보이면 PowerShell이니 그대로 붙여넣으면 됩니다. PS가 없으면 CMD라서 'irm' is not recognized 오류가 나요. 이때는 Win+X로 Windows PowerShell을 새로 여세요.

어제 하던 대화를 이어가려면 어떻게 하나요?

터미널에서 claude -c로 시작하면 이전 대화를 이어갈 수 있어요. 이미 클로드코드 안에 들어와 있다면 /resume을 쓰세요. 완전히 새로 시작하고 싶을 때는 /clear를 입력하면 됩니다.

관련 글

참고 자료