설치는 마쳤는데, 막상 까만 터미널 창을 앞에 두니 “이제 뭘 어떻게 시작하지?” 하고 막막하셨나요? 많은 분들이 클로드 코드 실행 단계에서 첫 명령어를 어디에 입력해야 할지 몰라 멈칫하십니다. 하지만 걱정 마세요. 클로드 코드의 시작은 생각보다 훨씬 간단합니다. 이번 편에서는 프로젝트 폴더로 이동해 클로드 코드를 처음 켜고, AI와 첫 대화를 나누는 전체 흐름을 차근차근 체험해 보겠습니다.
클로드 코드, 어떻게 실행하나요?
클로드 코드를 실행하는 방법은 놀라울 만큼 단순합니다. 터미널에 딱 한 단어만 입력하면 됩니다.
정의: 클로드 코드(Claude Code)는 터미널에서
claude명령어를 입력해 실행하는 대화형 AI 코딩 도구입니다.
클로드 코드를 시작하려면 터미널에 claude를 입력하고 엔터를 누르기만 하면 됩니다. 이 명령어 하나면 세션을 시작하기에 충분합니다.
핵심은 어느 폴더에서 실행하느냐입니다. 클로드 코드는 실행한 위치의 폴더를 기준으로 프로젝트를 이해하기 때문에, 반드시 작업할 프로젝트 폴더 안에서 실행해야 합니다.
# 1. 작업할 프로젝트 폴더로 이동
cd my-project
# 2. 클로드 코드 실행
claude
아무 프로젝트 디렉터리에서 터미널을 열고 claude 명령어로 대화형 세션을 시작하면, 처음 사용할 때는 로그인 안내가 나타납니다. 참고로 4편에서 배운 cd 명령어가 바로 여기서 쓰입니다. 폴더 이동에 자신이 없다면 이전 편을 다시 확인해 주세요.
처음 실행하면 무슨 일이 벌어지나요?
처음 claude를 입력하면 바로 코딩이 시작되는 게 아니라, 몇 가지 초기 절차가 진행됩니다.
1) 로그인(인증) 안내
클로드 코드를 설치한 뒤 처음 실행하면 인증(로그인)을 하라는 안내가 나옵니다. 화면에 표시되는 안내를 따라 진행하면 됩니다. Claude 구독 계정이나 콘솔 계정을 사용하는 경우, 안내에 따라 브라우저에서 인증을 완료하게 됩니다.
2) 환영 화면 표시
로그인이 끝나면 클로드 코드의 환영 화면이 나타납니다. 환영 화면에는 세션 정보, 최근 대화 내역, 최신 업데이트 소식 등이 함께 표시됩니다.
3) 프로젝트 자동 파악
새 프로젝트에서 처음 실행하면 클로드 코드는 대화형 REPL 세션을 시작하며, 몇 가지 작업을 자동으로 수행합니다. 그중 하나가 디렉터리 구조를 스캔해 프로젝트 구성을 파악하는 것입니다.
한 번 인증을 마치면 다음부터는 다시 로그인할 필요가 없습니다. 인증 정보가 저장되기 때문에 다시 로그인하지 않아도 됩니다.
첫 대화, 무엇을 입력해 볼까요?
이제 프롬프트 입력창에 커서가 깜빡이고 있을 겁니다. 여기에 사람에게 말하듯 자연스럽게 요청을 적으면 됩니다. 첫 실행에서는 무리한 요청보다 가벼운 탐색용 질문으로 시작하는 것을 추천합니다.
프로젝트 폴더에서 claude를 실행해 세션을 시작한 뒤, “이 프로젝트는 무엇을 하나요?” 같은 탐색용 질문으로 시작해 클로드가 코드베이스를 분석하게 한 다음, 작은 수정을 시도해 보는 것이 좋습니다.
첫 대화로 시도해 볼 만한 예시입니다.
| 상황 | 입력 예시 |
|---|---|
| 프로젝트 파악 | 이 프로젝트가 어떤 역할을 하는지 설명해 줘 |
| 파일 구조 확인 | 이 폴더에 어떤 파일들이 있는지 정리해 줘 |
| 기능 이해 | 이 코드의 핵심 기능을 초보자도 알기 쉽게 알려 줘 |
| 첫 작업 | README 파일 초안을 만들어 줘 |
요청을 입력하고 엔터를 누르면, 클로드가 폴더를 살펴본 뒤 답변을 화면에 출력합니다. 이 응답이 정상적으로 뜬다면 클로드 코드 사용법의 첫 관문을 통과하신 겁니다.
세션을 다루는 기본 명령어는?
대화 도중 알아 두면 편리한 기본 조작들이 있습니다. 클로드 코드에서는 슬래시(/)로 시작하는 명령어로 세션을 제어합니다.
/help: 사용할 수 있는 명령어 목록과 도움말을 확인합니다./clear: 현재 대화 맥락을 초기화해 새 주제로 깔끔하게 시작합니다./login: 계정을 다시 인증하거나 다른 계정으로 전환합니다.- 종료하기 : 세션을 끝내려면
/exit를 입력하거나Ctrl + C를 두 번 눌러 터미널로 돌아옵니다.
다시 로그인하거나 계정을 전환해야 할 때는 클로드 코드 안에서 /login 명령어를 사용하면 됩니다. 슬래시 명령어는 8편에서 더 자세히 다루니, 지금은 “이런 게 있구나” 정도만 기억해 두시면 충분합니다.
자주 묻는 질문(FAQ)
Q1. 아무 폴더에서나 claude를 실행해도 되나요?
실행은 되지만 권장하지 않습니다. 클로드 코드는 실행한 폴더를 프로젝트 기준으로 삼으므로, 먼저 cd 명령어로 작업할 프로젝트 폴더로 이동한 뒤 실행하는 것이 좋습니다. 빈 폴더에서 새 프로젝트를 시작하는 것도 가능합니다.
Q2. 매번 실행할 때마다 로그인을 다시 해야 하나요?
아닙니다. 처음 한 번만 인증하면 인증 정보가 저장되어, 이후에는 claude만 입력해도 바로 세션이 시작됩니다. 계정을 바꾸고 싶을 때만 /login을 사용하면 됩니다.
Q3. 클로드 코드를 종료하려면 어떻게 하나요?
세션 창에서 /exit를 입력하거나 Ctrl + C를 두 번 누르면 종료되어 원래 터미널로 돌아옵니다. 종료해도 프로젝트 파일은 그대로 남아 있으니 안심하세요.
한 줄 요약: 작업할 폴더로 cd 이동 → claude 입력 → 첫 질문 던지기, 이 세 단계면 클로드 코드 첫 실행과 프로젝트 시작이 끝납니다!
참고 자료
- Claude Code Quickstart – Claude Docs
- Claude Code Commands – Claude Docs
- Starting Claude Code Sessions – CodeSignal