클로드 코드 사용방법의 첫 단계는 설치 명령이 아닙니다. 클로드 코드는 터미널에서 AI에게 코드 작업을 맡기는 도구인데, 설치 명령보다 먼저 확인해야 할 것이 두 가지 있습니다. 로그인할 수 있는 계정과, 명령을 붙여 넣을 터미널 창입니다. 2026년 10월 3일에 확인한 앤트로픽 공식 문서(퀵스타트, 설치 안내) 기준으로 준비물, 설치, 로그인, 첫 질문까지의 순서를 정리했습니다. 개발 경험이 없어도 따라갈 수 있도록 공식 문서가 예시로 든 문장을 그대로 옮겨 보겠습니다.
먼저 확인할 것: 계정, 터미널, 작업할 폴더
공식 퀵스타트는 시작 전 준비물을 세 가지로 적습니다. 터미널(명령 프롬프트)을 열어 둘 것, 작업할 코드 프로젝트가 있을 것, 그리고 Claude 구독(Pro, Max, Team, Enterprise 중 하나) 또는 Claude Console 계정 또는 지원되는 클라우드 서비스 계정이 있을 것입니다. 터미널을 한 번도 써 본 적이 없다면 공식 문서에 별도의 터미널 안내 페이지가 있다고 소개되어 있습니다. 앤트로픽의 Claude Code 제품 소개 페이지는 터미널, IDE, Slack, 웹에서 작업을 맡기고 검토할 수 있다고 안내합니다.
여기서 구독 요금이 얼마인지는 이 글에서 다루지 않았습니다. 요금은 바뀔 수 있고, 클로드 요금제는 이 블로그의 클로드 요금제 비교 글에서 따로 정리했습니다. 이 글은 사용방법에 집중합니다.
내 컴퓨터가 지원되는지도 봐야 합니다. 설치 안내 페이지의 시스템 요구사항은 운영체제로 macOS 13.0 이상, Windows 10 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상을 적고 있습니다. 하드웨어는 4GB 이상의 메모리와 x64 또는 ARM64 프로세서, 그리고 인터넷 연결이 필요하다고 되어 있습니다.
설치: 내 운영체제에 맞는 명령 하나만 붙여 넣습니다
공식 문서가 권장하는 방식은 네이티브 설치입니다. 운영체제별 명령은 다음과 같이 안내됩니다.
- macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash
- Windows PowerShell: irm https://claude.ai/install.ps1 | iex
- Windows CMD: 공식 문서의 CMD용 명령을 그대로 사용
여기서 자주 틀리는 부분이 Windows입니다. 공식 문서는 PowerShell과 CMD의 명령이 서로 다르다고 알려 줍니다. 오류 문구에 &&가 나오면 PowerShell에서 CMD용 명령을 쓴 경우이고, irm이 인식되지 않는다는 문구가 나오면 CMD에서 PowerShell용 명령을 쓴 경우라고 설명합니다. 지금 열린 창이 어느 쪽인지는 입력 줄 앞의 표시로 구분할 수 있고, PowerShell은 PS C:\로, CMD는 PS 없이 C:\로 시작한다고 합니다.
Homebrew나 WinGet으로 설치하는 방법도 있습니다. 맥에서는 brew install --cask claude-code, 윈도우에서는 winget install Anthropic.ClaudeCode가 안내됩니다.
다만 이 두 방식은 자동 업데이트가 되지 않아서, 공식 문서는 brew upgrade claude-code 또는 winget upgrade Anthropic.ClaudeCode로 직접 올려야 한다고 적습니다.
네이티브 설치는 백그라운드에서 자동으로 업데이트된다고 되어 있으므로, 처음이라면 네이티브 설치가 신경 쓸 일이 적습니다.
설치가 끝나면 새 터미널 창을 열고 claude --version을 입력합니다. 버전 숫자가 뒤에 (Claude Code)와 함께 나오면 정상입니다. claude를 찾을 수 없다는 문구가 나온다면 설치 위치가 PATH에 아직 잡히지 않은 상태이고, 공식 문서에 PATH 수정 안내가 따로 있습니다.
로그인과 첫 실행
터미널에서 claude라고 입력하면 처음 한 번 로그인 안내가 나옵니다. Claude 구독이나 Console 계정이라면 안내에 따라 브라우저에서 인증을 마치면 됩니다. 이미 ANTHROPIC_API_KEY 환경 변수를 설정해 둔 경우에는 로그인 대신 그 키를 쓸지 승인하라는 화면이 나온다고 합니다. 나중에 계정을 바꾸고 싶다면 실행 중인 화면에서 /login을 입력하면 됩니다. 한 번 로그인하면 인증 정보가 저장되어 다시 로그인하지 않아도 된다고 적혀 있습니다.
실제로 쓰는 순서는 이렇습니다. 작업할 프로젝트 폴더로 이동한 뒤 claude를 실행합니다. 화면에는 버전, 현재 모델, 작업 폴더가 표시된 프롬프트가 뜨고, /help로 사용 가능한 명령을, /resume으로 이전 대화를 이어 갈 수 있습니다. 폴더 이동 경로를 모르겠다면 파일 탐색기에서 폴더를 열어 경로를 복사하는 방법을 쓰면 됩니다.
첫 질문과 첫 수정: 공식 문서의 순서
퀵스타트는 코드를 고치기 전에 질문부터 해 보라고 권합니다. 공식 문서가 예시로 든 첫 질문은 "what does this project do?"입니다. 한국어로 물어도 되는지는 이 문서에서 확인한 내용이 아니라서 적지 않습니다. 같은 문서가 이어서 보여 주는 질문은 쓰인 기술이 무엇인지, 시작 파일이 어디인지, 폴더 구조를 설명해 달라는 것들입니다. 공식 문서는 Claude Code가 필요할 때 프로젝트 파일을 알아서 읽으므로 맥락을 직접 붙여 넣을 필요가 없다고 설명합니다.
질문에 익숙해졌다면 작은 수정을 맡겨 봅니다. 공식 문서의 예시는 "add a hello world function to the main file"입니다. Claude Code가 알맞은 파일을 찾아 바뀌는 내용을 보여 주고, 변경 전에 묻는 화면이 나오면 Yes를 골라 승인하면 됩니다.
여기서 하나 알아 둘 점이 권한 모드입니다. 공식 문서는 Claude Code v2.1.283 이상에서 대화형 터미널 세션의 기본 시작 모드가 자동 모드라고 설명합니다. 자동 모드는 사용자 대신 분류기가 작업을 검토하고, 대부분의 파일 수정과 명령 실행을 묻지 않고 진행하는 방식입니다. 그보다 이전 버전에서는 Pro, Max, Team 요금제에서만 기본이라고 합니다.
설정이나 소속 조직이 다른 시작 모드를 정할 수도 있고, 실행 중에 Shift+Tab을 누르면 권한 모드를 바꿀 수 있습니다. 처음 쓰는 분은 변경 내용을 직접 보면서 승인하는 쪽이 편한지, 자동으로 두는 쪽이 편한지 이 키로 바꿔 보며 정하시면 됩니다.
자주 쓰는 명령을 표로 정리합니다
공식 퀵스타트가 꼽은 하루 단위 명령은 아래와 같습니다. 앞의 네 줄은 터미널에서 시작할 때, 뒤의 세 줄은 실행 중에 입력합니다.
| 입력 | 하는 일 |
|---|---|
claude | 대화형 모드 시작 |
claude "task" | 첫 요청을 붙여서 대화형 모드 시작 |
claude -p "query" | 한 번만 묻고 바로 종료 |
claude -c | 현재 폴더의 가장 최근 대화 이어가기 |
claude -r | 이전 대화를 골라 다시 열기 |
/clear | 대화 기록 지우기 |
/exit 또는 Ctrl+D 두 번 | Claude Code 종료 |
처음에는 claude와 /exit 두 가지만 외워도 시작할 수 있습니다. 나머지는 필요해질 때 하나씩 늘리면 됩니다. 예를 들어 어제 하던 작업을 이어 가고 싶다면 claude -c를, 한 줄만 물어보고 바로 닫고 싶다면 claude -p를 쓰면 되고, 대화가 길어져 내용을 비우고 싶다면 /clear를 입력하면 됩니다. 이 명령들은 공식 퀵스타트의 필수 명령 표에 같은 설명으로 나와 있고, 전체 명령 목록은 공식 문서의 CLI 참조와 명령어 참조 페이지에 따로 있다고 안내됩니다.
이 표 말고 입력창에서 /를 누르면 쓸 수 있는 명령과 스킬 목록이 보이고, Tab으로 명령을 자동 완성하고, 위쪽 화살표로 이전 입력을 불러올 수 있다고 공식 문서는 안내합니다.
처음에는 이렇게 요청하라고 안내합니다
퀵스타트의 초보자 팁은 세 가지입니다. 첫째는 구체적으로 요청하는 것입니다. "버그를 고쳐 줘"보다 "잘못된 비밀번호를 입력한 뒤 사용자에게 빈 화면이 보이는 로그인 버그를 고쳐 줘"처럼 말하라는 예시를 듭니다. 둘째는 큰 일을 단계로 나누는 것입니다. 예시는 사용자 프로필용 데이터베이스 표를 만들고, 그 정보를 읽고 고치는 API를 만들고, 화면을 만드는 순서로 나눕니다. 셋째는 고치기 전에 먼저 살펴보게 하는 것입니다. 데이터 구조를 분석해 달라고 먼저 시키고 그다음에 수정을 시키는 식입니다.
비개발자에게는 첫째와 셋째가 특히 쓸모 있습니다. 코드를 읽지 못해도 "무엇이 어떻게 잘못됐는지"는 말로 설명할 수 있고, 수정 전에 설명부터 받으면 맡긴 일이 내가 원한 방향인지 확인할 수 있기 때문입니다. 이미 클로드 코드를 쓰고 있다면 이 블로그의 클로드 코드 사용량 줄이려 소넷 5.5로 옮기며 막힌 부분 기록에서 설정을 바꿀 때 막힌 지점을 볼 수 있습니다.
자주 묻는 질문
Q. 무료로도 쓸 수 있나요?
A. 공식 퀵스타트가 적은 계정 유형은 Claude 구독(Pro, Max, Team, Enterprise), Claude Console, 지원되는 클라우드 서비스입니다. 무료 계정으로 쓸 수 있는지는 이 문서에서 확인되지 않아서 적지 않았습니다. 계정 조건은 가입 화면과 공식 요금 안내에서 확인하세요.
Q. 컴퓨터가 망가지지 않을까 걱정됩니다.
A. 이 문서는 Claude Code가 변경 전에 묻는 화면을 보여 줄 수 있고, 시작 모드는 설정에 따라 다르다고 안내합니다. 어떤 폴더에서 시작하느냐가 작업 범위를 정하므로, 처음에는 연습용 폴더에서 시작하는 것이 안전합니다. 이 글은 직접 새로 설치해 시험해 본 기록이 아닌 공식 문서 정리라서 실제 화면은 버전에 따라 다를 수 있습니다.
같이 읽을 글을 고르신다면, 설치 뒤 구독을 정할 때는 요금제 비교 글을, 실제로 이미 맡겨 본 기록은 소넷 5.5 전환 글을 보시면 이어집니다.
확인 자료
- Claude Code 퀵스타트 (확인 2026-10-03)
- Claude Code 설치 안내 (확인 2026-10-03)
- Claude Code 제품 소개 (claude.com) (확인 2026-10-18)
이 글은 위 공식 문서에서 확인한 내용만 바탕으로 작성했습니다. 구독 요금, 무료 계정 사용 가능 여부, 한국어 질문의 동작은 확인하지 못해 포함하지 않았습니다. 버전과 조건은 바뀔 수 있으니 설치 전에 공식 문서를 다시 확인하세요.