"클로드코드 사용방법"을 검색해서 들어오셨다면, 아마 처음 접해보셔서 어디서부터 시작해야 할지 막막하실 겁니다. 클로드코드(Claude Code)는 Anthropic이 만든 AI 코딩 도구인데, 이름만 보면 복잡할 것 같지만 실제로는 터미널 열기 → 최소한의 환경설정 → 폴더 만들고 실행 이렇게 3단계만 거치면 바로 사용할 수 있습니다. 실행 이후부터는 클로드코드가 알아서 다음 할 일을 안내해주기 때문에, 사용자는 대부분 물어보는 질문에 승인(예)만 눌러주면 됩니다. 이 글 하나로 클로드코드 사용방법을 끝까지 따라 해볼 수 있도록 순서대로 정리했습니다.
1단계. 터미널 열기
터미널은 컴퓨터에 명령어를 직접 입력하는 화면입니다. 운영체제별로 여는 방법이 다릅니다.
macOS: Command + Space를 눌러 스팟라이트를 연 뒤 "터미널"이라고 입력하고 엔터
Windows: 시작 메뉴에서 "PowerShell"을 검색해서 실행 (관리자 권한으로 실행할 필요는 없습니다)
터미널 실행
2단계. 클로드코드를 위한 최소 환경설정
터미널을 열었다면, 딱 두 가지만 하면 됩니다. ① 설치 명령어 붙여넣기 ② 계정 로그인입니다.
① 설치
아래 명령어를 자신의 운영체제에 맞게 터미널에 붙여넣고 엔터를 누릅니다.
macOS / Linux 사용자:
bash
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell 사용자:
powershell
irm https://claude.ai/install.ps1 | iex
설치가 끝나면 아래 명령어로 잘 설치됐는지 확인합니다. 버전 번호가 뜨면 성공입니다.
bash
claude --version
⚠ Windows에서 claude 명령어가 안 먹힐 때 (PATH 오류 해결)
설치는 성공했다고 나오는데 claude --version을 입력하면 아래처럼 "인식되지 않는 명령어"라는 오류가 뜨는 경우가 있습니다.
claude : 'claude' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.
이건 실패한 게 아니라, 설치된 claude.exe 파일의 위치(C:\Users\사용자명\.local\bin)가 윈도우의 "PATH"(명령어를 찾는 경로 목록)에 아직 등록이 안 돼서 생기는 문제입니다. 아래 방법으로 바로 해결됩니다.
명령어를 입력했다고 바로 적용되지는 않습니다. PowerShell 창을 완전히 닫고 새로 열어야 합니다. 새 창을 연 뒤 다시 확인해보세요.
powershell
claude --version
이렇게 해도 안 된다면, 아래 명령어로 설치 폴더에 실제로 claude.exe 파일이 있는지부터 확인해보시기 바랍니다.
powershell
dir $env:USERPROFILE\.local\bin
터미널 새창으로 열어서 해당 명령어 실행
② 로그인
터미널에 claude라고만 입력하고 엔터를 누르면 브라우저 창이 자동으로 열리면서 로그인 화면이 나옵니다. 화면 안내에 따라 본인 계정(Claude Pro, Max, Team 등)으로 로그인하면 끝입니다. 참고로 무료 Claude.ai 플랜은 클로드코드에서 사용할 수 없고, Pro 이상 유료 플랜이나 Console(API) 계정이 있어야 합니다. 한 번 로그인해두면 다음부터는 다시 로그인할 필요가 없습니다.
bash
claude
모델은 오퍼스 5 ㅎㅎ
3단계. 작업할 폴더 생성 후 그 안에서 claude 실행
이제 실제로 작업할 폴더를 만들고 그 안에서 클로드코드를 실행하면 됩니다.
1. 터미널에서 폴더 만들기
bash
mkdir 내프로젝트
cd 내프로젝트
claude
이렇게 하면 해당 폴더를 기준으로 클로드코드 세션이 시작됩니다.
2. 그냥 폴더 만들어도 돼요
폴더를 만드셨다면, 터미널을 다시 열고
cd (해당 폴더)
claude
하시면 됩니다.
실행하고 나면? 클로드코드가 방향을 잡아줍니다
claude를 실행하면 화면에 프롬프트(>)가 뜨는데, 여기서부터는 어렵게 생각할 필요가 없습니다. 하고 싶은 걸 그냥 말(한글도 가능)로 입력하면, 클로드코드가 알아서 다음에 뭘 해야 할지 방향을 제시해줍니다.
> 이 폴더에 간단한 자기소개 웹페이지를 하나 만들어줘
이렇게 요청하면 클로드코드가 필요한 파일을 확인하고, 어떤 작업을 할지 스스로 계획을 세운 뒤, 실제로 파일을 만들거나 수정하기 직전에 항상 먼저 물어봅니다. 이때 사용자는 화면에 뜬 선택지 중 "예(Yes)"에 해당하는 항목을 고르기만 하면 됩니다. 즉 처음부터 끝까지 복잡한 명령어를 외울 필요 없이, 클로드코드가 묻는 질문에 승인만 반복하면 작업이 진행되는 구조입니다.
yes 누르기
자주 쓰는 기본 명령어
세션 안에서 슬래시(/)로 시작하는 명령어를 쓰면 여러 기능을 바로 실행할 수 있습니다.
명령어기능
/help
사용 가능한 명령어 목록 보기
/init
프로젝트 규칙을 담은 CLAUDE.md 파일 생성
/resume
이전 세션 이어서 진행
/login
계정 전환 또는 재로그인
/rewind
이전 상태로 되돌리기
마무리 팁
처음 사용한다면 /init 명령어로 CLAUDE.md 파일을 먼저 만들어두는 걸 추천합니다. 프로젝트의 코딩 규칙이나 폴더 구조 같은 정보를 미리 적어두면, 이후 작업 요청을 할 때 클로드코드가 훨씬 정확하게 이해하고 결과물을 냅니다. 또한 큰 폭의 코드 수정을 시키기 전에는 git commit으로 체크포인트를 먼저 남겨두면, 예상과 다른 결과가 나와도 쉽게 되돌릴 수 있어 안전합니다.
클로드코드 사용방법, 자주 묻는 질문
Q. 클로드코드는 무료인가요? 무료 Claude.ai 플랜으로는 사용할 수 없습니다. Pro, Max, Team, Enterprise 중 하나의 유료 구독이 있거나, 사용한 만큼 요금이 부과되는 Console(API) 계정이 있어야 합니다.
Q. 코딩을 전혀 몰라도 사용할 수 있나요? 자연어(한글 포함)로 요청하는 방식이라 명령어를 외울 필요는 없습니다. 다만 클로드코드가 만든 결과물이 내가 원하는 방향이 맞는지 판단하려면 최소한의 기초 지식이 있으면 훨씬 수월합니다.
Q. Windows에서도 문제없이 쓸 수 있나요? 네, Windows 10(1809) 이상에서 PowerShell로 바로 설치할 수 있고, WSL 환경에서도 사용 가능합니다.
Q. 파일을 마음대로 수정하거나 삭제하지는 않나요? 아닙니다. 파일을 실제로 만들거나 수정하기 직전에 항상 사용자에게 먼저 승인을 요청하는 구조이기 때문에, 허락 없이 임의로 작업을 진행하지 않습니다.
