클로드 코드 사용방법은 다섯 단계입니다. 쓸 수 있는 계정인지 확인하고, 설치 명령 한 줄을 붙여넣고, 새 터미널 창에서 claude --version으로 설치를 확인한 뒤, 작업할 폴더에서 claude를 입력해 로그인하고 할 일을 평소 말로 적으면 됩니다.
계정은 Pro·Max 같은 유료 플랜이나 Console 계정이어야 하고, 무료 플랜에는 들어 있지 않습니다. 2026년 10월 21일 Claude Code 공식 한국어 문서(개요·빠른 시작·고급 설정)를 직접 읽고 처음부터 활용까지 순서대로 정리했습니다.
1. 클로드 코드 사용방법, 무엇부터 하나요?
계정 확인부터 합니다. 설치는 누구나 할 수 있지만, 처음 실행할 때 로그인하려면 클로드 코드가 들어 있는 계정이 있어야 합니다. 2026년 10월 21일 공식 고급 설정 문서 기준 문장은 이렇습니다.
Claude Code는 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 claude.ai 플랜에는 Claude Code 액세스가 포함되지 않습니다.
Console 계정은 미리 충전한 크레딧으로 쓴 만큼 내는 API 계정입니다. 플랜별 요금과 사용량 한도는 클로드 코드 요금제, 무료로 쓸 수 있을까?에 정리해 두었습니다.
2026년 10월 21일 공식 문서 기준으로 컴퓨터는 macOS 13.0 이상이나 Windows 10 1809 이상, Ubuntu 20.04 이상 같은 운영체제에 메모리(RAM) 4GB 이상이면 됩니다. 인터넷 연결은 꼭 있어야 합니다.
2. 터미널·VS Code·데스크톱 앱, 쓸 곳 고르기
클로드 코드는 한곳에서만 돌아가는 프로그램이 아닙니다. 공식 개요 문서는 터미널, IDE 확장 프로그램, 데스크톱 앱, 웹을 쓰는 곳으로 꼽습니다. IDE는 VS Code처럼 코드를 쓰고 고치는 편집기 프로그램입니다.
- 터미널(명령어 창): 설치 명령으로 깔고
claude로 시작합니다 - VS Code·Cursor: 확장 프로그램 보기에서 「Claude Code」를 검색해 설치합니다
- 데스크톱 앱: 앱에 클로드 코드가 들어 있어 따로 설치할 필요가 없고, 유료 구독이 필요합니다
- 웹: claude.ai/code에서 내 컴퓨터 설정 없이 브라우저로 시작합니다
어디서 쓰든 같은 엔진에 연결돼 CLAUDE.md 파일과 설정이 모든 환경에서 작동한다고 문서에 적혀 있습니다. 이 글은 가장 기본인 터미널을 기준으로 설명합니다.
3. 설치 명령 한 줄과 설치 확인
터미널을 열고 내 운영체제에 맞는 명령 하나를 붙여넣습니다. 공식 문서에 적힌 명령 그대로입니다.
- 맥·리눅스·WSL(윈도우 안의 리눅스 환경):
curl -fsSL https://claude.ai/install.sh | bash - 윈도우 PowerShell:
irm https://claude.ai/install.ps1 | iex - 윈도우 CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
설치하는 동안에는 진행 표시가 나오지 않습니다. 끝나면 새 터미널 창을 열고 claude --version을 실행합니다. 버전 번호가 나오면 설치가 된 것입니다.
윈도우에서는 관리자로 실행할 필요가 없습니다. 명령어 창을 처음 다룬다면 클로드 코드 터미널(CLI) 처음 쓰는 법에 창 여는 법부터 적어 두었습니다.
4. 프로젝트 폴더에서 claude 입력하고 로그인
설치가 끝나면 작업할 폴더로 들어가 claude를 입력합니다. 공식 빠른 시작 문서의 예시는 cd /path/to/your/project 다음 줄에 claude입니다. 경로 부분은 내 폴더 위치로 바꿉니다.
처음 실행하면 로그인을 요청합니다. Claude 구독이나 Console 계정이면 안내에 따라 브라우저에서 인증을 마칩니다. 한 번 로그인하면 자격 증명이 저장돼 다시 로그인할 필요가 없습니다.
로그인하면 입력창 위에 버전, 현재 모델, 작업 폴더가 표시됩니다. 나중에 계정을 바꾸거나 다시 인증하려면 실행 중인 세션 안에서 /login을 입력합니다.
5. 첫 질문과 첫 수정은 이렇게
처음에는 묻기만 해 봅니다. 공식 문서가 권하는 첫 질문은 what does this project do?처럼 이 프로젝트가 무엇을 하는지 묻는 문장입니다. 클로드 코드가 필요한 파일을 알아서 읽으므로 내용을 붙여넣을 필요가 없습니다.
다음은 작은 수정입니다. 문서 예시는 add a hello world function to the main file입니다. 클로드 코드가 고칠 파일을 찾아 바뀔 내용을 보여 주고, 허락을 물으면 「Yes」를 골라 승인합니다.
먼저 묻지 않고 할 수 있는 일의 범위는 권한 모드가 정합니다. 언제든 Shift+Tab을 눌러 바꿀 수 있습니다.
요청은 증상과 원하는 결과까지 구체적으로 적을수록 좋습니다. 문서는 「버그 수정」 대신 「사용자가 잘못된 자격 증명을 입력한 후 빈 화면을 보는 로그인 버그 수정」처럼 적고, 큰 일은 단계로 나눠 시키라고 권합니다.
6. 자주 쓰는 명령과 되돌리는 법
처음 며칠은 아래 명령 몇 개면 충분합니다. 앞의 셋은 클로드 코드 안에서, 마지막 하나는 터미널에서 입력합니다.
/help: 쓸 수 있는 명령 보기/clear: 대화 기록 지우기/exit: 클로드 코드 끝내기(Ctrl+D 두 번도 됩니다)claude -c: 지금 폴더에서 마지막으로 하던 대화 이어 하기
일하는 도중에 멈추려면 Esc를 누릅니다. 바뀐 파일을 되돌리려면 Esc를 두 번 누르거나 /rewind를 실행해 돌아갈 시점을 고릅니다. 클로드 코드는 파일을 고치기 전에 내용을 저장해 둡니다.
다만 이 되돌리기(체크포인트)는 git을 대신하지 않습니다. 터미널 명령으로 바뀐 것이나 데이터베이스·배포처럼 바깥에 영향을 준 작업은 되돌리지 못한다고 문서에 적혀 있습니다. git은 파일 변경 이력을 남기는 버전 관리 도구입니다.
7. CLAUDE.md와 스킬로 내 방식 가르치기
같은 설명을 매번 되풀이하지 않으려면 프로젝트 맨 위 폴더에 CLAUDE.md 파일을 둡니다. 클로드 코드는 세션을 시작할 때마다 이 파일을 읽으므로, 지킬 규칙과 자주 쓰는 방식을 적어 두면 됩니다.
반복하는 작업 순서는 스킬로 묶어 /review-pr 같은 이름으로 부를 수 있습니다. 스킬을 두는 폴더와 만드는 법은 클로드 코드 스킬, 무엇이고 어디서 구할까?에 정리했습니다.
설치나 설정이 이상하면 claude doctor를 실행합니다. 세션을 시작하지 않고 설치 상태와 설정 오류, 고칠 방법을 읽기 전용으로 보여 줍니다.
정리하면 클로드 코드는 이 순서로 시작합니다.
- 계정을 확인합니다(Pro·Max·Team·Enterprise 또는 Console)
- 내 운영체제에 맞는 설치 명령 한 줄을 붙여넣습니다
- 새 터미널 창에서
claude --version으로 확인합니다 - 작업할 폴더에서
claude를 입력하고 로그인합니다 - 구체적으로 요청하고, 필요하면
Esc두 번으로 되돌립니다
채팅 Claude와 무엇이 다른지는 클로드 코드란? 채팅 클로드와 다른 점에, 처음 무엇을 만들어 볼지는 클로드 바이브코딩, 무엇부터 시작할까?에 있습니다.
혼자 배울 공식 자료는 클로드 코드 강의 글에, 커서와 함께 쓰는 법은 커서 클로드 코드 사용법에 정리했습니다.
운영체제별 설치는 윈도우 설치 따라 하기와 맥북 설치 따라 하기를, 막혔을 때는 설치가 안 될 때 확인할 것을 보세요.
직접 만들어 보려면 클로드로 홈페이지 만들기를, 만든 화면을 다른 사람에게 보여 주려면 클로드 웹사이트 배포, 만든 화면 공개하기로 이어 가면 됩니다.
참고자료 (모두 2026년 10월 21일 확인)
- Claude Code 문서 「개요」 — code.claude.com/docs/ko/overview
- Claude Code 문서 「빠른 시작」 — code.claude.com/docs/ko/quickstart
- Claude Code 문서 「고급 설정」 — code.claude.com/docs/ko/setup
- Claude Code 문서 「Claude Code의 작동 방식」 — code.claude.com/docs/ko/how-claude-code-works
- Claude Code 문서 「모범 사례」 — code.claude.com/docs/ko/best-practices
#클로드코드 #클로드코드사용법 #ClaudeCode #바이브코딩 #AI코딩도구
